Skip to content

Đặ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.

GateTên đầy đủGói bắt buộcQuyết định của ngườiKiểm tra tự động được phépKhông bao giờ tự động
1ARequirements approvalspec.md, nhật ký clarification, phạm vi, acceptance criteria (AC), NFRDuyệt / từ chối / yêu cầu chỉnhĐộ đầy đủ, liên kết, schema, sinh checklistPhê duyệt phạm vi nghiệp vụ hoặc yêu cầu
1BArchitecture approvalplan.md, ADR, contracts, review bảo mật/dữ liệu/migrationDuyệt / từ chối / yêu cầu chỉnhKiểm Constitution, lint, sơ đồ/liên kếtPhê duyệt kiến trúc/bảo mật/dữ liệu trọng yếu
1CImplementation authorizationtasks.md, dependency graph, ownership task, kế hoạch test/rollbackỦy quyền ImplementationKiểm dependency, truy vết task, kiểm cấu hình CIBắt đầu coding trước khi có ủy quyền tường minh
4QA verificationBáo cáo test, ma trận chấp nhận, defects, báo cáo Analyze/ConvergeQA ký PASS/FAIL; Owner chấp nhận/từ chối bàn giaoAutomated tests, ngưỡng coverage, static analysisCoi Converge như software testing hoặc miễn defects Critical
5Production release approvalCommit SHA, CI, kế hoạch deploy/rollback, monitoring, change windowDuyệt / hoãn / từ chối Production releaseBuild, ký artifact, kiểm chính sách, staging smoke testsDeploy 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-ai rule 30-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.

docs/ = SoT duy nhất · văn xuôi tiếng Việt + thuật ngữ chuyên ngành English