docs: update templates with molecule navigation workflow (gt-lz13)

- Add bd mol current for orientation in polecat, crew, refinery, deacon
- Replace 3-command dance with bd close --continue (Propulsion Principle)
- Witness template unchanged (monitor role, no molecule execution)
This commit is contained in:
Steve Yegge
2025-12-24 00:23:50 -08:00
parent e7f9dc8576
commit bf754a8e2b
4 changed files with 26 additions and 24 deletions
+9 -7
View File
@@ -146,18 +146,20 @@ This enables **overnight autonomous work** on long molecules.
### Working on Attached Molecules ### Working on Attached Molecules
```bash ```bash
# Check what's attached # Check what's attached and see current step
gt mol status gt mol status
bd mol current
# Find next ready step in the attached work # Work the step (current step shown by bd mol current)
bd ready --parent=<work-mol-root>
# Work the step
bd update <step> --status=in_progress
# ... do the work ... # ... do the work ...
bd close <step>
# Close and auto-advance to next step
bd close <step> --continue
``` ```
The `--continue` flag closes your step and automatically marks the next ready step
as in_progress. This is the **Propulsion Principle** - seamless step transitions.
### Attaching Work (for the overseer) ### Attaching Work (for the overseer)
To enable autonomous work, attach a molecule: To enable autonomous work, attach a molecule:
+4 -4
View File
@@ -41,17 +41,17 @@ Your work is defined by the `mol-deacon-patrol` molecule with these steps:
v v
┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
│ 2. Execute current step │ │ 2. Execute current step │
│ - Read step description │ - bd mol current (see your step)
│ - Perform the work │ │ - Perform the work │
│ - bd close <step-id> │ - bd close <step-id> --continue
└─────────────────────────────────────────┘ └─────────────────────────────────────────┘
v v
┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
│ 3. Next step? │ │ 3. Next step? │
│ - bd ready │ - --continue auto-advances you
│ - If more steps: go to 2 │ │ - If more steps: go to 2 │
│ - If done: go to 4 │ - If molecule done: go to 4 │
└─────────────────────────────────────────┘ └─────────────────────────────────────────┘
v v
+11 -11
View File
@@ -30,25 +30,25 @@ steps and exit conditions. The molecule is your contract:
Your molecule is attached to your handoff bead: Your molecule is attached to your handoff bead:
```bash ```bash
# Find your pinned assignment # See your current molecule and step at a glance
bd mol current
# Or manually find your assignment
bd list --pinned --assignee=$BEADS_AGENT_NAME bd list --pinned --assignee=$BEADS_AGENT_NAME
# View your molecule and its steps
bd show <mol-id> bd show <mol-id>
# Find your current step (first in_progress or next unblocked)
bd ready --parent=<mol-id>
``` ```
### Working Through Steps ### Working Through Steps
Steps have dependencies (`Needs: step1, step2`). Work in order: Steps have dependencies (`Needs: step1, step2`). Work in order:
1. Find the next ready step: `bd ready --parent=<mol-id>` 1. Check your current step: `bd mol current`
2. Mark it in_progress: `bd update <step-id> --status=in_progress` 2. Do the work
3. Do the work 3. Close and auto-advance: `bd close <step-id> --continue`
4. Mark complete: `bd close <step-id>` 4. Repeat until exit-decision step
5. Repeat until exit-decision step
The `--continue` flag closes your step and automatically marks the next ready step
as in_progress. No friction, no forgetting. This is the **Propulsion Principle**.
### Exit Strategies ### Exit Strategies
+2 -2
View File
@@ -73,9 +73,9 @@ GATE: Cannot proceed to merge without fix OR bead filed
v v
┌─────────────────────────────────────────┐ ┌─────────────────────────────────────────┐
│ 2. Execute current step │ │ 2. Execute current step │
│ - Read step description │ - bd mol current (see your step)
│ - Perform the work │ │ - Perform the work │
│ - bd close <step-id> │ - bd close <step-id> --continue
└─────────────────────────────────────────┘ └─────────────────────────────────────────┘
v v