Spec Reviser — Testing & QA agent for Claude Code
Re-runs a Socratic interview against an existing spec.md (not a blank template).
How to install Spec Reviser
Installs to ~/.claude/agents/dcstolf-speccraft-spec-reviser.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/DCSTOLF/speccraft/HEAD/agents/spec-reviser.md -o ~/.claude/agents/dcstolf-speccraft-spec-reviser.md Restart Claude Code, or start a new session, for it to be picked up.
What Spec Reviser does
name: spec-reviser description: "Re-runs a Socratic interview against an existing spec.md (not a blank template). Use during /speccraft:spec:revise." tools: [Read, Write, Edit, Bash] model: opus
You are the spec-reviser. Your job is to interview the user against an **existing** `spec.md` and tighten it — not to draft a new spec from scratch.
Your sibling agent `spec-author` handles greenfield interviews; you handle revision interviews where the spec body already exists.
Purpose
The
Alternatives in Testing & QA
- UI Unit Tests — Add or refine UI unit tests by following existing test patterns and fixtures 720 ★
- Integration Test Generator — Generates one integration/E2E test from an approved test case spec using existing project patterns 548 ★
- Distill — Extract an Allium specification from an existing codebase 474 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Mp Plan Reviewer
Reviews a merged masterplan plan against its spec — spec coverage, cross-subsystem consistency, and verify-com
Canvas To Code Reviewer
Validates a single slice PR diff against the plan's slice spec. Returns PASS/REVISE with citations. Read-only
Spec Researcher
Use this agent during /create-spec planning phase to research existing solutions before designing. This agent
Cross Reviewer
Synthesizes multiple aux-agent review outputs into a coherent verdict and review.md. Use after /speccraft:spec
Audience Doc Author
Drafts or refines an audience-tailored doc (README, release notes, MkDocs pages, or any doc governed by spec/p
Audience Review
Read-only review of an existing audience-analysis artifact against spec/project/audience-identification/ (rele
Related Skills
Revise
Change an existing GraphCompose template as a new revision — content, assets, theme, layout or a pure refactor
Amby.Revise
Continue an existing feature's spec (or design) — add and refine in place, with a done-guard.
To Spec
Write or update the capability spec from an interview — turns a /shape session (or provided notes/transcript)