kiln-hygiene

To audit repository hygiene, run a structural rubric evaluation that checks your codebase and writes a deterministic review preview to .kiln/logs/structural-hygiene-<timestamp>.md. The audit organizes signals into per-rule sections for manual review.

A structural hygiene audit evaluates your repository against the Kiln rubric, rendering an organized signal summary with per-rule sections and a bundled archive block for merged PRDs. It generates a deterministic review preview file without applying edits.

Yes, you can customize the structural hygiene audit using an optional override via .kiln/structural-hygiene.config. This allows you to tailor the rubric evaluation while still generating the deterministic review preview in the logs directory.

No, the repository hygiene audit never performs edits or applies changes automatically. It only writes a deterministic review preview to .kiln/logs/ to enable manual review and targeted fixes based on the structural rubric signals.

The structural hygiene audit supports a backfill workflow to derive missing derived_from frontmatter. This process runs alongside the rubric evaluation, ensuring frontmatter completeness while still never applying automatic edits to your files.

The audit reports gh availability and handles errors gracefully, but it is limited to generating a read-only review preview. You must manually address any structural rubric violations or missing frontmatter issues identified in the per-rule sections.