QuotaCheap Playbook

Cursor Plan Mode và Debug Mode: khi nào nên lập kế hoạch, khi nào cần runtime evidence

Tìm hiểu Cursor Plan Mode và Debug Mode theo docs chính thức: khi nào lập kế hoạch, khi nào debug runtime, reproduction steps, logs, tests và workflow veri…

Plan Mode giúp Agent nghĩ trước khi sửa nhiều file. Debug Mode giúp xử lý bug cần reproduction, logs và runtime instrumentation. Dùng đúng mode để giảm diff rác.

Hướng dẫn Cursor Plan Mode và Debug Mode theo docs chính thức: use cases, switching modes, planning complex work, reproducing bugs, expected vs actual behavior, logs, performance issues và workflow verify trước khi merge.

Cursor Agent không chỉ có một kiểu chạy.

Với task đơn giản, bạn có thể yêu cầu Agent sửa thẳng.

Nhưng với task phức tạp hoặc bug khó, sửa ngay thường là cách tạo diff rác nhanh nhất.

Cursor Docs có hai mode rất đáng dùng đúng lúc: Plan Mode và Debug Mode.

Plan Mode dùng để thiết kế approach trước khi code.

Debug Mode dùng khi bug cần runtime evidence: reproduction steps, logs, instrumentation, timing hoặc profiling.

Hai mode này giải quyết hai loại mù khác nhau.

Plan Mode xử lý mù về kiến trúc.

Debug Mode xử lý mù về hành vi khi chạy.

Bài này giải thích khi nào dùng từng mode, cách prompt và cách đưa output của agent vào workflow review.

Theo Cursor Docs, Plan Mode giúp Agent lập kế hoạch trước khi thực hiện.

Nó phù hợp với complex features có nhiều approach hợp lý, task chạm nhiều files/systems, requirement chưa rõ, hoặc architectural decisions cần review.

Plan Mode không phải thủ tục cho sang.

Nó là brake pedal.

Khi bạn chưa biết cách sửa tốt nhất, đừng để agent đoán bằng cách edit file.

Hãy để agent đọc repo, map source, phân tích options, rồi đề xuất plan.

Dùng Plan Mode cho: Feature mới ảnh hưởng frontend, backend, database và webhook.

Refactor code path nhiều service đang dùng.

Migration framework hoặc API contract.

Thiết kế logging/observability cho agent workflow.

Thay đổi billing, auth, permission hoặc data retention.

Không cần Plan Mode cho: Sửa typo.

Đổi copy một component.

Fix lint đơn giản.