harness-audit

To audit repository scaffolding health, run a validation pass that checks for critical files like CLAUDE.md, features.json, progress.txt, and init.sh, then outputs a structured report with findings and recommendations.

Repository scaffolding consists of critical structural files like CLAUDE.md, features.json, and init.sh. Auditing it identifies gaps, inconsistencies, and outdated content to keep repositories healthy, up-to-date, and maintainable over time.

Yes, the harness audit suggests auto-fixes where appropriate after detecting missing files or outdated content. It proposes remediation actions to apply fixes and maintain harness health directly from the generated health report.

Yes, the harness audit operates with no external dependencies. It directly validates the repository structure and scaffolding files, checking their presence and basic integrity to output findings without requiring additional setup.

The best way to maintain CI harness health is running periodic audit passes that detect outdated content and structural gaps. This generates a health report with recommendations and suggests auto-fixes to remediate issues proactively.

You should avoid using an automated scaffolding audit if your repository lacks standard harness files like CLAUDE.md or features.json entirely, as the audit specifically validates their presence and basic integrity rather than creating them from scratch.