| name | agent-context-verify |
| description | AGENTS.md 기반 instruction 구조의 정합성을 검증합니다. 링크 무결성, 코드/명령 참조, 문서 주장 정확성을 점검할 때 사용합니다. |
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
- 대상 instruction 문서와 연결된
docs/, CONTEXT.md를 모은다.
- 링크 무결성 → 명령/경로 → 내용 정확성 순으로 검증한다.
- 결과를
critical / warning / info / strength로 정리한다.
Use references
../agent-context-guide/references/verification-guide.md../../../docs/evaluator-output-contract.mdscripts/verify_agent_context.pyschemas/report.schema.json
Verification stages
- Reference integrity
AGENTS.md, AGENTS.override.md, CONTEXT.md, docs/ 링크가 실제로 존재하는지 확인한다.
- Code and command validation
- 문서에 적힌 파일 경로, 실행 명령, 테스트 명령이 현재 저장소와 맞는지 확인한다.
- Content accuracy
- 아키텍처 설명, 사용 라이브러리, 금지사항이 코드와 충돌하지 않는지 확인한다.
Workflow
- instruction 문서 전체를 수집한다.
- 상위/하위 문서가 어떤 범위를 담당하는지 매핑한다.
- 위 3단계를 순서대로 실행한다.
- 결과를
critical / warning / info / strength로 정리한다.
- 필요 시
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
