---
name: hi-plan
description: "Plan implementations, design architectures, create technical roadmaps with detailed phases."
argument-hint: "[task] [--full|--hard|--parallel|--two|--no-tasks]  — default: fast mode. Sub: archive|red-team|validate"
metadata:
  author: baka3k
  version: "2.0.0"
---
# Plan - Implementation Planning

**Scan `./plans/` first.** If relevant unfinished plans exist, update them. If unclear, ask user.

## Cross-Plan Dependency Detection
1. Scan `plans/*/plan.md` (status != completed/cancelled)
2. Detect overlapping files, shared deps, same feature area
3. Classify: new needs existing output -> `blockedBy: [dir]`, new changes existing deps -> update both
4. Bidirectional: update BOTH plan.md files

## Default (No Arguments)
| Operation | Description |
|-----------|-------------|
| (default) | Create implementation plan (fast mode) |
| `--full` | Full flow: research + scope challenge + red team + validate |
| `archive` | Archive plans + log |
| `red-team` | Adversarial review |
| `validate` | Critical questions interview |

If invoked without arguments, run fast mode trực tiếp (không AskUserQuestion).

## Workflow Modes
| Flag | Mode | Research | Red Team | Validation |
|------|------|----------|----------|------------|
| default / --fast | Fast | Skip | Skip | Skip |
| --full | Full | 1 researcher | Optional | Optional |
| --hard | Hard | 2 researchers | Yes | Optional |
| --parallel | Parallel | 2 researchers | Yes | Optional |
| --two | Two approaches | 2+ researchers | After select | After select |

Add `--no-tasks` to skip task hydration.

## Process Flow (default fast)
1. **Cross-Plan Scan** -> Chỉ quét nếu có plan active (scan nhanh)
2. **Scope Challenge** -> Skip (fast)
3. **Codebase Analysis** -> Đọc docs, scan nếu cần (không spawn researcher)
4. **Plan Documentation** -> Write plan.md + phase-XX.md
5. **Hydrate Tasks** -> TaskCreate per phase (--no-tasks để skip)
6. **Output** -> Absolute path

## Full Flow (--full)
1. **Pre-Creation Check** -> Check Plan Context
2. **Cross-Plan Scan** -> Detect blockedBy/blocks, update both
3. **Scope Challenge** -> Run 3 questions, select mode
4. **Research** -> Spawn 1 researcher
5. **Codebase Analysis** -> Read docs, scan if needed
6. **Plan Documentation** -> Write plan.md + phase-XX.md
7. **Red Team** -> `/hi-plan red-team {path}`
8. **Validate** -> `/hi-plan validate {path}`
9. **Hydrate Tasks** -> TaskCreate per phase
10. **Output** -> Absolute path + craft command

## Output Requirements
- Plans in CURRENT WORKING PROJECT DIRECTORY (not user home)
- Plan files = persistent. Tasks = session-scoped
- Invoke /hi-project-organization after output
- Respect `./docs/development-rules.md`

## Task Management
- Auto-hydrate tasks after plan write (skip --no-tasks)
- <3 phases -> skip task creation (overhead > benefit)
- Task tools CLI-only (VSCode: use TodoWrite)

## Subcommands
| Subcommand | Purpose |
|------------|---------|
| `/hi-plan archive` | Archive plans + log |
| `/hi-plan red-team {path}` | Adversarial review |
| `/hi-plan validate {path}` | Critical questions interview |