Phần 7 của 5140% hoàn thành

Plan mode — lên kế hoạch trước khi code

English title: Plan Mode — Plan Before You Code

Bài 7 trong chuỗi 15 bài hướng dẫn Cursor. Feature phức tạp hoặc nhiều file: đừng code ngay — hãy Plan trước, code sau. Plan mode trong Cursor cho phép AI research codebase, đặt câu hỏi làm rõ (clarifying questions), và tạo ra kế hoạch từng bước (step-by-step plan) mà bạn có thể chỉnh sửa trước khi để Agent thực hiện. Bài này hướng dẫn khi nào và cách dùng Plan mode.

Mở đầu: Feature phức tạp — Plan trước, code sau

Bạn nói: "Thêm tính năng export dữ liệu ra CSV cho toàn bộ module report." Module report có nhiều file, nhiều API, và bạn chưa chắc nên đặt logic ở đâu, cần sửa những file nào. Nếu bảo Agent "làm luôn", Agent có thể đoán và sửa rải rác. Plan mode giúp: AI đọc codebase, có thể hỏi lại bạn ("Export theo filter hiện tại hay toàn bộ?", "CSV có cần header không?"), rồi đưa ra danh sách bước (vd. 1. Thêm endpoint export, 2. Thêm nút Export trong UI, 3. Viết test). Bạn xem plan, sửa nếu cần, rồi mới cho Agent thực hiện từng bước. Kết quả kiểm soát được hơn.

1. Đi sâu: Plan mode làm gì

Tại sao chủ đề này quan trọng: Code trước khi hiểu rõ scope và cấu trúc codebase dễ dẫn đến thiếu bước, sửa sai chỗ, hoặc phải làm lại. Plan mode buộc bước "research + làm rõ + outline" trước khi thực thi.

Hiểu sai thường gặp: Nhiều người nghĩ "Plan mode = chỉ ra một list chung chung". Thực tế Plan mode (theo Cursor) research codebase và có thể hỏi lại bạn — plan sinh ra thường sát với cấu trúc project.

Bản chất đúng: Plan mode = chế độ trong Cursor (có thể trong Composer hoặc CLI) khi AI: (1) research codebase (tìm file liên quan, đọc cấu trúc), (2) đặt câu hỏi làm rõ nếu cần, (3) tạo document/outline từng bước. Output là plan có thể chỉnh sửa; sau đó user có thể trigger Agent thực hiện theo plan (từng bước hoặc cả cụm tùy Cursor).

2. Khái niệm

Plan mode: Chế độ "lên kế hoạch" trước khi code; AI không (hoặc chưa) sửa file mà tạo ra kế hoạch chi tiết. Tham khảo Cursor Docs và Cursor Learn để xác nhận cách bật và dùng.
Research codebase: AI đọc và tìm kiếm file/folder liên quan đến mô tả feature để đưa ra plan sát với code hiện tại.
Clarifying questions: Câu hỏi AI đặt lại để làm rõ yêu cầu (vd. "Validation áp dụng cho field nào?", "Có cần support nhiều format export không?").

3. Workflow: Dùng Plan mode

Mô tả feature — Ví dụ: "Thêm export CSV cho màn report, theo filter hiện tại."
Bật Plan mode (theo hướng dẫn Cursor — có thể là tùy chọn trong Composer hoặc CLI).
AI research + hỏi (nếu cần) — AI đọc codebase, có thể hỏi bạn vài câu. Bạn trả lời để scope rõ.
Nhận plan — AI đưa ra danh sách bước (có thể dạng outline hoặc checklist). Bạn đọc, sửa nếu thiếu/thừa.
Thực hiện — Trigger Agent thực hiện theo plan (từng bước hoặc cả cụm). Bạn review diff từng bước (bài 13).

4. Khi nào dùng Plan mode

Feature nhiều file, chưa rõ cấu trúc — Plan trước để không bỏ sót hoặc sửa sai chỗ.
Cần align với team — Plan = tài liệu trao đổi: "AI đề xuất các bước này, mọi người có ý kiến không?" rồi mới code.
Task nhỏ, một hai file rõ ràng — Có thể không cần Plan; dùng Agent trực tiếp.

5. Ứng dụng

Sau bài này bạn đã biết: Plan mode = research + làm rõ + outline trước khi code; phù hợp feature lớn. Bài tiếp: Rules — hướng dẫn AI theo dự án và cá nhân, không cần nhắc mỗi lần.

Bài tiếp: Rules — hướng dẫn AI theo dự án và cá nhân (bài 8).