@damphuquy/agent-init 1.3.0 → 1.4.1

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

@@ -0,0 +1,79 @@
+# Biên Bản Hủy Task (Cancellation Record): [TASK-ID] [Tiêu Đề Task]
+
+<cancellation_record task_id="[TASK-ID]" version="1.0" framework="RIPER-5">
+
+<!--
+  QUY CHUẨN HỦY BỎ TASK:
+  - Mục đích: Lưu giữ tri thức khảo sát, phát hiện kỹ thuật và lý do quyết định khi một task bị hủy giữa chừng.
+  - Tuyệt đối không xóa thẳng thư mục task nếu đã diễn ra khảo sát hoặc lập kế hoạch một phần.
+  - Khởi tạo tệp này dưới dạng `cancelled.md` bên trong thư mục task.
+  - Hoàn thành checklist hoàn nguyên, sau đó chuyển thư mục task sang `completed/` (hoặc `cancelled/`).
+-->
+
+<status>
+  <phase_at_cancellation>[RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW]</phase_at_cancellation>
+  <cancelled_date>[YYYY-MM-DD hoặc DD-MM-YY]</cancelled_date>
+  <cancelled_by>[@engineer_or_product_lead]</cancelled_by>
+  <reversal_status>[CLEAN | ROLLBACK_APPLIED | DIRTY_NEEDS_MANUAL_CLEANUP]</reversal_status>
+</status>
+
+---
+
+## 1. Lý Do Hủy Bỏ (Rationale for Cancellation)
+
+<cancellation_rationale>
+  <primary_reason>
+    <!-- [ví dụ: Thay đổi chiến lược sản phẩm / Rào cản kiến trúc / Bán kính ảnh hưởng quá lớn / Bị thay thế bởi CHG-YYY] -->
+    [Tóm tắt ngắn gọn vì sao task này bị dừng trước thời hạn.]
+  </primary_reason>
+
+  <decision_context>
+    [Ngữ cảnh chi tiết, các đánh đổi đã cân nhắc và chỉ đạo chính từ các bên liên quan dẫn đến quyết định hủy.]
+  </decision_context>
+</cancellation_rationale>
+
+---
+
+## 2. Phát Hiện Kỹ Thuật & Tri Thức Được Lưu Giữ (Preserved Knowledge)
+
+<preserved_knowledge>
+  <codebase_discoveries>
+    <!-- Chúng ta đã học được gì về hệ thống, data models hoặc dependency tiềm ẩn trong lúc làm task này? -->
+    - [Phát hiện 1 — Hành vi của component, giới hạn API chưa có tài liệu hoặc ràng buộc legacy]
+    - [Phát hiện 2 — Các bài test hiện có hoặc ranh giới subsystem được khám phá]
+  </codebase_discoveries>
+
+  <invalidated_hypotheses>
+    <!-- Những giả định nào đã bị chứng minh là sai trong quá trình khảo sát? -->
+    - [Giả thuyết hóa ra không đúng hoặc không khả thi về mặt kỹ thuật]
+  </invalidated_hypotheses>
+
+  <reusable_assets>
+    <!-- Có bài test, bản nháp schema, benchmark hoặc prototype nào các task sau có thể tái sử dụng không? -->
+    - [Tài sản tái sử dụng 1: các ca test hoặc mô hình dữ liệu trong branch nháp / commit]
+  </reusable_assets>
+</preserved_knowledge>
+
+---
+
+## 3. Checklist Hoàn Nguyên Mã Nguồn & Dọn Dẹp (Cleanup Checklist)
+
+<cleanup_checklist>
+  - [ ] Toàn bộ thay đổi chưa commit đã được rollback hoặc stash sạch sẽ (`git status` sạch hoàn toàn)
+  - [ ] Các dòng log debug tạm thời, script scratch hoặc dump dữ liệu test đã bị xóa
+  - [ ] Không còn migration ảo hoặc artifact schema tạm nào bị sót lại trong database nội bộ
+  - [ ] Thư mục task đã được chuyển vào lưu trữ trong `completed/` (hoặc `cancelled/`)
+</cleanup_checklist>
+
+---
+
+## 4. Task Thay Thế Hoặc Kế Hoạch Tiếp Theo (Follow-Up)
+
+<follow_up>
+  <superseded_by>[Liên kết tới thư mục task mới hoặc CHG-YYY, hoặc ghi NONE]</superseded_by>
+  <recommended_next_action>
+    [Khuyến nghị cụ thể nếu bài toán này được xem xét lại trong tương lai.]
+  </recommended_next_action>
+</follow_up>
+
+</cancellation_record>

package/templates/vi/process/_seeds/context-group.md.seed

@@ -0,0 +1,154 @@
+# Khảo Sát (Research): [TASK-ID]
+
+<research_context task_id="[TASK-ID]" version="2.0" framework="RIPER-5">
+
+<!-- GIAI ĐOẠN CHỈ ĐỌC (READ-ONLY). Không sửa mã nguồn. Không tự ý ra quyết định triển khai. -->
+<research_status>
+  <phase>RESEARCH</phase>
+  <mode>READ-ONLY</mode>
+  <research_owner></research_owner>
+  <last_updated></last_updated>
+</research_status>
+
+---
+
+## 1. Hành Vi Hiện Tại (Current Behavior)
+
+<current_behavior>
+  [Hành vi quan sát được của hệ thống trước thay đổi này, dựa trên bằng chứng cụ thể.]
+</current_behavior>
+
+---
+
+## 2. Luồng Thực Thi (Execution Flow)
+
+<execution_flow>
+
+```text
+Điểm vào (Entry)
+→ ...
+→ ...
+→ Tác dụng phụ / Đầu ra (Side effect / output)
+```
+
+</execution_flow>
+
+---
+
+## 3. Các Thành Phần Liên Quan (Relevant Components)
+
+<components>
+
+| File / Symbol | Vai trò | Bằng chứng | Độ tin cậy (Confidence) |
+|---|---|---|---|
+| | | | |
+
+</components>
+
+---
+
+## 4. Phụ Thuộc & Ranh Giới (Dependencies & Boundaries)
+
+<boundaries>
+  <callers>[Ai gọi đến đoạn code mục tiêu này]</callers>
+  <callees>[Đoạn code mục tiêu gọi đến những thành phần nào]</callees>
+  <persistence>[Bảng cơ sở dữ liệu, cache keys, hàng đợi queues]</persistence>
+  <external_systems>[API bên thứ ba, message brokers bên ngoài]</external_systems>
+  <transaction_boundary>[Nơi transaction cơ sở dữ liệu bắt đầu và kết thúc]</transaction_boundary>
+  <security_boundary>[Ngữ cảnh xác thực auth, kiểm tra phân quyền, ranh giới tin cậy]</security_boundary>
+</boundaries>
+
+---
+
+## 5. Các Bài Kiểm Thử Hiện Có (Existing Tests)
+
+<existing_tests>
+
+| Bài test | Hành vi được bao phủ | Lỗ hổng / Điểm thiếu (Gap) |
+|---|---|---|
+| | | |
+
+</existing_tests>
+
+---
+
+## 6. Môi Trường Chạy & Cấu Hình (Runtime / Configuration)
+
+<runtime_config>
+  [Biến môi trường, feature flags, tệp cấu hình liên quan đến thay đổi này.]
+</runtime_config>
+
+---
+
+## 7. Phân Tích Nguồn Sự Thật (Source-of-Truth Analysis)
+
+<source_of_truth_analysis>
+
+| Nguồn | Quy định điều gì | Thẩm quyền | Xung đột |
+|---|---|---|---|
+| | | | |
+
+</source_of_truth_analysis>
+
+---
+
+## 8. Phân Loại Bằng Chứng (Evidence Classification)
+
+<!-- TUYỆT ĐỐI KHÔNG trộn lẫn sự thật thực tế, quan sát và giả định trong cùng một danh sách -->
+<evidence>
+  <confirmed>
+    <!-- Đã xác minh trực tiếp từ mã nguồn, bài test hoặc tài liệu chuẩn -->
+    -
+  </confirmed>
+
+  <observed>
+    <!-- Suy luận từ hành vi, log hoặc đọc gián tiếp — chưa chứng minh trực tiếp -->
+    -
+  </observed>
+
+  <hypothesized>
+    <!-- Các giả định còn cần kiểm chứng trước khi thực hiện -->
+    -
+  </hypothesized>
+</evidence>
+
+---
+
+## 9. Các Giả Định & Độ Không Chắc Chắn (Assumptions & Uncertainty)
+
+<assumptions>
+  [Liệt kê bất kỳ giả định nào định hình kết luận khảo sát. Gắn cờ độ không chắc chắn: LOW / MEDIUM / HIGH.]
+</assumptions>
+
+---
+
+## 10. Danh Sách Tệp Bị Ảnh Hưởng (Impacted Files)
+
+<impacted_files>
+  - `duong/dan/toi/file` — [Lý do bị ảnh hưởng]
+</impacted_files>
+
+---
+
+## 11. Các Quyết Định Đang Mở (Open Decisions)
+
+<open_decisions>
+  <!-- Các câu hỏi chưa được giải quyết cần đưa vào giai đoạn Innovate (decision.md) -->
+  -
+</open_decisions>
+
+---
+
+## 12. Tiêu Chí Rời Khỏi Khảo Sát (Research Exit Criteria)
+
+<research_exit_criteria>
+  - [ ] Hành vi hiện tại đã được hiểu rõ và ghi nhận đầy đủ.
+  - [ ] Luồng thực thi đã được truy vết từ đầu đến cuối (end-to-end).
+  - [ ] Các ranh giới liên quan đã được xác định (callers, callees, persistence, security).
+  - [ ] Xung đột nguồn sự thật đã được làm rõ hoặc xác nhận không có xung đột.
+  - [ ] Danh sách các tệp bị ảnh hưởng đã được xác định rõ ràng.
+  - [ ] Bằng chứng đã được phân loại rõ ràng (Confirmed / Observed / Hypothesized).
+  - [ ] Không còn rào cản khảo sát nào chưa giải quyết.
+</research_exit_criteria>
+
+</research_context>

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

@@ -0,0 +1,143 @@
+# Quyết Định Kỹ Thuật (Decision): [DEC-ID] [Task ID]
+
+<technical_decision task_id="[TASK-ID]" dec_id="[DEC-ID]" version="1.0" framework="RIPER-5">
+
+<!-- GIAI ĐOẠN CHỈ ĐỌC (READ-ONLY). Đề xuất các phương án. Không tự ý quyết định khi chưa có kỹ sư duyệt. -->
+<decision_status>
+  <phase>INNOVATE</phase>
+  <mode>READ-ONLY</mode>
+  <decision_owner></decision_owner>
+  <last_updated></last_updated>
+</decision_status>
+
+---
+
+## 1. Ngữ Cảnh (Context)
+
+<context>
+  <task>[Liên kết tới task.md hoặc Task ID]</task>
+  <research_artifact>[Liên kết tới research.md]</research_artifact>
+  <constraints>
+    [Các ràng buộc chính từ khảo sát làm thu hẹp không gian giải pháp.]
+  </constraints>
+</context>
+
+---
+
+## 2. Vấn Đề Cần Quyết Định (Decision Required)
+
+<decision_question>
+  [Tuyên bố chính xác điều cần quyết định. Một câu hỏi trọng tâm cho mỗi artifact quyết định.]
+</decision_question>
+
+---
+
+## 3. Các Phương Án Đề Xuất (Options)
+
+<options>
+
+  <option id="A">
+    <approach>[Hướng tiếp cận triển khai tổng quan]</approach>
+    <advantages>-</advantages>
+    <disadvantages>-</disadvantages>
+    <complexity>LOW | MEDIUM | HIGH</complexity>
+    <compatibility>[Tác động tương thích ngược]</compatibility>
+    <concurrency_transaction_risk>[Race conditions, tranh chấp khóa lock, độ phức tạp rollback]</concurrency_transaction_risk>
+    <testability>[Mức độ thuận tiện khi viết test kiểm chứng phương án này]</testability>
+    <maintainability>[Gánh nặng bảo trì dài hạn]</maintainability>
+  </option>
+
+  <option id="B">
+    <approach>[Hướng tiếp cận triển khai tổng quan]</approach>
+    <advantages>-</advantages>
+    <disadvantages>-</disadvantages>
+    <complexity>LOW | MEDIUM | HIGH</complexity>
+    <compatibility>[Tác động tương thích ngược]</compatibility>
+    <concurrency_transaction_risk>[Race conditions, tranh chấp khóa lock, độ phức tạp rollback]</concurrency_transaction_risk>
+    <testability>[Mức độ thuận tiện khi viết test kiểm chứng phương án này]</testability>
+    <maintainability>[Gánh nặng bảo trì dài hạn]</maintainability>
+  </option>
+
+  <option id="C">
+    <approach>[Hướng tiếp cận triển khai tổng quan]</approach>
+    <advantages>-</advantages>
+    <disadvantages>-</disadvantages>
+    <complexity>LOW | MEDIUM | HIGH</complexity>
+    <compatibility>[Tác động tương thích ngược]</compatibility>
+    <concurrency_transaction_risk>[Race conditions, tranh chấp khóa lock, độ phức tạp rollback]</concurrency_transaction_risk>
+    <testability>[Mức độ thuận tiện khi viết test kiểm chứng phương án này]</testability>
+    <maintainability>[Gánh nặng bảo trì dài hạn]</maintainability>
+  </option>
+
+</options>
+
+---
+
+## 4. Ma Trận Đánh Đổi (Trade-off Matrix)
+
+<tradeoff_matrix>
+
+| Tiêu chí | A | B | C |
+|---|:---:|:---:|:---:|
+| Khả năng tương thích | | | |
+| Độ phức tạp | | | |
+| Mức độ rủi ro | | | |
+| Khả năng kiểm thử | | | |
+| Khả năng bảo trì | | | |
+
+<!-- Thang điểm: 1 (kém) → 5 (xuất sắc) -->
+</tradeoff_matrix>
+
+---
+
+## 5. Đề Xuất Của Agent (Recommendation)
+
+<recommendation>
+  [Phương án Agent đề xuất kèm lý do lập luận. Đây là đề xuất — kỹ sư con người sẽ quyết định.]
+</recommendation>
+
+---
+
+## 6. Quyết Định Của Kỹ Sư (Engineer Decision)
+
+<!-- Phần này BẮT BUỘC kỹ sư con người phải điền trước khi Gate 1 được thông qua -->
+<engineer_decision>
+  <selected_option></selected_option>
+  <rationale></rationale>
+  <rejected_alternatives>
+    - Phương án [X]: [Lý do từ chối]
+  </rejected_alternatives>
+</engineer_decision>
+
+---
+
+## 7. Ràng Buộc Phái Sinh Từ Quyết Định Này (Constraints Created)
+
+<constraints_created>
+  [Liệt kê các ràng buộc mới lên khâu triển khai sẽ chuyển tiếp vào plan.md]
+  -
+</constraints_created>
+
+---
+
+## 8. Bằng Chứng Còn Cần Xác Minh (Evidence Still Required)
+
+<evidence_required>
+  [Bất kỳ sự thật nào chưa được khẳng định cần xác minh trong giai đoạn Plan hoặc Execute]
+  -
+</evidence_required>
+
+---
+
+## Gate 1 — Phê Duyệt Quyết Định (Decision Approved)
+
+<gate id="G1">
+  - [ ] Toàn bộ phương án đã được trình bày và phân tích đánh đổi.
+  - [ ] Kỹ sư đã xem xét các phương án.
+  - [ ] Phương án do kỹ sư chọn đã được ghi nhận ở trên.
+  - [ ] 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>
+
+</technical_decision>

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

@@ -0,0 +1,79 @@
+# Biên Bản Bàn Giao (Handoff): [TASK-ID]
+
+<handoff task_id="[TASK-ID]" version="2.0" framework="RIPER-5">
+
+<!-- Tóm tắt bàn giao cuối cùng. Cố tình thiết kế ngắn gọn. Không lặp lại các chi tiết dài dòng trong research/plan/review. -->
+<!-- Trả lời 4 câu hỏi: Đã thay đổi gì? Vì sao? Bằng chứng nào chứng minh? Còn rủi ro gì? -->
+
+<handoff_status>
+  <review_decision>PASS</review_decision>  <!-- Bắt buộc phải là PASS trước khi bàn giao hợp lệ -->
+  <review_artifact>[Liên kết tới review.md]</review_artifact>
+  <completed_date></completed_date>
+</handoff_status>
+
+---
+
+## 1. Những Gì Đã Thay Đổi (What Changed)
+
+<what_changed>
+  [Tóm tắt súc tích về thay đổi hành vi đã hoàn thành. Tham chiếu tới mục tiêu trong task.md.]
+</what_changed>
+
+<main_changes>
+  - `duong/dan/toi/file` — [Bản chất thay đổi]
+</main_changes>
+
+---
+
+## 2. Lý Do Thay Đổi (Why)
+
+<why>
+  [Lập luận kỹ thuật hoặc nghiệp vụ. Một đoạn văn ngắn gọn. Liên kết tới task.md để xem toàn bộ ngữ cảnh.]
+</why>
+
+---
+
+## 3. Bằng Chứng Xác Minh (What Proves It)
+
+<evidence>
+
+| AC | Công cụ kiểm chứng (Verifier) | Kết quả |
+|---|---|---|
+| AC-1 | `[lệnh]` | PASS |
+| AC-2 | `[lệnh]` | PASS |
+| AC-3 | `[lệnh]` | PASS |
+
+<!-- Lệnh để tái lập kiểm chứng: -->
+```bash
+[Các lệnh kiểm chứng theo thứ tự]
+```
+
+</evidence>
+
+---
+
+## 4. Rủi Ro Tồn Đọng (What Remains Risky)
+
+<residual_risk>
+  [Bất kỳ rủi ro nào đã được chấp thuận tại Gate 3 mà người tiếp nhận cần lưu ý.]
+  - [Mục rủi ro — khuyến nghị giảm thiểu hoặc giám sát]
+</residual_risk>
+
+---
+
+## 5. Quyết Định & Giả Định (Decisions & Assumptions)
+
+<decisions_and_assumptions>
+  <!-- Chỉ liệt kê các quyết định ảnh hưởng đến người bảo trì tương lai. Chi tiết xem tại decision.md. -->
+  - [Tóm tắt quyết định — vì sao chọn giải pháp này thay vì các lựa chọn khác]
+</decisions_and_assumptions>
+
+---
+
+## 6. Hành Động Tiếp Theo (Next Action)
+
+<next_action>
+  [Những việc người hoặc giai đoạn tiếp theo nên làm, nếu có. Nếu không: NONE.]
+</next_action>
+
+</handoff>

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

@@ -0,0 +1,135 @@
+# Kế Hoạch Lát Cắt (Plan): [PLAN-ID] [Task ID]
+
+<execution_plan task_id="[TASK-ID]" plan_id="[PLAN-ID]" version="2.0" framework="RIPER-5">
+
+<!-- GIAI ĐOẠN LẬP KẾ HOẠCH (PLAN). Chỉ tạo/sửa artifact kế hoạch. Không sửa mã nguồn. -->
+<plan_status>
+  <phase>PLAN</phase>
+  <last_updated></last_updated>
+</plan_status>
+
+---
+
+## 1. Artifact Đầu Vào (Input Artifacts)
+
+<input_artifacts>
+  <task_spec>[Liên kết tới task.md]</task_spec>
+  <research>[Liên kết tới research.md]</research>
+  <decision>[Liên kết tới decision.md — DEC-ID, phương án đã chọn]</decision>
+</input_artifacts>
+
+---
+
+## 2. Ràng Buộc Thực Thi (Execution Constraints)
+
+<!-- Các ràng buộc này có tính pháp lý ràng buộc giai đoạn Execute. Agent không được vượt quá. -->
+<execution_constraints>
+  <allowed_files>
+    - `src/duong/dan/...` — [Lý do cho phép]
+    - `tests/duong/dan/...` — [Lý do cho phép]
+  </allowed_files>
+  <forbidden_files>
+    - `src/public-api/...` — [Không nằm trong phạm vi]
+    - `schema/...` — [Thay đổi schema yêu cầu phê duyệt riêng]
+  </forbidden_files>
+  <allowed_commands>
+    - `[lệnh chạy test]`
+    - `[lệnh chạy lint/format]`
+  </allowed_commands>
+  <restricted_operations>
+    - Không chạy migration database khi chưa có sự phê duyệt rõ ràng từ kỹ sư.
+    - Không thêm thư viện bên thứ ba mới khi chưa có sự phê duyệt rõ ràng từ kỹ sư.
+  </restricted_operations>
+  <required_approvals>
+    - [Liệt kê các điểm cần dừng xin phép giữa chừng, ví dụ: trước khi sửa module dùng chung]
+  </required_approvals>
+</execution_constraints>
+
+---
+
+## 3. Bảng Tóm Tắt Lát Cắt (Slice Summary)
+
+<slice_summary>
+
+| ID | Hành vi | Ranh giới | Danh sách file | AC | Verifier | Rủi ro | Mode | Rollback |
+|---|---|---|---|---|---|---|---|---|
+| S1 | | | | | | | | |
+| S2 | | | | | | | | |
+
+</slice_summary>
+
+---
+
+## 4. Chi Tiết Từng Lát Cắt (Slice Details)
+
+<slices>
+
+  <slice id="S1">
+    <objective>[Hành vi cụ thể mà lát cắt này mang lại]</objective>
+    <change>[Những gì cụ thể sẽ được chỉnh sửa]</change>
+    <allowed_files>
+      - `src/duong/dan/file.py`
+    </allowed_files>
+    <acceptance_criteria>
+      - [ ] AC-N: [Tiêu chí mà lát cắt này thỏa mãn]
+    </acceptance_criteria>
+    <verifier>
+      ```bash
+      # Lệnh kiểm chứng chứng minh lát cắt này hoạt động chính xác
+      ```
+    </verifier>
+    <expected_evidence>[Đầu ra mong muốn từ lệnh verifier]</expected_evidence>
+    <rollback_point>[Cách hoàn nguyên nếu lát cắt này thất bại — git stash / revert commit / flag]</rollback_point>
+    <stop_conditions>
+      - [Điều kiện bắt buộc dừng lại và yêu cầu con người hướng dẫn]
+    </stop_conditions>
+  </slice>
+
+  <!-- Sao chép khối <slice> này cho từng lát cắt bổ sung -->
+
+</slices>
+
+---
+
+## 5. Hợp Đồng Phạm Vi (Scope Contract)
+
+<scope_contract>
+  <allowed>
+    - [Những gì Agent được phép chỉnh sửa]
+  </allowed>
+  <forbidden>
+    - [Những gì Agent tuyệt đối không bao giờ được chạm vào trong kế hoạch này]
+  </forbidden>
+</scope_contract>
+
+---
+
+## 6. Ma Trận Kiểm Chứng (Verification Matrix)
+
+<!-- Đượ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 | | | |
+
+</verification_matrix>
+
+---
+
+## Gate 2 — Phê Duyệt Kế Hoạch (Plan Approved)
+
+<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.
+  - [ ] Đ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ê.
+  - [ ] Kỹ sư đã ký duyệt.
+  <approved_by></approved_by>
+  <approved_date></approved_date>
+</gate>
+
+</execution_plan>

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

@@ -0,0 +1,56 @@
+# Chương Trình Nhiều Giai Đoạn (Program): [PROG-ID] [Tên Chương Trình]
+
+<program_umbrella_plan version="2.0" framework="RIPER-5">
+
+<metadata>
+  <program_id>[PROG-ID]</program_id>
+  <lead>@engineering_lead</lead>
+  <target_timeline>[ví dụ: Sprint 1-3]</target_timeline>
+</metadata>
+
+## 1. Chiến Lược & Kết Quả Kỳ Vọng (Executive Strategy & Outcome)
+<strategy>
+  <target_outcome>
+    [Mục tiêu kiến trúc hoặc nghiệp vụ đo lường được ở cấp độ cao.]
+  </target_outcome>
+
+  <system_impact>
+    [Các subsystem bị ảnh hưởng, downstream services, hoặc chỉ tiêu hiệu năng.]
+  </system_impact>
+</strategy>
+
+---
+
+## 2. Phân Rã Giai Đoạn & Bán Kính Ảnh Hưởng (Phase Breakdown & Blast Radius)
+<phase_breakdown>
+  <phase number="1" id="phase-01">
+    <title>[Domain Models & Port Interfaces]</title>
+    <scope>`src/domain/`, `src/application/port_*`</scope>
+    <blast_radius level="LOW">Không ảnh hưởng dependency bên ngoài</blast_radius>
+    <status>NOT_STARTED</status>
+  </phase>
+
+  <phase number="2" id="phase-02">
+    <title>[Infrastructure Adapters & Persistence]</title>
+    <scope>`src/infrastructure/`</scope>
+    <blast_radius level="MEDIUM">Phụ thuộc vào hợp đồng domain của Phase 01</blast_radius>
+    <status>NOT_STARTED</status>
+  </phase>
+
+  <phase number="3" id="phase-03">
+    <title>[API Exposure & End-to-End Integration]</title>
+    <scope>`src/api/`</scope>
+    <blast_radius level="HIGH">Mở public HTTP endpoints và DTO contracts</blast_radius>
+    <status>NOT_STARTED</status>
+  </phase>
+</phase_breakdown>
+
+---
+
+## 3. Bất Biến Toàn Cục & Quy Tắc Cổng Phase (Global Invariants & Phase Gate Rules)
+<phase_gates>
+  <rule>Mỗi phase bắt buộc phải pass 100% các lệnh kiểm thử xác minh trước khi phase tiếp theo bắt đầu.</rule>
+  <rule>Không phase nào được đưa ra breaking change lên các public API hiện có khi chưa có sự chấp thuận trước.</rule>
+</phase_gates>
+
+</program_umbrella_plan>

package/templates/vi/process/_seeds/results-template.tsv.seed

@@ -0,0 +1,5 @@
+# Bảng Đăng Ký Đánh Giá Benchmark & Số Liệu Định Lượng (RIPER-5 Framework)
+# Khởi tạo dưới tên results.tsv trong thư mục task khi cần theo dõi hiệu năng, độ trễ latency, bộ nhớ hoặc điểm eval.
+iteration	timestamp	slice_id	metric_name	baseline	observed	unit	diff_pct	status	notes
+0	2026-01-01T00:00:00Z	baseline	p99_latency_ms	100.0	100.0	ms	0.0%	BASELINE	Đo lường baseline ban đầu
+1	2026-01-01T01:00:00Z	slice-01	p99_latency_ms	100.0	75.0	ms	-25.0%	PASS	Áp dụng tối ưu hóa slice 1