What problem does it solve?
Housekeeping prevents drift across the factory and every agent clone by enforcing mechanical cleanups and running deterministic fleet-wide audits of repo state, skills, beads, lint, services, and memory indexes.
Core Features & Use Cases
- Mechanical cleanup + documentation refresh: delete deprecated code, update specs/architecture docs, refresh README/CLAUDE.md, and add deprecation markers without changing behavior.
- Fleet-wide state audits: verify CLAUDE.md identity per agent, ensure skill-file consistency across global/canonical/factory copies, and check bead hygiene (including closing, syncing JSONL drift, and routing follow-ups into beads).
- Deterministic quality gates: run import-dependency scans before deletions, regenerate derived architecture views from active decision beads, auto-fix formatting/lint via Biome, and validate systemd worker/dev-server health plus worktree cleanup and memory index correctness.
Quick Start
Run /housekeeping from the factory root to perform the fleet-wide hygiene pass, then confirm the exit criteria are all green.