Claude Skill

ca-fix

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

LLM Mart · 0 points · 16 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download arbiterForge-codeArbiter-plugins_ca-codex_skills_ca-fix-6039d39.zip · 1 KB

arbiterforge/codearbiter 145 7 forks AGPL-3.0 Updated 7d ago

Part of arbiterforge/codearbiter — 238 skills

Install

skills CLI npx skills add https://github.com/arbiterForge/codeArbiter/tree/main/plugins/ca-codex/skills/ca-fix

Claude Code

claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install arbiterforge-codearbiter@llmmart

Git git clone https://github.com/arbiterForge/codeArbiter.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole arbiterforge/codearbiter collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

$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 (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.

Files (codearbiter)

SKILL.md 1.9 KB

---
name: ca-fix
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>"
---

# $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:

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` ([routines/tdd/SKILL.md](../../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.