# spec-reviewer

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.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 155 repo stars
- Author: serpro69
- License: Elastic-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/agents/spec-reviewer.md
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/spec-reviewer

## What it 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.

## Install

### Claude Code (native platform)

1. **Plugin marketplace**
In the agent chat (not a shell):
```text
/plugin marketplace add serpro69/claude-toolbox
```
In the agent chat (not a shell):
```text
/plugin install kk@claude-toolbox
```

2. **Manually: put the files in place**
- File: `.claude/agents/spec-reviewer.md` — For all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention

### Codex

**Manually: put the files in place**
- File: `.codex/agents/spec-reviewer.toml` — Codex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/

### Cursor

**Manually: put the files in place**
- File: `.cursor/agents/spec-reviewer.md` — Cursor also reads .claude/agents/

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/serpro69/claude-toolbox/tree/HEAD/klaude-plugin/agents/spec-reviewer.md

## When to use it
- 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
- 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.

## Similar
- [gjalla-spec-review](https://affpapa.org/en/nevibecode/skills/gjalla-spec-review.md) — skill · 902 installs
- [dual-axis-skill-reviewer](https://affpapa.org/en/nevibecode/skills/dual-axis-skill-reviewer.md) — skill · 3600 installs
- [skill-reviewer](https://affpapa.org/en/nevibecode/skills/skill-reviewer.md) — skill · 1500 installs
- [critical-code-reviewer](https://affpapa.org/en/nevibecode/skills/critical-code-reviewer.md) — skill · 1100 installs
- [code-reviewer](https://affpapa.org/en/nevibecode/agents/anthropic-code-reviewer.md) — subagent · 31050 installs
- [surgeon-reviewer](https://affpapa.org/en/nevibecode/agents/surgeon-reviewer.md) — subagent · ★ 26718 repo stars

From the same set: [serpro69/claude-toolbox](https://affpapa.org/en/nevibecode/by/serpro69/claude-toolbox.md) — 30 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
