docs: terminology sweep - add missing terms and unify patrol templates

Missing terms added:
- Stranded Convoy: convoy with ready work but no polecats (convoy.md)
- Shiny Workflow: canonical polecat formula (molecules.md)
- Health Check Commands: gt deacon health-check/health-state (reference.md)
- MQ Commands: gt mq list/submit/retry/etc (reference.md)

Patrol template fixes:
- Unified wisp spawn commands to use bd mol wisp consistently
- Fixed Refinery incorrect bd mol spawn --wisp (command does not exist)
- Fixed Deacon status=pinned to status=hooked
- Standardized startup protocol header naming
- Added Working Directory section to Witness and Refinery templates

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
furiosa
2026-01-20 19:39:45 -08:00
committed by beads/crew/emma
parent 9b412707ab
commit 2b56ee2545
6 changed files with 49 additions and 10 deletions

View File

@@ -51,6 +51,7 @@ so you can see when it lands and what was included.
|---------|-------------|-----|-------------|
| **Convoy** | Yes | hq-cv-* | Tracking unit. What you create, track, get notified about. |
| **Swarm** | No | None | Ephemeral. "The workers currently on this convoy's issues." |
| **Stranded Convoy** | Yes | hq-cv-* | A convoy with ready work but no polecats assigned. Needs attention. |
When you "kick off a swarm", you're really:
1. Creating a convoy (the tracking unit)

View File

@@ -25,6 +25,7 @@ Protomolecule (frozen template) ─── Solid
| **Molecule** | Active workflow instance with trackable steps |
| **Wisp** | Ephemeral molecule for patrol cycles (never synced) |
| **Digest** | Squashed summary of completed molecule |
| **Shiny Workflow** | Canonical polecat formula: design → implement → review → test → submit |
## Common Mistake: Reading Formulas Directly

View File

@@ -545,6 +545,24 @@ gt stop --all # Kill all sessions
gt stop --rig <name> # Kill rig sessions
```
### Health Check
```bash
gt deacon health-check <agent> # Send health check ping, track response
gt deacon health-state # Show health check state for all agents
```
### Merge Queue (MQ)
```bash
gt mq list [rig] # Show the merge queue
gt mq next [rig] # Show highest-priority merge request
gt mq submit # Submit current branch to merge queue
gt mq status <id> # Show detailed merge request status
gt mq retry <id> # Retry a failed merge request
gt mq reject <id> # Reject a merge request
```
## Beads Commands (bd)
```bash