📘 Guide vận hành

PHẦN 7 — VẬN HÀNH HẰNG NGÀY

7.1 Nhịp vận hành

NhịpThời điểmAiNội dungThời lượng
Daily sync9:00 hằng ngày3 ngườiHôm qua / hôm nay / vướng gì15 phút
Spec reviewKhi có MR specBA + DEVDuyệt từng AC, đóng câu hỏi phát sinh30–45 phút
GroomingThứ BaBA + DEVĐọc trước PRD sắp tới, chốt hướng60 phút
Sprint planningThứ Hai đầu sprint3 ngườiChốt scope, chạy /dor-check60 phút
Demo nội bộThứ Năm3 ngườiDEV demo, PM test thử30 phút
Weekly reportThứ Sáu chiềuPM/weekly, gửi khách hàng45 phút
Sprint review + retroCuối sprint3 ngườiNhìn số liệu, chỉnh quy trình90 phút

Spec review không xếp lịch cố định — chạy ngay khi DEV mở MR spec. Để dồn tới buổi họp tuần sẽ chặn DEV mất nhiều ngày. Sprint 2 tuần: team 3 người mà sprint 1 tuần thì không đủ để một feature đi hết bảy giai đoạn.

7.2 Luật cứng cho AI

Đưa nguyên khối này vào CLAUDE.md gốc:

  1. Không tự chốt yêu cầu. Giả định ghi vào open-questions.md, không viết thẳng vào PRD hay spec như thể đã xác nhận.
  2. Không ghi ngoài vùng của mình (Phần 2.3). Ngoại lệ duy nhất: DEV được ghi trong 02-requirements/spec/, qua MR.
  3. Không sửa file `status: baselined` hoặc `status: approved` nếu chưa có CR.
  4. Không sửa nội dung `00-inbox/` — bằng chứng gốc.
  5. Không code khi spec chưa `approved`.
  6. Mọi AC phải có mã. Spec thiếu mã là spec không dùng được.
  7. Luôn trích dẫn nguồn. Mỗi Business Rule và mỗi mục spec ghi rõ nguồn.
  8. Không đưa dữ liệu thật của khách hàng vào ví dụ, test data hay commit message.
  9. Không commit secret.
  10. Không chạy lệnh phá hủy dữ liệu trên bất kỳ môi trường nào.
  11. Phát hiện mâu thuẫn giữa tài liệu và code → dừng, báo cáo, không tự chọn bên nào đúng.
  12. Khi không chắc, hỏi. Một câu hỏi tốn 5 phút; một giả định sai tốn 5 ngày.

7.3 Lộ trình triển khai

TuầnViệc làmTiêu chí thành công
1Dựng repo, CLAUDE.md, 3 file role, scoped label3 người clone được, AI đọc được luật
2Chạy G0→G2 với 1 feature nhỏ. Chưa có spec, chưa đo lường1 PRD baseline, mọi AC đã có mã
3Thêm G3. DEV sinh spec đầu tiên, BA duyệt1 spec approved, thấy được câu hỏi phát sinh
4Thêm G4–G5. Test đặt tên theo AC, chạy /trace thủ công1 feature đi hết vòng, AC coverage 100%
5Đưa /trace vào CI. Bật G6, báo cáo tuần đầu tiênPipeline fail khi thiếu test, báo cáo < 45 phút
6–7Retro, cắt bỏ thứ không dùngQuy trình còn lại là thứ team thật sự dùng

Đừng bật spec ngay tuần đầu. Team cần cảm nhận được nỗi đau "DEV hiểu sai yêu cầu" ít nhất một lần thì mới thấy giai đoạn G3 đáng công.

Dấu hiệu quy trình đang sai: nếu ai đó phải làm việc gì đó "chỉ để cho đúng quy trình" mà không tạo ra giá trị, bỏ bước đó trong retro.

7.4 Điểm dễ hỏng

Triệu chứngNguyên nhân gốcCách xử lý
Spec chỉ là bản chép lại PRDDEV làm cho có, AI sinh xong không ràKiểm mục "trường hợp biên" — chép lại thì mục này rỗng
BA duyệt spec qua loaCoi là thủ tục, không phải điểm chốtĐưa spec review thành buổi họp có mặt hai người, không duyệt qua comment
Spec trôi khỏi PRD sau CRQuên cập nhật spec khi PRD lên versionKiểm trường prd_baseline trong CI
AC coverage 100% nhưng vẫn lỗiTest có tên đúng nhưng assert saiScript không thay được review
DEV liên tục hỏi lại BA giữa chừngSpec chưa đủ, hoặc bỏ qua G3Siết DoR
PRD và code lệch nhauSửa PRD không tag baselineBắt buộc link issue → PRD ở tag cụ thể
Số liệu PM không khớp thực tếDEV không /spend hằng ngàyĐưa vào DoD, kiểm ở daily
3 AI cho kết quả mâu thuẫnglossary.md thiếuĐầu tư vào glossary — rẻ nhất, hiệu quả nhất
Scope phình mà không ai biếtCR bị bỏ qua khi khách hàng "nhờ tí"Mọi thay đổi sau baseline đều phải có CR