From 9ff8ed6c035e469928b58cbaaeffc36329f05470 Mon Sep 17 00:00:00 2001 From: claude-bot-andresmgsl Date: Sat, 25 Jul 2026 04:27:04 +0000 Subject: [PATCH] docs: a park is declared once and stands; nothing-changed resumptions post nothing MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The park contract said declared-never-inferred but not that the declaration stands, so a conservative builder re-declared every ~5 minutes — rig#145 collected 38 identical resumption audits in one night. Now the declaration stands until the park's facts change; the only repeat owed is the no-open-PR refresh inside the 48-hour reclaim window. Decided on #177. Closes #178 Co-Authored-By: Claude Fable 5 --- BUILDER.md | 16 ++++++++++++++++ changelog.d/178.md | 3 +++ 2 files changed, 19 insertions(+) create mode 100644 changelog.d/178.md diff --git a/BUILDER.md b/BUILDER.md index fdecb62..23534e6 100644 --- a/BUILDER.md +++ b/BUILDER.md @@ -84,6 +84,22 @@ triage bug, and the move is to say so on the issue, not to guess. owns the next move (the human), and both are visible to any scan as a `labeled` event with the summary beside it. No second comment is owed on the issue. Every other shape still declares as above. + Declared once, the declaration **stands** until the park's facts change: + a resumption that finds nothing changed posts nothing — the standing + declaration is the record, and silence while parked is compliant, not + abandonment-shaped. Re-declaring on every resume is the flood + [rig#145](https://github.com/heavy-duty/rig/pull/145) drowned in — 38 + near-identical audits in one night, each saying nothing changed + ([#177](https://github.com/heavy-duty/ceremony/discussions/177)). What + re-opens the duty to comment is the facts changing — the named wait + resolves or changes hands, the parked shape changes, or the claim + unparks — and each owes one new comment. The one place silence has a + cost: a parked claim with **no open PR** still feeds the 48-hour + reclaim clock, so there the builder refreshes the declaration before + the window closes. That refresh is the only repeat a park ever owes, + and its cadence is the reclaim window's, not any duty loop's. None of + this loosens the abandonment rule below: a claim that was never parked + and has simply stopped moving is abandoned, not silent. - **Pick up `attention` before anything else.** On your claim, first post a short pickup comment and remove `attention`; the removal is the ack. A demand on a parked claim is usually its unpark, so take the slot back under diff --git a/changelog.d/178.md b/changelog.d/178.md new file mode 100644 index 0000000..5709aea --- /dev/null +++ b/changelog.d/178.md @@ -0,0 +1,3 @@ +- BUILDER.md: a park declaration stands until its facts change — a + nothing-changed resumption posts nothing; only a no-open-PR park owes a + refresh, inside the 48-hour reclaim window (#178).