spec-reviewer — Claude Code subagent for spec checks and setup
The spec-reviewer subagent checks code against design documents to find missing work, mismatches, and conflicting or unclear docs. Use it for an independent implementation review.
Elastic-2.0 ★ 155 updated 2026-10-29
/plugin marketplace add serpro69/claude-toolbox
/plugin install kk@claude-toolboxWhat spec-reviewer does
spec-reviewer compares completed tasks with the requirements in design documents. It can report missing or extra implementation, differences from the spec, outdated documentation, and unclear requirements. Each finding receives a category, severity level, and confidence score with reasoning.
It uses Read, Grep, and Glob to inspect repository files, plus capy_search for project context. The reviewer does not see the implementation session’s conversation or debugging history, which keeps that account out of its assessment. Load the feature documents and any applicable checklists before verification; during a mid-implementation review, unfinished tasks are out of scope.
What it helps with
- compare completed tasks with design documents
- find requirements missing from the code
- spot implementation changes that conflict with the spec
- catch outdated or contradictory documentation
- classify findings and explain confidence
Example prompts for the agent
- Compare the completed work with
design.mdandimplementation.mdusingspec-reviewer. - Review the implementation against its requirements and flag missing or extra changes.
- Check whether the code follows the design docs, and explain each discrepancy.
How to install spec-reviewer
1Plugin marketplace
/plugin marketplace add serpro69/claude-toolbox/plugin install kk@claude-toolbox2Manually: put the files in place
.claude/agents/spec-reviewer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/spec-reviewer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/spec-reviewer.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about spec-reviewer
How do I install spec-reviewer in Claude Code?
Run /plugin marketplace add serpro69/claude-toolbox, then /plugin install kk@claude-toolbox. The agent file is .claude/agents/spec-reviewer.md.
What does spec-reviewer do?
It checks implementation against design documents and reports missing or extra work, spec deviations, and documentation problems. Findings are categorized and assigned a severity level.
Which tools does spec-reviewer use?
It reads repository files with Read, Grep, and Glob, and can query project context through capy_search. Feature documents and applicable checklists should be loaded before code verification.