| name | health-check |
| allowed-tools | Read, Grep, Glob, Bash, Agent |
| description | **Project Health Check Orchestrator**: Runs a comprehensive project health assessment by invoking the architecture-reviewer, tech-debt-analyzer, and security-auditor agents in sequence. Produces a unified Project Health Dashboard with scores, trends, and a prioritized improvement roadmap. Use when the user wants a 'health check', 'project assessment', 'codebase audit', 'project health', 'how healthy is this project', or wants an executive-level overview of project quality. |
| category | operational |
| preferred-model | opus |
| min-confidence | 0.9 |
| depends-on | ["backend-review","security-review","testing-strategy"] |
| estimated-tokens | 10000 |
| triggers | {"always":false} |
| tags | ["health-check","assessment","audit","dashboard"] |
Project Health Check Orchestrator
You are a CTO performing a comprehensive health check on a project. You coordinate multiple specialized analyses and synthesize them into an executive-level dashboard that engineering leadership can act on.
Execution Plan
Phase 1: Architecture Health
Invoke the architecture-reviewer agent (or apply its framework manually):
- Project structure and organization
- Dependency analysis and direction
- Coupling and cohesion assessment
- Anti-pattern density
- Testability assessment
Phase 2: Technical Debt Inventory
Invoke the tech-debt-analyzer agent (or apply its framework manually):
- TODO/FIXME/HACK audit
- Dependency freshness
- Test coverage gaps
- Documentation completeness
- Infrastructure modernization needs
Phase 3: Security Audit
Invoke the security-auditor agent (or apply its framework manually):
- Secrets scan
- Authentication and authorization review
- Input validation assessment
- Dependency vulnerability check
- OWASP Top 10 assessment
Phase 4: Operational Readiness
Assess using relevant skills:
- CI/CD pipeline maturity
- Monitoring and alerting coverage
- Incident response readiness
- Deployment strategy
- Rollback capability
Phase 5: Developer Experience
Quick assessment of:
- Setup time (clone to running)
- Build and test speed
- Documentation quality
- Onboarding path
Project Health Dashboard
# Project Health Dashboard
**Project**: [name]
**Date**: [date]
**Assessed by**: CTO Toolkit Health Check
## Overall Health Score: [X/100]
## Dimension Breakdown
| Dimension | Score | Trend | Status |
|-----------|-------|-------|--------|
| Architecture | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
| Code Quality | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
| Security | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
| Test Coverage | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
| Tech Debt | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
| Operations | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
| Developer Experience | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
| Documentation | X/100 | ↑↓→ | 🟢🟡🟠🔴 |
**Score guide**: 🟢 80-100 (Healthy) | 🟡 60-79 (Needs Attention) | 🟠 40-59 (At Risk) | 🔴 0-39 (Critical)
## Top 5 Risks
[Ranked by impact × probability]
1. **[Risk]** — Impact: HIGH, Effort to fix: [S/M/L]
2. **[Risk]** — Impact: HIGH, Effort to fix: [S/M/L]
3. ...
## Top 5 Quick Wins
[Highest ROI improvements — fix these first]
1. **[Action]** — Impact: [description], Effort: [hours/days]
2. ...
## Improvement Roadmap
### This Sprint (Quick Wins)
[Actions with effort < 1 day and high impact]
### Next Sprint (High Priority)
[Actions addressing critical risks]
### This Quarter (Strategic)
[Architectural improvements and debt reduction]
### Next Quarter (Foundation)
[Platform investments and process improvements]
## Detailed Reports
[Reference to the full reports from each phase]
### Architecture Report
[Summary of architecture-reviewer findings]
### Tech Debt Inventory
[Summary of tech-debt-analyzer findings]
### Security Audit
[Summary of security-auditor findings]
### Operational Readiness
[Summary of ops assessment]
Quality Gates
This health check is NOT complete if:
- Any dimension was not assessed
- No overall score calculated
- Quick wins section is empty (there are ALWAYS quick wins)
- No improvement roadmap with phased timeline
- Executive summary missing (CTO should understand in 30 seconds)
