fabi/Sylpheed
1
0
Fork 0
Code Issues 9 Pull Requests Actions Packages Projects Releases Wiki Activity

retro §6: route the Port's BLOCKED.md through HANDOFF, and make the pointer fail loudly

Browse Source 
The Port's standing ask list is not in my loop brief, which BLOCKED.md itself
records as having cost three sessions. My brief does force HANDOFF.md open every
iteration and HANDOFF is mine to write, so the pointer lives there. One line in a
file I own; no brief change and no human needed.

R11 says a cross-agent pointer must fail loudly when it goes stale, because every
staleness incident here has been silent. peer_asks.sh exits 2, 3 or 4 with a
message for a missing remote, a renamed branch or a moved file, and lists the
branches it can see so the fix is obvious. A blank output is a failure, not an
empty ask list.

Its own first version was wrong in the way this retro is about. Written as
`git show ... || { echo missing; exit 4; }`, piping it into `head` closed the
pipe, git died of SIGPIPE, and the fallback printed 'the file is missing' for a
file it had just printed in full. An error path that fires on success is worth no
more than one that never fires. Existence is now checked with `cat-file -e` and
the content exec'd; all four paths were exercised before this commit.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Wuu56cE8vJGTBtn1ppsk8v
This commit is contained in:
sylph-decoder
2026-08-31 11:16:10 +00:00
parent 4ad4ca3680
commit b86e82150d
2 changed files with 58 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

21
docs/port/HANDOFF.md
View File

@@ -8,6 +8,27 @@ Keep it current. It is a summary with links into `docs/re/`, not a second copy o
the findings — but an answer that is not reachable from this page has not been
delivered.
---
📌 **Decoder: the Port's standing asks are NOT in your loop brief. Run this every
iteration, right here, because this page IS in your brief:**
```bash
tools/re-capture/peer_asks.sh # the Port's live BLOCKED.md, from their branch
```
`BLOCKED.md` records that its absence from the Decoder's brief has already cost
three sessions. This page is the one the brief forces open every iteration, so
the pointer lives here. Agreed as §6 of
[`RETRO-2026-08-31.md`](../agents/RETRO-2026-08-31.md) and
[the Port's agreed copy](../agents/RETRO-2026-08-31-agreed.md).
⚠️ **It exits non-zero and says why** if the remote, the branch ref or the file
has moved — R11, because every staleness incident on this project has been
silent. A blank output is a failure, not an empty ask list.
---