Skip to main content
subagent CX Codex

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

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add serpro69/claude-toolbox
/plugin install kk@claude-toolbox
Open on GitHub

What 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.md and implementation.md using spec-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-toolbox

2Manually: put the files in place

.claude/agents/spec-reviewer.md

For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

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.

Similar subagents

All subagents for Code review and refactoring →

From the same set30

The whole set →
review-code review-code reviews active git changes through an experienced engineering perspective. Identifies SOLID flaws, architecture issues, and security vulnerabilities. CX Codex +1 ★ 155repo stars review-design review-design is a Claude Code skill that checks design documents before implementation begins. It runs after $kk:design and reviews all documents by default. CX Codex +1 ★ 155repo stars review-spec review-spec is a Claude Code skill that compares code with feature docs and reports mismatches in both directions. Run it mid-feature or after completion. CX Codex +1 ★ 155repo stars design-reviewer design-reviewer audits feature designs and implementation plans without conversational bias. Flags ambiguities, missing edge cases, and contradictions before implementation begins. CX Codex ★ 155repo stars eval-grader eval-grader — a grader for skill-eval assertions that returns PASS, FAIL or PARTIAL on each, with one line of evidence. Handy when a reviewer's write-up needs a verdict from something that did not produce it. CX Codex ★ 155repo stars code-reviewer code-reviewer is a Claude Code subagent that independently evaluates git diffs for SOLID principles, architectural flaws, and security risks. CX Codex ★ 155repo stars implement This skill guides planned work and standalone fixes through implementation, verification, and code review. It selects a workflow based on the request. CX Codex +1 ★ 155repo stars kk kk — a workflow plugin that carries an AI assistant from design through review, tests and docs, with a permission guard on the side. CX Codex ★ 155repo stars

Project sponsors

Companies that keep this analytics open