Ca Fix

$ca-fix — regression-first bug fix

The only permitted entry to bug-fix work. No fix code is written before a regression test reproduces the defect and goes red for the right reason. Give the observed behavior and the expected behavior, plus a stack trace or reproduction when you have one.

Orientation: if .codearbiter/code-map.md is present, read it before diagnosing — a coarse concern→path→role map that helps locate the defect. Absent is fine; it is read-on-demand.

Flow

Routes to the tdd skill, bug variant — Phase 1 is framed around confirming the defect, not building

new behavior:

• Reproduce the bug consistently.
• Locate the root cause — the exact code path producing the wrong behavior.
• Write a regression test that fails in the current state for the precise reason the bug causes

(not an unrelated error).

• Confirm it's red for the right reason — the failure message matches the described defect.

Only then does tdd proceed: minimal fix to green, then the remaining tdd gates. The implementation

agent (backend-author, frontend-author, or infra-author) is selected by where the bug lives. If

the defect cannot be pinned by a failing test, STOP and surface the question.

Routes to

tdd (${CLAUDE_PLUGIN_ROOT}/routines/tdd/SKILL.md) — all phases, Phase 1 framed for bug confirmation.

When NOT to use

• New behavior → $ca-feature.
• A behavior-preserving restructure → $ca-refactor.
• "Why does it do this?" → $ca-btw.
• Persisting fix code already written → $ca-commit (the gates still apply).

Hard gate

MUST NOT write fix code before the regression test is red for the right reason. MUST NOT accept a test

that passes against the broken state as proof of the defect.