GitLab Duo는 AI 코딩 어시스턴트에 컨텍스트와 지침을 제공하는 새로운 표준인 AGENTS.md 사양을 지원합니다.

AGENTS.md 파일을 사용하여 저장소 구조, 코딩 컨벤션, 스타일 가이드라인, 빌드 및 테스트 지침, 프로젝트 컨텍스트를 문서화할 수 있습니다. AGENTS.md 파일을 지정하면 GitLab Duo Agent Platform과 해당 사양을 지원하는 다른 AI 도구에서 이러한 세부 정보를 사용할 수 있습니다.

GitLab Duo에서 AGENTS.md 파일을 사용하는 기능:

• GitLab UI 및 로컬 환경의 GitLab Duo Chat.

• Code Review Flow를 제외한 파운데이션 및 커스텀 플로우.

GitLab Duo가 AGENTS.md 파일을 사용하는 방법#

GitLab Duo 사용 방법에 따라 여러 수준에서 AGENTS.md 파일을 생성할 수 있습니다:

IDE에서 멀티 루트 워크스페이스를 사용하는 경우, 워크스페이스의 각 프로젝트에 대한 프로젝트 수준 AGENTS.md 파일을 생성할 수 있습니다.

GitLab Duo는 모든 대화에 대해 사용자 수준 및 프로젝트 수준 AGENTS.md 파일의 사용 가능한 지침을 결합합니다. 작업에 추가 AGENTS.md 파일이 포함된 디렉토리의 파일 작업이 필요한 경우, Chat은 해당 지침도 적용합니다.

GitLab Duo와 함께 AGENTS.md 사용하기#

AGENTS.md 파일을 추가하거나 업데이트한 후에 생성된 새 대화 및 플로우만 새 지침을 따릅니다. 이전에 존재하던 대화는 따르지 않습니다.

사전 요구 사항#

• Agent Platform 사전 요구 사항을 충족합니다.

• 로컬 환경에서 GitLab Duo Chat을 사용하려면 다음 중 하나를 설치하고 구성합니다:

  • GitLab for VS Code 6.60 이상.

  • JetBrains IDEs용 GitLab Duo 플러그인 3.26.0 이상.

  • GitLab Duo CLI 8.47.0 이상.

• 커스텀 플로우의 경우, executor에서 전달된 user_rule 컨텍스트에 액세스하도록 플로우의 구성 파일을 업데이트합니다:

  components:
  - name: "my_agent"
     type: AgentComponent
     prompt_id: "my_prompt"
     inputs:
     - from: "context:inputs.user_rule"
        as: "agents_dot_md"
      optional: true
  

  optional: true를 설정하면 AGENTS.md 파일이 없는 경우에도 플로우가 정상적으로 처리됩니다. 에이전트는 추가 컨텍스트 유무에 관계없이 작동합니다.

사용자 수준 AGENTS.md 파일 생성#

사용자 수준 AGENTS.md 파일은 모든 프로젝트에 적용됩니다.

1. 홈 디렉토리에 AGENTS.md 파일을 생성합니다:

   • Linux 또는 macOS에서는 ~/.gitlab/duo/AGENTS.md에 파일을 생성합니다.

   • Windows에서는 %APPDATA%\GitLab\duo\AGENTS.md에 파일을 생성합니다.

2. 파일에 지침을 추가합니다. 예를 들어:

   # 나의 개인 코딩 선호도
   
   - 초보자를 위해 항상 코드 변경 사항을 간단한 용어로 설명하기
   - 설명적인 변수명 사용
   - 복잡한 로직에 주석 추가
   - 적절한 경우 함수형 프로그래밍 패턴 선호
   

3. 파일을 저장합니다.

4. 지침을 적용하려면 새 대화 또는 플로우를 시작합니다. AGENTS.md 파일을 변경할 때마다 이 작업을 수행해야 합니다.

특정 환경 변수를 설정한 경우, AGENTS.md 파일을 다른 위치에 생성합니다:

• GLAB_CONFIG_DIR 환경 변수를 설정한 경우, $GLAB_CONFIG_DIR/AGENTS.md에 파일을 생성합니다.

• XDG_CONFIG_HOME 환경 변수를 설정한 경우, $XDG_CONFIG_HOME/gitlab/duo/AGENTS.md에 파일을 생성합니다.

프로젝트 수준 AGENTS.md 파일 생성#

프로젝트 수준 AGENTS.md 파일은 특정 프로젝트에만 적용됩니다.

1. 프로젝트 루트에 AGENTS.md 파일을 생성합니다.

2. 파일에 지침을 추가합니다. 예를 들어:

   # 프로젝트별 가이드라인
   
   - 이 프로젝트는 TypeScript를 사용한 React를 사용합니다
   - /src/components의 컴포넌트 구조를 따릅니다
   - /src/hooks의 커스텀 훅을 사용합니다
   - 상태 관리는 Redux Toolkit을 사용합니다
   

3. 파일을 저장합니다.

4. 지침을 적용하려면 새 대화 또는 플로우를 시작합니다. AGENTS.md 파일을 변경할 때마다 이 작업을 수행해야 합니다.

모노레포 및 하위 디렉토리에 AGENTS.md 파일 생성#

모노레포 또는 구별된 구성 요소가 있는 프로젝트의 경우, 하위 디렉토리에 AGENTS.md 파일을 배치하여 코드베이스의 다른 부분에 대한 컨텍스트별 지침을 제공할 수 있습니다.

GitLab Duo Chat이 하위 디렉토리에서 추가 AGENTS.md 파일을 발견하면, 해당 디렉토리의 파일을 편집하기 전에 관련 파일을 읽습니다. 예를 들어:

/my-project
  AGENTS.md              # 루트 지침 (모든 대화에 포함)
  /frontend
    AGENTS.md            # 프론트엔드별 지침
  /backend
    AGENTS.md            # 백엔드별 지침

이 예시에서:

• 루트 AGENTS.md는 항상 대화에 포함됩니다.

• GitLab Duo가 /frontend의 파일을 편집할 때 먼저 /frontend/AGENTS.md를 읽습니다.

• GitLab Duo가 /backend의 파일을 편집할 때 먼저 /backend/AGENTS.md를 읽습니다.

이 방법은 GitLab Duo가 프로젝트의 각 부분에 적합한 컨벤션을 따르도록 하는 데 도움이 됩니다.

하위 디렉토리에서 AGENTS.md를 사용하려면:

1. 프로젝트의 하위 디렉토리에 AGENTS.md 파일을 생성합니다.

2. 해당 디렉토리에 특화된 지침을 추가합니다. 예를 들어, 백엔드 서비스의 경우:

   # 백엔드 서비스 가이드라인
   
   - 이 서비스는 Express를 사용하는 Node.js를 사용합니다
   - RESTful API 컨벤션을 따릅니다
   - 비동기 작업에 async/await를 사용합니다
   - Joi 스키마로 모든 입력을 검증합니다
   

3. 파일을 저장합니다.

4. 지침을 적용하려면 해당 디렉토리의 파일과 관련된 새 대화를 시작합니다. AGENTS.md 파일을 변경할 때마다 이 작업을 수행해야 합니다.

관련 항목#

• 커스텀 규칙