# design-reviewer

design-reviewer audits feature designs and implementation plans without conversational bias. Flags ambiguities, missing edge cases, and contradictions before implementation begins.

- 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/design-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/design-reviewer

## What it does

The subagent inspects feature documentation, including `design.md`, `implementation.md`, and `tasks.md`. It remains structurally isolated from the earlier planning discussion. Because it lacks access to meeting notes or discarded alternatives, it judges specifications solely on written text.

The review workflow enforces strict sequence. It first retrieves `design-review-criteria.md` alongside `verification-policy.md`. Document evaluation never starts before these rules load. The agent then scans the repo with Read, Grep, and Glob to confirm that referenced files actually exist. Background context comes from `capy_search` targeting `kk:arch-decisions` and `kk:review-findings`.

The subagent lacks shell execution rights, stopping immediately if review criteria files cannot be located instead of guessing rules. It groups issues into taxonomy codes like `INCOMPLETE` or `TECH_RISK`, assigning severities from P0 to P3 and confidence scores up to 10.

## 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/design-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/design-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/design-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/design-reviewer.md

## When to use it
- spot conflicting requirements across design and task files
- detect missing error handling or omitted migration pathways
- verify that documented functions exist in current source code
- evaluate architectural readiness without relying on unwritten chat context

## Example prompts
- Review design.md and tasks.md for the new billing service
- Evaluate the storage migration implementation plan against repository patterns
- Inspect the feature specification and list any P0 or P1 architectural concerns

## Similar
- [writing-design-docs](https://affpapa.org/en/nevibecode/skills/writing-design-docs.md) — skill · 26900 installs
- [design-review-gate](https://affpapa.org/en/nevibecode/rules/design-review-gate.md) — rule · ★ 3774 repo stars
- [rfc-generator](https://affpapa.org/en/nevibecode/skills/rfc-generator.md) — skill · 294 installs
- [om-spec-writing](https://affpapa.org/en/nevibecode/skills/om-spec-writing.md) — skill · 3900 installs
- [oma-brainstorm](https://affpapa.org/en/nevibecode/skills/oma-brainstorm.md) — skill · ★ 1472 repo stars
- [design-docs](https://affpapa.org/en/nevibecode/skills/design-docs.md) — skill · ★ 539 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
