You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: update all agent templates and concepts for root-only wisps
Update P0 role templates (polecat, deacon, witness, refinery) to remove
bd mol current / bd close references and replace with inline formula
checklist + gt patrol report pattern.
Update P1 docs (molecules.md, propulsion-principle.md, reference.md,
polecat-CLAUDE.md) to reflect the new architecture where formula steps
are read from the embedded binary, not materialized as database rows.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Polecats typically use **regular molecules** because each assignment has audit value.
171
-
Patrol agents (Witness, Refinery, Deacon) use **wisps** to prevent accumulation.
103
+
All formula-based work uses root-only wisps. Steps are read from the
104
+
embedded binary, not materialized as database rows.
172
105
173
-
### Hook Management
106
+
##Patrol Workflow
174
107
175
-
```bash
176
-
gt hook # What's on MY hook?
177
-
gt mol attach-from-mail <id># Attach work from mail message
178
-
gt done# Signal completion (syncs, submits to MQ, notifies Witness)
179
-
```
180
-
181
-
### Polecat Workflow Summary
108
+
Patrol agents (Deacon, Witness, Refinery) cycle through patrol formulas:
182
109
183
110
```
184
-
1. Spawn with work on hook
185
-
2. gt hook # What's hooked?
186
-
3. bd mol current # Where am I?
187
-
4. Execute current step
188
-
5. bd close <step> --continue
189
-
6. If more steps: GOTO 3
190
-
7. gt done # Signal completion
111
+
1. gt patrol new # Create root-only patrol wisp
112
+
2. gt prime # Shows patrol checklist inline
113
+
3. Work through each step
114
+
4. gt patrol report --summary "..." # Close + start next cycle
191
115
```
192
116
193
-
### Wisp vs Molecule Decision
194
-
195
-
| Question | Molecule | Wisp |
196
-
|----------|----------|------|
197
-
| Does it need audit trail? | Yes | No |
198
-
| Will it repeat continuously? | No | Yes |
199
-
| Is it discrete deliverable? | Yes | No |
200
-
| Is it operational routine? | No | Yes |
117
+
`gt patrol report` atomically closes the current patrol root and spawns
118
+
a new one for the next cycle.
201
119
202
120
## Best Practices
203
121
204
-
1.**CRITICAL: Close steps in real-time** - Mark `in_progress` BEFORE starting, `closed` IMMEDIATELY after completing. Never batch-close steps at the end. Molecules ARE the ledger - each step closure is a timestamped CV entry. Batch-closing corrupts the timeline and violates HOP's core promise.
205
-
2.**Use `--continue` for propulsion** - Keep momentum by auto-advancing
206
-
3.**Check progress with `bd mol current`** - Know where you are before resuming
207
-
4.**Squash completed molecules** - Create digests for audit trail
208
-
5.**Burn routine wisps** - Don't accumulate ephemeral patrol data
122
+
1.**Persist findings early** — `bd update <issue> --notes "..."` before session death
123
+
2.**Run `gt done` when complete** — mandatory for polecats (pushes, submits to MQ, nukes)
124
+
3.**Use `gt patrol report`** — for patrol agents to cycle (replaces squash+new pattern)
125
+
4.**File discovered work** — `bd create` for bugs found, don't fix them yourself
0 commit comments