verify-and-health

Automated project integrity checks run verification gates and health assessments before commits to surface failures and provide actionable remediation steps. This prevents regressions by validating frontmatter, references, and coverage automatically.

Verification gates are automated checks for frontmatter, references, triplets, coverage, and workflow-quality. They detect project regressions by running health assessments that surface failures and deliver concrete fixes to restore integrity.

Running workflow debugging gates at session start executes end-to-end verification checks to ensure project integrity. The process loads project constraints and reference materials to guide diagnostics and prevent early regressions.

Project constraints in CLAUDE.md are required to run health assessments. The verification process loads these constraints alongside reference materials like the three-layer-architecture document to guide diagnostics and execute actionable repairs.

Fixing verification gate failures requires interpreting the surfaced errors and applying the provided actionable remediation steps. After applying fixes, re-run the automated validations to confirm the project integrity is successfully restored.

Project health assessments fail after significant edits when automated verification gates detect broken references, missing frontmatter, or insufficient coverage. The assessment surfaces these failures with concrete remediation steps to resolve the regressions.