guide-reviewer — Claude Code subagent: what it does, how to install
guide-reviewer audits technical documentation drafts for factual errors, marketing buzzwords, and AI phrasing patterns before committing.
CC-BY-SA-4.0 ★ 6,529 updated 2026-10-22
.claude/agents/guide-reviewer.mdWhat guide-reviewer 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.
What it helps with
- 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 for the agent
- 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]
How to install guide-reviewer
Manually: put the files in place
.claude/agents/guide-reviewer.mdFor all projects use ~/.claude/agents/. Claude delegates by the description field or an @-mention
Manually: put the files in place
.codex/agents/guide-reviewer.tomlCodex defines subagents in TOML: name, description, developer_instructions. Move the Markdown text into developer_instructions by hand. For all projects use ~/.codex/agents/
Manually: put the files in place
.cursor/agents/guide-reviewer.mdCursor also reads .claude/agents/
Step by step, with commands for each platform: Claude Code subagents: how to create one, call it and keep context clean
Questions about guide-reviewer
How to install guide-reviewer in Claude Code?
Place the subagent definition file into your project repository at .claude/agents/guide-reviewer.md.
What does guide-reviewer do?
It reviews draft technical documentation for factual mistakes, marketing claims, and artificial writing habits, returning grouped findings with line references.
Which tools and model does guide-reviewer require?
It runs on the haiku model using Read, Grep, Glob, and two dedicated MCP endpoints: mcp__claude-code-guide__search_guide and mcp__claude-code-guide__read_section.