oozoofrog/agent-context-verify

Agent Context Verify

원본 ctx-verify의 Codex 버전입니다. AGENTS.md 계층 구조와 보조 문서가 실제 저장소 상태와 맞는지 검사합니다.

When to use

• AGENTS.md 계층과 보조 문서가 실제 저장소 상태와 맞는지 검증할 때
• 링크 무결성, 실행 명령, 파일 경로, 문서 주장의 사실 여부를 점검할 때
• agent-context-init/guide 결과를 skeptical하게 확인할 때

Do not use when

• 새 instruction 구조를 설계하거나 생성해야 하는 작업 → agent-context-guide, agent-context-init
• 구조 건강도와 중복 부채를 감사하는 작업 → agent-context-audit
• 일반 코드 구현/디버깅처럼 instruction 문서가 주대상이 아닌 작업

Quick start

1. 대상 instruction 문서와 연결된 docs/, CONTEXT.md를 모은다.
2. 링크 무결성 → 명령/경로 → 내용 정확성 순으로 검증한다.
3. 결과를 critical / warning / info / strength로 정리한다.

Use references

• ../agent-context-guide/references/verification-guide.md
• ../../../docs/evaluator-output-contract.md
• scripts/verify_agent_context.py
• schemas/report.schema.json

Verification stages

1. Reference integrity
   • AGENTS.md, AGENTS.override.md, CONTEXT.md, docs/ 링크가 실제로 존재하는지 확인한다.
2. Code and command validation
   • 문서에 적힌 파일 경로, 실행 명령, 테스트 명령이 현재 저장소와 맞는지 확인한다.
3. Content accuracy
   • 아키텍처 설명, 사용 라이브러리, 금지사항이 코드와 충돌하지 않는지 확인한다.

Workflow

1. instruction 문서 전체를 수집한다.
2. 상위/하위 문서가 어떤 범위를 담당하는지 매핑한다.
3. 위 3단계를 순서대로 실행한다.
4. 결과를 critical / warning / info / strength로 정리한다.
5. 필요 시 context-validator custom agent 또는 일반 read-only subagent에 검증 일부를 위임한다.

가능하면 먼저 아래 deterministic script를 사용합니다.

python3 .agents/skills/agent-context-verify/scripts/verify_agent_context.py [target]

Review Harness

• mode: none
• 공통 기준: ../../../docs/review-harness.md
• generator: 상위 스킬이 만든 instruction 파일 및 링크
• evaluator: 이 스킬 자체가 evaluator-native verification 역할을 수행한다
• 평가축: 링크 무결성, 명령/파일 경로 정확성, 문서 주장과 저장소 상태 일치성
• artifacts/evidence: 링크 무결성, 파일 경로, 실행 명령, 코드와 문서 주장 일치 여부
• pass condition: 모든 critical 항목이 해소되거나 명시적으로 남아 있어야 한다
• 자동 다음 행동: pass면 종료, warning이면 수정 후보 제시, critical이면 해당 문서를 block 처리하고 상위 스킬에 재작성 요청

Output expectation

• # Agent Context Verification Report
• ## Summary
• ## Findings
  • critical / warning / info / strength
• ## Recommended fixes
• 필요 시 ## Machine summary