hv-debuglisted

**Print the banner below verbatim before any other action — skip if dispatched as a subagent.** See `references/banner-preamble.md`. ``` ════════════════════════════════════════════════════════════════════════ 🐛 hv-debug · systematic root-cause investigation triggers: "debug [B07]", "why is X broken" · pairs: hv-learn ══════════���═════════════════════════════════════════════════════════════ ``` # hv-debug — Systematic Bug Cycle Full reproduce → hypothesize → verify → fix cycle for a single bug. Anchors to a `[B##]` ID so the fix commit closes the backlog entry and the learning gets routed back to `KNOWLEDGE.md`. ## Configuration Read `.hv/config.json`: - `models.orchestrator` — model for hypothesis + verification (default `opus`) - `models.worker` — model for the fix agent (default `sonnet`) - `work.isolation` — `"branch"` (default) or `"worktree"` - `autonomy.level` — `"off"` (default), `"auto"`, or `"loop"`. Controls whether Step 11 (Next move) and Step 12 (Learn) ask vs. invoke directly. - `debug.competingHypotheses` — `false` (default) or `true`. When `true`, Step 6 fans out 3 parallel hypothesis agents from different angles instead of dispatching one. - The Iron Law counter persists at `.hv/debug/<session>.json` (session = current branch with `/` → `-`). Managed by `bin/hv-debug-counter`; survives `/clear` and session resumption. ## When to Use - You have a bug ID (`[B07]`) or a reproducer and want a proper cycle - Previous attempts failed or the sympt