bugfix

NW-BUGFIX: Defect Resolution Workflow

Wave: CROSS_WAVE Agents: Rex (nw-troubleshooter) → selected crafter (OOP or FP per project paradigm)

Overview

End-to-end bug fix pipeline: diagnose root cause, review findings with user, then deliver regression tests that fail with the bug and pass with the fix. Ensures every defect produces a test that prevents recurrence.

Flow

INPUT: "{bug-description}"
  │
  ├─ Phase 1: Root Cause Analysis (@nw-troubleshooter)
  │   └─ /nw-root-why "{bug-description}"
  │   └─ Output: RCA document with root cause chain + fix proposal
  │
  ├─ Phase 2: User Review (INTERACTIVE — STOP here)
  │   └─ Present RCA findings to user
  │   └─ User confirms root cause + approves fix direction
  │   └─ If user rejects → refine RCA or stop
  │
  └─ Phase 3: Regression Test + Fix (via /nw-deliver)
      └─ /nw-deliver "fix-{bug-id}" with bug-fix scope
      └─ Paradigm detection determines crafter (OOP or FP)
      └─ Roadmap: regression test (RED) → fix (GREEN) → verify (COMMIT)

Execution Steps

Phase 1: Root Cause Analysis

Skill loading: The troubleshooter loads its skills from ~/.claude/skills/nw-{skill}/SKILL.md:

• nw-five-whys-methodology — core investigation methodology
• nw-investigation-techniques — systematic debugging patterns
• nw-post-mortem-framework — structured incident analysis

Invoke @nw-troubleshooter via Agent tool:

Execute *investigate-root-cause for the following defect:

{bug-description}

Configuration:
- investigation_depth: 5
- multi_causal: true
- evidence_required: true

Produce:
1. Root cause chain (5 Whys with evidence at each level)
2. Contributing factors
3. Proposed fix with specific code changes
4. Files affected
5. Risk assessment of the fix

After the troubleshooter returns, present findings to the user. Include:

• Root cause summary (1-2 sentences)
• Evidence chain
• Proposed fix
• Files to modify
• Risk level

STOP and wait for user confirmation before proceeding to Phase 3.