Cook — Implement tính năng

Implement tính năng đầy đủ end-to-end: plan (nếu chưa có) → code → test → review → docs → commit.

Cú pháp

/cook "mô tả feature"           # Implement đầy đủ (interactive)
/cook:auto "mô tả feature"      # Auto-plan + implement
/cook:auto:fast "mô tả feature" # Nhanh nhất, minimal planning
/cook:auto:parallel "mô tả"     # Parallel phases + fullstack agents
/cook                            # Implement theo plan đã tạo trước đó

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

Khi bạn gõ /cook "platform listing page", đây là 7 bước xảy ra:

Bước 1: Intent Detection

Phân tích input để detect mode:

Có path tới plan.md? → mode code (execute plan)
Chứa “fast”, “quick”? → mode fast
Chứa “trust me”, “auto”? → mode auto
Liệt kê 3+ features? → mode parallel
Mặc định → mode interactive (có review gates)

Bước 2: Research (skip nếu fast/code mode)

Spawn researcher agents song song để tìm hiểu codebase. Dùng /scout hoặc /scout:ext tìm files liên quan. Review Gate: Hỏi user approve findings trước khi plan.

Bước 3: Plan

planner subagent tổng hợp research và tạo plan. Nếu có UI work → spawn ui-ux-designer subagent. Review Gate: Hỏi user approve plan trước khi code.

Bước 4: Implement

coder subagent viết code theo plan. Chạy typecheck + compile để đảm bảo không lỗi cú pháp. Review Gate: Hỏi user approve code trước khi test.

Bước 5: Test (skip nếu --no-test)

tester subagent viết và chạy tests. Nếu fail → debugger subagent tìm root cause → fix → re-test. Gate: 100% tests phải PASS mới tiếp.

Bước 6: Code Review

code-reviewer subagent review code. Nếu có critical issues → fix → re-test. Auto-approve nếu score >= 9.5 và 0 critical (chỉ auto mode).

Bước 7: Finalize (LUÔN chạy, không skip)

project-manager subagent → sync-back tất cả completed steps vào plan.md
docs-manager subagent → cập nhật ./docs/ nếu cần
Hỏi user commit qua git-manager subagent
Viết journal entry

Hard Gate: KHÔNG được viết code nếu chưa có plan và chưa được review. Dù task có đơn giản đến đâu, phải plan trước.

Ví dụ thực tế

Input
Output — Files tạo ra

/cook "Tạo trang listing platforms với search, filter category, pagination"

Bước 1: Intent detected → interactive mode
Bước 2: 3 researcher agents scouted: 42 files mapped
Bước 3: Plan created → plans/260401-platform-listing/

Bước 4: Files implemented:
├── src/app/(public)/platforms/page.tsx         # Page component
├── src/app/(public)/platforms/loading.tsx       # Loading skeleton
├── src/components/platforms/PlatformCard.tsx    # Card component
├── src/components/platforms/PlatformFilter.tsx  # Filter sidebar
├── src/components/platforms/SearchBar.tsx       # Search input
├── src/lib/api/platforms.ts                     # API client
├── src/lib/hooks/use-platforms.ts               # TanStack Query hook
└── src/types/platform.ts                        # TypeScript types

Bước 5: 18 tests written, 18 PASS
├── src/__tests__/platforms/PlatformCard.test.tsx
├── src/__tests__/platforms/PlatformFilter.test.tsx
└── src/__tests__/platforms/page.test.tsx

Bước 6: Code review score 9.2/10, 0 critical
Bước 7: Docs updated, plan synced, ready to commit

4 Chế độ Cook

/cook (interactive — mặc định)
/cook:auto
/cook:auto:fast
/cook:auto:parallel

Implement đầy đủ với review gates ở mỗi bước. User approve trước khi tiếp.

/cook "implement user profile page with edit functionality"

Thời gian: 5-15 phút. Tốt cho: Feature quan trọng, cần kiểm soát chặt.

Auto-approve nếu score cao. Không dừng lại hỏi (trừ khi có vấn đề).

/cook:auto "add dark mode toggle to settings"

Thời gian: 3-10 phút. Tốt cho: Feature rõ requirements, trust automation.

Nhanh nhất. Skip research, minimal planning, code ngay.

/cook:auto:fast "fix button alignment on mobile"

Thời gian: 1-5 phút. Tốt cho: Task nhỏ, fix nhanh, config.

Plan parallel phases + execute với nhiều fullstack-developer agents đồng thời.

/cook:auto:parallel "implement auth + profile + settings modules"

Thời gian: 5-15 phút. Tốt cho: Nhiều modules độc lập, cần nhanh.

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

Tiêu chí	`/cook`	Chat trực tiếp
Planning	Bắt buộc plan trước (Hard Gate)	Có thể code thẳng, bỏ plan
Testing	Bắt buộc viết tests, 100% PASS mới tiếp	Có thể bỏ qua tests
Code Review	Bắt buộc code-reviewer subagent	Không có review tự động
Documentation	Tự động cập nhật docs	Phải nhắc thủ công
Anti-rationalization	Chặn lý do bỏ qua: “quá đơn giản”, “tôi biết cách rồi”	Không có cơ chế chặn
Agents	7+ agents phối hợp	1 Claude instance
Finalize	3 subagents: project-manager + docs-manager + git-manager	Phải làm thủ công

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

Dùng	Không dùng
Implement tính năng mới	Sửa bug (dùng `/fix`)
Task có plan sẵn từ `/plan`	Chỉ muốn hỏi kiến trúc (dùng `/plan`)
Cần output đầy đủ: code + test + review	Thay đổi 1-2 dòng config
Feature cần nhiều files	Chạy tests (dùng `/test`)

Sub-commands

Sub-command	Mô tả	Khi nào dùng
`/cook "task"`	Implement interactive (có review gates)	Feature quan trọng
`/cook:auto "task"`	Auto-approve, không hỏi	Feature rõ ràng, tin tưởng
`/cook:auto:fast "task"`	Nhanh nhất, skip research	Task nhỏ, fix styling
`/cook:auto:parallel "task"`	Parallel fullstack agents	Nhiều modules độc lập

Bảng mode chi tiết

Mode	Research	Testing	Review Gates	Phase Progression
interactive	Có	Có	User approve mỗi bước	Tuần tự
auto	Có	Có	Auto nếu score >= 9.5	Liên tục
fast	Không	Có	User approve mỗi bước	Tuần tự
parallel	Tùy chọn	Có	User approve mỗi bước	Song song
no-test	Có	Không	User approve mỗi bước	Tuần tự
code	Không	Có	User approve mỗi bước	Theo plan

Workflow khuyên dùng

Plan trước

/plan "mô tả tính năng"

Review plan

Đọc và chỉnh sửa nếu cần.

Cook

/cook

Verify

/qa-full:check           # Kiểm tra tests
# hoặc
/qa-full:tdd:verify      # Nếu dùng TDD

Lưu ý & Best Practices

Sai lầm phổ biến:

Dùng /cook:auto cho task phức tạp → bỏ qua review gates, code sai hướng
Skip plan (“code luôn cho nhanh”) → implement sai, phải rewrite
Không đọc plan trước khi cook → implement thiếu hoặc thừa
Bỏ test phase → bugs lọt vào staging, QC reject

Tips từ team:

/cook --interactive (default) cho mọi feature quan trọng
/cook:auto:fast chỉ cho task nhỏ, rõ ràng, ít rủi ro (typo fix, config change)
Luôn đọc và confirm plan trước khi approve implementation
Nếu cook bị stuck → /clear rồi /cook path/to/plan.md để resume

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

Bắt buộc Subagents (MANDATORY)

Phase	Subagent	Bắt buộc?
Research	`researcher`	Tùy mode
Scout	`ck:scout`	Tùy mode
Plan	`planner`	Tùy mode
UI Work	`ui-ux-designer`	Nếu có frontend
Testing	`tester`, `debugger`	PHẢI spawn
Review	`code-reviewer`	PHẢI spawn
Finalize	`project-manager`, `docs-manager`, `git-manager`	PHẢI spawn cả 3

Bắt đầu

Quan trọng

Tham khảo

Dev — Bắt đầu

Dev — Lệnh chính

Dev — Nâng cao

QA — Bắt đầu

QA — Use Cases

PM

DevOps

UI/UX Design

Marketing

Cook

Cook — Implement tính năng

Cú pháp

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

Ví dụ thực tế

4 Chế độ Cook

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

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

Sub-commands

Bảng mode chi tiết

Workflow khuyên dùng

Lưu ý & Best Practices

Bắt buộc Subagents (MANDATORY)

Bắt đầu

Quan trọng

Tham khảo

Dev — Bắt đầu

Dev — Lệnh chính

Dev — Nâng cao

QA — Bắt đầu

QA — Use Cases

PM

DevOps

UI/UX Design

Marketing

​Cook — Implement tính năng

​Cú pháp

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

​Ví dụ thực tế

​4 Chế độ Cook

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

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

​Sub-commands

​Bảng mode chi tiết

​Workflow khuyên dùng

​Lưu ý & Best Practices

​Bắt buộc Subagents (MANDATORY)

Cook — Implement tính năng

Cú pháp

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

Ví dụ thực tế

4 Chế độ Cook

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

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

Sub-commands

Bảng mode chi tiết

Workflow khuyên dùng

Lưu ý & Best Practices

Bắt buộc Subagents (MANDATORY)