cyberneticlibrary

Generate project health report with metrics

reportcommandsetup L21,676
rohitg00/awesome-claude-code-toolkit
What it does

Generate project health report with metrics

Best for

Tech leads and engineering managers running quarterly health reviews who want a one-page snapshot of code quality, velocity, and dependency health.

Inputs
  • · Git history (commits, contributors, dates)
  • · Test results (pass/fail, coverage if available)
  • · Dependency inventory (count, outdated, vulnerable)
Outputs
  • · Project Health Report with score (A-F)
  • · Code metrics (LOC, test ratio, file health)
  • · Top 2-3 issues ranked by impact
Requires
  • · Git
  • · Test runner (optional)
  • · Dependency checker (npm audit, pip audit)
Preconditions
  • · Git repository initialized
  • · Dependency manifests present
Failure modes
  • · Test coverage estimate is approximate if coverage tool absent
  • · TODO/FIXME counts are superficial (not rooted in impact analysis)
  • · Does not compare against project-specific benchmarks (only industry defaults)
Trust signals
  • · Seven metrics dimensions (code, tests, dependencies, activity, documentation, assessment)
  • · git shortlog and git log commands automated
  • · Compares against industry benchmarks
  • · Highlights trends (improving/declining) over last 30 days
  • · Output under 100 lines for quick consumption
  • · Test-to-code ratio and TODO/FIXME comment density included