📘 Guide vận hành

PHẦN 1 — GIỚI THIỆU & NGUYÊN TẮC

1.1 Bối cảnh và đối tượng áp dụng

Quy trình này dành cho một team ba người, mỗi người phụ trách một vai trò (BA, DEV, PM) và mỗi người vận hành một Claude Code riêng trên máy của mình. Ba con AI không nói chuyện trực tiếp với nhau — chúng chỉ giao tiếp qua các file có cấu trúc nằm trong repository.

Điểm cốt lõi của bản v2.0 là bổ sung một lớp đặc tả kiểm chứng được (spec) đứng giữa tài liệu nghiệp vụ (PRD) và code. Lớp này tồn tại để hiểu sai lộ ra sớm — sửa một dòng spec tốn năm phút, còn phát hiện đúng chỗ hiểu sai đó ở UAT thì tốn cả tuần.

1.2 Sáu nguyên tắc nền tảng

#Nguyên tắcÝ nghĩa thực tế
P1Repo là nguồn sự thật duy nhấtChưa nằm trong repo = chưa tồn tại.
P23 AI không nói chuyện với nhau — chúng giao tiếp qua fileMỗi Claude Code là một hòn đảo. Cầu nối duy nhất là artifact có cấu trúc.
P3Mã định danh xuyên suốt tới cấp ACFE-001-AC-03 chạy từ PRD → spec → issue → test → code → báo cáo.
P4Ranh giới ghiMỗi vai trò chỉ ghi trong vùng của mình. Ngoại lệ duy nhất: thư mục spec.
P5AI không được chốt yêu cầuMọi giả định ghi vào open-questions.md; chỉ con người xác nhận với khách hàng mới thành yêu cầu chính thức.
P6Hiểu sai phải lộ ra sớm nhất có thểLý do tồn tại của giai đoạn G3.