Skill Tracer
Skills › gstack › captain › AGENTS.md

AGENTS.md

40 lines · captain/templates/AGENTS.md at 3f79d81

Open on GitHub
1# <CREW_NAME> standing rules
2
3The controller's own file. Scope instructions: every thread in the crew reads it. Each
4rule that came from the owner keeps the date and the exact words, so lanes can cite it as
5a standing approval instead of asking again. Append; never rewrite an owner's words.
6

<CREW_NAME> standing rules

The controller's own file. Scope instructions: every thread in the crew reads it. Each rule that came from the owner keeps the date and the exact words, so lanes can cite it as a standing approval instead of asking again. Append; never rewrite an owner's words.

Raw lines 1 to 6
7## Mandate (<owner>, <date>)
8"<the owner's words for what this crew is for>"
9
10- Every <code prefix>-* thread in <project> is in the crew. New threads the owner starts
11 are added too.
12- Watch <REPO> issues and PRs. Start lanes for severe user-reported bugs no live thread
13 has claimed (the severity bar is below).
14- Severity first: S1 is a broken install or upgrade, data loss, a security result that is
15 wrong, or `BASE` red. S2 is a broken workflow with no workaround. Everything else is
16 batched.

Mandate (<owner>, <date>)

"<the owner's words for what this crew is for>"

  • Every <code prefix>-* thread in <project> is in the crew. New threads the owner starts are added too.
  • Watch <REPO> issues and PRs. Start lanes for severe user-reported bugs no live thread has claimed (the severity bar is below).
  • Severity first: S1 is a broken install or upgrade, data loss, a security result that is wrong, or BASE red. S2 is a broken workflow with no workaround. Everything else is batched.
Raw lines 7 to 17
18## Merging (<owner>, <date>: "<words>")
19- One controller merges, through a train (`/captain`, the merge-train section). Lanes send
20 READY and never merge. Standing approval to merge when green: "<words>".
21- A merge outside a train costs a backstop gate; none without the owner's words.

Merging (<owner>, <date>: "<words>")

  • One controller merges, through a train (/captain, the merge-train section). Lanes send READY and never merge. Standing approval to merge when green: "<words>".
  • A merge outside a train costs a backstop gate; none without the owner's words.
Raw lines 18 to 22
23## Spend (<owner>, <date>: "<words>")
24- Pre-approved: train gates, bisects, the backstop, screens, focused paid cases. Cap per
25 rerun: <amount>. Over the cap is a fresh ask.

Spend (<owner>, <date>: "<words>")

  • Pre-approved: train gates, bisects, the backstop, screens, focused paid cases. Cap per rerun: <amount>. Over the cap is a fresh ask.
Raw lines 23 to 26
27## Asks to the owner (<owner>, <date>: "<words>")
28- The ask format (gstack docs/captain.md), explained like I'm five: <Captain name>, then one
29 lettered line per decision: "A: <code> hit problem p, which happens when h. We could fix it
30 in these ways: 1) x; 2) y; 3) z. Recommendation: x because why. A1 to take recommendation."
31 "do it" takes every recommendation in the list at full scope, follow-ons included, no
32 further ask; a named option ("A2") takes that option instead.

Asks to the owner (<owner>, <date>: "<words>")

  • The ask format (gstack docs/captain.md), explained like I'm five: <Captain name>, then one lettered line per decision: "A: <code> hit problem p, which happens when h. We could fix it in these ways: 1) x; 2) y; 3) z. Recommendation: x because why. A1 to take recommendation." "do it" takes every recommendation in the list at full scope, follow-ons included, no further ask; a named option ("A2") takes that option instead.
Raw lines 27 to 33
34## Parallelism (<owner>, <date>: "<words>")
35- Keep about <N> lanes working on disjoint files whenever there is backlog. Serial steps
36 stay serial only where the tooling requires it: one train's slots, version stamps, edits
37 to a shared file.

Parallelism (<owner>, <date>: "<words>")

  • Keep about <N> lanes working on disjoint files whenever there is backlog. Serial steps stay serial only where the tooling requires it: one train's slots, version stamps, edits to a shared file.
Raw lines 34 to 38
39## Decisions log
40- <date> <time> · <decision> · "<owner's exact words>" · covers: <scope>

Decisions log

  • <date> <time> · <decision> · "<owner's exact words>" · covers: <scope>
Raw lines 39 to 40