@damphuquy/agent-init 2.2.0 → 3.0.0

package/templates/vi/process/_seeds/plan-template.md.seed

@@ -109,11 +109,11 @@
 <!-- Được điền trong và sau giai đoạn Thực thi (Execute) -->
 <verification_matrix>
 
-| AC / Rủi ro | Bài test / Lệnh | Bằng chứng kỳ vọng | Kết quả thực tế |
-|---|---|---|---|
-| AC-1 | | | |
-| AC-2 | | | |
-| AC-3 | | | |
+| AC / Rủi ro | Bài test / Lệnh | Bằng chứng kỳ vọng | Mức độ nghiêm ngặt (hard-mandatory / soft-mandatory / advisory) | Kết quả thực tế |
+|---|---|---|---|---|
+| AC-1 | | | hard-mandatory | |
+| AC-2 | | | hard-mandatory | |
+| AC-3 | | | advisory | |
 
 </verification_matrix>
 
@@ -124,6 +124,7 @@
 <gate id="G2">
   - [ ] Mọi lát cắt đều có verifier xác định.
   - [ ] Hợp đồng phạm vi (cho phép / cấm) đã được phê duyệt.
+  - [ ] Mức độ nghiêm ngặt thực thi đã được gán cho từng AC / mục kiểm chứng.
   - [ ] Điều kiện dừng đã được định nghĩa cho từng slice.
   - [ ] Điểm hoàn nguyên (rollback point) đã được định nghĩa cho từng slice.
   - [ ] Danh sách lệnh được phép đã được liệt kê.

package/templates/vi/process/_seeds/review-template.md.seed

@@ -7,6 +7,7 @@
   <phase>REVIEW</phase>
   <mode>READ-ONLY</mode>
   <reviewer></reviewer>
+  <reviewer_harness></reviewer_harness>  <!-- ví dụ: human-pair / independent-subagent / cross-model-harness -->
   <last_updated></last_updated>
 </review_status>
 
@@ -136,6 +137,7 @@
 
 <gate id="G3">
   - [ ] Toàn bộ git diff đã được kiểm toán (không có thay đổi ngoài luồng).
+  - [ ] Đã xác minh nghiệm thu độc lập (người thực hiện không phải là người nghiệm thu duy nhất).
   - [ ] Hoàn tất dọn dẹp vệ sinh: toàn bộ debug log, lệnh print tạm và file nháp scratch đã bị xóa.
   - [ ] Mọi bằng chứng yêu cầu đều tồn tại và được đính kèm.
   - [ ] Toàn bộ phát hiện đã được phân loại xử lý (Lỗi xác nhận đã sửa hoặc được chấp nhận rủi ro).

package/templates/vi/process/_seeds/task-lite.md.seed

@@ -0,0 +1,88 @@
+# Nhiệm Vụ Tinh Gọn: [TASK-ID] [Tiêu Đề Nhiệm Vụ]
+
+<task_lite version="3.0" framework="RIPER-5-Lite">
+
+<!-- ════════════════════════════════════════════
+     PHẦN 0 — ĐIỀU KHIỂN NHIỆM VỤ
+     ════════════════════════════════════════════ -->
+<task_control>
+  <track>LITE</track>  <!-- LITE: Artifact 1 file duy nhất cho tác vụ nhanh, sửa lỗi, micro-task -->
+  <status>ACTIVE</status>  <!-- ACTIVE | REVIEW | COMPLETED | CANCELLED -->
+  <priority>P2</priority>  <!-- P0=khẩn | P1=cao | P2=bình thường | P3=thấp -->
+  <working_mode>PAIR</working_mode>  <!-- PAIR (duyệt tại cổng) | DELEGATED (chạy tự trị liên tục) -->
+  <current_phase>PLAN</current_phase>  <!-- PLAN | EXECUTE | REVIEW -->
+  <owner>@engineer</owner>
+</task_control>
+
+---
+
+## 1. Ý Định & Bản Đặc Tả (Intent & Spec)
+
+<specification>
+  <goal>
+    [Mô tả rõ ràng mục tiêu sửa lỗi, cải tiến nhỏ, hoặc tính năng phụ trợ]
+  </goal>
+
+  <invariants>
+    - [Ràng buộc bất biến tuyệt đối KHÔNG được phá vỡ trong nhiệm vụ này]
+  </invariants>
+
+  <acceptance_criteria>
+    - [ ] AC-1: [Kết quả chức năng cụ thể có thể kiểm chứng được]
+    - [ ] AC-2: [Kiểm thử tự động hoặc lệnh lint vượt qua không có lỗi]
+  </acceptance_criteria>
+
+  <!-- Cổng Định Nghĩa Sẵn Sàng (DoR): Không bắt đầu code nếu bài toán hoặc file được sửa còn mơ hồ -->
+  <definition_of_ready>
+    - [ ] Mục tiêu và tiêu chí nghiệm thu rõ ràng, không giả định.
+    - [ ] Danh sách file được phép sửa ở Mục 2 đã được xác định.
+  </definition_of_ready>
+</specification>
+
+---
+
+## 2. Hợp Đồng Phạm Vi & Danh Sách Tệp Được Phép Sửa
+
+<scope_contract>
+  <allowed_files>
+    <file>[đường/dẫn/tuyệt/đối/hoặc/tương/đối/file1.ts]</file>
+    <file>[đường/dẫn/file1.test.ts]</file>
+  </allowed_files>
+
+  <forbidden_files>
+    <file>[các/file/nằm/ngoài/phạm/vi/nhiệm/vụ]</file>
+  </forbidden_files>
+</scope_contract>
+
+---
+
+## 3. Kế Hoạch Cắt Lát Thực Thi (Compact Slices)
+
+<execution_plan>
+  ### Slice 1: [Tiêu Đề Thay Đổi Cốt Lõi]
+  - **Hành động:** [Viết mã hoặc test gì]
+  - **Lệnh kiểm chứng (Verifier):** [ví dụ: npm test path/to/test.ts || pytest path/to/test.py]
+  - **Trạng thái:** [ ] PENDING / IN_PROGRESS / DONE
+
+  ### Slice 2 (Tùy chọn): [Thay Đổi Bổ Trợ / Tích Hợp]
+  - **Hành động:** [Viết mã hoặc test gì]
+  - **Lệnh kiểm chứng (Verifier):** [Lệnh thực thi kiểm thử]
+  - **Trạng thái:** [ ] PENDING / IN_PROGRESS / DONE
+</execution_plan>
+
+---
+
+## 4. Kiểm Thử Tổng Hợp & Cổng Chất Lượng
+
+<verification_gates>
+  <!-- Cổng G1/G2: Kiểm tra thiết kế & phạm vi (trước khi code) -->
+  - [ ] **Cổng G1/G2 (Kế hoạch được duyệt):** Danh sách allowed_files xác định rõ ràng, có verifier.
+
+  <!-- Cổng G3: Bằng chứng nghiệm thu (sau khi code xong) -->
+  - [ ] **Cổng G3 (Sẵn sàng nghiệm thu/handoff):**
+    - [ ] Các lệnh kiểm thử (verifier) thực thi thành công 100% (Zero lỗi).
+    - [ ] Kiểm tra `git diff` — KHÔNG chạm vào bất kỳ file nào ngoài `<allowed_files>`.
+    - [ ] Đã dọn sạch mọi log debug hoặc thay đổi ngoài ý muốn.
+</verification_gates>
+
+</task_lite>

package/templates/vi/process/_seeds/task-template.md.seed

@@ -53,6 +53,14 @@
     - [ ] AC-2: [Các trường hợp biên (edge cases), quy tắc kiểm tra hợp lệ hoặc xử lý lỗi]
     - [ ] AC-3: [Kiểm thử tự động được bổ sung/cập nhật và chạy pass 100%]
   </acceptance_criteria>
+
+  <!-- Cổng Định Nghĩa Sẵn Sàng (Definition-of-Ready - DoR) — Tư duy trước khi dispatch -->
+  <definition_of_ready>
+    - [ ] Mục tiêu và tiêu chí nghiệm thu rõ ràng, kiểm chứng được (không phải đoán mò).
+    - [ ] Ràng buộc bất biến và phạm vi loại trừ <out_of_scope> được tuyên bố tường minh.
+    - [ ] Các câu hỏi mở được giải quyết hoặc đưa vào decision.md (Không code phỏng đoán).
+    <!-- DỪNG LẠI: Nếu bất kỳ mục DoR nào chưa thỏa mãn, dừng lại và hỏi người dùng trước! -->
+  </definition_of_ready>
 </specification>
 
 ---

package/templates/vi/process/development-protocols/orchestration.md

@@ -98,4 +98,23 @@
   </rule>
 </coordination_and_recovery>
 
+---
+
+## 6. Giao Thức Đánh Giá Độc Lập & Đa Harness (Cross-Harness Review)
+
+<cross_harness_review>
+  <rule id="implementer_cannot_review">
+    Subagent hoặc harness đã trực tiếp viết mã triển khai TUYỆT ĐỐI KHÔNG được đóng vai trò là người phê duyệt duy nhất cho lát cắt đó.
+    Nhằm triệt tiêu thiên kiến xác nhận, hãy ủy quyền việc thẩm định các lát cắt phức tạp hoặc nhạy cảm bảo mật cho một subagent đánh giá độc lập, hoặc yêu cầu kỹ sư con người ký duyệt quality gate.
+  </rule>
+
+  <rule id="adversarial_verification">
+    Subagent đánh giá phải được giao nhiệm vụ chủ động tìm kiếm các trường hợp biên (edge cases), vi phạm tuân thủ và vi phạm phạm vi so với `<scope_contract>`, thay vì chỉ xác nhận thụ động tuyên bố thành công của người viết mã.
+  </rule>
+
+  <rule id="fresh_context_mandate">
+    Subagent đánh giá độc lập phải vận hành với ngữ cảnh sạch: chỉ nhận yêu cầu của task, git diff và lệnh kiểm thử mà không bị ảnh hưởng bởi nhật ký hội thoại hay các suy luận phỏng đoán trong vòng lặp triển khai.
+  </rule>
+</cross_harness_review>
+
 </orchestration_protocol>