best-practices-audit

To audit a CLAUDE.md file, the best-practices-audit validates size, sections, and import usage against a configurable checklist. It identifies drift, enforces structure, and flags documentation issues for developer review.

To keep CLAUDE.md concise, this audit auto-excludes bloated or redundant sections and extracts long sections to separate docs/ files. This enforces length targets and maintains optimal documentation structure.

Yes, you can automatically fix structural issues in CLAUDE.md. The audit applies auto-fixes for structural problems during the ship phase and prepares notes for developer review of remaining flagged items.

The best way to enforce @import structure is using a configurable audit checklist that validates external docs and references. This ensures CLAUDE.md follows Anthropic best practices for import usage.

You should run a CLAUDE.md quality assurance audit during the ship phase and after any CLAUDE.md updates. This timing enforces documentation quality and catches structural drift as the project evolves.

Yes, the CLAUDE.md audit identifies potential hook candidates to improve agent behavior. This feature runs alongside structural checks to optimize conciseness and validate documentation quality.