AGENTS.md
40 lines · captain/templates/AGENTS.md at 3f79d81
1# <CREW_NAME> standing rules
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.
<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 67## Mandate (<owner>, <date>)
8"<the owner's words for what this crew is for>"
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
BASEred. S2 is a broken workflow with no workaround. Everything else is batched.
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.
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.
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.
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.
Decisions log
- <date> <time> · <decision> · "<owner's exact words>" · covers: <scope>