docs: a park is declared once and stands; nothing-changed resumptions post nothing
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 <noreply@anthropic.com>
This commit is contained in:
parent
486bbd10a4
commit
9ff8ed6c03
2 changed files with 19 additions and 0 deletions
16
BUILDER.md
16
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
|
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
|
`labeled` event with the summary beside it. No second comment is owed
|
||||||
on the issue. Every other shape still declares as above.
|
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
|
- **Pick up `attention` before anything else.** On your claim, first post a
|
||||||
short pickup comment and remove `attention`; the removal is the ack. 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
|
demand on a parked claim is usually its unpark, so take the slot back under
|
||||||
|
|
|
||||||
3
changelog.d/178.md
Normal file
3
changelog.d/178.md
Normal file
|
|
@ -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).
|
||||||
Loading…
Reference in a new issue