Ck Fix

ck:fix — Structured Bug-Fix Pipeline

Modes (default = Standard: auto-approve if score ≥ 9.5 with 0 CRITICAL):

• --quick — trivial issues (lint, type errors, build errors); skip scout, review, docs
• --hard — mandatory review, no auto-approve

Step 0 — Prerequisites + Scope

If no error message, stack trace, or concrete description provided: → "Paste the error message or stack trace." Wait before continuing.

# Scope:
#   Description: {what the user said}
#   Quick?      → {yes/no — reason}
#   Mode:       {Standard | Quick | Hard}

If --quick or clearly a build/compiler/lint error: skip Step 1 → go directly to Step 2.

Step 1 — Scout

Spawn scout with the bug description:

• Greps for error patterns in logs and stack traces
• Reads affected source files and maps dependencies
• Checks recent git changes for related commits

// Evidence:
//   Error pattern: NullReferenceException at auth.ts:45
//   Affected files: auth.ts, session.ts
//   Recent change: commit a3f2b1 modified auth.ts (2h ago)

Step 2 — Diagnose

Spawn debugger with the scout evidence report:

• Forms 2–3 hypotheses from the evidence
• Confirms or rejects each against the codebase
• Applies the minimal fix at the confirmed root cause

// Hypothesis A: null check missing in auth.ts:45 → CONFIRMED ✓
// Hypothesis B: race condition in session init   → REJECTED ✗
//
// Root cause: missing null guard on req.user before .validate()
// Fix applied: auth.ts:45
// Severity: HIGH | Scope: 1 file

Step 3 — Review

--quick: skip → Step 4.

Spawn code-reviewer: correctness, security, regressions, code quality.

Standard: auto-approve if score ≥ 9.5 with 0 CRITICAL. Up to 3 fix/re-review cycles (different approach each), then escalate. --hard: no auto-approve — human must explicitly approve before Step 4.

Step 4 — Finalize (MANDATORY)

project-manager (skip --quick): sync plan progress if bug was tracked. docs-manager (skip --quick): update docs if fix changes a public contract. git-manager (always): conventional commit + ask to push.

// git-manager → fix(auth): add null guard on req.user before validate
//            → Push to remote? [y/N]

Agents