Commit 8b37a09
docs(agents): stacked PR series are not a supported working form (#16743)
* docs(agents): stacked PR series are not a supported working form
Record the maintainer's ruling (director seat, decision batch #66): a
stacked series -- each PR branched off the one below -- is not a supported
working form in this repository, and no gate rule or merge-policy change is
made for it. A multi-card change uses a trunk branch and pays the two
recorded workarounds.
The paragraph is self-contained rather than a pointer: AGENTS.md is in
check:pm-skill-id-lint's scan set (pattern /#[0-9]{3,}/), so the card number
cannot be cited in the file. The three tooling blind spots are stated in one
clause each so the rule is actionable without dereferencing history.
Fold payment for the 1068/1068 line ratchet: the ADR-0087 marker block in
the Post-Task Checklist listed 4 of the gate's 7 disposition categories --
a drifted copy of output the same paragraph already calls "the authority".
Replaced by a pointer to the gate's own FIXIT, which prints the full set.
Net 0 lines.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P58euzUXCVJNwmhuPC9DXY
* docs(agents): drop the heavy-CI clause from the stacked-series paragraph
Seat review: the ruling grades that cost as "a defect independent of
stacking" and splits it out to its own devx card, so it is a defect being
fixed -- not a price of an unsupported form. Stating it in AGENTS.md as an
inherent property of stacking contradicts the ruling, and the clause goes
false the moment that card lands, rotting in place like any other restated
fact.
The paragraph now carries only the two structural costs the ruling did
assign here: squash landing destroys the ancestry link, so every descendant
pays a rebuild lap per landing; and a breaking changeset's ADR-0087
disposition is base-relative, so a stacked card's two bases demand
contradictory markers.
No pointer to the split-out card: AGENTS.md is in check:pm-skill-id-lint's
scan set, and any wording like "CI does not run on these yet" would itself
go false when that card lands.
AGENTS.md 1068 -> 1067; the ratchet is a cap, so a net decrease is legal and
nothing was restored to pad it back.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P58euzUXCVJNwmhuPC9DXY
* docs(agents): keep the stacked-series paragraph inside the 120-byte budget
check:pm-skill-ratchet enforces a per-LINE byte budget alongside the
per-file line ceiling, and the reflow left L469 at 121B. Rewrapped to five
lines, each under 120B, with the closing boundary shortened to "No gate or
merge-policy change is made for it" to fit without an orphan line.
Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01P58euzUXCVJNwmhuPC9DXY
---------
Co-authored-by: Claude <noreply@anthropic.com>1 parent cf33adb commit 8b37a09
1 file changed
Lines changed: 9 additions & 10 deletions
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
461 | 461 | | |
462 | 462 | | |
463 | 463 | | |
| 464 | + | |
| 465 | + | |
| 466 | + | |
| 467 | + | |
| 468 | + | |
| 469 | + | |
464 | 470 | | |
465 | 471 | | |
466 | 472 | | |
| |||
1037 | 1043 | | |
1038 | 1044 | | |
1039 | 1045 | | |
1040 | | - | |
1041 | | - | |
1042 | | - | |
1043 | | - | |
1044 | | - | |
1045 | | - | |
1046 | | - | |
1047 | | - | |
1048 | | - | |
1049 | | - | |
| 1046 | + | |
| 1047 | + | |
| 1048 | + | |
1050 | 1049 | | |
1051 | 1050 | | |
1052 | 1051 | | |
| |||
0 commit comments