From bf754a8e2bb6b3f7b3cb8170fd90a92c2799084f Mon Sep 17 00:00:00 2001 From: Steve Yegge Date: Wed, 24 Dec 2025 00:23:50 -0800 Subject: [PATCH] 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) --- prompts/roles/crew.md | 16 +++++++++------- prompts/roles/deacon.md | 8 ++++---- prompts/roles/polecat.md | 22 +++++++++++----------- prompts/roles/refinery.md | 4 ++-- 4 files changed, 26 insertions(+), 24 deletions(-) diff --git a/prompts/roles/crew.md b/prompts/roles/crew.md index 306f459a..51455194 100644 --- a/prompts/roles/crew.md +++ b/prompts/roles/crew.md @@ -146,18 +146,20 @@ This enables **overnight autonomous work** on long molecules. ### Working on Attached Molecules ```bash -# Check what's attached +# Check what's attached and see current step gt mol status +bd mol current -# Find next ready step in the attached work -bd ready --parent= - -# Work the step -bd update --status=in_progress +# Work the step (current step shown by bd mol current) # ... do the work ... -bd close + +# Close and auto-advance to next step +bd close --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) To enable autonomous work, attach a molecule: diff --git a/prompts/roles/deacon.md b/prompts/roles/deacon.md index 8eaf1330..7799b74b 100644 --- a/prompts/roles/deacon.md +++ b/prompts/roles/deacon.md @@ -41,17 +41,17 @@ Your work is defined by the `mol-deacon-patrol` molecule with these steps: v ┌─────────────────────────────────────────┐ │ 2. Execute current step │ -│ - Read step description │ +│ - bd mol current (see your step) │ │ - Perform the work │ -│ - bd close │ +│ - bd close --continue │ └─────────────────────────────────────────┘ │ v ┌─────────────────────────────────────────┐ │ 3. Next step? │ -│ - bd ready │ +│ - --continue auto-advances you │ │ - If more steps: go to 2 │ -│ - If done: go to 4 │ +│ - If molecule done: go to 4 │ └─────────────────────────────────────────┘ │ v diff --git a/prompts/roles/polecat.md b/prompts/roles/polecat.md index 248f249a..e19b7453 100644 --- a/prompts/roles/polecat.md +++ b/prompts/roles/polecat.md @@ -30,25 +30,25 @@ steps and exit conditions. The molecule is your contract: Your molecule is attached to your handoff bead: ```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 - -# View your molecule and its steps bd show - -# Find your current step (first in_progress or next unblocked) -bd ready --parent= ``` ### Working Through Steps Steps have dependencies (`Needs: step1, step2`). Work in order: -1. Find the next ready step: `bd ready --parent=` -2. Mark it in_progress: `bd update --status=in_progress` -3. Do the work -4. Mark complete: `bd close ` -5. Repeat until exit-decision step +1. Check your current step: `bd mol current` +2. Do the work +3. Close and auto-advance: `bd close --continue` +4. 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 diff --git a/prompts/roles/refinery.md b/prompts/roles/refinery.md index 5e2cd398..18683491 100644 --- a/prompts/roles/refinery.md +++ b/prompts/roles/refinery.md @@ -73,9 +73,9 @@ GATE: Cannot proceed to merge without fix OR bead filed v ┌─────────────────────────────────────────┐ │ 2. Execute current step │ -│ - Read step description │ +│ - bd mol current (see your step) │ │ - Perform the work │ -│ - bd close │ +│ - bd close --continue │ └─────────────────────────────────────────┘ │ v