ContextQMD
Back to Gitlabhq

Project onboarding for GitLab Duo Agent Platform

doc/user/duo_agent_platform/onboarding.md

19.1.03.0 KB
Original Source

{{< details >}}

  • Tier: Free, Premium, Ultimate
  • Offering: GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

{{< /history >}}

[!flag] The availability of this feature is controlled by a feature flag. For more information, see the history.

The Onboarding page helps you set up your project for use with GitLab Duo Agent Platform. From this page you can initialize project context and improve your CI/CD setup using AI agents.

Prerequisites

Initialize project context

The Initialize project context task analyzes your repository to create an AGENTS.md file for your project.

This file follows the AGENTS.md specification and documents your project conventions, such as test commands, linting rules, commit format, and coding patterns. Agent Platform features use it for context when working in your repository.

To initialize project context:

  1. In the top bar, select Search or go to and find your project.
  2. In the left sidebar, select Automate > Onboarding.
  3. Select Initialize project context. If AGENTS.md or .ai/AGENTS.md already exists on your default branch, this option is not available.

GitLab starts a developer/v1 agent session that analyzes your repository and opens a draft merge request to add an AGENTS.md file. A link to the agent session appears so you can track progress.

Improve CI/CD setup

The Improve CI setup task launches an agent that analyzes your existing CI/CD configuration and suggests improvements.

To improve your CI/CD setup:

  1. In the top bar, select Search or go to and find your project.
  2. In the left sidebar, select Automate > Onboarding.
  3. Select Improve CI setup. If .gitlab-ci.yml doesn't exist on your default branch, this option is not available.

GitLab starts an agent session that analyzes your .gitlab-ci.yml and opens a draft merge request with suggested improvements. A link to the agent session appears so you can track progress.