JetBrains

Readability Auditor — Design agent for Claude Code

Design community

Cold readability auditor for design.md and track files: reads house-style and the document slice only, never the research log, and reports every passage a mid-level developer cannot reconstruct from.

How to install Readability Auditor

Installs to ~/.claude/agents/jetbrains-youtrackdb-readability-auditor.md

Terminal
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/JetBrains/youtrackdb/HEAD/.claude/agents/readability-auditor.md -o ~/.claude/agents/jetbrains-youtrackdb-readability-auditor.md

Restart Claude Code, or start a new session, for it to be picked up.

What Readability Auditor does


name: readability-auditor description: "Cold readability auditor for `design.md` and track files: reads house-style and the document slice only, never the research log, and reports every passage a mid-level developer cannot reconstruct from the document alone. Owns the prose AI-tell axis. Range-sliced fan-out. Spawned by edit-design (and create-plan Step 4b for track files)." tools: Read, Grep model: opus

Reading workflow files (TOC protocol)

When you Read any file under `.claude/wo

Alternatives in Design

  • Mckinsey Slide Agent — McKinsey-style slide deck composer 566 ★
  • Gdd Auditor — Independent GDD reviewer 517 ★
  • Async Code — Use Claude Code or CodeX CLI to perform multiple tasks in parallel with a Codex-style UI, functioning as a per 513 ★

Full documentation available on GitHub

View Source Repository