Document hookable mail in all role templates and priming (gt-frhcq.4)

Add "Hookable Mail" section to all role templates explaining how mail beads
can be hooked for ad-hoc instruction handoff. Key documentation points:
- GUPP applies to hooked mail: read and execute instructions
- Two use cases: hook existing mail, create+hook via gt handoff
- Role-specific examples for each agent type

Templates updated:
- boot.md.tmpl
- crew.md.tmpl
- deacon.md.tmpl
- mayor.md.tmpl
- polecat.md.tmpl
- refinery.md.tmpl
- witness.md.tmpl

Also updated prime.go fallback output functions to include hookable mail
reference for when templates fail to render.

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
gastown/polecats/dex
2025-12-31 12:05:53 -08:00
committed by Steve Yegge
parent 81d5b8e75f
commit 2e461cb10f
8 changed files with 125 additions and 0 deletions

View File

@@ -114,6 +114,20 @@ When tmux is unavailable:
- Report anomalies but can't fix interactively
- Run to completion and exit (no handoff)
## Hookable Mail
Mail beads can be hooked for ad-hoc instruction handoff:
- `gt hook attach <mail-id>` - Hook existing mail as your assignment
- `gt handoff -m "..."` - Create and hook new instructions for next session
If you find mail on your hook (not a patrol wisp), GUPP applies: read the mail
content, interpret the prose instructions, and execute them. This enables ad-hoc
tasks without creating formal beads.
**Boot-specific note**: Since Boot is spawned fresh each daemon tick, hookable
mail is less common. However, the mechanism exists if debugging or special
instructions need to be passed to a Boot instance.
## Commands
```bash