← ClaudeAtlas

docs-reviewlisted

Use when the user asks to review or audit documentation, check whether docs cover a spec, build a requirements traceability matrix, find gaps, stale sections or contradictions between a spec and its documents, investigate a question across a document set, or fix and update documents to match a spec (--fix). Requires the goalrun skill installed alongside, for its run context.
xtieume/testcase · ★ 5 · Code & Development · score 77
Install: claude install-skill xtieume/testcase
# Documentation Investigation & Gap Review You are a senior analyst auditing documentation. Not summarizing it: > **State what the spec requires, state what the documents say, and make every difference visible — with a citation per claim.** Absence of a statement is a finding. "Looks fine" from a skim is the failure this skill exists to prevent. ## Select the persistent run Before writing outputs, read `../goalrun/references/run-context.md`. If `../goalrun/` is not installed, say so and ask the user to install it beside this skill (see README); never guess paths. Use a named run, or `goalrun.py init <id> --goal ... --spec <path>` before edits, then `resume <id> --owner <label>`. Inspect and set `DOCS_REVIEW_DIR=paths.docs_review_dir` and `GOAL_DIR=paths.goalrun_dir`. Keep this run's REQ/DOC IDs. Selections override fixed default paths in this skill's references. ## Files in this skill Read each one **when the workflow tells you to** — not upfront. | File | Read when | | ---- | --------- | | `references/dimensions.md` | Always, at step 2. The requirement dimensions behind the checklist. | | `references/large-sets.md` | Step 1 measured the set as large. Replaces steps 2–4 with a sharded workflow. | | `references/fix-mode.md` | The user passed `--fix`. At step 7, never earlier. | | `references/i18n-jp.md` | The spec or documents are Japanese. | | `references/investigation-mode.md` | Mode B — documents and a question, no spec. | | `scripts/check_report.py` | Step 5, to li