oozoofrog 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) - 우선순위별 분리/정리 제안