/project-health-check

name: project-health-check
description: Audit project health across 7 dimensions (documentation, test coverage, security, code quality, dependencies, database, build/deploy) producing a scored report with prioritized fixes. Use for periodic checkups, before releases, or when the user runs /project-health-check.
user-invocable: true

Project Health Check

Comprehensive 7-point audit for project health.

---

7-Point Audit

1. Documentation

• [ ] README is accurate
• [ ] API docs exist
• [ ] Code comments explain "why"

2. Test Coverage

• [ ] Coverage > 80%
• [ ] Critical paths tested
• [ ] Edge cases covered

3. Security

• [ ] No secrets in code
• [ ] No vulnerable dependencies
• [ ] Input validation exists

4. Code Quality

• [ ] Linting passes
• [ ] No large files (> 500 lines)
• [ ] Consistent naming

5. Dependencies

• [ ] No outdated majors
• [ ] No unused deps
• [ ] Compatible licenses

6. Database

• [ ] Schema documented
• [ ] Migrations versioned
• [ ] Indexes documented

7. Build/Deploy

• [ ] Build succeeds
• [ ] CI/CD exists
• [ ] Env vars documented

---

Health Score Template

# Project Health Report - [Date]

## Overall Score: [X]/100

| Area | Score | Status |
|------|-------|--------|
| Documentation | /15 | |
| Test Coverage | /15 | |
| Security | /20 | |
| Code Quality | /15 | |
| Dependencies | /15 | |
| Database | /10 | |
| Build/Deploy | /10 | |

### Critical Issues
1. [Fix immediately]

### Warnings
1. [Fix this week]

### Suggestions
1. [Consider]

---

Frequency

| Check | When | |-------|------| | Quick | Weekly | | Standard | Bi-weekly | | Full | Monthly |