AGENTS.md 초기화
저장소 루트 또는 기존 디렉토리에 기여자 가이드를 생성합니다. 출력 형식과 권장 섹션의 유일한 출처는 references/agents-md-prompt.md입니다. 이 스킬은 이 고정된 지침을 올바른 범위에 안전하게 적용하는 역할을 합니다.
입력 및 범위
- 0개 또는 하나의 디렉토리 인수를 받으며, 상대 경로는 현재 작업 디렉토리를 기준으로 해석됩니다. 인수가 없으면
git rev-parse --show-toplevel로 찾은 Git 루트를 사용합니다. - 명시적 디렉토리는 Git 저장소에 속하지 않을 수 있습니다. 인수가 없고 Git 루트를 찾을 수 없으면 사용자에게 디렉토리를 지정하도록 요청하고 중단합니다. 경로는 읽기 가능한 디렉토리여야 하며, 누락된 경로, 파일, 읽기 불가능한 디렉토리 또는 여러 디렉토리 인수는 중단합니다.
- 기본 후보 출력은 해당 디렉토리의
AGENTS.md입니다. 한 번에 하나의 범위만 처리하며, 디렉토리를 생성하지 않고, 다른 파일을 수정하지 않으며, 스테이징, 커밋 또는 브랜치를 생성하지 않습니다. - 본문은 로컬 문서의 기본 언어를 따릅니다. 신호가 불충분하면 영어를 사용합니다. 선택된 디렉토리가 저장소 루트가 아닌 경우, 출력 시작 부분에
## Scope를 추가하여 상대 디렉토리와 적용되는 상위 가이드를 설명하고 로컬에서 새로 추가되거나 좁혀진 규칙만 작성합니다.
먼저 정찰, 그 다음 생성
- 초안을 작성하기 전에 대상 및 필요한 프로젝트 컨텍스트(디렉토리 구조, manifest/lockfile, 스크립트, 빌드/테스트/lint 설정, CI, README/CONTRIBUTING, Git 사용 시 최대 30개의 관련 커밋)를 읽습니다. 모노레포 패키지 경계, 패키지 관리자 및 로컬 문서의 기본 언어를 식별합니다.
- 모든 관련
AGENTS.md(대상 파일, 저장소 루트에서 대상 상위 디렉토리까지의 상위 파일, 대상 하위 트리의 중첩 파일)를 찾습니다. Git 디렉토리가 아닌 경우 상위 체인을 따라 확인합니다. 하위 트리는 먼저 직접 하위 디렉토리를 확인하고, manifest, 패키지 경계 또는 기존 가이드가 더 깊은 곳을 가리키는 경우에만 확장합니다..git, 종속성/vendor, 빌드/coverage 출력, 캐시 및 무시된 비밀 저장소는 건너뜁니다. - 일치 항목을
target,ancestor또는nested로 표시하고CLAUDE.md,CONTRIBUTING.md등의 관련 가이드를 제약 조건으로 읽습니다. 중첩 가이드는 읽고, 보존하고, 필요한 경우 링크만 제공합니다. 병합하거나 수정하지 않습니다. - 잠재적 비밀 파일의 이름과 메타데이터만 확인합니다. 키, 토큰, 자격 증명 또는
.env내용을 절대 읽거나 쓰지 않습니다. - 모든 명령과 규칙은 스크립트, 설정, 기존 파일 또는 기록으로 검증 가능해야 합니다. 관찰된 저장소 규칙과 일반적인 기본 권장 사항을 구분합니다. 증거가 없는 섹션, 명령 또는 어설션은 직접 생략합니다.
가이드 일치 확인
초안을 생성하기 전에 모든 일치 항목, 각각의 범위 및 후보 출력 경로를 표시하고 대소문자 충돌(예: agents.md)을 확인합니다. 이는 하드 장벽입니다:
- 후보 대상이 이미 존재하는 경우 읽고 사용자에게
merge,replace또는abort를 선택하도록 요청합니다. - 대상이 존재하지 않지만 상위 또는 중첩 가이드가 발견된 경우, 사용자에게 명시적으로 "해당 범위의 새 가이드 생성" 또는 "기존 명명된 가이드 업데이트"를 선택하도록 요청합니다. 자식 파일을 자동으로 추가하지 않습니다. 다른 기존 파일을 선택하면 해당 파일 디렉토리로 다시 정찰한 후 모드를 선택합니다.
- 일치 항목이 없으면 원래 대상에 대한 새 파일 초안을 계속 작성합니다.
- 선택된
AGENTS.md가 심볼릭 링크, 디렉토리, 특수 파일 또는 쓰기 불가능한 일반 파일인 경우 중단하고 이유를 보고합니다.
응답되지 않거나 모호한 선택, 또는 CLAUDE.md 등의 가이드와의 충돌은 작업 공간을 변경하지 않고 유지합니다.
고정 지침 읽기
초안 작성을 시작하기 전에 references/agents-md-prompt.md를 완전히 읽습니다. 이 파일은 제목, 문서 요구 사항, 권장 섹션, 단어 수 목표 및 표현 스타일의 정식 소유자입니다. 정상 작동 중에는 변경하지 않으며, 이 스킬 내에서 본문을 복사하지 마십시오.
병합, 미리보기 및 쓰기
merge는 Markdown 제목 의미론에 따라 병합합니다. 기존 사실과 사용자 정의 섹션을 유지하고 증거가 있는 누락된 내용만 보충합니다. 모든 명령, 경로, 우선 순위 또는 사실 충돌을 표로 만들어 사용자가 항목별로 기존 항목 유지, 증거 사용 또는 사용자 정의 텍스트 제공을 선택하도록 합니다. 미해결 충돌이 있는 경우 쓰지 않습니다. replace는 선택된 단일 파일에만 영향을 미치며 자동으로 백업을 생성하지 않습니다.
새 파일은 전체 초안을 표시합니다. 업데이트는 통합 diff(unified diff)를 표시하고 경로, 범위, 섹션, 단어 수, 증거 격차 및 모드 요약을 함께 제공합니다. 사용자가 최종 쓰기를 명시적으로 확인하기 전까지 파일을 생성하거나 수정하지 않습니다. 수정을 요청하면 초안 및 미리보기 단계로 돌아갑니다. 쓰기 전에 대상을 다시 읽고 내용이 외부에서 변경된 경우 확인 프로세스를 다시 시작합니다.
검증 및 완료
쓰기 전에 제목, 제목 계층, 중첩 가이드의 범위 링크, 참조된 경로/스크립트, 플레이스홀더, 민감한 값 및 Markdown 공백을 확인합니다. 루트 가이드는 고정 지침의 단어 수 목표에 따라 검사하고, 중첩 증분은 약 100-300단어로 검사합니다. 후행 공백, 중복 빈 줄 등의 기계적 문제만 자동 수정하고 다시 미리봅니다. 의미론적 또는 사실적 문제는 사용자에게 결정을 맡깁니다. 대상이 Git에 있는 경우 git diff --check를 실행하고, 그렇지 않은 경우 동등한 공백 검사를 수행합니다. 이 스킬을 위해 전체 빌드, 테스트 또는 린트를 기본 실행하지 마십시오.
완료 조건: 확인된 AGENTS.md가 선택된 경로에 존재하고, 정적 검사를 통과했으며, 승인된 미리보기와 일치합니다. 최종 보고서는 모드, 범위, 검증된 명령, 누락/불확실한 항목 및 검증 결과를 보고합니다. 사용자가 abort하거나 검증이 실패하면 이유를 보고하고 대상을 변경하지 않고 유지합니다.