| name | hi:fix |
| description | ALWAYS activate before fixing ANY bug, error, test failure, CI/CD issue, type error, lint, log error, UI issue, code problem. |
| argument-hint | [issue] [--standard|--deep|--parallel|--review] — default: Quick mode |
| metadata | {"author":"baka3k","version":"2.0.0"} |
Fix - Issue Resolution
Mode Selection
| Flag | When |
|---|
| default | Quick: 1 file, type/lint, lỗi rõ ràng |
| --standard | Standard: 2-5 files, cần debug đầy đủ |
| --deep | Deep: 5+ files, architecture impact |
| --parallel | 2+ independent issues |
| --review | Human-in-the-loop at each step |
Process Flow
[Scout] -> [Diagnose] -> [Fix] -> [Verify+Prevent] -> [Finalize]
Do NOT fix before Scout + Diagnose. Find ROOT CAUSE first. If 3+ fix attempts fail, STOP and question architecture with user.
Step 1: Scout (locate-only, default)
Locate affected files và đọc lỗi. 1 agent là đủ.
Standard/Deep: activate hi:scout hoặc 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.
Nếu khó: activate hi:debug. Nếu 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 (mặc định)
Standard: + build + test
Deep: comprehensive (edge cases, security, perf)
Step 5: Finalize
Quick: report ngắn -> ask commit (skip docs, skip review)
Standard/Deep: report -> review (nếu --review) -> docs -> commit
Workflows
Quick (default, 1 file, type/lint, clear error)
Scout (locate only) -> Diagnose (read error) -> Fix -> Verify (typecheck+lint) -> Done
Standard (--standard, 2-5 files)
Full Scout -> Full Diagnose (gọi hi:debug nếu cần) -> Fix -> Verify (typecheck+lint+build+test) -> Review (nếu --review) -> Finalize
Deep (--deep, 5+ files, architecture impact)
Parallel Scout + Diagnose + Research -> Fix -> Comprehensive Verify -> Review -> Finalize
Parallel (2+ independent)
Separate task tree per issue. Spawn fullstack-developer per issue.
