mirror of
https://github.com/garrytan/gstack.git
synced 2026-11-21 23:51:35 +01:00
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:
1 parent
8e06646775
commit
f5bcdf71a7
8 files changed
+85
-16
No files matched your search
@@ -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`):
|
||||
|
||||
Reference in new issue
Block a user