@damphuquy/agent-init 1.3.0 → 1.4.1

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

@@ -0,0 +1,149 @@
+# Biên Bản Nghiệm Thu (Review): [REVIEW-ID] [Task ID]
+
+<review_artifact task_id="[TASK-ID]" review_id="[REVIEW-ID]" version="1.0" framework="RIPER-5">
+
+<!-- GIAI ĐOẠN CHỈ ĐỌC (READ-ONLY). Có thể chạy lệnh kiểm thử. Không sửa mã nguồn trong lúc review. -->
+<review_status>
+  <phase>REVIEW</phase>
+  <mode>READ-ONLY</mode>
+  <reviewer></reviewer>
+  <last_updated></last_updated>
+</review_status>
+
+---
+
+## 1. Phạm Vi Nghiệm Thu (Review Scope)
+
+<review_scope>
+  <task_spec>[Liên kết tới task.md]</task_spec>
+  <plan>[Liên kết tới plan.md]</plan>
+  <diff>[Khoảng git diff hoặc liên kết PR]</diff>
+  <tests>[Đường dẫn các bộ test suite đã chạy]</tests>
+</review_scope>
+
+---
+
+## 2. Nghiệm Thu Hành Vi (Behavior Review)
+
+<behavior_review>
+
+| AC | Hành vi kỳ vọng | Hành vi thực tế | Bằng chứng | Kết quả |
+|---|---|---|---|---|
+| AC-1 | | | | PASS / FAIL |
+| AC-2 | | | | PASS / FAIL |
+| AC-3 | | | | PASS / FAIL |
+
+</behavior_review>
+
+---
+
+## 3. Nghiệm Thu Kiến Trúc (Architecture Review)
+
+<architecture_review>
+  <dependency_direction>[Chiều import/dependency có tuân thủ đúng quy tắc kiến trúc không?]</dependency_direction>
+  <boundary_violations>[Có lời gọi vượt ranh giới vi phạm phạm vi đã khai báo không?]</boundary_violations>
+  <unnecessary_abstraction>[Có lớp trừu tượng hay cấu trúc bắc cầu nào được thêm vào mà không có lý do không?]</unnecessary_abstraction>
+  <unrelated_refactor>[Có thay đổi refactor nào không bắt nguồn từ đặc tả task không?]</unrelated_refactor>
+</architecture_review>
+
+---
+
+## 4. Nghiệm Thu Dữ Liệu (Data Review)
+
+<data_review>
+  <transaction>[Ranh giới transaction đã đúng chưa? Có nguy cơ partial commit không?]</transaction>
+  <consistency>[Tính nhất quán dữ liệu có được đảm bảo khi có ghi đồng thời?]</consistency>
+  <concurrency>[Xung đột race condition, tranh chấp khóa, kiểm soát optimistic locking?]</concurrency>
+  <migration>[Các thay đổi schema cơ sở dữ liệu có tương thích ngược không?]</migration>
+  <constraints>[Các ràng buộc database constraints có được tôn trọng không?]</constraints>
+</data_review>
+
+---
+
+## 5. Nghiệm Thu Bảo Mật (Security Review)
+
+<security_review>
+  <authentication>[Ngữ cảnh xác thực có được kiểm tra tại các điểm bắt buộc không?]</authentication>
+  <authorization>[Kiểm tra phân quyền đã được đặt đúng chỗ chưa?]</authorization>
+  <validation>[Validation và chuẩn hóa dữ liệu đầu vào đã đầy đủ chưa?]</validation>
+  <secrets>[Không có token, secret hoặc credential nào bị lộ trong code hay log?]</secrets>
+  <injection>[Các nguy cơ SQL/command injection đã được phòng chống triệt để chưa?]</injection>
+  <sensitive_logging>[Không có dữ liệu nhạy cảm PII bị ghi vào log hệ thống?]</sensitive_logging>
+</security_review>
+
+---
+
+## 6. Nghiệm Thu Hồi Quy (Regression Review)
+
+<regression_review>
+  <existing_behavior>[Các bài test cũ còn chạy pass không? Có bài test nào trước đây pass nay bị fail?]</existing_behavior>
+  <backward_compatibility>[Public API / schema có duy trì tương thích ngược không?]</backward_compatibility>
+  <existing_tests>[Có bài test có sẵn nào bị chỉnh sửa mà thiếu lý do chính đáng không?]</existing_tests>
+</regression_review>
+
+---
+
+## 7. Bảng Phát Hiện (Findings)
+
+<findings>
+
+| ID | Danh mục | Mức độ | Loại | Bằng chứng | File/Ký hiệu | Hành động yêu cầu |
+|---|---|---|---|---|---|---|
+| F-1 | Behavior | HIGH | Confirmed Defect | | | |
+
+<!-- Danh mục (Category): Behavior | Architecture | Data | Security | Regression | Scope -->
+<!-- Mức độ (Severity): CRITICAL | HIGH | MEDIUM | LOW | INFO -->
+<!-- Loại (Type): Confirmed Defect (Lỗi xác nhận) | Risk requiring validation (Rủi ro cần kiểm chứng) | Optional Improvement (Cải tiến tùy chọn) -->
+
+</findings>
+
+---
+
+## 8. Ma Trận Kiểm Chứng (Verification Matrix)
+
+<verification_matrix>
+
+| AC / Rủi ro | Công cụ kiểm chứng | Kết quả | Bằng chứng | Điểm chưa kiểm chứng |
+|---|---|---|---|---|
+| AC-1 | | PASS / FAIL | | |
+| AC-2 | | PASS / FAIL | | |
+| AC-3 | | PASS / FAIL | | |
+
+</verification_matrix>
+
+---
+
+## 9. Rủi Ro Tồn Đọng (Residual Risk)
+
+<residual_risk>
+  [Các rủi ro vẫn còn lại sau review. Bắt buộc phải được chấp nhận rõ ràng trước khi Gate 3 thông qua.]
+  -
+</residual_risk>
+
+---
+
+## 10. Quyết Định Nghiệm Thu (Review Decision)
+
+<review_decision>
+  <!-- Chọn một trong ba: PASS | CHANGES_REQUIRED | BLOCKED -->
+  <decision></decision>
+  <rationale></rationale>
+</review_decision>
+
+---
+
+## Gate 3 — Nghiệm Thu Đạt (Review Passed)
+
+<gate id="G3">
+  - [ ] Toàn bộ git diff đã được kiểm toán (không có thay đổi ngoài luồng).
+  - [ ] 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).
+  - [ ] Rủi ro tồn đọng đã được chấp nhận rõ ràng.
+  - [ ] Quyết định review: PASS.
+  - [ ] Sẵn sàng bàn giao (handoff).
+  <approved_by></approved_by>
+  <approved_date></approved_date>
+</gate>
+
+</review_artifact>

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

@@ -0,0 +1,149 @@
+# Tiến Độ Vòng Lặp (State): [TASK-ID]
+
+<loop_state task_id="[TASK-ID]" version="2.0" framework="RIPER-5">
+
+<!-- Bộ nhớ bền vững của vòng lặp Execute. Cập nhật ngay sau mỗi slice. -->
+<state_header>
+  <current_phase>EXECUTE</current_phase>  <!-- RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW -->
+  <current_gate>G2</current_gate>  <!-- G0 | G1 | G2 | G3 -->
+  <last_updated></last_updated>
+</state_header>
+
+---
+
+## 1. Tham Chiếu Task
+
+<task_ref>
+  <task_spec>[Liên kết tới task.md]</task_spec>
+  <plan>[Liên kết tới plan.md]</plan>
+</task_ref>
+
+---
+
+## 2. Mục Tiêu & Tính Bất Biến (Goal & Invariants)
+
+<goal_and_invariants>
+  <goal>[Tuyên bố một dòng về mục tiêu của task]</goal>
+  <invariants>
+    - [Bất biến 1 — bắt buộc phải luôn đúng trong suốt giai đoạn Execute]
+  </invariants>
+</goal_and_invariants>
+
+---
+
+## 3. Các Quyết Định Đã Phê Duyệt (Approved Decisions)
+
+<approved_decisions>
+  <!-- Tuyệt đối không mở lại các quyết định này. Đọc decision.md để biết đầy đủ lập luận. -->
+  - [DEC-ID]: [Tóm tắt quyết định — chọn phương án X vì Y]
+</approved_decisions>
+
+---
+
+## 4. Các Lát Cắt Đã Hoàn Thành (Completed Slices)
+
+<completed_slices>
+  <!-- Cập nhật sau khi verifier của mỗi slice chạy pass -->
+  | Slice | Trạng thái | Kết quả Verifier | Bằng chứng |
+  |---|---|---|---|
+  | S1 | | | |
+</completed_slices>
+
+---
+
+## 5. Lát Cắt Hiện Tại (Current Slice)
+
+<current_slice>
+  <id></id>
+  <objective></objective>
+  <status>IN_PROGRESS</status>  <!-- NOT_STARTED | IN_PROGRESS | VERIFYING | DONE | BLOCKED -->
+</current_slice>
+
+---
+
+## 6. Git Diff Hiện Tại (Current Diff)
+
+<current_diff>
+  <!-- Dán tóm tắt `git diff` liên quan vào đây sau mỗi slice để xác minh không có code rác -->
+  ```diff
+  ```
+</current_diff>
+
+---
+
+## 7. Bằng Chứng Kiểm Chứng (Verification Evidence)
+
+<verification_evidence>
+  <!-- Tích lũy kết quả thực tế của lệnh verifier cho từng slice đã xong -->
+  ```
+  [Đầu ra từ lệnh verifier]
+  ```
+</verification_evidence>
+
+---
+
+## 8. Bộ Nhớ Lỗi (Failure Memory)
+
+<!-- QUAN TRỌNG: Ghi nhận mọi lỗi. Tuyệt đối không thử lại cùng một cách tiếp cận 2 lần. -->
+<failure_memory>
+
+  <failure id="F1">
+    <signature>[Mô tả triệu chứng lỗi / dấu hiệu lỗi duy nhất]</signature>
+    <hypothesis>[Giả thuyết nguyên nhân được cho là gì]</hypothesis>
+    <experiment>[Thử nghiệm đã thực hiện]</experiment>
+    <result>[Kết quả thực tế đã diễn ra]</result>
+    <must_not_repeat>[Hành động / giả định cụ thể tuyệt đối không bao giờ lặp lại]</must_not_repeat>
+  </failure>
+
+</failure_memory>
+
+---
+
+## 9. Ngân Sách Thử Lại (Retry Budget)
+
+<retry_budget>
+  <allowed>3</allowed>
+  <used>0</used>
+  <remaining>3</remaining>
+  <!-- Nếu remaining về 0: DỪNG LẠI và chuyển lên open_decisions trong task.md -->
+</retry_budget>
+
+---
+
+## 10. Thay Đổi Phạm Vi (Scope Changes)
+
+<scope_changes>
+  <!-- Bất kỳ thay đổi phạm vi nào so với plan.md đã được phê duyệt -->
+  -
+</scope_changes>
+
+---
+
+## 11. Rủi Ro / Rào Cản Đang Mở (Open Risks / Blockers)
+
+<open_risks>
+  -
+</open_risks>
+
+---
+
+## 12. Hành Động Tiếp Theo (Next Action)
+
+<next_action>
+  [Mô tả chính xác bước đi cụ thể tiếp theo mà Agent phải thực hiện.]
+</next_action>
+
+---
+
+## 13. Kiểm Tra Độ Tươi Ngữ Cảnh (Context Freshness Check)
+
+<context_freshness>
+  <!-- Hoàn thành trước khi tiếp tục sau bất kỳ lần tạm dừng hoặc nạp lại ngữ cảnh nào -->
+  - [ ] Đặc tả task đang hoạt động đã được đọc lại.
+  - [ ] Các tệp mã nguồn liên quan đã được đọc lại sau thay đổi gần nhất.
+  - [ ] Lát cắt hiện tại trong plan.md đã được xác nhận.
+  - [ ] Bộ nhớ lỗi đã được kiểm tra — không lặp lại giả định đã thất bại.
+  - [ ] Không coi giả thuyết chưa kiểm chứng là sự thật đã xác nhận.
+</context_freshness>
+
+</loop_state>

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

@@ -0,0 +1,196 @@
+# Task: [TASK-ID] [Tiêu Đề Task]
+
+<task_spec version="3.0" framework="RIPER-5">
+
+<!-- ════════════════════════════════════════════
+     PHẦN 0 — KIỂM SOÁT TASK (bản lưu vết trạng thái master)
+     ════════════════════════════════════════════ -->
+<task_control>
+  <status>BACKLOG</status>  <!-- BACKLOG | ACTIVE | BLOCKED | REVIEW | COMPLETED -->
+  <spec_level>S1</spec_level>  <!-- S0=phác thảo | S1=đã định nghĩa | S2=đã kiểm chứng | S3=đã khóa -->
+  <risk>MEDIUM</risk>  <!-- LOW | MEDIUM | HIGH -->
+  <working_mode>PAIR</working_mode>  <!-- MANUAL | PAIR | DELEGATED | DIAGNOSE-ONLY -->
+  <current_phase>RESEARCH</current_phase>  <!-- RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW -->
+  <owner>@engineer</owner>
+  <decision_owner>@engineer</decision_owner>
+  <created></created>
+  <last_updated></last_updated>
+</task_control>
+
+---
+
+## 1. Đặc Tả (Trụ cột 1: Task / Spec)
+
+<specification>
+  <goal>
+    [Mục tiêu mong muốn, giá trị nghiệp vụ hoặc khả năng chức năng cần đạt được.]
+  </goal>
+
+  <current_behavior>
+    [Hành vi hiện tại của hệ thống trước khi thực hiện thay đổi này.]
+  </current_behavior>
+
+  <expected_behavior>
+    [Hành vi kỳ vọng sau khi hoàn thành thay đổi.]
+  </expected_behavior>
+
+  <actor_authorization>
+    [Ai khởi tạo hành động này, dưới ngữ cảnh phân quyền nào.]
+  </actor_authorization>
+
+  <invariants>
+    - [Bất biến 1 — Các điều kiện bắt buộc phải luôn đúng trong suốt và sau khi hoàn thành task.]
+  </invariants>
+
+  <out_of_scope>
+    - [Các thành phần, hoạt động refactor hoặc thay đổi API/schema chưa được khai báo nằm ngoài phạm vi.]
+  </out_of_scope>
+
+  <acceptance_criteria>
+    - [ ] AC-1: [Hành vi chức năng kiểm chứng được với input rõ ràng và output kỳ vọng]
+    - [ ] 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>
+</specification>
+
+---
+
+## 2. Ranh Giới Ngữ Cảnh (Trụ cột 2: Context)
+
+<context_boundaries>
+  <target_files>
+    - `src/[duong/dan/toi/file]` — [Dự kiến chỉnh sửa]
+    - `tests/[duong/dan/toi/test]` — [Khẳng định mục tiêu và test fixtures]
+  </target_files>
+
+  <source_of_truth>
+    <requirement>[Liên kết tới tài liệu yêu cầu hoặc đặc tả]</requirement>
+    <architecture>[Liên kết tới tài liệu kiến trúc hoặc ADR]</architecture>
+    <existing_behavior>[Tệp test hoặc luồng code chứng minh hành vi hiện tại]</existing_behavior>
+    <tests>[Đường dẫn bộ test chính]</tests>
+  </source_of_truth>
+</context_boundaries>
+
+---
+
+## 3. Chiến Lược Kiểm Chứng (Verification Strategy)
+
+<!-- Bằng chứng bắt buộc phải có để đóng từng AC trước khi đánh dấu COMPLETED -->
+<verification_strategy>
+
+| AC / Rủi ro | Bằng chứng yêu cầu | Công cụ kiểm chứng (Verifier) |
+|---|---|---|
+| AC-1 | | |
+| AC-2 | | |
+| AC-3 | | |
+
+</verification_strategy>
+
+---
+
+## 4. Các Quyết Định (Decisions)
+
+<decisions>
+  <approved_decisions>
+    <!-- Các quyết định đã chốt và Agent không được phép mở lại -->
+    <!-- | ID | Quyết định | Lý do | Người duyệt | -->
+  </approved_decisions>
+
+  <open_decisions>
+    <!-- Các quyết định còn cần con người lựa chọn; Agent BẮT BUỘC DỪNG LẠI (HALT) ở đây -->
+    <!-- | ID | Câu hỏi | Vì sao quan trọng | Người quyết định | Có chặn tiến độ? | -->
+  </open_decisions>
+</decisions>
+
+---
+
+## 5. Kế Hoạch Thực Thi RIPER-5 (Trụ cột 4: Vòng lặp)
+
+<execution_plan>
+  <phase name="Research" order="1">
+    <!-- CHỈ ĐỌC. Không sửa mã nguồn. Không tự ý ra quyết định triển khai. -->
+    - [ ] Nạp đặc tả task, các điều kiện bất biến và ranh giới ngoài phạm vi.
+    - [ ] Đọc các bài test tương ứng và giao diện cổng (port interfaces).
+    - [ ] Xác định luồng thực thi, ranh giới và xung đột nguồn sự thật.
+    - [ ] Tạo/cập nhật artifact `research.md`.
+    <gate id="G0" label="Research Complete - Hoàn tất khảo sát">
+      - [ ] Hành vi hiện tại đã được hiểu và ghi nhận tài liệu.
+      - [ ] Luồng thực thi đã được truy vết đầy đủ.
+      - [ ] Không còn rào cản khảo sát chưa giải quyết.
+    </gate>
+  </phase>
+
+  <phase name="Innovate" order="2">
+    <!-- CHỈ ĐỌC. Đề xuất 2-3 phương án khả thi. Không tự ý đơn phương quyết định. -->
+    - [ ] Đề xuất 2–3 hướng tiếp cận khác nhau kèm ma trận đánh đổi.
+    - [ ] Tạo artifact `decision.md`.
+    <gate id="G1" label="Gate 1 — Phê duyệt phương án (Decision Approved)">
+      - [ ] Các phương án đã được kỹ sư xem xét.
+      - [ ] Phương án được chọn đã ghi nhận vào `decision.md`.
+      - [ ] Không còn quyết định nghiệp vụ/schema/bảo mật nào đang bỏ ngỏ.
+      <approved_by></approved_by>
+      <approved_date></approved_date>
+    </gate>
+  </phase>
+
+  <phase name="Plan" order="3">
+    <!-- Chỉ tạo/sửa artifact lập kế hoạch. Không sửa mã nguồn. -->
+    - [ ] Phân rã thành các lát cắt dọc kèm verifiers và điểm hoàn nguyên.
+    - [ ] Điền vào `plan.md` hợp đồng phạm vi và ma trận kiểm chứng.
+    <gate id="G2" label="Gate 2 — Phê duyệt kế hoạch (Plan Approved)">
+      - [ ] Mỗi slice đều có một verifier xác định.
+      - [ ] Phạm vi file được phép / bị cấm sửa được xác định rõ ràng.
+      - [ ] Điểm hoàn nguyên (rollback point) được định nghĩa cho từng slice.
+      - [ ] Điều kiện dừng khẩn cấp được nêu rõ.
+      - [ ] Kỹ sư đã ký duyệt.
+      <approved_by></approved_by>
+      <approved_date></approved_date>
+    </gate>
+  </phase>
+
+  <phase name="Execute" order="4">
+    <!-- Chỉ đọc/ghi trong phạm vi đã phê duyệt. Làm từng lát cắt một. -->
+    - [ ] Triển khai từng slice theo kiểu atomic (nguyên tử).
+    - [ ] Chạy verifier ngay sau mỗi slice.
+    - [ ] Kiểm tra git diff sau mỗi slice.
+    - [ ] Cập nhật `state.md` sau mỗi slice.
+  </phase>
+
+  <phase name="Review" order="5">
+    <!-- CHỈ ĐỌC. Có thể chạy lệnh kiểm thử. Không sửa mã nguồn trong lúc review. -->
+    - [ ] Review toàn bộ git diff, hành vi, kiến trúc, dữ liệu, bảo mật, hồi quy.
+    - [ ] Tạo `review.md` kèm các phát hiện và ma trận kiểm chứng.
+    <gate id="G3" label="Gate 3 — Nghiệm thu đạt (Review Passed)">
+      - [ ] Mọi AC đều được kiểm chứng kèm bằng chứng thực tế.
+      - [ ] Rủi ro tồn đọng đã được chấp nhận.
+      - [ ] Quyết định review: PASS | CHANGES_REQUIRED | BLOCKED.
+      - [ ] Sẵn sàng bàn giao (handoff).
+      <approved_by></approved_by>
+      <approved_date></approved_date>
+    </gate>
+  </phase>
+</execution_plan>
+
+---
+
+## 6. Ranh Giới An Toàn & Dừng Khẩn Cấp (Trụ cột 3 & 4: Harness)
+
+<guardrails>
+  <stop_conditions>
+    <!-- Agent BẮT BUỘC DỪNG LẠI và yêu cầu con người hướng dẫn nếu gặp bất kỳ điều nào sau đây -->
+    - Thiếu quyết định nghiệp vụ hoặc chính sách sản phẩm.
+    - Thay đổi Public API / DB schema chưa được khai báo trong đặc tả này.
+    - Thêm dependency bên thứ ba mới chưa được khai báo trong đặc tả.
+    - Yêu cầu thay đổi chính sách bảo mật.
+    - Mở rộng phạm vi ra ngoài mục `<out_of_scope>`.
+    - Ngân sách thử lại cạn kiệt cho một lỗi lặp đi lặp lại.
+  </stop_conditions>
+
+  <retry_budget max_attempts="3">
+    Tối đa 3 lần thử liên tiếp cho cùng một triệu chứng lỗi trước khi dừng lại.
+    Tuyệt đối không giấu lỗi bằng cờ bỏ qua (ví dụ: `# type: ignore`, `eslint-disable`).
+    Nếu cạn ngân sách, ghi nhận vào `<open_decisions>` và dừng lại.
+  </retry_budget>
+</guardrails>
+
+</task_spec>

package/templates/vi/process/context/all-context.md

@@ -0,0 +1,53 @@
+# Router Định Tuyến Ngữ Cảnh Gốc (Root Context Router)
+
+<context_router version="1.0">
+
+<description>
+  Chỉ mục tri thức bền vững trung tâm định tuyến đến các nhóm ngữ cảnh chuyên biệt theo domain trên toàn hệ thống.
+</description>
+
+## Mục Lục Thư Mục Ngữ Cảnh (Context Directory Index)
+
+<!--
+  HƯỚNG DẪN ĐỊNH TUYẾN NGỮ CẢNH:
+  - Chỉ mục trung tâm cho toàn bộ tri thức domain, kiến trúc và tính bất biến của dự án.
+  - Khi thêm tệp hoặc thư mục ngữ cảnh mới (ví dụ: context/auth/, context/database/),
+    LUÔN LUÔN đăng ký một mục <group> mới bên dưới.
+  - Chỉ định rõ ràng `scope` để Agent biết chính xác khi nào cần nạp nhóm ngữ cảnh này mà
+    không phải quét toàn bộ thư mục một cách lãng phí.
+-->
+<context_groups>
+  <group id="planning">
+    <title>Quy Chuẩn Lập Kế Hoạch & Hiệu Chỉnh Năng Lực</title>
+    <path>[`planning/all-planning.md`](planning/all-planning.md)</path>
+    <scope>Tiêu chuẩn INVEST, quy tắc cắt lát dọc (vertical slicing), hiệu chỉnh Story Point</scope>
+  </group>
+
+  <group id="seeds">
+    <title>Cẩm Nang Mẫu Chuẩn & Seeds</title>
+    <path>[`../_seeds/_GUIDE.md`](../_seeds/_GUIDE.md)</path>
+    <scope>Blueprints mẫu cho task, research, decision, plan, state, review, handoff và program. Đầy đủ chuỗi artifact và lệnh khởi tạo.</scope>
+  </group>
+
+  <group id="tests">
+    <title>Tiêu Chuẩn Kiểm Thử & Chiến Lược Khung Thử Nghiệm</title>
+    <path>[`tests/all-tests.md`](tests/all-tests.md)</path>
+    <scope>Kim tự tháp test, chính sách cách ly unit/integration, quy ước mock và fixtures kiểm thử</scope>
+  </group>
+
+  <group id="protocols">
+    <title>Mục Lục Giao Thức Phát Triển</title>
+    <path>[`../development-protocols/all-development-protocols.md`](../development-protocols/all-development-protocols.md)</path>
+    <scope>Khung kiểm thử kỹ thuật, điều phối subagent và quy chuẩn mã nguồn</scope>
+  </group>
+
+  <!-- Ví dụ: Đăng ký ngữ cảnh domain tùy chỉnh bên dưới
+  <group id="domain-billing">
+    <title>Kiến Trúc Thanh Toán & Hóa Đơn</title>
+    <path>[`billing/billing-context.md`](billing/billing-context.md)</path>
+    <scope>Tích hợp cổng thanh toán, bất biến tính toán hóa đơn, xử lý thuế</scope>
+  </group>
+  -->
+</context_groups>
+
+</context_router>

package/templates/vi/process/context/planning/all-planning.md

@@ -0,0 +1,31 @@
+# Quy Chuẩn Lập Kế Hoạch & Hiệu Chỉnh Năng Lực (Planning Context)
+
+<planning_context version="1.0">
+
+<overview>
+  Hướng dẫn ước lượng Story Point, phân rã lát cắt dọc và hiệu chỉnh năng lực thực thi.
+</overview>
+
+## 1. Tiêu Chuẩn Chất Lượng (Quality Standards)
+<quality_standards>
+  <standard name="INVEST">
+    - **Độc lập (Independent):** Có thể bàn giao mà không bị chặn bởi các story khác.
+    - **Thương lượng được (Negotiable):** Chi tiết triển khai có thể tinh chỉnh linh hoạt.
+    - **Có giá trị (Valuable):** Mang lại giá trị đo lường được cho người dùng hoặc doanh nghiệp.
+    - **Ước lượng được (Estimable):** Phạm vi đủ rõ để ước lượng khối lượng công việc.
+    - **Nhỏ gọn (Small):** Hoàn thành vừa vặn trong 1-3 ngày làm việc của kỹ sư.
+    - **Kiểm chứng được (Testable):** Có Tiêu chí nghiệm thu (AC) cụ thể, đo lường được.
+  </standard>
+
+  <standard name="Vertical Slicing (Cắt Lát Dọc)">
+    Tránh chia việc theo các tầng ngang độc lập (horizontal silos). Bàn giao từng lát cắt dọc hoàn chỉnh xuyên suốt qua API, logic nghiệp vụ và lưu trữ dữ liệu.
+  </standard>
+</quality_standards>
+
+## 2. Hiệu Chỉnh Năng Lực (Capacity Calibration)
+<capacity_calibration>
+  <unit>1 Story Point ≈ 2-4 giờ làm việc kỹ thuật tập trung</unit>
+  <max_task_size>3-5 Story Points (các task lớn hơn bắt buộc phải phân rã nhỏ hơn)</max_task_size>
+</capacity_calibration>
+
+</planning_context>

package/templates/vi/process/context/tests/all-tests.md

@@ -0,0 +1,56 @@
+# Tiêu Chuẩn Kiểm Thử & Chiến Lược Khung Thử Nghiệm (Testing Context)
+
+<testing_context version="1.0">
+
+<overview>
+  Hướng dẫn hiệu chỉnh kim tự tháp kiểm thử, chính sách cách ly, quy ước mock và khung kiểm tra tự động xuyên suốt hệ thống.
+</overview>
+
+## 1. Kim Tự Tháp Kiểm Thử & Phân Loại (Test Pyramid & Classification)
+<test_pyramid>
+  <layer name="Unit Tests (Kiểm thử đơn vị)" path="tests/unit/">
+    - Phạm vi: Logic nghiệp vụ thuần túy, domain models, hàm tiện ích, phân nhánh trường hợp biên.
+    - Tốc độ thực thi: Rất nhanh (< 50ms mỗi test), không có I/O mạng / đĩa / ngoại vi.
+    - Chính sách mock: Mock toàn bộ ranh giới I/O, client bên ngoài và giao diện cổng (port interfaces).
+  </layer>
+
+  <layer name="Integration Tests (Kiểm thử tích hợp)" path="tests/integration/">
+    - Phạm vi: Lưu trữ cơ sở dữ liệu, adapter gọi API bên ngoài, cấu hình framework.
+    - Mức độ cách ly: Test containers tạm thời (ví dụ: Testcontainers) hoặc database test cách ly riêng cho từng suite.
+    - Dọn dẹp (Teardown): Phải đảm bảo không rò rỉ dữ liệu hoặc trạng thái giữa các lần chạy test.
+  </layer>
+
+  <layer name="End-to-End Tests (Kiểm thử đầu-cuối)" path="tests/e2e/">
+    - Phạm vi: Các luồng trải nghiệm người dùng trọng yếu, toàn bộ vòng đời HTTP/gRPC API, regression smoke tests.
+    - Kiểm chứng: Xác thực tính toàn vẹn hợp đồng đầu-cuối xuyên suốt các subsystem.
+  </layer>
+</test_pyramid>
+
+## 2. Chính Sách Khung Kiểm Thử (Test Harness Policies)
+<test_policies>
+  <policy name="Determinism (Tính tiền định)">
+    Tuyệt đối không có test chập chờn (flaky tests). Test không được phụ thuộc vào thời gian thực tế của đồng hồ hệ thống (sử dụng frozen clock hoặc fake timer) hay thứ tự thực thi ngẫu nhiên.
+  </policy>
+
+  <policy name="Clean State (Trạng thái sạch)">
+    Mỗi bài test phải tự khởi tạo dữ liệu seed hoặc fixtures riêng của mình. Không bao giờ giả định sẵn có các dòng dữ liệu trong database.
+  </policy>
+
+  <policy name="Assertion Precision (Độ chính xác của khẳng định)">
+    Tránh các khẳng định mơ hồ (ví dụ: `expect(res).toBeTruthy()`). Luôn khẳng định cấu trúc chính xác kỳ vọng, mã trạng thái HTTP (status code) và loại lỗi.
+  </policy>
+
+  <policy name="Fast Feedback (Phản hồi nhanh)">
+    Toàn bộ bộ unit test phải hoàn thành trong vòng dưới 30 giây. Các bộ integration test chậm phải được phân vùng rõ ràng.
+  </policy>
+</test_policies>
+
+## 3. Ánh Xạ Lệnh Kiểm Tra (Verification Commands Mapping)
+<verification_commands>
+  <!-- Giữ đồng bộ với <validation_commands> trong AGENTS.md -->
+  <command type="unit">Chạy bộ kiểm thử unit test nhanh</command>
+  <command type="integration">Chạy kiểm thử tích hợp integration/e2e</command>
+  <command type="coverage">Chạy kiểm tra độ bao phủ test coverage</command>
+</verification_commands>
+
+</testing_context>

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

@@ -0,0 +1,27 @@
+# Mục Lục Giao Thức Phát Triển (Development Protocols Index)
+
+<protocols_router version="1.0">
+
+<description>
+  Router trung tâm cho các giao thức kỹ thuật, điều phối subagent và tiêu chuẩn chất lượng mã nguồn.
+</description>
+
+## Danh Mục Giao Thức (Protocol Catalog)
+<protocol_list>
+  <protocol name="Điều phối Subagent (Subagent Orchestration)">
+    <path>[`orchestration.md`](orchestration.md)</path>
+    <description>Quy tắc phân công subagent, cách ly và phối hợp phản ứng (reactive coordination)</description>
+  </protocol>
+
+  <protocol name="Tiêu chuẩn Triển khai & Kiểm thử (Implementation & Testing Standards)">
+    <path>[`implementation-standards.md`](implementation-standards.md)</path>
+    <description>Kiểu dữ liệu nghiêm ngặt, vệ sinh mã nguồn và tiêu chuẩn khung kiểm thử</description>
+  </protocol>
+
+  <protocol name="Quy Chuẩn Điều Phối Agent & RIPER-5">
+    <path>[`../../AGENTS.md`](../../AGENTS.md)</path>
+    <description>4 trụ cột cốt lõi và đặc tả vòng lặp vận hành RIPER-5</description>
+  </protocol>
+</protocol_list>
+
+</protocols_router>