Claude Docu Optimizer

claude-docu-optimizer

A Claude Code plugin for optimizing `CLAUDE.md` files and the `docs/` documentation ecosystem following battle-tested patterns from Boris Cherny's team at Anthropic.

What it does

Analyzes and optimizes your project documentation to keep Claude Code's context efficient and your docs synchronized with code.

**Key features:**

• Token analysis with target benchmarks (2.5k ideal, 4k max)
• 15 anti-pattern detection (context stuffing, stale docs, orphan files, code-doc drift, cache-hostile ordering...)
• Semantic sync analysis between code and documentation
• Project stage detection (INIT / ACTIVE / STABLE / MAINTENANCE)
• Documentation ecosystem mapping and link graph analysis

Modes

Mode	Description
analyze	Report issues only (default)
optimize	Full analysis + optimized version
apply	Directly update the file
compare	Before/after with token savings
create	Generate new CLAUDE.md from project structure
sync	Semantic check of docs ↔ code synchronization
audit	Complete audit of documentation ecosystem
scaffold	Generate docs/ structure for new project. scaffold security generates /.claude/claude-security-guidance.md for the `security-guidance` plugin
insights	Analyze friction patterns from git history; generate copy-paste-ready CLAUDE.md rules

Installation

Add the marketplace and install the plugin:

claude plugin marketplace add https://github.com/kojott/claude-docu-optimizer
claude plugin install docu-optimizer@claude-docu-optimizer

Updating

claude plugin marketplace update claude-docu-optimizer
claude plugin update docu-optimizer@claude-docu-optimizer

Usage

/docu-optimizer analyze     # Report issues
/docu-optimizer optimize    # Full analysis + optimized version
/docu-optimizer apply       #