Skip to content
DEVKIT INDEX

Skill definition

hi-plan

Plan implementations, design architectures, create technical roadmaps with detailed phases.

SKILL.md

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)

OperationDescription
(default)Create implementation plan (fast mode)
--fullFull flow: research + scope challenge + red team + validate
archiveArchive plans + log
red-teamAdversarial review
validateCritical questions interview

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

Workflow Modes

FlagModeResearchRed TeamValidation
default / --fastFastSkipSkipSkip
--fullFull1 researcherOptionalOptional
--hardHard2 researchersYesOptional
--parallelParallel2 researchersYesOptional
--twoTwo approaches2+ researchersAfter selectAfter 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

SubcommandPurpose
/hi-plan archiveArchive plans + log
/hi-plan red-team {path}Adversarial review
/hi-plan validate {path}Critical questions interview

Continue exploring