docs: clarify pinned molecule vs handoff mail distinction

Two mechanisms, different purposes:
- Pinned molecule (bd mol run) = What you are working on, tracked by beads
- Handoff mail = Optional context notes for session restarts

Updated templates, architecture.md, and builtin_molecules.go

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-12-21 21:41:23 -08:00
parent 4cdc746fd5
commit 8fb9f9a321
5 changed files with 75 additions and 54 deletions

View File

@@ -754,8 +754,8 @@ Submit to merge queue. Create PR if needed.
Verify CI passes.
Needs: rebase-main
## Step: update-handoff
Update handoff bead with final state.
## Step: generate-summary
Generate summary for molecule squash.
File any remaining work as issues.
Needs: submit-merge
@@ -817,8 +817,8 @@ Graceful shutdown with handoff preservation.
Send shutdown notification to all agents.
Record which agents acknowledged.
## Step: wait-handoffs
Wait for agents to update handoff beads.
## Step: wait-squash
Wait for agents to squash their molecules.
Track completion status.
Needs: notify-agents