Workflow chuẩn Explore→Plan→Code→Commit + phỏng vấn ngược + 4 lỗi code AI
Best practice chính thức của Anthropic cho thay đổi không tầm thường, kèm kỹ thuật phỏng vấn ngược và 4 lỗi cần soi khi review code AI.
📖 Đây là best practice chính thức của Anthropic, đặc biệt cho thay đổi không tầm thường:
- Explore: "Đọc các file liên quan đến [tính năng X], chưa sửa gì." Codebase lớn → "Dùng subagent Explore khảo sát hệ thống auth" (subagent có context riêng, không làm "đầy bộ nhớ" phiên chính).
- Plan: nhấn Shift+Tab vào Plan mode — Claude chỉ đề xuất kế hoạch, không sửa file. Bài toán khó → thêm từ khoá tăng độ suy nghĩ:
think < think hard < ultrathink. Đọc kỹ plan, chỉnh đến khi ưng — plan là điểm can thiệp rẻ nhất. 💬 Kỹ thuật "phỏng vấn ngược" (cho tính năng lớn/mơ hồ): "Trước khi lập plan hay viết code, hãy phỏng vấn tôi một cách hệ thống về: yêu cầu kỹ thuật, đặc tả tính năng, quyết định UI, data model, và các trade-off tôi nên cân nhắc. Chưa phỏng vấn xong thì chưa lập plan." — Claude sẽ lộ ra những quyết định bạn chưa từng nghĩ tới, trước khi chúng biến thành code sai. - Code: duyệt plan cho Claude thực thi. Sai hướng → Esc để dừng, hoặc
/rewindquay lại trạng thái trước — đừng cố "vá" bằng cách cãi nhau. - Commit: "Stage các file liên quan, viết commit theo Conventional Commits, cho tôi xem message trước." Claude đọc
git diffthật để viết message. Tạo PR: "Tạo PR lên nhánh develop, mô tả thay đổi và cách test." (cầnghCLI).
Kỹ thuật đi kèm
- TDD với Claude (pattern mạnh nhất): "Viết test cho [hành vi] trước, xác nhận test FAIL, rồi mới implement cho pass. Không mock để lách test." Test = tiêu chí khách quan để Claude tự kiểm chứng.
- Quản lý context: phiên dài làm Claude "quên".
/contextxem mức chiếm dụng,/compactnén tóm tắt,/clearlàm mới khi đổi chủ đề. - Course correction sớm: thấy sai ở bước 2/10 thì dừng ngay ở bước 2.
- 4 lỗi điển hình của code AI — soi đúng chỗ khi review: (1) API hallucination: gọi hàm/tham số/version thư viện không tồn tại hoặc đã đổi — hay gặp nhất với thư viện tiến hóa nhanh; (2) bỏ sót edge case: happy path đúng nhưng input rỗng/null/lỗi mạng chưa xử lý; (3) lỗ hổng bảo mật vượt qua được kiểm tra bằng mắt (injection, sanitize thiếu, credential sai chỗ); (4) "confident incorrectness": giọng tự tin KHÔNG phải chỉ báo về độ đúng.
- Quy tắc vàng: PR mang tên bạn = trách nhiệm của bạn, dù ai/AI nào viết. Mọi code AI đều qua review người.
🏋️ Bài tập 3.3: Chọn 1 bug nhỏ trong backlog, xử lý trọn vòng Explore→Plan→Code→Commit, kèm 1 test tái hiện bug. Ghi lại thời gian so với cách làm thường.