Fix - Issue Resolution

Mode Selection

Flag	When
default	1 file, type/lint, clear error
--standard	Standard: 2-5 files, full debug needed
--deep	Deep: 5+ files, architecture impact
--parallel	2+ independent issues
--review	Human-in-the-loop at each step

Process Flow

[Explorer] -> [Diagnose] -> [Fix] -> [Verify+Prevent] -> [Finalize]

Step 1: Explorer (locate-only, default)

Locate affected files and clear error. One agent is sufficient. Standard/Deep: activate hi-explorer Or 2-3 parallel agents.

Step 2: Diagnose (MANDATORY)

Capture pre-fix state: exact error, stack traces, logs. Trace backward: symptom -> immediate cause -> contributing factor -> ROOT CAUSE. If difficult: activate hi-debug. If 2+ hypotheses fail -> activate hi-problem-solving.

Step 3: Fix

Fix ROOT CAUSE. Minimal changes. Follow existing patterns.

Step 4: Verify + Prevent

Quick: typecheck + lint (default) Standard: + build + test Deep: comprehensive (edge cases, security, perf)

Step 5: Finalize

Quick: short report -> ask commit (skip docs, skip review) Standard/Deep: report -> review (if --review) -> docs -> commit

Workflows

Quick (default, 1 file, type/lint, clear error)

Explorer (locate only) -> Diagnose (read error) -> Fix -> Verify (typecheck+lint) -> Done

Standard (--standard, 2-5 files)

Full Explorer -> Full Diagnose (call hi-debug if needed) -> Fix -> Verify (typecheck+lint+build+test) -> Review (if --review) -> Finalize

Deep (--deep, 5+ files, architecture impact)

Parallel Explorer + Diagnose + Research -> Fix -> Comprehensive Verify -> Review -> Finalize

Parallel (2+ independent)

Separate task tree per issue. Spawn fullstack-developer per issue.