Skip to content
Development
Command

/fix

Fix a confirmed bug: a failing regression test first, then a minimal fix, then the rest of the tdd gates.

From plugin
codearbiter
13944 skills28 agents44 commands
Install
$ npx -y skills add arbiterForge/codeArbiter --agent claude-code

How it fires

How this command gets triggered: by you, by Claude, or both.

  • Fires itselfClaude auto-loads it when your prompt matches the work.
  • You can call itInvoke it directly when you want it.
  • Slash command/fix

Context preview

What this command does when you run it.

Fix a confirmed bug: a failing regression test first, then a minimal fix, then the rest of the tdd gates.

Command definition

fix.md
description: Fix a confirmed bug: a failing regression test first, then a minimal fix, then the rest of the tdd gates.
argument-hint: "<what's happening vs. what should happen>"

{{CMD: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:

1. **Reproduce** the bug consistently. 2. **Locate the root cause** — the exact code path producing the wrong behavior. 3. **Write a regression test** that fails in the current state for the precise reason the bug causes (not an unrelated error). 4. **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` (`{{PLUGIN_ROOT}}/skills/tdd/SKILL.md`) — all phases, Phase 1 framed for bug confirmation.

When NOT to use

  • New behavior → `{{CMD:feature}}`.
  • A behavior-preserving restructure → `{{CMD:refactor}}`.
  • "Why does it do this?" → `{{CMD:btw}}`.
  • Persisting fix code already written → `{{CMD: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.

Read more
Ships withcodearbiter

When you can't trust yourself with your code base, trust Arbiter.

Get the whole plugin, auto-invoked
Stats
139
Stars
1
Views
7
Forks
Active
Maintenance
Python
Language
AGPL-3.0
License
57m ago
Last commit
3mo ago
Created

Repo: arbiterForge/codeArbiter