fix

Fix

Structured bug fixing workflow. Five steps: REPRODUCE → DIAGNOSE → FIX → VERIFY → COMMIT → (HARDEN). Enforces test-first debugging — no source changes until a failing test exists. HARDEN is optional: fires when the same errata class has appeared 2+ times — offers to convert the pattern into a PreToolUse gate.

Usage

/brana:fix [task-id or bug description]

If a task ID is provided, load it via brana backlog get <id> and use the description as the bug statement.

Step Registry

On entry, create CC Tasks for each step (for compression resilience):

TaskCreate: "/brana:fix — REPRODUCE"
TaskCreate: "/brana:fix — DIAGNOSE"   (blocked by REPRODUCE)
TaskCreate: "/brana:fix — FIX"        (blocked by DIAGNOSE)
TaskCreate: "/brana:fix — VERIFY"     (blocked by FIX)
TaskCreate: "/brana:fix — COMMIT"     (blocked by VERIFY)
TaskCreate: "/brana:fix — HARDEN"     (blocked by COMMIT, optional)

Mark each in_progress when starting, completed when done. Resume after compression by calling TaskList and finding the in_progress step.

After creating the step registry, call /goal and write active-goal.json unless --no-goal was passed.

If a task_id is known, first extract AC: lines from task context:

brana backlog get {task_id} | python3 -c "
import json, sys
t = json.load(sys.stdin)
lines = [l[3:].strip() for l in (t.get('context') or '').splitlines() if l.startswith('AC:')]
print('\n'.join(lines))
"

• If AC: criteria found:

  /goal "fix {task-id} — Done when: {criteria joined with ' AND '}"
  

  Pin base_ref at goal start and initialize tests_required[] empty (hardened form — ADR-061 §4, identical to build's LOAD step 0):

  base_ref=$(git -C "{git_root}" rev-parse HEAD)
  cat > ~/.claude/run-state/active-goal.json <<JSON
  {"task_id": "{task_id}", "cwd": "{git_root}", "session_id": "$BRANA_SESSION_ID", "base_ref": "$base_ref", "criteria": ["{criterion1}", "{criterion2}"], "tests_required": []}
  JSON
  

  base_ref anchors the grader-immutability check; the REPRODUCE failing test is committed red in its own commit (the REPRODUCE step, Step 1) so the red-verification pre-commit hook (t-2216) registers it into tests_required[] — earning the exemption by observed redness. The Stop hook (goal-completion.sh) auto-completes the task when all criteria pass, behind the presence + immutability interlocks.