​
Plan — Lập kế hoạch

Tạo kế hoạch implementation chi tiết từ ý tưởng. Có research agents chạy song song để tìm hiểu codebase trước khi plan.

​
Cú pháp

/plan "mô tả ý tưởng"          # Plan chuẩn (auto-detect mode)
/plan:fast "mô tả ý tưởng"     # Plan nhanh (không research)
/plan:hard "mô tả ý tưởng"     # Plan sâu (research nhiều)
/plan:two "mô tả ý tưởng"      # 2 phương án so sánh
/plan:parallel "mô tả ý tưởng" # Plan với parallel phases
/plan:ci                        # Phân tích GitHub Actions logs

​
Luồng hoạt động bên trong

Khi bạn gõ /plan "task", đây là những gì xảy ra bên trong:
1

Bước 1: Pre-Creation Check

Kiểm tra ./plans/ xem có plan nào đang active hoặc liên quan không.
  • Có plan active → hỏi: “Tiếp tục plan này? [Y/n]”
  • Có plan gợi ý từ branch → hỏi: “Kích hoạt plan này hay tạo mới?”
  • Không có plan → tạo mới
2

Bước 2: Cross-Plan Scan

Đọc frontmatter của tất cả plan chưa hoàn thành (status != completed/cancelled). So sánh scope: overlapping files, shared dependencies, cùng feature area. Nếu phát hiện dependency → cập nhật blockedBy/blocks ở CẢ HAI plan.
3

Bước 3: Scope Challenge

Hỏi câu hỏi thách thức scope để đảm bảo bạn đang giải quyết đúng vấn đề. Skip nếu mode --fast hoặc task quá đơn giản (<20 từ).
4

Bước 4: Mode Detection

Tự động phân tích độ phức tạp và chọn mode phù hợp (hoặc dùng flag bạn chỉ định).
5

Bước 5: Spawn Research Agents (song song)

Spawn 2+ researcher agents, mỗi agent tìm hiểu 1 phần codebase khác nhau. Skip nếu mode --fast.
6

Bước 6: Codebase Analysis

Đọc docs (./docs/), scout codebase nếu cần, hiểu patterns hiện có.
7

Bước 7: Plan Creation (planner subagent)

Planner subagent tổng hợp research reports và tạo plan chi tiết:
  • plan.md — overview, phases, status, links
  • phase-01-*.md, phase-02-*.md — chi tiết từng phase
8

Bước 8: Red Team Review (hard/parallel/two)

Gọi /plan red-team — adversarial reviewers cố tìm lỗ hổng trong plan.
9

Bước 9: Validation Interview (hard/parallel/two)

Gọi /plan validate — hỏi câu hỏi critical để validate plan.
10

Bước 10: Hydrate Tasks + Output

Tạo Claude Tasks từ phases. Output cook command với absolute path.

​
5 Chế độ Plan

Tự động detect mode dựa trên độ phức tạp task.
/plan "build user authentication with Google OAuth"
Thời gian: 3-5 phút. Output: Plan chi tiết với file list, steps, dependencies.

​
Bảng so sánh các modes

FlagModeResearchRed TeamValidationCook Flag
--autoAuto-detectTheo modeTheo modeTheo modeTheo mode
--fastFastSkipSkipSkip--auto
--hardHard2 researchersCóTùy chọn(none)
--parallelParallel2 researchersCóTùy chọn--parallel
--twoTwo approaches2+ researchersSau chọnSau chọn(none)
Thêm --no-tasks để skip task hydration ở bất kỳ mode nào.

​
Ví dụ thực tế

/plan "user authentication with Google OAuth"

​
So sánh với chat trực tiếp

Tiêu chí/planChat trực tiếp
ResearchSpawn agents song song tìm hiểu codebaseKhông research, dựa vào context có sẵn
Cross-planDetect dependency giữa các planKhông biết plan khác tồn tại
Scope challengeHỏi thách thức trước khi planNhận task và làm ngay
Red teamAdversarial reviewer tìm lỗ hổngKhông có đối trọng
OutputPlan files persistent, có phases + file listText trả lời 1 lần, mất khi hết session
HandoffOutput cook command với absolute pathPhải copy-paste thủ công
Dependency trackingblockedBy/blocks giữa plansKhông theo dõi

​
Khi nào dùng / không dùng

DùngKhông dùng
Feature mới phức tạpFix bug đơn giản (dùng /fix)
Cần thiết kế architectureThay đổi config/style nhỏ
Nhiều files liên quanTask < 30 phút
Cần nhiều người review planTask quá rõ ràng, không cần plan
Refactor lớnThêm 1 field vào form

​
Sub-commands

Sub-commandMô tả
/plan "task"Plan chuẩn (auto-detect mode)
/plan:fast "task"Plan nhanh, không research
/plan:hard "task"Plan sâu, 2 researchers + red team
/plan:two "task"Tạo 2 phương án so sánh
/plan:parallel "task"Plan với phases chạy song song
/plan:cro "url"Plan CRO cho content/trang cụ thể
/plan:ciPhân tích GitHub Actions logs + plan fix
/plan red-team {path}Adversarial review plan đã tạo
/plan validate {path}Validate plan với câu hỏi critical
/plan archiveArchive plans + viết journal entries

​
Các plan review bổ sung

LệnhMô tả
/plan-ceo-reviewCEO/founder review — tìm 10-star solution
/plan-eng-reviewEng manager review — lock execution plan
/plan "feature mô tả"
/plan-ceo-review        # CEO góc nhìn
/plan-eng-review        # Eng manager góc nhìn
/cook                   # Implement

​
Lưu ý & Best Practices

Sai lầm phổ biến:
  • Dùng /plan:fast cho feature phức tạp → thiếu research, plan sai hướng
  • Plan quá rộng (8+ files trong 1 phase) → khó review, dễ conflict
  • Skip /plan:validate → assumptions sai, phải rewrite plan
  • Không đọc research output → plan dựa trên assumptions thay vì facts
Tips từ team:
  • /plan:hard cho feature mới (cần research), /plan:fast cho task đã rõ requirements
  • Mỗi phase nên dưới 5 files — chia nhỏ nếu quá rộng
  • Luôn validate plan trước khi cook: /plan:validate path/to/plan.md
  • Dùng /plan:two khi không chắc approach nào tốt hơn
→ Xem thêm: Best Practices tổng hợp

​
Sau khi plan xong

1

Review plan

Đọc plan, kiểm tra:
  • Đúng requirements không?
  • Architecture hợp lý?
  • Steps đúng thứ tự?
2

Implement

/cook                  # Implement theo plan đã tạo
# hoặc
/code                  # Code trực tiếp theo plan