Appearance
Đặc tả Human Approval Gates
Version: 1.1
Date: 2026-11-21
Status: Working baseline
Đặt tên
Gate 1A / 1B / 1C / 4 / 5 là ID cổng phê duyệt của con người, không phải acronym tiếng Anh. Tên đầy đủ: 1A Requirements approval · 1B Architecture approval · 1C Implementation authorization · 4 QA verification · 5 Production release approval. Liên quan: D-0xx = Decision ID trong sổ quyết định kiến trúc (không phải Gate). Xem thêm 14-end-to-end-usage-guide.md §1.1 và /glossary.
| Gate | Tên đầy đủ | Gói bắt buộc | Quyết định của người | Kiểm tra tự động được phép | Không bao giờ tự động |
|---|---|---|---|---|---|
| 1A | Requirements approval | spec.md, nhật ký clarification, phạm vi, acceptance criteria (AC), NFR | Duyệt / từ chối / yêu cầu chỉnh | Độ đầy đủ, liên kết, schema, sinh checklist | Phê duyệt phạm vi nghiệp vụ hoặc yêu cầu |
| 1B | Architecture approval | plan.md, ADR, contracts, review bảo mật/dữ liệu/migration | Duyệt / từ chối / yêu cầu chỉnh | Kiểm Constitution, lint, sơ đồ/liên kết | Phê duyệt kiến trúc/bảo mật/dữ liệu trọng yếu |
| 1C | Implementation authorization | tasks.md, dependency graph, ownership task, kế hoạch test/rollback | Ủy quyền Implementation | Kiểm dependency, truy vết task, kiểm cấu hình CI | Bắt đầu coding trước khi có ủy quyền tường minh |
| 4 | QA verification | Báo cáo test, ma trận chấp nhận, defects, báo cáo Analyze/Converge | QA ký PASS/FAIL; Owner chấp nhận/từ chối bàn giao | Automated tests, ngưỡng coverage, static analysis | Coi Converge như software testing hoặc miễn defects Critical |
| 5 | Production release approval | Commit SHA, CI, kế hoạch deploy/rollback, monitoring, change window | Duyệt / hoãn / từ chối Production release | Build, ký artifact, kiểm chính sách, staging smoke tests | Deploy production khi chưa có ủy quyền release tường minh |
Đóng gói chat với Owner (tiếng Việt, một câu mỗi lượt)
Khi trình bày Gate 1A / 1B / 1C / 4 (Owner acceptance) / 5 hoặc mục QA cần Owner confirm, Orchestrator phải theo 13-documentation-language.md § Owner Gate / QA trong chat:
- Chat với Owner bằng tiếng Việt (thuật ngữ chuyên ngành giữ English).
- Một câu hỏi mỗi lượt; đầu vòng nêu tổng
N; mỗi câu ghi tiến độk/N+ số còn lại; ≥3 lựa chọn; đề xuất của Agent + lý do (không bắt buộc đúng wording nhãn); Owner có thể trảOK/YESđể nhận đề xuất. - Sau câu trả lời, cập nhật SoT dưới
docs//specs/, rồi hỏi câu tiếp nếu cần. - Kèm tóm tắt tiếng Việt ngắn về nội dung đang duyệt, plus path artifact English và commit SHA.
- Vẫn ghi bản ghi phê duyệt bền vững sau quyết định (dưới đây).
- Không tự
git commit; chỉ gợi ý nhánh + message khi cần (platform-airule30-git-and-worktrees).
Schema bản ghi phê duyệt
Mỗi bản ghi dưới .minap/work-items/<id>/approvals/ phải có: Gate ID, work item ID, quyết định, danh tính người phê duyệt, timestamp/timezone, commit SHA, đường dẫn artifact chính xác và hash SHA-256, điều kiện/ngoại lệ, lý do, supersedes (nếu có). Chỉ phản hồi chat không phải bản ghi bền vững; Orchestrator ghi quyết định và nhờ Owner xác minh bản ghi. Lưu bằng chứng phê duyệt qua protected PR/environment của Git host đã chọn khi có sẵn.
Làm mất hiệu lực phê duyệt
Thay đổi trọng yếu trên artifact đã phê duyệt làm mất hiệu lực Gate liên quan. Orchestrator đánh dấu REAPPROVAL_REQUIRED, chặn implement/release phía sau, và yêu cầu quyết định mới từ người. Sửa typo thuần túy có thể không cần phê duyệt lại chỉ khi không đổi nghĩa; phải ghi nhận phần sửa.