| name | agent-context-audit |
| description | Codex instruction 구조의 밀도와 건강도를 감사합니다. AGENTS.md 길이, 계층 깊이, 중복 규칙, 커버리지 부족을 찾을 때 사용합니다. |
Agent Context Audit
원본 ctx-audit의 Codex 버전입니다. 목표는 instruction 체계를 더 짧고, 더 가까이, 더 명확하게 유지하는 것입니다.
When to use
AGENTS.md 계층이 커지며 instruction 부채를 점검할 때- 루트 문서 비대화, 규칙 중복, 커버리지 빈 구역을 찾고 싶을 때
agent-context-init 또는 agent-context-guide 이후 구조 건강도를 진단할 때
Do not use when
- 새 instruction 파일을 실제로 생성·정리해야 하는 작업 →
agent-context-init
- 계층 설계안을 먼저 제안해야 하는 작업 →
agent-context-guide
- 링크·명령·문서 주장 사실 여부를 결정적으로 검증하는 작업 →
agent-context-verify
Quick start
- 빠르면
scripts/check_agents_md.sh [target]로 표면 신호를 본다.
- instruction tree와 루트/하위 책임을 수집한다.
- 중복·장문·커버리지 공백을
critical / warning / info / strength로 정리한다.
Optional quick check
빠른 점검이 필요하면 scripts/check_agents_md.sh [target]를 먼저 실행한다.
Audit dimensions
- 루트
AGENTS.md가 과하게 비대한지
- 하위
AGENTS.md 깊이가 불필요하게 깊은지
- 동일 규칙과 명령이 여러 문서에 복제되는지
- 중요한 서브시스템에 가까운 instruction이 빠져 있는지
Workflow
- instruction 파일 트리를 수집한다.
- 루트 문서와 하위 문서의 책임 분리를 평가한다.
- 중복·장문·휘발성 정보를 찾아 외부 문서 분리 지점을 제안한다.
- 커버리지 빈 구역이 있으면 하위
AGENTS.md 또는 CONTEXT.md 추가를 권한다.
- 결과를 우선순위순 개선안으로 정리한다.
Review Harness
- mode: none
- 공통 기준:
../../../docs/review-harness.md
- generator: 상위 스킬이나 사용자가 제공한 instruction 구조
- evaluator: 이 스킬 자체가 evaluator-native audit 역할을 수행한다
- 평가축: instruction 밀도, 책임 분리, 중복 규칙, 커버리지 공백
- artifacts/evidence: instruction tree, 책임 분리 근거, 중복 규칙, 커버리지 공백
- pass condition:
critical / warning / info 분류와 구체적 분리 제안이 남아야 한다
- 자동 다음 행동:
warning이면 분리/정리 제안, critical이면 상위 스킬에 구조 재설계 또는 agent-context-init 실행을 권한다
Output expectation
- 현재 구조의 장점
- 위험 신호 (
critical / warning / info)
- 우선순위별 분리/정리 제안
