mirror of
https://github.com/garrytan/gstack.git
synced 2026-11-19 22:54:36 +01:00
* captain: stop a finished /ship subagent at its READY after subscribing to its PR Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * chore: CHANGELOG for stopping finished /ship subagents (unreleased) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> * captain: /ship subagent stop review fixes (subscribe at PR open, parent owns post-READY work, unconditional one-line wake, tight budget) Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com> --------- Co-authored-by: capy-ai[bot] <230910855+capy-ai[bot]@users.noreply.github.com>
48 lines
3.0 KiB
Markdown
48 lines
3.0 KiB
Markdown
# Brief
|
|
|
|
Sent by the controller when a lane starts, and again when a lane takes on scope its brief
|
|
did not name. The lane reads the rules file first, then this. Everything in angle brackets
|
|
is filled by the controller; `Plan:` says whether the lane plans first
|
|
(`docs/captain.md`, Plan before build).
|
|
|
|
```text
|
|
Lane: <thread code> · Controller: <CONTROLLER> · Rules: <drive>/CREW.md · Base: <BASE>
|
|
Owns: <the files and directories this lane may edit; everything else is routed through the controller>
|
|
Do not touch: <files other live lanes own, each with its lane>
|
|
Plan: required | approved: <autoplan run dir, or its checkpoint dir> | exempt: <reason from the exemption list>
|
|
Spend cap: <focused paid runs per PR, from SPEND>
|
|
|
|
1. Plan (when Plan: required). After the session-start install check, install for autoplan
|
|
and follow autoplan/DRIVER.md "On Capy" (launch file sourced, GSTACK_AUTOPLAN_CHECKPOINT_DIR
|
|
set, run dir under ~/.capy/work). Write the plan with its ## ELI5, ## Before → after,
|
|
## Why it matters, ## What caused this work, ## Big decisions and ## Implementation plan
|
|
sections, then run gstack-autoplan next --out <run dir> --plan <plan.md> <scope flags>
|
|
sized to this brief (a fix: --no-ui --no-dx --max-rounds 1 --estimate-usd <n>
|
|
--spend-cap <small>, then close the CEO phase before dispatching its voices with
|
|
gstack-autoplan close --out <run dir> --phase ceo --deferred "eng-only fix plan"
|
|
--by agent:<your thread>).
|
|
At the gate send me the output of
|
|
gstack-owner-brief render --captain --out <run dir> whole, as a needs-you report.
|
|
Build nothing yet.
|
|
2. Build after the word. I bring the owner's exact words back. Answer them into the run
|
|
(gstack-autoplan answer --out <run dir> --gate-rev <n> --reply <tokens> --rec-hash <h>
|
|
--by agent:<your thread> --owner-reply "<their words>"), incorporate every accepted plan
|
|
change (revise), finish every reopened phase, and start product edits only when the run
|
|
reports APPROVED (a later gate that asks nothing new prints CARRIED: and needs no second
|
|
ask). Then gstack-approvals import --autoplan <run dir> --by "<owner>" (--stack b1,b2 for a stack).
|
|
New scope you take on part-way goes back to step 1 with its own plan.
|
|
3. Ship. CHANGELOG entry under [Unreleased]; GUARD_CHECKS, pregate and /ship at the final
|
|
head; one unstamped READY block (captain/templates/READY.md) to me; the PR body carries
|
|
gstack-approvals render. Never merge; stamp only on my slot call.
|
|
The lane subscribes to the PR, then stops its /ship subagent at READY (docs/captain.md, the lane's /ship sequence).
|
|
|
|
Done when: the READY block is sent at a frozen head, reports/<thread code>.md is written,
|
|
and its Approvals table carries the plan approval row (the owner's words, the date) or the
|
|
Plan: exempt reason.
|
|
```
|
|
|
|
A lane whose brief says `approved: <dir>` starts at step 2 with that run (restore it with
|
|
`gstack-autoplan resume --out <new dir> --from <its checkpoint dir>` when it lives on another machine); a
|
|
lane whose brief says `exempt:` starts at step 3. A brief with no `Plan:` line reads as
|
|
`Plan: required`.
|