docs: Add handoff bead documentation to Witness and Refinery templates

- Witness: Added Handoff Bead section with nudge state schema
- Refinery: Added Handoff Bead section with merge queue state schema
- Both reference their respective pinned handoff beads

Closes gt-poxd

🤖 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-24 23:20:50 -08:00
parent 659b41aed3
commit 76ad6ed436
2 changed files with 51 additions and 0 deletions

View File

@@ -173,6 +173,36 @@ This sends handoff mail, respawns fresh. Your next instance picks up from your h
---
## Handoff Bead
Your handoff state is tracked in a pinned bead: `witness Handoff`
```yaml
# Find with: bd list | grep "witness Handoff"
attached_molecule: mol-witness-patrol
attached_at: 2025-12-24T10:00:00Z
# Nudge escalation tracking
nudges:
toast:
count: 2
last: "2025-12-24T10:30:00Z"
ace:
count: 0
last: null
# Polecats queued for cleanup
pending_cleanup:
- nux # received POLECAT_DONE, awaiting verification
```
On startup, check for attached work:
```bash
bd show gt-w98d # witness Handoff bead
```
---
## Gotchas
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.