From e100391d6eb34dd1ed68d3ec383b5a281fcef7d6 Mon Sep 17 00:00:00 2001 From: Jammy2211 Date: Wed, 8 Jul 2026 11:29:36 +0100 Subject: [PATCH] Point boundary prose at canonical PyAutoBrain/ORGANISM.md The mirrored boundary/call-chain block is now defined once in PyAutoBrain/ORGANISM.md; this repo keeps only its own side (observer-only). Co-Authored-By: Claude Fable 5 --- AGENTS.md | 28 +++++----------------------- 1 file changed, 5 insertions(+), 23 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 04cdb19..9316cc3 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,30 +6,12 @@ hygiene, generated-artifact/noise classification, and continuous monitoring of the PyAuto repos. `pyauto-heart readiness` is the authoritative "is it safe to release?" gate. -## The boundary (one description, mirrored in all three repos) +## The boundary -- **PyAutoHeart — the health authority.** All health/readiness logic lives here: - version drift, install-path, URL hygiene, CI/worktree/timing monitoring. - `pyauto-heart readiness` is the **authoritative** green/yellow/red verdict — - the single "is it safe to release?" gate. Heart is an observer: it reads and - emits verdicts; it never writes into other repos and never triggers Build. -- **PyAutoHands / PyAutoBuild — the executor.** Packaging, tagging, notebook - generation, and PyPI publication via `release.yml`. Hands runs **no** - readiness checks of its own and never re-derives a gate decision; it just - executes. -- **PyAutoBrain — the brain.** Hosts the agents that connect the - two. It owns no checks and no release steps; it gates on Heart and delegates - execution to Hands. - -## The call chain (always this order) - -``` -Brain → Heart (gate) → Hands (execute) -``` - -The brain asks `pyauto-heart readiness --json`; only on a **green** verdict does -it trigger Hands' release work. Heart never triggers Hands; Hands never -re-derives a gate decision the brain already made. +The organs, boundaries and the `Brain → Heart (gate) → Hands (execute)` call +chain are defined once in `PyAutoBrain/ORGANISM.md`. Heart's side of it: +**observer only** — it reads and emits the authoritative green/yellow/red +verdict, never writes into other repos, and never triggers Build. For the release-**validation** rehearsal specifically (build-and-exercise the exact source about to ship, before promoting to PyPI — see