AGENTS.md 검토
판정은 agents-md의 테스트를 따릅니다: 값싼 피드백 두 번 이상을 통해 발견 및 수정되어야 하며, 어떤 스킬에도 명시되지 않았거나 항상 읽히는 파일에 포함되지 않은 지침을 대상으로 합니다.
확인 후 분류
주어진 파일을 검토하고 어떤 수정본인지 명시하십시오. 각 블록을 판단하기 전에 실제 상황과 대조하십시오; 판정당 하나의 증거면 충분합니다.
- 해당 블록을 소비하는 도구(변경 로그 생성기, 릴리스 도구, CI 워크플로우)에 대한 예제 및 형식: 잘못됨(Wrong). 도구의 구성을 읽는 것만으로 충분합니다; 잘못 렌더링될 내용은 실제로 잘못된 출력이 배포되었는지 여부와 관계없이 잘못된 것입니다.
- 트리 및 원격 기본 브랜치와 대조한 목록: 오래됨(Stale).
- 병합된 PR 기록과 대조한 주장된 규칙: 아무도 따르지 않고 유지보수 담당자가 아무도 결정하지 않았다고 확인한 경우 결코 규칙이 아님(Never a convention). 유지보수 담당자가 의도적으로 규칙을 도입하고 있을 수 있으며, 인간 커미터가 누가 결정했는지를 증명하지 않으므로, 유지보수 담당자가 판단하지 않은 따르지 않는 규칙은 인간 결정 목록에 추가됩니다.
- 설치된 스킬 및 항상 읽히는 파일과 대조한 규칙: 중복됨(Duplicated).
- 그 외 모든 것은 위 테스트에 따라: 발견 가능함(Discoverable), 내용 없음(Content-free) 또는 평범한 명령(Plain command).
- 긴 가이드를 가리키는 항상 로드되는 포인터: 잘못 배치됨(Misplaced); 해당 가이드는 그 가이드가 필요한 스킬에 속합니다.
하나의 블록은 각각 고유한 증거와 함께 여러 판정을 받을 수 있습니다; 사람의 확인이 필요 없는 판정을 우선으로 제시하여 유지보수 담당자의 응답을 기다리기 전에 정리 작업을 시작할 수 있도록 하십시오.
또한 누락된(Missing) 항목을 찾으십시오: 조직이 다른 곳에서 적용하는 정책(의도 파일 규칙, 작성 규칙, 주석 표시), 포인터가 없는 비표준 레이아웃, 그리고 형제 CLAUDE.md 심볼릭 링크가 없는 AGENTS.md.
agents-md/references/before-after.md는 하나의 저장소에서 작업된 답변입니다; 현재 저장소에 대해 모든 행을 다시 확인하고 절대 그대로 붙여넣지 마십시오.
보고서
| 블록 | 판정 | 증거 |
|---|---|---|
| `Issue: #456`, `Issue: N/A`를 유효한 바닥글로 사용 | 잘못됨, 결코 규칙이 아님 | `cliff.toml`은 모든 `Issue:` 값을 Jira 링크로 변환합니다; 유지보수 담당자는 둘 다 결정되지 않았다고 확인함 |
| 테스트는 라이브러리가 아닌 CLI 바이너리를 구동합니다; `testsuite/AGENTS.md` 참조 | 유지 | 라이브러리 수준의 테스트 스위트를 다시 작성하는 것은 한 번 이상의 피드백 라운드가 필요함; 어떤 스킬도 이를 명시하지 않음 |
그런 다음 완전히 정리된 파일을 제안하고, 어떤 내용이 스킬 또는 중첩된 AGENTS.md로 이동했는지, 그리고 어떤 내용이 인간의 결정이 필요한지 목록화하십시오.
요청하지 않는 한 변경 사항을 적용하지 마십시오.