InfoGrab DocsInfoGrab Docs

GitLab AI 지침 파일 리뷰

GitLab AI 지침 파일을 리뷰할 때 참고할 기준을 설명하고 코드 리뷰 가이드로 연결합니다.

코드 리뷰에 관한 더 폭넓은 조언과 모범 사례는 코드 리뷰 가이드 를 참조합니다. 일반 프로세스 # .ai/ 아래 파일을 변경할 때마다 전담 리뷰가 필요합니다. 이 파일들은 AI 코딩 에이전트(GitLab Duo, Claude Code, OpenCode 및 AGENTS.md 를 인식하는 기타 도구)가 이 리포지터리에서 작업할 때 어떻게 동작할지를 구성하므로, 실수가 하나의 런타임 코드 경로에만 영향을 주지 않고 모든 기여자의 에이전트 세션에 영향을 줍니다. 정제된 원칙에는 소비자가 하나 더 있습니다. .gitlab/duo/mr-review-instructions.yaml 은 정제된 원칙에서 가져온 생성된 펜스를 담고 있으므로, 정제된 원칙을 변경하면 해당 원칙의 파일 필터와 일치하는 모든 머지 리퀘스트에 Duo가 게시하는 자동 리뷰 피드백도 함께 바뀝니다. 펜스 재생성은 정제 작업과 분리되어 있습니다. 정제된 원칙의 머지 리퀘스트는 .ai/principles/distilled/*.md 파일만 업데이트합니다. 머지된 후에는 별도의 CI/CD 잡이 머지된 master 의 정제된 파일에서 순수 투영 방식으로 펜스를 조정하고(각 파일의 distilled_at_sha 와 source_checksum 프런트 매터를 복사하며 정제를 다시 실행하지 않습니다), 자체 머지 리퀘스트를 엽니다. 이렇게 하면 팀의 정제 머지 리퀘스트와 펜스 업데이트를 독립적으로 머지할 수 있으므로, 어느 쪽도 상대방이 CI를 통과하기를 기다리지 않습니다. .ai/ 파일을 변경하려면 AI 하네스 직접 책임자(DRI)의 승인이 필요합니다. 이 규칙은 .gitlab/CODEOWNERS 의 "Monolith AI harness files" 블록에 반영되어 있습니다. 이 파일들은 광범위한 * 규칙의 승인은 필요하지 않지만, 각각 지정된 DRI의 승인이 필요합니다. 리뷰 규칙은 작업 항목 20880 에서 추적합니다. 정제된 원칙 파일에는 승인 경로가 한 단계 더 있습니다. 각 파일은 단일 진실 공급원(Single Source Of Truth, SSOT) 문서를 소유한 팀도 소유하므로, 정제 변경은 해당 도메인 팀이 승인합니다. 자동 생성된 동기화 머지 리퀘스트 리뷰 를 참조합니다. .ai/ 파일의 구성 # .ai/ 디렉터리에는 네 가지 범주의 파일이 있으며, 범주마다 리뷰 방식이 다릅니다. 직접 작성한 모듈: .ai/README.md , .ai/ci-cd.md , .ai/git.md , .ai/merge-requests.md , .ai/code-review.md 입니다. 사람이 작성한 지침 문장이며, 리포지터리 루트의 AGENTS.md 에서 참조합니다. 정제된 원칙: .ai/principles/distilled/*.md 입니다. AI 원칙 정제기 가 docs.gitlab.com 의 SSOT 문서에서 자동 생성합니다. 이 파일은 직접 편집하면 안 됩니다. 베이스라인: .ai/principles/baselines/*.md 입니다. 아직 docs.gitlab.com 에서 다루지 않아 직접