AI 개발 원칙 매니페스트 참조

AI 개발 원칙 동기화에 사용되는 manifest.yml 파일의 최상위 키, Principle entry, Source entry, Auto-MR 설정 등 전체 구조와 유효성 검사 규칙을 설명합니다.

원칙 동기화는 .ai/principles/manifest.yml 을 읽어 생성할 원칙, 각 원칙이 파생된 소스 파일, 자동 생성된 머지 리퀘스트를 여는 방법을 결정합니다. 온보딩 플로에 대한 내용은 AI 개발 원칙 을 참조하세요. 최상위 키 # 키 타입 필수 여부 설명 auto_mr map 예 예약된 동기화에서 열리는 머지 리퀘스트 설정. principles map 예 원칙 슬러그에서 원칙 항목으로의 맵. Principle entry 참조. static_entries list 아니오 에이전트 컨텍스트 로딩 스킬에 포함되는 수동으로 관리되는 파일 목록. Principle entry # principles: 아래의 각 키는 슬러그입니다. 값은 다음 키를 가진 맵입니다: 키 타입 필수 여부 설명 description string 예 에이전트 라우팅 테이블에 사용되는 한 줄 요약. 대문자로 시작하며 마침표로 끝내지 않습니다. group string 예 라우팅 테이블에서 관련 원칙을 묶는 데 사용되는 그룹 라벨. 예: Database, Backend, Frontend. sources list of maps 예 원칙의 소스 문서 파일 목록. Source entry 참조. file_filters list of strings 아니오 원칙이 적용되는 리포지터리 경로를 식별하는 Glob 패턴. 동기화에서 이를 사용하여 드리프트 탐지 범위를 지정합니다. baseline string 아니오 수작업으로 관리되는 규칙이 포함된 파일 경로. 디스틸러는 baseline 콘텐츠를 원문 그대로 보존합니다. Baseline files 참조. prerequisite boolean 아니오 true일 경우, 라우팅 테이블은 이 원칙을 같은 그룹의 다른 모든 원칙에 대한 선행 조건으로 표시하고, 디스틸러는 해당 그룹 내 선행 조건이 아닌 모든 디스틸 파일에 참조 노트를 추가합니다. 기본값: false. owner_team string 아니오 소스 문서를 소유한 팀의 CODEOWNERS 핸들. 동기화는 이 값으로 원칙을 그룹화하고, 팀별로 머지 리퀘스트를 하나씩 열며, CODEOWNERS를 통해 이 팀으로 승인을 라우팅합니다. secondary_teams list of strings 아니오 소스 문서가 둘 이상의 팀에 걸쳐 있는 경우 추가되는 CODEOWNERS 핸들. 머지 리퀘스트가 이 그룹에 알림을 보내지 않도록 "Request a review from" 섹션에 인라인 코드로 표시됩니다. fallback_ping_team boolean 아니오 소스 문서 작성자가 사용자로 확인되지 않을 때의 대체 핑 동작. true(기본값)일 경우, 머지 리퀘스트 요약에서 owner_team 핸들을 멘션합니다. false일 경우, 실행할 때마다 대규모 그룹에 알림이 가지 않도록 멘션되지 않는 팀 슬러그를 사용합니다. team_slug string 아니오 팀별 브랜치와 머지 리퀘스트 제목에 사용되는 짧고 URL에 안전한 이름. 기본값은 owner_team의 마지막 경로 세그먼트입니다. 마지막 세