Analyze overall project health and metrics
Comprehensive project health analysis covering code quality, dependencies, team metrics, and delivery performance. Generates actionable reports with health scores, trend analysis, and prioritized recommendations for engineering leaders.
/plugin marketplace add jmagly/ai-writing-guide/plugin install jmagly-sdlc-plugins-sdlc@jmagly/ai-writing-guideAnalyze overall project health and metrics
Health Check Initialization
Multi-Dimensional Analysis
# Code churn analysis
git log --format=format: --name-only --since="30 days ago" | sort | uniq -c | sort -rg
# Contributor activity
git shortlog -sn --since="30 days ago"
# Branch health
git for-each-ref --format='%(refname:short) %(committerdate:relative)' refs/heads/ | grep -E "(months|years) ago"
# File complexity (if cloc available)
cloc . --json --exclude-dir=node_modules,dist,build
# Test coverage trends
npm test -- --coverage --json
# Check for outdated dependencies
npm outdated --json
# Security vulnerabilities
npm audit --json
# License compliance
npx license-checker --json
1. Sprint velocity trends
2. Cycle time analysis
3. Blocked task duration
4. Backlog growth rate
5. Bug vs feature ratio
6. Task completion predictability
1. PR review turnaround time
2. Commit frequency distribution
3. Work distribution balance
4. On-call incident frequency
5. Documentation updates
# Project Health Report - [Project Name]
Generated: [Date]
## Executive Summary
Overall Health Score: [Score]/100 [🟢 Healthy | 🟡 Needs Attention | 🔴 Critical]
### Key Findings
- ✅ Strengths: [Top 3 positive indicators]
- ⚠️ Concerns: [Top 3 areas needing attention]
- 🚨 Critical Issues: [Immediate action items]
## Detailed Health Metrics
1. **Delivery Health** (Score: [X]/100)
| Metric | Current | Target | Status |
|--------|---------|--------|--------|
| Sprint Velocity | [X] pts | [Y] pts | 🟢 |
| On-time Delivery | [X]% | 90% | 🟡 |
| Cycle Time | [X] days | [Y] days | 🟢 |
| Defect Rate | [X]% | <5% | 🔴 |
2. **Code Quality** (Score: [X]/100)
| Metric | Current | Target | Status |
|--------|---------|--------|--------|
| Test Coverage | [X]% | 80% | 🟡 |
| Code Duplication | [X]% | <3% | 🟢 |
| Complexity Score | [X] | <10 | 🟡 |
| Security Issues | [X] | 0 | 🔴 |
3. **Technical Debt** (Score: [X]/100)
- 📊 Total Debt Items: [Count]
- 📈 Debt Growth Rate: [+/-X% per sprint]
- ⏱️ Estimated Debt Work: [X days]
- 💰 Debt Impact: [Description]
4. **Team Health** (Score: [X]/100)
| Metric | Current | Target | Status |
|--------|---------|--------|--------|
| PR Review Time | [X] hrs | <4 hrs | 🟢 |
| Knowledge Silos | [X] | 0 | 🟡 |
| Work Balance | [Score] | >0.8 | 🟢 |
| Burnout Risk | [Level] | Low | 🟡 |
5. **Dependency Health** (Score: [X]/100)
- 🔄 Outdated Dependencies: [X]/[Total]
- 🛡️ Security Vulnerabilities: [Critical: X, High: Y]
- 📜 License Issues: [Count]
- 🔗 External Service Health: [Status]
## Trend Analysis
### Velocity Trend (Last 6 Sprints)
Sprint 1: ████████████ 40 pts Sprint 2: ██████████████ 45 pts Sprint 3: ████████████████ 50 pts Sprint 4: ██████████████ 45 pts Sprint 5: ████████████ 38 pts Sprint 6: ██████████ 35 pts ⚠️ Declining
### Bug Discovery Rate
Week 1: ██ 2 bugs Week 2: ████ 4 bugs Week 3: ██████ 6 bugs ⚠️ Increasing Week 4: ████████ 8 bugs 🚨 Action needed
## Risk Assessment
### High Priority Risks
1. **Declining Velocity**
- Impact: High
- Likelihood: Confirmed
- Mitigation: Review sprint planning process
2. **Security Vulnerabilities**
- Impact: Critical
- Count: [X] high, [Y] medium
- Action: Immediate patching required
3. **Knowledge Concentration**
- Impact: Medium
- Bus Factor: 2
- Action: Implement pairing/documentation
## Actionable Recommendations
### Immediate Actions (This Week)
1. 🛡️ **Security**: Update [package] to fix critical vulnerability
2. 🐛 **Quality**: Address top 3 bug-prone modules
3. 👥 **Team**: Schedule knowledge transfer for [critical component]
### Short-term Improvements (This Sprint)
1. 📈 **Velocity**: Reduce scope to sustainable level
2. 🧪 **Testing**: Increase coverage in [module] to 80%
3. 📚 **Documentation**: Update outdated docs for [feature]
### Long-term Initiatives (This Quarter)
1. 🏗️ **Architecture**: Refactor [component] to reduce complexity
2. 🔄 **Process**: Implement automated dependency updates
3. 📊 **Metrics**: Set up continuous health monitoring
## Comparison with Previous Health Check
| Category | Last Check | Current | Trend |
|----------|------------|---------|-------|
| Overall Score | 72/100 | 68/100 | ↓ -4 |
| Delivery | 80/100 | 75/100 | ↓ -5 |
| Code Quality | 70/100 | 72/100 | ↑ +2 |
| Technical Debt | 65/100 | 60/100 | ↓ -5 |
| Team Health | 75/100 | 70/100 | ↓ -5 |
Offer focused analysis options:
"Based on the health check, would you like to:
1. Deep dive into declining velocity trends
2. Generate security vulnerability fix plan
3. Analyze technical debt hotspots
4. Create team workload rebalancing plan
5. Set up automated health monitoring"
"Linear MCP not connected. Health check will be limited to:
- Git/GitHub metrics only
- No sprint velocity or task metrics
- Manual input required for team data
To enable full health analysis:
1. Install Linear MCP server
2. Configure with API credentials
3. Re-run health check"
"Some metrics could not be calculated:
- [List missing metrics]
- [Explain impact on analysis]
Would you like to:
1. Proceed with available data
2. Manually provide missing information
3. Skip incomplete sections"
# health-check-config.yml
thresholds:
velocity_variance: 20 # Acceptable % variance
test_coverage: 80 # Minimum coverage %
pr_review_time: 4 # Maximum hours
bug_rate: 5 # Maximum % of work
dependency_age: 90 # Days before "outdated"
Allow users to define additional metrics:
"Add custom health metric:
- Name: Customer Satisfaction
- Data Source: [API/Manual/File]
- Target Value: [>4.5/5]
- Weight: [Impact on overall score]"
"Would you like me to:
1. Schedule weekly health checks
2. Set up alerts for critical metrics
3. Create Linear tasks for action items
4. Generate PR templates with health criteria
5. Configure CI/CD health gates"