# guide-reviewer

guide-reviewer audits technical documentation drafts for factual errors, marketing buzzwords, and AI phrasing patterns before committing.

- subagent · `type=agent` · Claude Code, Codex, Cursor · ★ 6529 repo stars
- Author: FlorianBruniaux
- License: CC-BY-SA-4.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/agents/guide-reviewer.md
- Updated: 2026-10-22
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/agents/guide-reviewer

## What it does

This subagent inspects additions to documentation files, categorizing issues into distinct groups. It flags unverified claims, hallucinated API signatures, missing sources, and broken line references to keep the guide accurate.

Beyond factual checks, the agent enforces a strict technical tone. It flags empty superlatives, catches em dashes, spots staccato rhythms of three short sentences in a row, and removes slogan-like endings.

Execution relies on the `haiku` model, standard file inspection utilities like `Read` and `Grep`, and project-specific MCP guide tools. Instead of rewriting the entire passage, the agent returns exact line numbers with specific text replacements.

## Install

### Claude Code (native platform)

**Manually: put the files in place**
- File: `.claude/agents/guide-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/guide-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/guide-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/FlorianBruniaux/claude-code-ultimate-guide/tree/HEAD/.claude/agents/guide-reviewer.md

## When to use it
- catch unverified performance claims and fake API names in docs
- remove marketing buzzwords and unsupported superlatives before committing
- locate forbidden em dashes and robotic staccato sentence patterns
- get line-by-line editorial suggestions without altering the whole document

## Example prompts
- Review this section of the guide before commit
- Audit this new addition for factual accuracy and style
- Check the following guide text before I commit: [insert text]

## Similar
- [code-reviewer-pro](https://affpapa.org/en/nevibecode/agents/code-reviewer-pro.md) — subagent · ★ 1357 repo stars
- [technical-writing](https://affpapa.org/en/nevibecode/skills/backnotprop-technical-writing.md) — skill · 10700 installs
- [docs-review](https://affpapa.org/en/nevibecode/skills/docs-review.md) — skill · 2000 installs
- [technical-documentation](https://affpapa.org/en/nevibecode/skills/technical-documentation.md) — skill · 1900 installs
- [markdown-style](https://affpapa.org/en/nevibecode/skills/markdown-style.md) — skill · 125 installs
- [verify-docs-findable](https://affpapa.org/en/nevibecode/skills/verify-docs-findable.md) — skill · 340 installs

From the same set: [florianbruniaux/claude-code-ultimate-guide](https://affpapa.org/en/nevibecode/by/florianbruniaux/claude-code-ultimate-guide.md) — 45 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
