By kojott
Audit and optimize CLAUDE.md hierarchies, .claude/rules, ecosystem files, and docs/ folders against Anthropic best practices and Boris Cherny guidelines. Detect redundancies, conflicts, anti-patterns, and receive targeted improvement suggestions to enhance Claude integration.
npx claudepluginhub joshuarweaver/cascade-code-general-misc-1 --plugin kojott-claude-docu-optimizerA Claude Code plugin for optimizing CLAUDE.md files and the docs/ documentation ecosystem following battle-tested patterns from Boris Cherny's team at Anthropic.
Analyzes and optimizes your project documentation to keep Claude Code's context efficient and your docs synchronized with code.
Key features:
| 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 |
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
claude plugin marketplace update claude-docu-optimizer
claude plugin update docu-optimizer@claude-docu-optimizer
/docu-optimizer analyze # Report issues
/docu-optimizer optimize # Full analysis + optimized version
/docu-optimizer apply # Directly update CLAUDE.md
/docu-optimizer compare # Before/after comparison
/docu-optimizer create # Generate new CLAUDE.md
/docu-optimizer sync # Check docs ↔ code sync
/docu-optimizer audit # Full documentation ecosystem audit
/docu-optimizer scaffold # Generate docs/ structure
| Metric | Value |
|---|---|
| Ideal CLAUDE.md size | ~2.5k tokens (~100-150 lines) |
| Maximum recommended | 4k tokens |
| Warning threshold | 5k+ tokens (causes context rot) |
MIT + Commons Clause - Free to use, modify, and share. Commercial selling requires author's approval. See LICENSE for details.
Complete developer workflow toolkit. Includes 34 reference skills, 34 specialized agents, and 21 slash commands covering TDD, debugging, code review, architecture, documentation, refactoring, security, testing, git workflows, API design, performance, UI/UX design, plugin development, and incident response. Full SDLC coverage with MCP integrations.
draw.io diagram creation, editing, and review. Use for .drawio XML editing, PNG conversion, layout adjustment, and AWS icon usage.
Upstash Context7 MCP server for up-to-date documentation lookup. Pull version-specific documentation and code examples directly from source repositories into your LLM context.
20 modular skills for idiomatic Go — each under 225 lines, backed by 48 reference files, 8 automation scripts (all with --json, --limit, --force), and 4 asset templates. Covers error handling, naming, testing, concurrency, interfaces, generics, documentation, logging, performance, and more. Activates automatically with progressive disclosure and conditional cross-references.
Connect to Atlassian products including Jira and Confluence. Search and create issues, access documentation, manage sprints, and integrate your development workflow with Atlassian's collaboration tools.
Search and retrieve relevant code documentation from multiple sources. Helps developers quickly access context for coding tasks.