Skill Tracer
Skills › gstack › captain › plan-ask.md

plan-ask.md

46 lines · captain/templates/plan-ask.md at 3f79d81

Open on GitHub
1# Plan ask (shape B)
2
3Relayed by the controller to the owner. Written for someone outside the project; no
4gate codes in the body. `gstack-owner-brief render --captain --out <run dir>` prints this
5shape from an autoplan run; write it by hand for any other plan.
6
7```text
8Decision needed on <thread>: <one-line title>. Reply **do it** to take every recommendation.
9
10## ELI5
11<5-10 plain sentences: what changes, for whom, and what it costs>
13## Before → after
14<what the user or maintainer sees today; what they will see after; a command and its
15output, a screen, a cost or time number>
17## Why it matters
18<who is hurt today and how much, with numbers>
20## What caused this work
21<the trigger: an issue or PR link, a failed run, a user report, or the owner's words quoted>
23## Big decisions
241. <decision>: options <a, b, c>; pick <b> because <why>; what would flip it: <condition>.
252. …
27## What we need from you
28<Captain name>
29- A: <code> hit problem <p>, which happens when <h>. We could fix it in these ways: 1) <x> (<cost>); 2) <y> (<cost>); 3) <z> (<cost>). Recommendation: <x> because <why>. A1 to take recommendation.
30- B: …
32**do it** = take every recommendation in this list at full scope, including <the follow-ons
33named: docs, trains, cleanups>, and carry them through to done with no further ask. A named
34option ("A2") takes that option instead.
36<only when the owner must act; the exact link, never a menu path (a Capy app page: its exact path and field)>
37- C: <code> needs you to <action>, because <why>. Open <exact URL>, then:
38 1. Click <button>.
39 2. Type <value> in <field>.
40 3. Reply **done**.
41```
43When the answer comes back, record it before the work starts. For an autoplan gate:
44`gstack-autoplan answer --out <run dir> --gate-rev <n> --reply <tokens> --rec-hash <h> --by agent:<thread> --owner-reply "<exact words>"`,
45then `gstack-approvals import --autoplan <run dir> --by "<owner>"` (the tool records the relayer). For any
46other plan: `gstack-approvals add --ask "<what>" --words "<exact words>" --by "<owner> (via <controller>)" --scope "<what it covers>"`.

Plan ask (shape B)

Relayed by the controller to the owner. Written for someone outside the project; no gate codes in the body. gstack-owner-brief render --captain --out <run dir> prints this shape from an autoplan run; write it by hand for any other plan.

Decision needed on <thread>: <one-line title>. Reply **do it** to take every recommendation.

## ELI5
<5-10 plain sentences: what changes, for whom, and what it costs>

## Before → after
<what the user or maintainer sees today; what they will see after; a command and its
output, a screen, a cost or time number>

## Why it matters
<who is hurt today and how much, with numbers>

## What caused this work
<the trigger: an issue or PR link, a failed run, a user report, or the owner's words quoted>

## Big decisions
1. <decision>: options <a, b, c>; pick <b> because <why>; what would flip it: <condition>.
2. …

## What we need from you
<Captain name>
- A: <code> hit problem <p>, which happens when <h>. We could fix it in these ways: 1) <x> (<cost>); 2) <y> (<cost>); 3) <z> (<cost>). Recommendation: <x> because <why>. A1 to take recommendation.
- B: …

**do it** = take every recommendation in this list at full scope, including <the follow-ons
named: docs, trains, cleanups>, and carry them through to done with no further ask. A named
option ("A2") takes that option instead.

<only when the owner must act; the exact link, never a menu path (a Capy app page: its exact path and field)>
- C: <code> needs you to <action>, because <why>. Open <exact URL>, then:
  1. Click <button>.
  2. Type <value> in <field>.
  3. Reply **done**.

When the answer comes back, record it before the work starts. For an autoplan gate: gstack-autoplan answer --out <run dir> --gate-rev <n> --reply <tokens> --rec-hash <h> --by agent:<thread> --owner-reply "<exact words>", then gstack-approvals import --autoplan <run dir> --by "<owner>" (the tool records the relayer). For any other plan: gstack-approvals add --ask "<what>" --words "<exact words>" --by "<owner> (via <controller>)" --scope "<what it covers>".

Raw lines 1 to 46