# reviewer

A reviewer persona for Claude that reads a change like a senior engineer: behaviour, security holes, slow paths, standards, docs. You get a summary with critical issues.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 850 repo stars
- Author: ruvnet
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/ruvnet/agentic-flow/tree/HEAD/agentic-flow/.claude/agents/core/reviewer.md
- Updated: 2026-10-26
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/ruvnet-reviewer

## What it does

The agent takes the role of a senior reviewer and goes over a change on five fronts: what the code actually does, where it can be attacked, what will be slow, how it sits with the project's conventions, and whether the docs keep up. The file ships worked examples of the usual offenders — a raw `userId` interpolated into SQL, a password written to the log, a loop that fires one query per user, a class holding four unrelated jobs.

Two hooks bracket the run. Ahead of the review it pulls similar past reviews from `claude-flow` memory, including cases where problems slipped through, and writes a five-point checklist. Afterwards it saves a scored record of the outcome and, when nothing critical surfaced and more than 10 issues were found, starts a pattern training pass with `npx claude-flow neural train`.

Both hooks shell out to `npx claude-flow`. On a machine without that CLI the memory lookups and the training step never happen; you are left with the written checklist and whatever the model can do from the agent file alone.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/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/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/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/ruvnet/agentic-flow/tree/HEAD/agentic-flow/.claude/agents/core/reviewer.md

## When to use it
- catch an SQL injection in the payment handler
- drop the N+1 when loading users with their posts
- check whether one class is doing persistence, email and reports at once
- produce a review summary with critical issues and strengths
- match the API docs against what the code really does

## Example prompts
- Review `src/api/payments.ts` for amount validation and unsafe database queries.
- Walk this pull request and point out slow paths like N+1 lookups.
- Write up a review of the `orders` module with critical issues first.

## Similar
- [ns-reviewer](https://affpapa.org/en/nevibecode/skills/ns-reviewer.md) — skill · 140 installs
- [qa-reviewer](https://affpapa.org/en/nevibecode/agents/qa-reviewer.md) — subagent · ★ 1472 repo stars
- [code-reviewer](https://affpapa.org/en/nevibecode/agents/code-reviewer.md) — subagent · 31050 installs
- [gem-reviewer](https://affpapa.org/en/nevibecode/agents/gem-reviewer.md) — subagent · ★ 41430 repo stars
- [code-documentation-code-reviewer](https://affpapa.org/en/nevibecode/agents/code-documentation-code-reviewer.md) — subagent · ★ 42780 repo stars
- [gsd-code-reviewer](https://affpapa.org/en/nevibecode/agents/gsd-code-reviewer.md) — subagent · ★ 3785 repo stars

## Other versions with the same name
- [reviewer · voltagent](https://affpapa.org/en/nevibecode/agents/voltagent-reviewer.md) — ★ 6505 repo stars
- [reviewer · rohitg00](https://affpapa.org/en/nevibecode/agents/reviewer.md) — ★ 2966 repo stars
- [reviewer · mralexivy](https://affpapa.org/en/nevibecode/agents/mralexivy-reviewer.md) — ★ 80 repo stars

From the same set: [ruvnet/agentic-flow](https://affpapa.org/en/nevibecode/by/ruvnet/agentic-flow.md) — 76 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
