204-an-agent-stays-on-its-pull-request
An agent stays on its pull request until it is clean, at an owner checkpoint, quiet, or out of time
Lifecycle approvedImplementation completeVerification unknownQualification unknown
Opening or updating a pull request is not the end of an agent's task. The agent keeps polling the change's review route every two minutes, answers every review item on the current head (reply first, then resolve), treats every push as a reset, and leaves only on one of four exits: clean, an owner checkpoint, thirty quiet minutes, or a ninety minute ceiling. It reports the exit and the head SHA, and a change left with open items is reported unfinished. The contract is stated over the review route and its required checks; GitHub is the current route, not the authority. The build adds the contract to `AGENTS.md`.
Read the full pinned specification ↗Relationships
Claimed units
- extends
{ "nature": "additive", "spec": "093-the-harness-this-repository-runs", "unit": { "kind": "file", "path": "AGENTS.md" } }
Source headings
- 204: An agent stays on its pull request until it is clean, at an owner checkpoint, quiet, or out of time
- 1. Purpose
- 2. Territory
- 3. Behavior
- 3.1 The review route
- 3.2 When the contract starts
- 3.3 The poll
- 3.4 Answering
- 3.5 The exits
- 3.6 The report
- 4. Relation to `/shepherd`
- 5. Acceptance criteria
- 6. Out of scope
- 7. Resolved decisions
- Verification
Frozen anchors
No frozen anchors declared.