Skip to content

bro drill

When a task needs focused investigation, bro drill creates a frame: a drill-labeled bead nested under the current one. A frame can only close with a result — and if it found a lesson, a prevention plan. beads is the memory system; there is no .drills/ directory.

Command What it does
bro drill down <title> [--under ID] [--ephemeral] New child frame under the current leaf (or a root). --ephemeral = wisp, no audit trail
bro drill up --result T [--prevent T]… [--evidence R]… Close the frame. --result is mandatory (CLI-enforced); each --prevent spawns a prevention task linked discovered-from; --evidence lands in bd provenance
bro unwind … Alias for drill up
bro drill current / tree / list Active leaf · all hierarchies · open frames
bro drill distill <id> bd mol distill — a good drill tree becomes a reusable proto

Narrow → investigate → ascend → prevent. Descend only into a strictly narrower problem. A frame that returns nothing teaches nothing; a frame that found an error owes a prevention bead so it doesn’t recur.

Hooks block Stop once while a frame is open — a repeated stop is let through. Gates, not loops.