Nguyên tắc 2: AI-Assisted

AI làm phần lặp lại; con người giữ phần quyết định.

Ranh giới

AI hợp với việc có khuôn rõ: CRUD, mapping, boilerplate, rename, extract method, sinh test theo AC có sẵn, viết doc từ code và spec, viết adapter.

AI KHÔNG nên tự quyết những thứ có hệ quả business lớn: chính sách refund, hạn mức tín dụng, quyền truy cập dữ liệu, trade-off kiến trúc lớn, rule liên quan pháp lý/tiền bạc. AI có thể đề xuất, nhưng con người phải quyết.

Hai câu chuyện cạnh nhau

• Thắng: Trang đưa /specs/entities.md cho Claude Code → 30 phút có controller/service/test cho 12 entity; một buổi review sửa vài relationship. Việc 2 tuần rút còn ~1 ngày.
• Thua: Tú nhờ AI viết rule refund “hủy trong 24h refund 100%, sau đó 50%“. Không ai kiểm lại. 3 tuần sau kế toán phát hiện rule thật khác hẳn (sau 24h không refund, trừ khi chưa shipping). Team mất tiền thật.

Cách áp dụng

Trong sprint planning, chia task hai nhóm:

• AI-driven: pattern rõ, ít rủi ro nghiệp vụ.
• Human-driven, AI-assisted: cần con người quyết, AI chỉ hỗ trợ.

Khi review code business-critical, hỏi thẳng: “Rule này đến từ spec nào?” - không trả lời được thì đừng merge. (Vai trò dev lúc này gọi là AI Conductor: đưa spec, đưa context, kiểm tra kết quả, giữ quyết định quan trọng - không chỉ “prompt rồi merge”.)

Liên quan

• Sáu nguyên tắc Spec-Driven - nguyên tắc số 2
• Port và Adapter - vùng lý tưởng để giao cho AI
• Vai trò trong SDD - dev như người dẫn việc cho AI
• Test-Protected - điểm tựa để AI làm mà không lệch