What problem does it solve? It gives you an objective, repeatable assessment of a codebase's overall health — covering documentation, CI, testing, runnability, and dependency stability — without manual inspection of every config file. ## Core Features & Use Cases - Deterministic Scoring: Runs 12 checks across 5 dimensions (oss, robustness, scope, runnability, stability) producing a 0-100 score with confidence levels. - Prioritized Findings: Classifies issues as P0/P1/P2 and maps them to a status of Blocked, Needs Work, or Healthy with exit codes 2/1/0. - Actionable Next Steps: Suggests concrete remediation commands (e.g., /update-docs, /codex-test-gen) ranked by confidence. - Use Case: When onboarding to an unfamiliar repository, run the audit to instantly see that the README is minimal, no CI exists, and test coverage is at 5% — then follow the prioritized fix list. ## Quick Start Ask the AI to run a project health audit on the current repository and summarize the score, status, and top priority fixes.
