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ập nhật bộ claudekit mới: Các lệnh /plan:fast, /plan:hard, /plan:two, /plan:parallel, /plan:cro, /plan:ci đã bỏ. Thay bằng /plan (tự chọn depth), cộng với /plan validate, /plan red-team. Xem cấu trúc skill mới để biết đầy đủ.

Cú pháp

/plan "mô tả ý tưởng"       # Plan chuẩn (auto-detect mode)
/plan validate {file}       # Validate plan với câu hỏi critical
/plan red-team {file}       # Adversarial review plan đã tạo

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:

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

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.

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ừ).

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).

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.

Bước 6: Codebase Analysis

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

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

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

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

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

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

Bước 10: Hydrate Tasks + Output

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

Lệnh Plan chính

Skill auto-detects độ phức tạp task và chọn research mode thích hợp.

/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.

Sub-commands: Validate & Red Team

Sau khi plan được tạo, sử dụng các commands sau để review:

/plan validate plans/260401-0900-google-oauth-auth/plan.md
# → Hỏi câu hỏi critical để validate assumptions

/plan red-team plans/260401-0900-google-oauth-auth/plan.md
# → Adversarial reviewers tìm lỗ hổng trong plan

Cách sử dụng Plan Validation & Red Team

`/plan validate {file}` — Validate plan

Gọi skill validation để hỏi câu hỏi critical về assumptions trong plan:

Có bỏ sót edge cases?
Dependencies đầy đủ?
Estimation thực tế?

/plan validate plans/260401-0900-google-oauth-auth/plan.md

`/plan red-team {file}` — Adversarial Review

Gọi red team tìm lỗ hổng, trade-offs chưa cân nhắc:

Architecture weakness?
Scope creep risks?
Performance concerns?

/plan red-team plans/260401-0900-google-oauth-auth/plan.md

Ví dụ thực tế

Input
Output

/plan "user authentication with Google OAuth"

plans/260401-0900-google-oauth-auth/
├── plan.md                          # Overview: 3 phases, 8 steps
├── phase-01-setup-oauth.md          # Phase 1: Setup Google OAuth
├── phase-02-auth-flow.md            # Phase 2: Auth flow + JWT
└── phase-03-ui-login.md             # Phase 3: Login UI

plan.md nội dung:
---
title: Google OAuth Authentication
status: planned
phases: 3
estimated: 4-6 hours
blocks: []
blockedBy: []
---

## Phase 1: Setup Google OAuth (2h)
- Cài đặt @google-cloud/oauth2-client
- Tạo OAuth credentials trên Google Console
- Config environment variables
- Files: auth.module.ts, google-oauth.strategy.ts

## Phase 2: Auth Flow + JWT (2h)
- Implement callback handler
- Generate JWT + refresh token
- Files: auth.service.ts, auth.controller.ts, jwt.strategy.ts

## Phase 3: Login UI (1h)
- Google Sign-In button component
- Redirect flow handling
- Files: LoginPage.tsx, GoogleButton.tsx

Tiếp theo: /cook plans/260401-0900-google-oauth-auth/plan.md

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

Tiêu chí	`/plan`	Chat trực tiếp
Research	Spawn agents song song tìm hiểu codebase	Không research, dựa vào context có sẵn
Cross-plan	Detect dependency giữa các plan	Không biết plan khác tồn tại
Scope challenge	Hỏi thách thức trước khi plan	Nhận task và làm ngay
Red team	Adversarial reviewer tìm lỗ hổng	Không có đối trọng
Output	Plan files persistent, có phases + file list	Text trả lời 1 lần, mất khi hết session
Handoff	Output cook command với absolute path	Phải copy-paste thủ công
Dependency tracking	`blockedBy`/`blocks` giữa plans	Không theo dõi

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

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

Sub-commands

Sub-command	Mô tả
`/plan "task"`	Plan chuẩn (auto-detect mode, skill tự chọn research depth)
`/plan validate {path}`	Validate plan với câu hỏi critical
`/plan red-team {path}`	Adversarial review plan đã tạo

Plan Review bổ sung (Persona-based)

Sau khi plan được tạo, có thể gọi thêm review từ các personas khác nhau:

Lệnh	Mô tả
`/plan-ceo-review`	CEO/founder review — tìm 10-star solution, business implications
`/plan-eng-review`	Eng manager review — lock execution plan, identify risks

Workflow ví dụ:

/plan "build payment integration with Stripe"
/plan-ceo-review        # CEO góc nhìn: market fit, timeline, competition
/plan-eng-review        # Eng manager góc nhìn: tech risk, resource planning
/cook                   # Implement

Lưu ý & Best Practices

Sai lầm phổ biến:

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
Skip CEO/Eng review cho high-stakes features → thiếu alignment

Tips từ team:

Skill auto-detects độ phức tạp; với task phức tạp, nó tự spawn researchers
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-ceo-review + /plan-eng-review cho features liên quan tới business/architecture

→ Xem thêm: Best Practices tổng hợp

Sau khi plan xong

Review plan

Đọc plan, kiểm tra:

Đúng requirements không?
Architecture hợp lý?
Steps đúng thứ tự?

Validate & Red Team (tùy chọn)

/plan validate path/to/plan.md    # Critical assumptions?
/plan red-team path/to/plan.md    # Adversarial review

Implement

/cook                  # Implement theo plan đã tạo

Chi tiết lệnh Plan (Accordion)

/plan — Plan với auto-detect depth

Prefix: /plan "task description"Tạo kế hoạch implementation chi tiết. Skill tự động detect độ phức tạp:

Task đơn giản (<20 từ) → skip scope challenge, minimal research
Task trung bình → spawn 1-2 researchers, optional red team
Task phức tạp (multi-file, arch change) → spawn 2+ researchers, red team bắt buộc

/plan "build user authentication with Google OAuth"

Output:

plans/260401-0900-google-oauth-auth/
├── plan.md
├── phase-01-*.md
├── phase-02-*.md
└── phase-03-*.md

Khi dùng: Mỗi lần cần implementation detail trước khi code. Feature mới, refactor lớn, architecture change.

/plan validate — Validate assumptions

Prefix: /plan validate {file.md}Hỏi câu hỏi critical để validate assumptions trong plan đã tạo:

Edge cases bị bỏ sót?
Dependencies đầy đủ?
Estimation thực tế?
Requirements rõ ràng?

/plan validate plans/260401-0900-google-oauth-auth/plan.md

Output: List câu hỏi + answers + refinements to plan.Khi dùng: Trước khi cook (bắt buộc với high-stakes features), hoặc khi nghi ngờ assumptions.

/plan red-team — Adversarial review

Prefix: /plan red-team {file.md}Gọi red team tìm lỗ hổng, trade-offs chưa cân nhắc:

Architecture weakness?
Scope creep risks?
Performance concerns?
Security holes?
Team alignment issues?

/plan red-team plans/260401-0900-google-oauth-auth/plan.md

Output: Red team report + list concerns + mitigation suggestions.Khi dùng: High-impact features, refactor toàn module, khi need outsider perspective.

/plan-ceo-review — CEO/founder perspective

Prefix: /plan-ceo-reviewCEO/founder review kế hoạch từ business angle:

Phù hợp business goals?
Timeline realistic?
Competition + market implications?
10-star solution hay safe incremental?

/plan "build payment integration with Stripe"
/plan-ceo-review

Output: Business-focused feedback + strategic recommendations.Khi dùng: Features ảnh tới revenue, pricing, market positioning. Large refactors.

/plan-eng-review — Eng manager perspective

Prefix: /plan-eng-reviewEng manager review kế hoạch từ execution angle:

Tech risk assessment?
Resource planning realistic?
Dependency lock-in?
Team readiness?

/plan "migrate from REST to GraphQL for order module"
/plan-eng-review

Output: Tech risk report + execution concerns + resource recommendations.Khi dùng: Large refactors, infrastructure changes, architectural decisions. Mid-level teams.

​Plan — Lập kế hoạch

​Cú pháp

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

​Lệnh Plan chính

​Sub-commands: Validate & Red Team

​Cách sử dụng Plan Validation & Red Team

​/plan validate {file} — Validate plan

​/plan red-team {file} — Adversarial Review

​Ví dụ thực tế

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

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

​Sub-commands

​Plan Review bổ sung (Persona-based)

​Lưu ý & Best Practices

​Sau khi plan xong

​Chi tiết lệnh Plan (Accordion)

Plan — Lập kế hoạch

Cú pháp

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

Lệnh Plan chính

Sub-commands: Validate & Red Team

Cách sử dụng Plan Validation & Red Team

`/plan validate {file}` — Validate plan

`/plan red-team {file}` — Adversarial Review

Ví dụ thực tế

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

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

Sub-commands

Plan Review bổ sung (Persona-based)

Lưu ý & Best Practices

Sau khi plan xong

Chi tiết lệnh Plan (Accordion)