From 92c0e7c6f0189ca7d3e2e88e6152787ea3e0d575 Mon Sep 17 00:00:00 2001 From: cndgrr <59120057+cndgrr@users.noreply.github.com> Date: Tue, 4 Aug 2026 14:13:34 +0000 Subject: [PATCH] docs(builder): bind the red-head trigger to the round's ruled terms The red-head rule in Picking carried its own trigger definition at the pre-slim head; the squeeze took it, leaving 'failing check' and 'red check' classified only forward in the review round. At an all-cancelled head that let parked shape 2 read satisfied on its face, parking a claim the rule says is never parked (#163, #276). Co-Authored-By: Claude Opus 5 (1M context) --- BUILDER.md | 18 ++++++++++-------- 1 file changed, 10 insertions(+), 8 deletions(-) diff --git a/BUILDER.md b/BUILDER.md index 243da93..4429bbc 100644 --- a/BUILDER.md +++ b/BUILDER.md @@ -12,14 +12,16 @@ triage bug, and the move is to say so on the issue, not to guess. the most work; where a repo adopts version epics, [RELEASES.md](RELEASES.md) governs among window members. - **Your own red head outranks a new claim**: repair a failing check at your - PR's head before claiming another issue (#163). Record the check and its - failure class; rerun a clearly retryable infrastructure failure unchanged; - treat a branch failure as an ordinary fix round, worklog and all; leave - evidence where a rerun cannot start or the cause is unclear; never rerun a - deterministic failure without a corrective commit; hand off once green - with current-head approvals. Such a PR is **never parked**, whatever the - verdict state says; how the engine detects a red head is crew's to - describe. + PR's head before claiming another issue (#163). Red and green here are the + review round's ruled terms: cancelled, stale, or unreported — every entry + at the head cancelled — is not green; skipped or neutral is. Record the + check and its failure class; rerun a clearly retryable infrastructure + failure unchanged; treat a branch failure as an ordinary fix round, + worklog and all; leave evidence where a rerun cannot start or the cause is + unclear; never rerun a deterministic failure without a corrective commit; + hand off once green with current-head approvals. Such a PR is **never + parked**, whatever the verdict state says; how the engine detects a red + head is crew's to describe. - **One build at a time**: one issue on which you are writing or revising a deliverable, finished or released before you start more. The rule counts work in flight, not claims — a **parked** claim, whose next move is