project-audit

A project health audit diagnoses CLAUDE.md quality, memory references, file structure, and Git hygiene to generate a severity-grouped report with actionable findings. It operates in read-only mode, surfacing precise file paths and a prioritized action plan without making automatic changes.

A quick project audit takes roughly five minutes, while a full audit takes about eight minutes and supports optional parallel agents for deeper analysis. Both modes auto-detect project type—Code, Product, Docs, or Mixed—to tailor checks and severity accordingly.

No, the project audit tool enforces strict read-only analysis and does not modify repository files during analysis. It only surfaces findings and recommendations, allowing user-approved actions exclusively to ensure safe and reproducible audits.

Yes, you can check memory system alignment in a documentation project because the tool auto-detects project types including Docs and Mixed. It specifically evaluates memory references and tailors severity checks to match the detected project context.

To get a structured action plan for fixing a messy file structure, run a full audit to evaluate file structure hygiene alongside CLAUDE.md and Git cleanliness. The audit outputs a prioritized, severity-grouped report with precise file paths for reproducible improvements.