KittyClaw

Periodic codebase hygiene agent. Tracks health metrics, reports risky patterns, makes only zero-risk changes, files tickets for anything that needs judgment.

Runs when a ticket reaches Done. Commits only the changes related to that ticket, at hunk-level if needed. Never pushes.

Keeps project documentation in sync with the code. Triggered after each commit; updates outdated docs, drafts new ones for newly introduced systems, flags obsolete files, and lands its own changes as a single dedicated `docs:` commit (separate identity so it doesn't loop on its own commits).

Post-mortem ticket evaluator. Runs when a ticket reaches Done. Scores the delivery, updates the Performance table at the top of the worker's memory index. No comment posted on the ticket.

Verifies programmer deliveries when a ticket reaches Review. Actually runs the application/tests/endpoints to confirm the change works, sets up missing test tooling when needed, and blocks the ticket if execution is impossible. Posts a PASS/FAIL/BLOCKED report; on FAIL, returns the ticket to Todo.