# Agent Context Audit

> Codex instruction 구조의 밀도와 건강도를 감사합니다. AGENTS.md 길이, 계층 깊이, 중복 규칙, 커버리지 부족을 찾을 때 사용합니다.

- Skill: `oozoofrog/agent-context-audit-2` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add oozoofrog/agent-context-audit-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oozoofrog/agent-context-audit-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: oozoofrog (https://skillmd.com/u/oozoofrog)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/oozoofrog/agent-context-audit-2

---


# 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
1. 빠르면 `scripts/check_agents_md.sh [target]`로 표면 신호를 본다.
2. instruction tree와 루트/하위 책임을 수집한다.
3. 중복·장문·커버리지 공백을 `critical / warning / info / strength`로 정리한다.

## Optional quick check
빠른 점검이 필요하면 `scripts/check_agents_md.sh [target]`를 먼저 실행한다.

## Audit dimensions
- 루트 `AGENTS.md`가 과하게 비대한지
- 하위 `AGENTS.md` 깊이가 불필요하게 깊은지
- 동일 규칙과 명령이 여러 문서에 복제되는지
- 중요한 서브시스템에 가까운 instruction이 빠져 있는지

## Workflow
1. instruction 파일 트리를 수집한다.
2. 루트 문서와 하위 문서의 책임 분리를 평가한다.
3. 중복·장문·휘발성 정보를 찾아 외부 문서 분리 지점을 제안한다.
4. 커버리지 빈 구역이 있으면 하위 `AGENTS.md` 또는 `CONTEXT.md` 추가를 권한다.
5. 결과를 우선순위순 개선안으로 정리한다.

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