From c89566832f567ff134da8c2d224c25bd2bb817a4 Mon Sep 17 00:00:00 2001 From: Jonathan Glassman Date: Tue, 16 Dec 2025 10:01:07 +0000 Subject: [PATCH 1/2] Add Customize GitLab Duo landing page --- doc/user/gitlab_duo/customize_duo.md | 27 +++++++++++++++++++++++++++ 1 file changed, 27 insertions(+) create mode 100644 doc/user/gitlab_duo/customize_duo.md diff --git a/doc/user/gitlab_duo/customize_duo.md b/doc/user/gitlab_duo/customize_duo.md new file mode 100644 index 00000000000000..9213f3e7076cb2 --- /dev/null +++ b/doc/user/gitlab_duo/customize_duo.md @@ -0,0 +1,27 @@ +--- +stage: AI-powered +group: Duo Chat +info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://handbook.gitlab.com/handbook/product/ux/technical-writing/#assignments +title: Customize GitLab Duo +--- + +You can customize GitLab Duo to match your workflow, coding standards, or project requirements. + +## Customization options + +| Method | Use cases | +|-----------|--------------| +| [Use custom rules](../gitlab_duo_chat/agentic_chat.md#create-custom-rules) to provide instructions for GitLab Duo Chat. Applies to GitLab tools only. | - Apply personal preferences.
- Enforce team standards. | +| [Create an AGENTS.md file](../gitlab_duo_chat/agentic_chat.md#create-agentsmd-instruction-files) to provide instructions to GitLab Duo Chat and other AI coding tools. Applies to GitLab and non-GitLab tools. | - Account for project-specific context
- Organize a monorepo.
- Enforce directory-specific conventions. | +| [Customize instructions for GitLab Duo Code Review](../project/merge_requests/duo_in_merge_requests.md#customize-instructions-for-gitlab-duo-code-review) to ensure consistent and specific code review standards in your project.| Apply:
- Language-specific review rules.
- Security standards.
- Code quality requirements.
- File-specific guidelines. | + +## Best practices + +When customizing GitLab Duo, apply the following best practices: + +- Start with some clear and simple instructions, and add more as needed. +- Provide specific and actionable guidance. +- Choose the method that matches your use case. +- Combine multiple methods to tailor and control how GitLab Duo behaves. +- Document your choices in comments to explain why certain instructions exist. +- Protect customization files with [Code Owners](../project/codeowners/_index.md) to manage changes. -- GitLab From 16040f2ea819dc2fb6898d3b8cbd1b918645893e Mon Sep 17 00:00:00 2001 From: Jonathan Glassman Date: Wed, 17 Dec 2025 08:15:40 +0000 Subject: [PATCH 2/2] Expand best practices --- doc/user/gitlab_duo/customize_duo.md | 6 ++++-- 1 file changed, 4 insertions(+), 2 deletions(-) diff --git a/doc/user/gitlab_duo/customize_duo.md b/doc/user/gitlab_duo/customize_duo.md index 9213f3e7076cb2..190f3f0af96b86 100644 --- a/doc/user/gitlab_duo/customize_duo.md +++ b/doc/user/gitlab_duo/customize_duo.md @@ -19,8 +19,10 @@ You can customize GitLab Duo to match your workflow, coding standards, or projec When customizing GitLab Duo, apply the following best practices: -- Start with some clear and simple instructions, and add more as needed. -- Provide specific and actionable guidance. +- Start with minimal clear and simple instructions, and add more as needed. + Keep the instruction file as short as possible. +- Make sure the instructions are specific and actionable. Provide examples as + needed. - Choose the method that matches your use case. - Combine multiple methods to tailor and control how GitLab Duo behaves. - Document your choices in comments to explain why certain instructions exist. -- GitLab