review-doclisted
Install: claude install-skill kohj1018/agentic-dev-harness
너의 역할은 입력 경로의 문서를 비판적으로 검토하는 것이다.
**Codex**: 본 skill은 wrapper 미보유(자연어 호출) — Codex에서는 "Follow `.claude/skills/review-doc/SKILL.md`"로 호출한다(목록 SSOT = README, ADR-010#amend-3·#amend-4).
입력:
- `$ARGUMENTS`에는 검토할 문서의 경로가 들어온다(예: `docs/10-charter/PROJECT_CHARTER.md`).
반드시 먼저 할 일:
1. 입력 경로의 문서를 읽는다.
2. 필요하면 관련 상위/하위 문서를 함께 읽어 맥락을 파악한다.
검토 항목:
- 누락된 요구사항
- 모순된 진술
- 모호하거나 검증 불가능한 표현
- 숨은 복잡도
- 빠진 엣지 케이스
- 본문 내용이 첫 줄의 모드 라벨(`> 모드: ...`)과 정합한지 점검.
- mismatch 발견 시 `docs/40-validation/IMPROVEMENT_GUIDE.md`에 **P1 severity**로 보고.
*아래 항목은 검토 대상 문서가 그 항목의 대상일 때만 적용한다* (review-doc 은 단일 문서 도구 — 예: AGENTS.md 검토 시 길이 점검 / boilerplate README 검토 시 표 점검 / `docs/00-meta/` 문서 검토 시 파일 수 점검. repo 전체 상시 감사는 `/stabilize-milestone` deterministic preflight 책임 — stabilize-milestone SKILL "review-doc 책임 분담" 단락 정합):
- AGENTS.md 길이 점검: 100줄 초과 시 IMPROVEMENT_GUIDE에 P0 severity로 보고. 80~100줄 사이는 P1.
- `docs/90-decisions/boilerplate/README.md`의 *Reserved / Parked / Dropped 번호* 표가 git log의 실제 누락 번호와 일치하는지 점검. 새 dropped 번호 발견 시 P2 보고.
- `docs/90-decisions/boilerplate/README.md` ADR 표의 *Amendments* 컬럼이 각 ADR 본문의 실제 `## Amendment N` 단락 — **코드펜스(```)·`<!-- -->` 주석 *밖의* 것만**(예시·주석 헤딩 제외) — 과 일치하는지 점검. 누락 발견 시 P1 보고.
- `docs/00-meta/` 파일 수가 ADR-012의 *6개* 원칙과 일치하는지 (`_templates/`는 카운트 제외). 위반 시 P0 보고.
- 검토 대상이 `## Surfaces` 블록을 가진 ADR이면, 등재된 각 surface 파일에 해당 `ADR-NNN` 역참조가 있는지 spot-check. 누락 시 P1 `[Surface-backref]` 보고 (ADR-045#d4).
- reviewer 위임 시 입력에 `review surface: doc` 를 명시한다 (reviewer.md 의 Document Consistency 차원