claude-md-review

To review CLAUDE.md documentation for staleness and redundancy, run an end-to-end audit that evaluates structure, flags broken file references, and detects duplicated statements, producing a 1-10 effectiveness rating with specific findings and a concrete restructure plan if the score is below 8.

AI-agent instruction files become bloated or unclear when critical enforcement details are missing, related topics are scattered, or guidance is duplicated. Reviewing documentation effectiveness helps identify these gaps and suggests removals to optimize concision.

To audit a pattern registry for broken references and missing enforcement details, run a staleness and coverage review. This process flags references to patterns that no longer exist and finds gaps between what the code enforces and what the documentation explains.

The best way to restructure project documentation when it gets a low effectiveness rating is to follow a concrete restructure plan. This plan is automatically generated when a documentation review scores below 8, providing specific steps to consolidate bloat and group scattered topics logically.

No, this documentation review process does not require any external dependencies or components. It operates independently to evaluate structure, redundancy, staleness, ordering, completeness, and bloat within your existing CLAUDE.md files.