docs: carry-forward, ELI5 section and stacked approvals import

Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
This commit is contained in:
garrytanandcapy-ai[bot] committed 2026-10-29 04:22:12 +00:00
1 parent 8e06646775
commit f5bcdf71a7
8 files changed
+85 -16

No files matched your search

+8 -2
View File
@@ -48,6 +48,7 @@ gstack-approvals add --ask "Spend up to \$40 on a paid eval rerun for the ship c
gstack-approvals add --outcome standing --ask "Merge #3330 when green" \
--words "yes merge when green" --by "Garry, 2026-10-16 (Captain rule)" --scope "every crew PR, through a train"
gstack-approvals import --autoplan <run dir> --by Garry # after gstack-autoplan answer; idempotent
gstack-approvals import --autoplan <run dir> --by Garry --stack b1,b2 # a stacked PR set: every branch, or none
gstack-approvals render # the ## Approvals section
```
@@ -93,8 +94,8 @@ project can follow it:
the plan names (docs, trains, cleanups) included, and carry them through to done with no further ask.
Say in one line what it covers. For an autoplan gate, "do it" answers as `rec`; record the words.
For an autoplan run, write parts 1 to 4 as `## Before → after`, `## Why it matters`,
`## What caused this work` and `## Big decisions` sections in the plan. Then, at the gate:
For an autoplan run, open the plan with `## ELI5` (5-10 plain sentences), then write parts 1 to 4 as
`## Before → after`, `## Why it matters`, `## What caused this work` and `## Big decisions` sections. Then, at the gate:
```bash
gstack-owner-brief render --captain --out <run dir>
@@ -112,6 +113,11 @@ gstack-autoplan answer --out <run dir> --gate-rev <n> --reply rec --rec-hash <h>
gstack-approvals import --autoplan <run dir> --by <name>
```
A later gate that asks nothing new is answered for you with the words you recorded (`CARRIED:`, then `APPROVED:`);
the brief says "Nothing pending. Carried forward", so import and build without a second ask. `CARRY_CHECK:` means
one reviewer from another model family reads the unreviewed delta first (`gstack-autoplan check`). Anything
else prints `CARRY: no (<why>)` and goes to the person as today (`docs/unattended.md#carry-forward`).
If the person answers in words ("split it into two PRs"), map the words to tokens, answer, and confirm in one
line what you recorded ("Recorded: split into two PRs; everything else as recommended"). A plan missing a
section renders "Not ready for approval" with no reply invitation, and exits 1 (`CAPTAIN_BRIEF_INCOMPLETE`):