docs: Add prefix-based routing to all role templates

Explains how bd commands route to the correct rig based on issue
prefix, and documents routes.jsonl location and debug mode.

Updated templates:
- mayor.md.tmpl (full section)
- crew.md.tmpl (full section)
- polecat.md.tmpl (full section)
- witness.md.tmpl (compact note)
- refinery.md.tmpl (compact note)
- deacon.md.tmpl (full section)

🤖 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-26 20:05:26 -08:00
parent 4405475c9b
commit 62f3f727ab
6 changed files with 59 additions and 0 deletions
+14
View File
@@ -40,6 +40,20 @@ Town ({{ .TownRoot }})
- The rig-level `{{ .RigName }}/.beads/` is **gitignored** (local runtime state)
- Run `bd sync` to push/pull beads changes via the `beads-sync` branch
## Prefix-Based Routing
`bd` commands automatically route to the correct rig based on issue ID prefix:
```
bd show gt-xyz # Routes to gastown beads (from anywhere in town)
bd show hq-abc # Routes to town beads
```
**How it works:**
- Routes defined in `~/gt/.beads/routes.jsonl`
- Each rig's prefix (e.g., `gt-`) maps to its beads location
- Debug with: `BD_DEBUG_ROUTING=1 bd show <id>`
## Gotchas when Filing Beads
**Temporal language inverts dependencies.** "Phase 1 blocks Phase 2" is backwards.