PyAutoGut is the Gut of the PyAutoScientist — the organ of elimination.
It owns the full lifecycle of condemned self-material: the stale branches,
git stash entries, dead code and retired tests that a hygiene sweep is
95%-but-not-100% sure is trash. The Gut holds each item recoverably through a
transit window, then performs the final deletion itself.
- Condemn. The Brain's hygiene conductor (
/hygiene) decides an item is spent and files it in the manifest — thecondemned.mdledger in the Mind (symmetric toparked.md: parked will resume, condemned awaits elimination). - Transit. Fragile forms (unmerged branches, stashes) are first
materialised as real commits and pushed here as durable git refs under
refs/heads/archive/condemned/<name>— this repo is the attic remote. Until itssweep-afterdate, recovery is just a checkout. - Void. A batch sweep (
/repo_cleanupsafety gates against the manifest) eliminates items past their transit window — the Gut deletes; the entry leaves the ledger.
The split mirrors Heart ↔ vitals: the conductor reasons and drives, the organ
holds and voids. There is no dashboard here by design — the Gut's ledger is
the Mind's condemned.md, one click above.
Full rationale and boundaries:
pyautogut-organ-decision.
Operating guidance for agents: AGENTS.md. The organism this
repo is the Gut of is described once in
PyAutoBrain/ORGANISM.md
and documented in full at https://pyautoscientist.readthedocs.io.
