What problem does it solve?
Codehealth identifies how verifiable a codebase is so that AI agents can safely change code, run validation gates, and know whether their changes are correct. It surfaces gaps in type safety, tests, error handling, security, architecture, and domain logic, and separates an automated health check from the LLM-driven quality assessment. The Skill produces actionable findings and a prioritized backlog so teams and orchestrators can fix agent-readiness problems.
Core Features & Use Cases
- Six-dimension LLM review: Deep, contextual inspections for Type Safety, Test Quality, Error Handling, Security, Clean Architecture, and Domain Logic using code-aware analysis.
- Automated web app health check: Run builds, linters, tests/coverage, bundle analysis, dev-server checks, Lighthouse, and dependency audits to capture objective metrics.
- Modes for workflow fit: Full scan (LLM review + health check + writes), quick health-only check, and diff mode for incremental re-scans.
- Outputs & integration: Writes latest, history, and backlog artifacts and creates Quality tasks in dev-manager state for the orchestrator to act on.
- Use case: Run a full audit before enabling autonomous change agents to ensure tests and validation gates will catch regressions.
Quick Start
Invoke the codehealth skill with /codehealth to run a full audit that scores six dimensions, performs a web app health check, and generates a prioritized Quality backlog for dev-manager.