← ClaudeAtlas

spec-revisionlisted

Reviews a spec, round after round, until every scenario has a written answer.
biancoenrico/claude-skills · ★ 0 · Code & Development · score 65
Install: claude install-skill biancoenrico/claude-skills
# spec-revision Review a technical specification, round after round, until it can be implemented without guessing: free of contradictions, ambiguities, and gaps that would force an implementer to invent an answer. You orchestrate; `dev-loop:reviewer` agents judge, one per group, against the criteria file this skill owns. The writing happens here, on the main thread. ## 1 — What you are given Priority order: an explicit path, the last spec-shaped file discussed, or text pasted inline. If none, ask the user rather than invent the content. This skill checks **what has to be built**; **how it gets built** is `/dev-loop:plan-revision`. ## 2 — Frame the document Before criticising, understand the **type** (API, feature, architecture, functional requirements), the **project context** (stack, domain, constraints) and the **current structure** (sections, format, detail level). This framing matters because the same sentence weighs differently by type: "fast" is a tolerable ambiguity in a vision note and a blocker in an API spec with latency requirements. **If the document builds inside an existing project, open it, read its conventions, and keep Grep on the shared helpers.** If the code is out of reach, **say so in the report**: that part stays uncovered, approved knowing it rather than believing it done. ## 3 — Cut into groups A document too large for one sitting is reviewed group by group — the signal, the cut, and what each group is entitled to are held by `${CLAUDE_PLUGI