## Background The AI engineering org has been restructured. The YAML files in `www-gitlab-com` have already been updated ([!143651](https://gitlab.com/gitlab-com/www-gitlab-com/-/merge_requests/143651)), but the frontmatter metadata (`stage:` and `group:`) in individual doc files in `gitlab-org/gitlab` still reference old values. See the full reorg details in: https://gitlab.com/groups/gitlab-org/ai-powered/-/work_items/8 ## New structure | Stage | Groups | |-------|--------| | `agent_foundations` | Agent Developer, Agent Execution, AI Catalog | | `ai_clients` | Developer Clients, Duo Chat, Duo Client SDK | | `ai_platform` | AI Model Services, AI Core Infra | | `ai_coding` | Code Review, DAP Repository Flows, DAP Events | The old `AI-powered` stage and all former group names are now deprecated. ## What needs to be done Each doc file that has `stage: AI-powered` needs to be updated to the correct new stage and group. The tables below are the result of a full `grep -r "stage: AI-powered" doc/` run, with group values confirmed by reading each file and EM input in the comments. **EMs: Please see comments for relevant thread and confirm the correct group mapping for each file, especially those marked with `?`.** > [!note] > Files under `doc/development/documentation/styleguide/deprecations_and_removals.md` contain `stage: AI-powered` only as an example in a code block — no change needed there. --- ### `doc/user/duo_agent_platform/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/_index.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`ai_catalog.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/ai_catalog.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`authentication.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/authentication.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`composite_identity.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/composite_identity.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`context.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/context.md) | `AI Framework` | `agent_foundations` | ? | Pending `@bastirehm` | | [`environment_sandbox.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/environment_sandbox.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`model_selection.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/model_selection.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`onboarding.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/onboarding.md) | `AI Coding` | `ai_coding` | ? | | | [`security_threats.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/security_threats.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/troubleshooting.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`turn_on_off.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/turn_on_off.md) | `AI Framework` | tbd | tbd | Pending `@mhamda` | | [`agents/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/_index.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`agents/custom.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/custom.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`agents/external.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/external.md) | `Agent Foundations` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`agents/external_examples.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/external_examples.md) | `Agent Foundations` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`agents/tools.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/tools.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`agents/foundational_agents/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/foundational_agents/_index.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | | | [`agents/foundational_agents/ci_expert_agent.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/foundational_agents/ci_expert_agent.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | | | [`agents/foundational_agents/data_analyst.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/foundational_agents/data_analyst.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | | | [`agents/foundational_agents/permissions_assistant.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/foundational_agents/permissions_assistant.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | | | [`agents/foundational_agents/planner.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/foundational_agents/planner.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | | | [`agents/foundational_agents/security_analyst_agent.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/agents/foundational_agents/security_analyst_agent.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | | | [`code_suggestions/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/code_suggestions/_index.md) | `AI Coding` | `ai_coding` | ? | | | [`customize/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/customize/_index.md) | `Duo Chat` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`customize/agents_md.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/customize/agents_md.md) | ? | `agent_foundations` | `Agent Developer` | ✅ `@bastirehm` | | [`customize/agent_skills.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/customize/agent_skills.md) | ? | `agent_foundations` | `Agent Developer` | ✅ `@bastirehm` | | [`customize/custom_rules.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/customize/custom_rules.md) | ? | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`customize/review_instructions.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/customize/review_instructions.md) | ? | `ai_coding` | `Code Review` | ✅ `@bastirehm` | | [`flows/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/_index.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`flows/custom.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/custom.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`flows/custom_flows_schema.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/custom_flows_schema.md) | ? | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`flows/execution.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/execution.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`flows/execution_variables.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/execution_variables.md) | ? | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`flows/foundational_flows/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/foundational_flows/_index.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`flows/foundational_flows/code_review.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/foundational_flows/code_review.md) | ? | `ai_coding` | `Code Review` | ✅ `@bastirehm` | | [`flows/foundational_flows/convert_to_gitlab_ci.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/foundational_flows/convert_to_gitlab_ci.md) | ? | `agent_foundations` | `Agent Developer` | ✅ `@bastirehm` | | [`flows/foundational_flows/developer.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/foundational_flows/developer.md) | ? | `agent_foundations` | `Agent Developer` | ✅ `@bastirehm` | | [`flows/foundational_flows/fix_pipeline.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/foundational_flows/fix_pipeline.md) | ? | `verify` | `Pipeline Execution` | ✅ `@bastirehm` — different stage, handle separately | | [`flows/foundational_flows/software_development.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/flows/foundational_flows/software_development.md) | ? | `agent_foundations` | `Agent Developer` | ✅ `@bastirehm` | | [`sessions/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/sessions/_index.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`triggers/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_agent_platform/triggers/_index.md) | `Agent Foundations` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | ### `doc/user/gitlab_duo/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/_index.md) | `AI Framework` | ? | ? | | | [`code_review.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/code_review.md) | `AI Coding` | `ai_coding` | `Code Review` | | | [`context.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/context.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`customize_duo/review_instructions.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/customize_duo/review_instructions.md) | `AI Coding` | `ai_coding` | `Code Review` | | | [`data_usage.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/data_usage.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`feature_summary.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/feature_summary.md) | `AI Framework` | ? | ? | Unclear — see comment | | [`model_context_protocol/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/model_context_protocol/_index.md) | `AI Framework` | `agent_foundations` | `Agent Execution` | ✅ `@wortschi` / `@bastirehm` | | [`model_context_protocol/ai_catalog_mcp_servers.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/model_context_protocol/ai_catalog_mcp_servers.md) | ? | `agent_foundations` | `AI Catalog` | ✅ `@wortschi` / `@bastirehm` | | [`model_context_protocol/mcp_clients.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/model_context_protocol/mcp_clients.md) | ? | `agent_foundations` | `AI Catalog` | ✅ `@wortschi` / `@bastirehm` | | [`model_context_protocol/mcp_server.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/model_context_protocol/mcp_server.md) | ? | `agent_foundations` | `Agent Execution` | ✅ `@wortschi` / `@bastirehm` | | [`model_context_protocol/mcp_server_tools.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/model_context_protocol/mcp_server_tools.md) | ? | `agent_foundations` | `Agent Execution` | ✅ `@wortschi` / `@bastirehm` | | [`model_context_protocol/mcp_server_troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/model_context_protocol/mcp_server_troubleshooting.md) | ? | `agent_foundations` | `Agent Execution` | ✅ `@wortschi` / `@bastirehm` | | [`model_selection.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/model_selection.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`prompt_examples/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/prompt_examples/_index.md) | ? | ? | ? | | | [`prompt_examples/analyze_vulnerabilities.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/prompt_examples/analyze_vulnerabilities.md) | ? | ? | ? | | | [`prompt_examples/debug_failing_code.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/prompt_examples/debug_failing_code.md) | ? | ? | ? | | | [`prompt_examples/generate_tests.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/prompt_examples/generate_tests.md) | ? | ? | ? | | | [`prompt_examples/refactor_legacy_code.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/prompt_examples/refactor_legacy_code.md) | ? | ? | ? | | | [`prompt_guardrails.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/prompt_guardrails.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`security.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/security.md) | `AI Framework` | — | — | Being merged into `duo_amazon_q/_index.md` — see [!241963](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/241963) | | [`semantic_code_search.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/semantic_code_search.md) | `Global Search` | — | — | Not AI reorg | | [`troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/troubleshooting.md) | ? | ? | ? | | | [`turn_on_off.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/turn_on_off.md) | `AI Framework` | tbd | tbd | Pending `@mhamda` | | [`turn_on_off_earlier.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/turn_on_off_earlier.md) | `AI Framework` | tbd | tbd | Pending `@mhamda` | | [`use_cases.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo/use_cases.md) | `AI Framework` | ? | ? | Unclear — see comment | ### `doc/user/gitlab_duo_chat/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo_chat/_index.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | | [`agentic_chat.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo_chat/agentic_chat.md) | ? | ? | ? | | | [`best_practices.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo_chat/best_practices.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | | [`example_prompts.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo_chat/example_prompts.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | | [`examples.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo_chat/examples.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | | [`troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo_chat/troubleshooting.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | ### `doc/user/` (other) | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`duo_amazon_q/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_amazon_q/_index.md) | `AI Framework` | `ai_platform` | `AI Model Services` | ✅ `@wortschi` / `@mhamda` | | [`duo_amazon_q/setup.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/duo_amazon_q/setup.md) | ? | `ai_platform` | `AI Model Services` | ✅ `@wortschi` / `@mhamda` | | [`get_started/get_started_agent_platform.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/get_started/get_started_agent_platform.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`get_started/getting_started_gitlab_duo.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/get_started/getting_started_gitlab_duo.md) | ? | ? | ? | | | [`gitlab_duo_cli/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/gitlab_duo_cli/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`project/merge_requests/duo_in_merge_requests.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/merge_requests/duo_in_merge_requests.md) | `AI Coding` | `ai_coding` | `Code Review` | | | [`project/repository/code_explain.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/repository/code_explain.md) | ? | ? | ? | | | [`project/repository/code_suggestions/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/repository/code_suggestions/_index.md) | ? | `ai_coding` | `DAP Repository Flows` | ✅ `@francoisrose` | | [`project/repository/code_suggestions/context.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/repository/code_suggestions/context.md) | ? | `ai_coding` | `DAP Repository Flows` | ✅ `@francoisrose` | | [`project/repository/code_suggestions/repository_xray.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/repository/code_suggestions/repository_xray.md) | ? | `ai_coding` | ? | Unclear — see comment | | [`project/repository/code_suggestions/set_up.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/repository/code_suggestions/set_up.md) | ? | `ai_coding` | `DAP Repository Flows` | ✅ `@francoisrose` | | [`project/repository/code_suggestions/supported_extensions.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/repository/code_suggestions/supported_extensions.md) | `AI Coding` | `ai_coding` | `DAP Repository Flows` | ✅ `@francoisrose` | | [`project/repository/code_suggestions/troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/project/repository/code_suggestions/troubleshooting.md) | ? | `ai_coding` | `DAP Repository Flows` | ✅ `@francoisrose` | | [`search/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/search/_index.md) | `Global Search` | — | — | Not AI reorg | | [`search/advanced_search.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/search/advanced_search.md) | `Global Search` | — | — | Not AI reorg | | [`search/exact_code_search.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/user/search/exact_code_search.md) | `Global Search` | — | — | Not AI reorg | ### `doc/editor_extensions/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`eclipse/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/eclipse/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`eclipse/setup.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/eclipse/setup.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`eclipse/troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/eclipse/troubleshooting.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`jetbrains_ide/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/jetbrains_ide/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`jetbrains_ide/jetbrains_troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/jetbrains_ide/jetbrains_troubleshooting.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`jetbrains_ide/setup.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/jetbrains_ide/setup.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`language_server/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/language_server/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`neovim/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/neovim/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`neovim/neovim_troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/neovim/neovim_troubleshooting.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`neovim/setup.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/neovim/setup.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`security_considerations.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/security_considerations.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio/setup.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio/setup.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio/visual_studio_troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio/visual_studio_troubleshooting.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/_index.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/cicd.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/cicd.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/custom_queries.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/custom_queries.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/projects.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/projects.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/remote_urls.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/remote_urls.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/security_scanning.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/security_scanning.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/settings.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/settings.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/setup.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/setup.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/ssl.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/ssl.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`visual_studio_code/troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/editor_extensions/visual_studio_code/troubleshooting.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | ### `doc/administration/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`gitlab_duo/configure/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo/configure/_index.md) | `AI Framework` | tbd | tbd | Pending `@mhamda` | | [`gitlab_duo/configure/access_control.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo/configure/access_control.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`gitlab_duo/configure/gitlab_dedicated_for_government.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo/configure/gitlab_dedicated_for_government.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`gitlab_duo/gateway.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo/gateway.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`gitlab_duo/model_selection.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo/model_selection.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/_index.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/configuration_types.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/configuration_types.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/configure_duo_features.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/configure_duo_features.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/logging.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/logging.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/offline_deployment.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/offline_deployment.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/supported_llm_serving_platforms.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/supported_llm_serving_platforms.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/supported_models_and_hardware_requirements.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/supported_models_and_hardware_requirements.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/troubleshooting.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/troubleshooting.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`gitlab_duo_self_hosted/vllm_gpt_oss_120b.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/gitlab_duo_self_hosted/vllm_gpt_oss_120b.md) | `Custom Models` | `ai_platform` | `AI Model Services` | ✅ `@mhamda` | | [`raketasks/ai_catalog.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/raketasks/ai_catalog.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`settings/editor_extensions.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/settings/editor_extensions.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | | [`settings/web_ide.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/administration/settings/web_ide.md) | `Editor Extensions` | `ai_clients` | `Developer Clients` | | ### `doc/install/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`install_ai_gateway.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/install/install_ai_gateway.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | ### `doc/api/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`admin/ai_catalog.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/admin/ai_catalog.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`chat.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/chat.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | | [`code_suggestions.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/code_suggestions.md) | `AI Coding` | `ai_coding` | `DAP Repository Flows` | ✅ `@francoisrose` | | [`duo_agent_platform_flows.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/duo_agent_platform_flows.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`search.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/search.md) | `Global Search` | — | — | Not AI reorg | | [`search_admin.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/api/search_admin.md) | `Global Search` | — | — | Not AI reorg | ### `doc/tutorials/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`duo_chat_issues/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/tutorials/duo_chat_issues/_index.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | ### `doc/development/` | File | Current `group` | Proposed new `stage` | Proposed new `group` | Confirmed? | |------|-----------------|----------------------|----------------------|------------| | [`advanced_search.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/advanced_search.md) | `Global Search` | — | — | Not AI reorg | | [`advanced_search/tips.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/advanced_search/tips.md) | `Global Search` | — | — | Not AI reorg | | [`search/advanced_search_migration_styleguide.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/search/advanced_search_migration_styleguide.md) | `Global Search` | — | — | Not AI reorg | | [`search/advanced_search_migration_review.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/search/advanced_search_migration_review.md) | `Global Search` | — | — | Not AI reorg | | [`exact_code_search.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/exact_code_search.md) | `Global Search` | — | — | Not AI reorg | | [`agent_principles/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/agent_principles/_index.md) | `AI Framework` | `agent_foundations` | ? | Pending `@bastirehm` | | [`agent_principles/manifest_reference.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/agent_principles/manifest_reference.md) | `AI Framework` | `agent_foundations` | ? | Pending `@bastirehm` | | [`ai_architecture.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_architecture.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/_index.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/actions.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/actions.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/ai_development_license.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/ai_development_license.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/ai_evaluation_guidelines.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/ai_evaluation_guidelines.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/ai_feature_development_playbook.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/ai_feature_development_playbook.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/amazon_q_integration.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/amazon_q_integration.md) | `Custom Models` | `ai_platform` | `AI Model Services` | | | [`ai_features/availability.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/availability.md) | `AI Framework` | tbd | tbd | Pending `@mhamda` | | [`ai_features/code_suggestions.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/code_suggestions.md) | `AI Coding` | `ai_coding` | `DAP Repository Flows` | | | [`ai_features/composite_identity.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/composite_identity.md) | `AI Framework` | ? | ? | Unclear — see comment | | [`ai_features/developing_ai_features_for_duo_self_hosted.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/developing_ai_features_for_duo_self_hosted.md) | `Custom Models` | `ai_platform` | `AI Model Services` | | | [`ai_features/duo_agent_platform.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/duo_agent_platform.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` / `@wortschi` | | [`ai_features/duo_chat.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/duo_chat.md) | `Duo Chat` | `ai_clients` | `Duo Chat` | | | [`ai_features/evaluation_runner/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/evaluation_runner/_index.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/foundational_chat_agents.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/foundational_chat_agents.md) | `Workflow Catalog` | `agent_foundations` | `AI Catalog` | ✅ `@bastirehm` | | [`ai_features/foundational_flows.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/foundational_flows.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`ai_features/glossary.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/glossary.md) | `AI Framework` | ? | ? | Unclear — see comment | | [`ai_features/local_models.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/local_models.md) | `Custom Models` | `ai_platform` | `AI Model Services` | | | [`ai_features/logged_events.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/logged_events.md) | `AI Framework` | `agent_foundations` | `Agent Execution` | ✅ `@wortschi` / `@bastirehm` | | [`ai_features/logging.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/logging.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/model_migration.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/model_migration.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/model_switching.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/model_switching.md) | `Custom Models` | `ai_platform` | `AI Model Services` | | | [`ai_features/prompt_engineering.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/prompt_engineering.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`ai_features/semantic_search.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/semantic_search.md) | `Global Search` | — | — | Not AI reorg | | [`ai_features/test_setup_for_amazon_q.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/test_setup_for_amazon_q.md) | `AI Framework` | `ai_platform` | `AI Model Services` | ✅ `@wortschi` / `@mhamda` | | [`ai_features/vertex_model_enablement_process.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/ai_features/vertex_model_enablement_process.md) | `AI Framework` | `ai_platform` | `AI Core Infra` | ✅ `@wortschi` | | [`duo_agent_platform/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/duo_agent_platform/_index.md) | `Agent Foundations` | `agent_foundations` | `AI Core Infra` | ✅ `@bastirehm` / `@wortschi` | | [`duo_agent_platform/agent_interaction_patterns.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/duo_agent_platform/agent_interaction_patterns.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | | [`duo_agent_platform/create_triage_policy_with_gitlab_duo_agent_platform_guide.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/duo_agent_platform/create_triage_policy_with_gitlab_duo_agent_platform_guide.md) | `Agent Foundations` | `agent_foundations` | `Agent Developer` | ✅ `@bastirehm` | | [`duo_agent_platform/mcp/_index.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/duo_agent_platform/mcp/_index.md) | `AI Framework` | `agent_foundations` | `Agent Execution` | ✅ `@wortschi` / `@bastirehm` | | [`duo_agent_platform/mcp/graphql_integration.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/duo_agent_platform/mcp/graphql_integration.md) | `AI Framework` | `agent_foundations` | `Agent Execution` | ✅ `@wortschi` / `@bastirehm` | | [`workhorse/ai_assisted_features_architecture.md`](https://gitlab.com/gitlab-org/gitlab/-/blob/master/doc/development/workhorse/ai_assisted_features_architecture.md) | `Agent Foundations` | `agent_foundations` | `Agent Execution` | ✅ `@bastirehm` | ### `doc/integration/` (Global Search — not AI reorg) These files have `stage: AI-powered` but `group: Global Search` — they are not part of the AI reorg and should be handled separately if needed. - `doc/integration/zoekt/_index.md` - `doc/integration/zoekt/troubleshooting.md` - `doc/integration/elasticsearch/troubleshooting/migrations.md` - `doc/integration/elasticsearch/troubleshooting/indexing.md` - `doc/integration/elasticsearch/troubleshooting/access.md` - `doc/integration/elasticsearch/troubleshooting/_index.md` - `doc/integration/advanced_search/elasticsearch.md` ### `doc/drawers/` (Global Search — not AI reorg) - `doc/drawers/exact_code_search_syntax.md` - `doc/drawers/advanced_search_syntax.md` --- ## Remaining unknowns The following files still need EM input: - `doc/user/duo_agent_platform/context.md` — pending `@bastirehm` - `doc/development/agent_principles/_index.md` and `manifest_reference.md` — pending `@bastirehm` - `doc/administration/gitlab_duo/configure/_index.md`, `doc/user/duo_agent_platform/turn_on_off.md`, `doc/user/gitlab_duo/turn_on_off.md`, `doc/user/gitlab_duo/turn_on_off_earlier.md`, `doc/development/ai_features/availability.md` — Duo settings ownership TBD, pending `@mhamda` - `doc/user/gitlab_duo/feature_summary.md`, `doc/user/gitlab_duo/use_cases.md`, `doc/development/ai_features/composite_identity.md`, `doc/development/ai_features/glossary.md` — cross-cutting, no clear single owner; may use [unassigned page format](https://docs.gitlab.com/development/documentation/metadata/#unassigned-pages) - `doc/user/duo_agent_platform/code_suggestions/_index.md` and `onboarding.md` — pending `@mnohr` - `doc/user/project/repository/code_suggestions/repository_xray.md` — unclear, see `@francoisrose` comment - `doc/user/duo_agent_platform/flows/foundational_flows/fix_pipeline.md` — `@bastirehm` suggests `verify` / `Pipeline Execution` (different stage, handle separately) - Various `doc/user/gitlab_duo/prompt_examples/`, `doc/user/gitlab_duo_chat/agentic_chat.md`, `doc/user/get_started/getting_started_gitlab_duo.md`, `doc/user/project/repository/code_explain.md` — not yet confirmed ## Next steps 1. Resolve remaining unknowns above 2. Merge [!243083](https://gitlab.com/gitlab-org/gitlab/-/merge_requests/243083) (batch 1 — confirmed files) 3. Open batch 2 MR for remaining confirmed files once outstanding input is received