← ClaudeAtlas

review-doclisted

문서의 모호함, 누락, 모순, 숨은 복잡도를 비판적으로 검토할 때 사용한다.
kohj1018/agentic-dev-harness · ★ 2 · Code & Development · score 80
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 차원