Claude Code Plan Mode as Default (Stage 2: Design)

1. Những thay đổi: Plan Mode

Kỹ sư bắt đầu phiên làm việc với Claude Code trong Plan Mode, cung cấp cho Claude bản spec.md đã được phê duyệt từ Stage 2: Design, và để Claude phỏng vấn làm rõ, lặp lại việc tinh chỉnh kế hoạch cho đến khi hoàn toàn hài lòng.

2. Sơ đồ Lifecycle Plan Mode & Giao thức Two Human Gates

Trong kiến trúc AI-Native SDLC, các cơ chế kiểm soát được tổ chức thành Approval Gates (cổng phê duyệt của con người), triển khai thông qua giao thức Two Human Gates (Gate 1 duyệt kế hoạch trước khi sinh code, Gate 2 nghiệm thu kiểm thử trước khi land):

Giao thức Two Human Gates thiết lập 2 điểm kiểm soát cốt lõi:

• Gate 1 (Approve Plan - Duyệt kế hoạch trước khi sinh code): Điểm dừng số một trước khi chạm vào mã nguồn. Kỹ sư rà soát các file thay đổi, rủi ro và các bài kiểm thử. Chỉ khi kế hoạch được phê duyệt và commit thành plan.md, agent mới được cấp quyền sửa đổi file.
• Autonomous Execution: Giữa Gate 1 và Gate 2, agent tự chủ lập trình và chạy test trong Auto Mode mà không gián đoạn bằng câu hỏi nhỏ lẻ.
• Gate 2 (Accept Verification - Nghiệm thu kiểm thử trước khi land): Điểm dừng số hai trước khi tích hợp vào nhánh chính. Kỹ sư nghiệm thu bằng chứng xác thực (unit tests, output, screenshots) trước khi tạo PR và merge code.

3. Các bước thực thi: 7 bước lập kế hoạch

Quy trình 7 bước làm việc với Plan Mode:

4. Cấu trúc mẫu chuẩn của plan.md

Cấu trúc chuẩn của một tệp plan.md theo nguyên tác:

# Plan: claims status self-service (from intent.md 2026-06-02)

## Files that change
portal/src/claims/StatusPanel.tsx (new), claims-api/routes/status.py, claims-api/tests/test_status.py

## Order of work
1. Add the status endpoint behind existing auth.
2. Panel against the endpoint.
3. Wire into the portal nav.

## Risks
The claims-core API rate-limits at 50 rps; the panel must cache.

## Proof
test_status.py covers the four claim states; screenshot matches the approved mock.

Bản kế hoạch gồm 4 phần kỹ thuật cốt lõi:

• Files that change: Danh sách chính xác file thêm mới hoặc chỉnh sửa.
• Order of work: Trình tự thực thi logic từ thêm endpoint auth, tạo panel giao diện, đến gắn navigation.
• Risks: Cảnh báo rủi ro cụ thể (rate limit 50 rps của claims-core API) và giải pháp bắt buộc (caching).
• Proof: Tiêu chí nghiệm thu rõ ràng (unit test bao phủ 4 trạng thái, screenshot khớp mock đã duyệt).

5. Claude Code in Auto Mode

Claude Code có thể chạy trong Auto Mode: kỹ sư tương tác và phê duyệt kế hoạch, sau đó Claude tự động áp dụng từng thay đổi mà không cần prompt hỏi ý kiến sau mỗi lần chỉnh sửa (per-edit prompt).

Trọng tâm làm việc chuyển dịch từ việc người dùng ngồi quan sát agent thực hiện từng chỉnh sửa sang việc review các artifact sau những phiên làm việc tự chủ dài hơn. Auto Mode còn thúc đẩy khả năng làm việc song song giữa các cá nhân và toàn đội ngũ khi kết hợp với Git Worktrees, đồng thời là nền tảng cốt lõi để vận hành SDLC một cách tự chủ và khép kín vòng lặp như được mô tả trong Stage 6: Maintain.

6. Hệ thống kế thừa & Source of Truth

Các quy trình SDLC hiện tại có thể đã theo dõi các artifact, chỉ là không lưu dưới dạng tệp Markdown: hạng mục công việc nằm trên Jira, yêu cầu nghiệp vụ nằm trong công cụ có sẵn khả năng truy vết quy chuẩn (regulatory traceability), bản vẽ nằm trên Figma, và phê duyệt thay đổi thông qua hội đồng quản lý thay đổi. Những hệ thống này rất khó thay thế vì các đơn vị kiểm toán và cơ quan quản lý đã chấp nhận chúng, và các đội nhóm khác phụ thuộc vào chúng. Do đó, AI-Native SDLC phải thích ứng linh hoạt xung quanh những gì đang tồn tại.

Đối với mỗi artifact được tạo ra, một hệ thống cần được chỉ định là Source of Truth (Nguồn sự thật duy nhất), và các hệ thống còn lại sẽ lưu một bản sao hoặc đường liên kết. Có 3 mô hình cấu hình có thể thiết lập:

Cả hệ thống kế thừa và hệ thống ưu tiên Markdown của AI-Native SDLC đều có thể cùng tồn tại miễn là có liên kết giữa hai bên hoặc một bên được tuyên bố rõ ràng là Source of Truth.

7. Kiểm soát & Đo lường hiệu quả

Review thiết kế diễn ra trước khi bất kỳ dòng mã nguồn nào được sinh ra, khi việc thay đổi hướng đi vẫn chỉ là sửa đổi một văn bản. Plan Mode tự động thực thi quy tắc này, bởi Claude không thể chỉnh sửa file cho đến khi kỹ sư chấp thuận kế hoạch. Kế hoạch và các bản sửa đổi của nó được ghi nhận vào nhật ký kiểm toán (audit trail) kèm theo danh tính người đã phê duyệt. Các thay đổi thông thường do kỹ sư phê duyệt; mọi thay đổi mà tổ chức phân loại là rủi ro cao hơn sẽ chuyển lên tech lead hoặc architect phê duyệt.