What problem does it solve?
Provides a structured, evidence-based way to verify that a project's harness is actually running, tracking operational cadences, surfacing trends between snapshots, and detecting when observability itself is failing so teams can act before drift accumulates.
Core Features & Use Cases
- Operational cadence checks that verify scheduled mechanisms (audit, GC, reflection, mutation testing) actually executed and surface overdue activities.
- Trend computation by diffing human-readable snapshots to highlight deltas and multi-period trends for reviews.
- Telemetry export guidance and a reference export script to emit OpenTelemetry metrics for external dashboards.
- Meta-observability: five automated checks (snapshot currency, cadence compliance, learning flow, GC effectiveness, trend direction) that feed a README health badge and meta section.
- Use Case: Run a harness snapshot before a quarterly review to baseline enforcement ratio, mutation trends, and learning promotions, then export metrics to Grafana.
Quick Start
Run the /harness-health command to generate the latest snapshot, compute trends against the previous snapshot, and update the README health badge.