@damphuquy/agent-init 1.4.2 → 1.4.4

package/README.md

@@ -17,17 +17,18 @@ npx @damphuquy/agent-init .
 
 ---
 
-## 🚀 Documentation
+## Documentation
 
 Designed for minimal overhead, practical focus, and zero fluff:
 
 ### 1. For Daily Development (Start Here)
-* 📘 **[01 · Hands-on Walkthrough from A–Z](docs/en/01-getting-started.md)**: **The only guide you need to get started**. Step-by-step instructions with **a complete end-to-end example** (adding a user change-password endpoint), prompt templates, and quality gate sign-offs.
-* ⚡ **[02 · Daily Cheat Sheet](docs/en/02-cheat-sheet.md)**: Copy-paste prompt templates for each phase, quality gates summary (Gates G0–G3), and file ownership matrix (Human vs Agent).
+* **[01 · Hands-on Walkthrough from A–Z](docs/en/01-getting-started.md)**: **The core guide to get started in 10–15 minutes**. Step-by-step instructions with **2 practical examples** (Task 1 Strict Track $\rightarrow$ Handoff $\rightarrow$ Task 2 Fast-Track with knowledge inheritance), prompt templates, and quality gate sign-offs.
+* **[02 · Daily Cheat Sheet](docs/en/02-cheat-sheet.md)**: Copy-paste prompt templates for each phase, quality gates summary (Gates G0–G3), and file ownership matrix (Human vs Agent).
+* **[03 · Advanced Workflows & Production Edge Cases](docs/en/03-advanced-workflows.md)**: Complex real-world scenarios: Epics in `process/features/`, multi-developer concurrency, git rebase conflicts, P0 emergency hotfixes, secret scanning, model switching, complex test harnesses, and task parking (`paused.md`).
 
 ### 2. In-Depth Reference (For Tech Leads & Maintainers)
-* 🏛️ **[3-Layer Architecture & Context Router](docs/en/reference/architecture.md)**: Deep dive into the 3-layer decoupled architecture and Minimum Sufficient Context principles (No Full-Repo Scan).
-* 🚢 **[DevOps & Release Automation](docs/en/reference/devops-release.md)**: CI/CD release lifecycle, automated Semantic Versioning, and NPM package publishing.
+* **[3-Layer Architecture & Context Router](docs/en/reference/architecture.md)**: Deep dive into the 3-layer decoupled architecture and Minimum Sufficient Context principles (No Full-Repo Scan).
+* **[DevOps & Release Automation](docs/en/reference/devops-release.md)**: CI/CD release lifecycle, automated Semantic Versioning, and NPM package publishing.
 
 ---
 
@@ -47,7 +48,7 @@ Designed for minimal overhead, practical focus, and zero fluff:
 
 ---
 
-## 📦 NPX CLI Commands
+## NPX CLI Commands
 
 ```bash
 # Bootstrap in current directory (interactive prompt: choose English or Tiếng Việt)
@@ -68,6 +69,6 @@ npx @damphuquy/agent-init . --force
 
 ---
 
-## 📄 License
+## License
 
 Licensed under the [MIT License](LICENSE).

package/README.vi.md

@@ -22,8 +22,9 @@ npx @damphuquy/agent-init .
 Tài liệu được thiết kế tối giản, tập trung vào thực hành, không lý thuyết rườm rà:
 
 ### 1. Dành cho công việc hằng ngày (Bắt đầu tại đây)
-* 📘 **[01 · Hướng dẫn Thực chiến từ A–Z (Hands-on Walkthrough)](docs/vi/01-getting-started.md)**: **Tài liệu duy nhất bạn cần đọc để bắt đầu**. Hướng dẫn từng bước với **ví dụ cụ thể xuyên suốt** (thêm chức năng đổi mật khẩu), chi tiết ai làm gì, gõ lệnh gì, prompt mẫu và cách ký duyệt qua các cổng.
+* 📘 **[01 · Hướng dẫn Thực chiến từ A–Z](docs/vi/01-getting-started.md)**: **Tài liệu cốt lõi để bắt đầu trong 10–15 phút**. Hướng dẫn từng bước với **2 ví dụ thực tế liên hoàn** (Task 1 Strict Track $\rightarrow$ Bàn giao $\rightarrow$ Task 2 Fast-Track kế thừa tri thức), prompt mẫu và cách duyệt qua các cổng.
 * ⚡ **[02 · Sổ tay Tra cứu Nhanh (Cheat Sheet)](docs/vi/02-cheat-sheet.md)**: Bảng copy-paste prompt mẫu cho từng giai đoạn, bảng 4 cổng kiểm soát (Gates G0–G3), và ma trận quyền hạn file (Human vs Agent).
+* 🚀 **[03 · Quy trình Nâng cao & Tình huống Thực chiến](docs/vi/03-advanced-workflows.md)**: Các kịch bản production phức tạp: Epic trong `process/features/`, đa lập trình viên đồng thời, xử lý xung đột rebase, hotfix P0 khẩn cấp, quét secret bảo mật, đổi model chat, và đóng băng task dài hạn (`paused.md`).
 
 ### 2. Tài liệu Chuyên sâu & Tham khảo (Dành cho Lead / Maintainer)
 * 🏛️ **[Kiến trúc 3 Tầng & Cơ chế Context Router](docs/vi/reference/architecture.md)**: Giải thích sâu về thiết kế tách rời 3 layer và cơ chế nạp ngữ cảnh tối thiểu (No Full-Repo Scan).

package/dist/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEvE,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EA6D9C,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EA6D9C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAAmB,CAAC;AAEhE,wBAAgB,aAAa,CAAC,IAAI,GAAE,iBAAwB,GAAG,SAAS,SAAS,EAAE,CAElF;AAGD,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED,wBAAgB,cAAc,CAAC,cAAc,GAAE,MAAyB,GAAG,WAAW,CAgBrF"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEvE,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EA8D9C,CAAC;AAEF,eAAO,MAAM,cAAc,EAAE,SAAS,SAAS,EA8D9C,CAAC;AAEF,eAAO,MAAM,WAAW,EAAE,SAAS,SAAS,EAAmB,CAAC;AAEhE,wBAAgB,aAAa,CAAC,IAAI,GAAE,iBAAwB,GAAG,SAAS,SAAS,EAAE,CAElF;AAGD,wBAAgB,cAAc,IAAI,MAAM,CASvC;AAED,wBAAgB,cAAc,CAAC,cAAc,GAAE,MAAyB,GAAG,WAAW,CAgBrF"}

package/dist/config.js

@@ -32,6 +32,7 @@ export const FILE_GROUPS_EN = [
             { path: 'process/_seeds/review-template.md.seed', desc: 'Review phase artifact & Gate 3' },
             { path: 'process/_seeds/handoff-template.md.seed', desc: 'Final projection (intentionally short)' },
             { path: 'process/_seeds/cancellation-template.md.seed', desc: 'Knowledge-preserving task cancellation record' },
+            { path: 'process/_seeds/pause-template.md.seed', desc: 'Task pause & parking record for temporary blockages' },
             { path: 'process/_seeds/results-template.tsv.seed', desc: 'Benchmark & quantitative metrics evaluation registry' },
             { path: 'process/_seeds/program-template.md.seed', desc: 'Multi-phase umbrella epic blueprint' },
         ],
@@ -94,6 +95,7 @@ export const FILE_GROUPS_VI = [
             { path: 'process/_seeds/review-template.md.seed', desc: 'Artifact giai đoạn Nghiệm thu (Review) & Gate 3' },
             { path: 'process/_seeds/handoff-template.md.seed', desc: 'Tóm tắt bàn giao cuối cùng (ngắn gọn)' },
             { path: 'process/_seeds/cancellation-template.md.seed', desc: 'Biên bản hủy task & lưu giữ tri thức' },
+            { path: 'process/_seeds/pause-template.md.seed', desc: 'Biên bản tạm dừng task & đóng băng an toàn' },
             { path: 'process/_seeds/results-template.tsv.seed', desc: 'Bảng theo dõi số liệu benchmark & định lượng' },
             { path: 'process/_seeds/program-template.md.seed', desc: 'Bản thiết kế chương trình lớn nhiều giai đoạn' },
         ],

package/dist/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damphuquy/agent-init",
-  "version": "1.4.2",
+  "version": "1.4.4",
   "description": "Scaffolding CLI to bootstrap RIPER-5 Coding Agents & Operational Workspace",
   "type": "module",
   "main": "./dist/index.js",

package/templates/en/process/README.md

@@ -147,4 +147,27 @@ handoff.md       ← (Complete) Short final projection
   </phase>
 </operational_phases>
 
+---
+
+## 4. Template Architecture Philosophy: Understanding Why & How
+
+To prevent mechanical, cargo-cult usage of the framework, the template architecture is engineered around the following core technical principles:
+
+### 1. The Architectural "WHY" — Core Rationale
+* **Why the `.seed` extension in `_seeds/`?**
+  * Blueprint Immutability: The `.seed` suffix isolates master templates from standard AI discovery tools (`grep`, `find`), preventing agents from mistaking blueprints for active tasks and overwriting master templates.
+* **Why separate phase-specific artifacts instead of one large Markdown file?**
+  * Enforces Single Responsibility. Prevents oversized context windows (Anti-Context Saturation) that trigger hallucinations or rule neglect (Lost in the Middle). Ensures every Quality Gate (G1, G2, G3) maps to an auditable, physical file on disk.
+* **Why split `features/` vs `general-plans/`?**
+  * Blast Radius Separation: `features/` handles large, multi-phase epics (≥5 files or domain subsystems), whereas `general-plans/` houses rapid bugfixes and optimizations (<5 files). This keeps your workspace organized and prevents minor fixes from burying major architecture.
+* **Why use the 3-state pipeline (`active/`, `backlog/`, `completed/`)?**
+  * Filesystem State Machine: `active/` contains strictly one in-flight task at any time, maintaining zero context bleeding. `completed/` serves as a permanent historical archive for future tasks to reference via `<context_references>`.
+* **Why pseudo-XML tags (`<goal>`, `<allowed_files>`,...)?**
+  * Machine-Readable Contract: Enforces unambiguous semantic boundaries that LLMs parse reliably, strictly constraining AI write access.
+
+### 2. The Operational "HOW" — Execution Principles
+* **Copy-On-Demand:** Never bulk-copy all seeds into a task folder upfront. Start with `task.md`, then instantiate `research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md` sequentially as phases advance.
+* **Stateless Chat, Stateful Workspace:** Sessions can reset and chats can close. All operational progress and error memory (`<failure_memory>`) are recorded on disk (`state.md`), allowing any new session to resume with 100% fidelity.
+* **Selective Knowledge Crystallization:** Upon completion, summarize the task in `handoff.md`. Only promote reusable architectural standards or schema contracts into `process/context/` and `all-context.md`.
+
 </process_orchestration>

package/templates/en/process/_seeds/_GUIDE.md

@@ -8,6 +8,13 @@
   Never edit seeds in-place — always copy first.
 </scope>
 
+<architectural_rationale>
+  ### Seeds Architectural Rationale: Understanding "Why" & "How"
+  * **Why the `.seed` extension? (Why):** The `.seed` suffix acts as an immutable boundary. It prevents automated AI discovery tools (`find`, `grep`) from confusing archetype templates with active `*.md` task files. This guarantees agents will never accidentally overwrite master blueprints during execution.
+  * **Why separate seeds per phase? (Why):** Each phase of RIPER-5 requires a distinct cognitive posture and permission boundary (Research vs Innovate vs Plan vs Execute vs Review). Splitting archetypes prevents context window bloat (Anti-Context Saturation), avoids hallucinations, and anchors each Quality Gate (G1–G3) to an auditable physical artifact.
+  * **Copy-On-Demand Protocol (How):** Never bulk-copy all seeds into a task directory. Start exclusively with `task.md`. Sequentially instantiate subsequent artifacts (`research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md`) only as the task progresses into each phase.
+</architectural_rationale>
+
 ---
 
 ## 1. Blueprint Catalog
@@ -74,6 +81,11 @@
     reusable prototypes/tests, and rollback verification when an in-flight task is cancelled.
   </seed>
 
+  <seed type="pause" path="pause-template.md.seed">
+    Task pause and parking record. Preserves working tree state, slice snapshot,
+    resumption criteria, and stale-risk assessment when an in-flight task is temporarily frozen.
+  </seed>
+
   <seed type="results" path="results-template.tsv.seed">
     Benchmark and quantitative metrics evaluation registry.
     Use for tracking latency, throughput, memory, or eval scores across iterations and vertical slices.
@@ -128,6 +140,7 @@ process/features/active/CHG-017-your-feature/
 ├── review.md        ← instantiated from review-template.md.seed (Gate 3 Audit)
 ├── handoff.md       ← instantiated from handoff-template.md.seed (Final Projection)
 ├── results.tsv      ← (Optional) instantiated from results-template.tsv.seed (Metrics/Benchmarks)
+├── paused.md        ← (If paused) instantiated from pause-template.md.seed
 └── cancelled.md     ← (If cancelled) instantiated from cancellation-template.md.seed
 ```
 
@@ -163,6 +176,9 @@ cp process/_seeds/handoff-template.md.seed process/features/active/CHG-XXX-your-
 # (Optional) Tracking performance or evaluation metrics:
 cp process/_seeds/results-template.tsv.seed process/features/active/CHG-XXX-your-feature/results.tsv
 
+# (When pausing or parking an in-flight task):
+cp process/_seeds/pause-template.md.seed process/features/active/CHG-XXX-your-feature/paused.md
+
 # (When cancelling an in-flight task):
 cp process/_seeds/cancellation-template.md.seed process/features/active/CHG-XXX-your-feature/cancelled.md
 ```

package/templates/en/process/_seeds/pause-template.md.seed

@@ -0,0 +1,106 @@
+# Pause Record: [TASK-ID] [Task Title]
+
+<pause_record task_id="[TASK-ID]" version="1.0" framework="RIPER-5">
+
+<!--
+  TASK PAUSE & PARKING GUIDELINES:
+  - Purpose: Freeze in-flight tasks cleanly when blocked by external dependencies, shifting priorities, or waiting on human feedback.
+  - Never abandon an active task without recording the exact working tree state and resumption conditions.
+  - Instantiate this file as `paused.md` inside the task workspace.
+  - If the pause is long-term (> 2 weeks), move the task directory from `active/` to `backlog/` (or `paused/`) to keep `active/` clean.
+-->
+
+<status>
+  <phase_at_pause>[RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW]</phase_at_pause>
+  <paused_date>[YYYY-MM-DD or DD-MM-YY]</paused_date>
+  <paused_by>[@engineer_or_tech_lead]</paused_by>
+  <git_branch>[feature/CHG-XXX-description]</git_branch>
+  <git_state>[COMMITTED_WIP | STASHED | CLEAN]</git_state>
+  <git_commit_or_stash_ref>[e.g. git commit hash: a1b2c3d or stash@{0}]</git_commit_or_stash_ref>
+</status>
+
+---
+
+## 1. Reason for Pause & Blockers
+
+<pause_context>
+  <primary_reason>
+    <!-- [e.g. Blocked on upstream API Task CHG-042 / Awaiting security review / Priority preemption by P0 hotfix / Waiting on customer feedback] -->
+    [Concise description of why this task was paused.]
+  </primary_reason>
+
+  <blocker_details>
+    [Detailed context on blocking conditions, external tickets, or dependencies.]
+  </blocker_details>
+</pause_context>
+
+---
+
+## 2. In-Flight Progress & Slice Snapshot
+
+<progress_snapshot>
+  <completed_slices>
+    <!-- Which slices from plan.md have already passed their verifiers? -->
+    - [Slice 1: Objective — VERIFIED & COMMITTED]
+  </completed_slices>
+
+  <active_slice_at_pause>
+    <!-- What was being worked on when paused? -->
+    <slice_id>[e.g. Slice 2]</slice_id>
+    <state_summary>[e.g. Service logic implemented, 2 unit tests written but failing due to mock issue]</state_summary>
+  </active_slice_at_pause>
+
+  <touched_files>
+    <!-- List of files modified or created during active work -->
+    - `src/...`
+    - `tests/...`
+  </touched_files>
+</progress_snapshot>
+
+---
+
+## 3. Resumption Criteria
+
+<resumption_criteria>
+  <!-- What explicit event, ticket resolution, or condition unlocks this task? -->
+  <trigger_condition>
+    [e.g. CHG-042 merged to main and published to staging environment]
+  </trigger_condition>
+
+  <responsible_owner>[@engineer_to_notify]</responsible_owner>
+</resumption_criteria>
+
+---
+
+## 4. Stale-Risk Assessment (Bit-Rot Warnings)
+
+<stale_risk_assessment>
+  <!-- What might decay or drift if this task remains parked for weeks/months? -->
+  <schema_drift_risk level="[LOW|MEDIUM|HIGH]">
+    [Potential DB migration or API contract changes occurring in parallel.]
+  </schema_drift_risk>
+
+  <dependency_drift_risk level="[LOW|MEDIUM|HIGH]">
+    [Libraries or internal shared modules that may be upgraded in the interim.]
+  </dependency_drift_risk>
+
+  <architecture_drift_risk level="[LOW|MEDIUM|HIGH]">
+    [Refactorings or new conventions that might invalidate assumptions in research.md.]
+  </architecture_drift_risk>
+</stale_risk_assessment>
+
+---
+
+## 5. Resumption Pre-Flight Checklist
+
+<resumption_checklist>
+  <!-- MUST execute in order before restarting EXECUTE loop -->
+  - [ ] 1. Move task folder back to `active/` (if it was parked in `backlog/`).
+  - [ ] 2. Checkout feature branch and rebase/merge latest `main` (`git checkout <branch> && git pull --rebase origin main`).
+  - [ ] 3. Run validation commands on baseline (`npm run test && npm run lint`) to ensure codebase is green.
+  - [ ] 4. Perform Context Freshness Check: Re-read `task.md`, `state.md`, and verify if assumptions in `research.md` still hold.
+  - [ ] 5. If `<allowed_files>` were altered on `main`, update `plan.md` scope contract before executing code.
+  - [ ] 6. Delete or archive `paused.md` and resume the current slice in `state.md`.
+</resumption_checklist>
+
+</pause_record>

package/templates/vi/process/README.md

@@ -147,4 +147,27 @@ handoff.md       ← (Complete) Tóm tắt bàn giao ngắn gọn
   </phase>
 </operational_phases>
 
+---
+
+## 4. Triết Lý Kiến Trúc Templates: Vì Sao Tổ Chức Như Vậy? (Why & How)
+
+Để tránh tình trạng chỉ sử dụng máy móc mà không hiểu nguyên lý, kiến trúc của hệ thống templates được xây dựng dựa trên các trụ cột kỹ thuật sau:
+
+### 1. Bản chất "WHY" — Lý Do Thiết Kế
+* **Tại sao có hậu tố `.seed` trong `_seeds/`?**
+  * Hậu tố `.seed` phân định ranh giới bất biến (Blueprint Immutability). Ngăn chặn các công cụ tìm kiếm của AI (như `grep`, `find`) nhận diện nhầm file mẫu thành file task đang chạy, bảo vệ phôi mẫu không bị AI vô tình ghi đè.
+* **Tại sao chia nhỏ theo từng Phase thay vì 1 file Markdown lớn?**
+  * Áp dụng nguyên lý Single Responsibility. Tránh hiện tượng phình to context window (Anti-Context Saturation) khiến AI bị ảo giác hoặc "quên" quy tắc (Lost in the middle). Đảm bảo mỗi Quality Gate (G1, G2, G3) được gắn với một bằng chứng vật lý độc lập.
+* **Tại sao phân chia `features/` vs `general-plans/`?**
+  * Phân tách theo bán kính ảnh hưởng (Blast Radius). `features/` dành cho task lớn (≥5 files hoặc theo domain), `general-plans/` dành cho tác vụ nhanh, sửa bug (<5 files). Ngăn chặn tình trạng hàng chục task vụn vặt làm loãng cấu trúc hệ thống.
+* **Tại sao có 3 trạng thái `active/`, `backlog/`, `completed/`?**
+  * Mô hình State Machine trên filesystem: `active/` tại một thời điểm chỉ chứa DUY NHẤT một task đang làm, giữ không gian làm việc của AI sạch sẽ tuyệt đối. `completed/` lưu trữ tri thức lịch sử để các task sau kế thừa qua `<context_references>`.
+* **Tại sao dùng thẻ XML (`<goal>`, `<allowed_files>`,...)?**
+  * Ranh giới cú pháp máy đọc được (Machine-Readable Contract), khóa chặt phạm vi sửa đổi của AI.
+
+### 2. Bản chất "HOW" — Nguyên Tắc Vận Hành
+* **Copy-On-Demand:** Tuyệt đối không copy hàng loạt tất cả seed vào task cùng lúc. Bắt đầu với `task.md`, sau đó sinh ra `research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md` theo tiến độ phase.
+* **Stateless Chat, Stateful Workspace:** Cửa sổ chat có thể tắt hoặc reset session. Toàn bộ tiến độ và bộ nhớ lỗi (`<failure_memory>`) được lưu bền vững trên ổ đĩa (`state.md`), session mới chỉ cần nạp lại file là tiếp tục công việc chính xác 100%.
+* **Selective Knowledge Crystallization:** Sau khi task hoàn thành và tạo `handoff.md`, chỉ những thay đổi kiến trúc/contract dùng chung mới được cập nhật vào `process/context/` và đăng ký trong `all-context.md`.
+
 </process_orchestration>

package/templates/vi/process/_seeds/_GUIDE.md

@@ -8,6 +8,13 @@
   Không bao giờ chỉnh sửa trực tiếp bên trong `_seeds/` — luôn luôn sao chép trước khi dùng.
 </scope>
 
+<architectural_rationale>
+  ### Triết Lý Thiết Kế Seeds: Bản Chất "Why" & "How"
+  * **Tại sao là đuôi `.seed`? (Why):** Đuôi `.seed` đóng vai trò ranh giới bất biến (Blueprint Immutability). Nó giúp phân biệt rõ ràng giữa "khuôn mẫu phôi" và "tài liệu markdown đang làm việc" (`*.md`). Khi AI quét repo bằng các công cụ tìm kiếm, hậu tố `.seed` bảo vệ các file này không bao giờ bị AI sửa đè vào làm hỏng template gốc của cả dự án.
+  * **Tại sao tách riêng từng seed theo phase? (Why):** Mỗi giai đoạn trong chu trình RIPER-5 đòi hỏi một kiểu tư duy và ranh giới quyền hạn khác biệt (Khảo sát vs Đề xuất vs Lập kế hoạch vs Thực thi vs Nghiệm thu). Việc tách rời giúp AI chỉ nạp đúng artifact cần thiết, chống phình to context window (Anti-Context Saturation) và gắn chặt với từng Cổng kiểm soát (Gates G1–G3).
+  * **Quy tắc Copy-On-Demand (How):** Tuyệt đối không copy hàng loạt tất cả seed vào thư mục task. Bắt đầu duy nhất với `task.md`. Khi task tiến vào phase nào, mới lần lượt khởi tạo artifact của phase đó (`research.md` $\rightarrow$ `decision.md` $\rightarrow$ `plan.md` $\rightarrow$ `state.md` $\rightarrow$ `review.md` $\rightarrow$ `handoff.md`).
+</architectural_rationale>
+
 ---
 
 ## 1. Danh Mục Blueprints Mẫu
@@ -74,6 +81,11 @@
     các prototype/test có thể tái sử dụng, và kiểm tra hoàn nguyên khi một task đang làm bị dừng giữa chừng.
   </seed>
 
+  <seed type="pause" path="pause-template.md.seed">
+    Biên bản tạm dừng task. Bảo toàn trạng thái cây làm việc git, ảnh chụp các slice đã xong,
+    điều kiện kích hoạt lại và đánh giá nguy cơ lỗi thời khi task bị đóng băng tạm thời.
+  </seed>
+
   <seed type="results" path="results-template.tsv.seed">
     Bảng đăng ký đánh giá số liệu benchmark và định lượng.
     Dùng để theo dõi latency, throughput, bộ nhớ hoặc điểm đánh giá qua các vòng lặp và lát cắt dọc.
@@ -128,6 +140,7 @@ process/features/active/CHG-017-your-feature/
 ├── review.md        ← khởi tạo từ review-template.md.seed (Biên bản kiểm toán Gate 3)
 ├── handoff.md       ← khởi tạo từ handoff-template.md.seed (Tóm tắt bàn giao)
 ├── results.tsv      ← (Tùy chọn) khởi tạo từ results-template.tsv.seed (Metrics/Benchmarks)
+├── paused.md        ← (Nếu tạm dừng) khởi tạo từ pause-template.md.seed
 └── cancelled.md     ← (Nếu hủy task) khởi tạo từ cancellation-template.md.seed
 ```
 
@@ -163,6 +176,9 @@ cp process/_seeds/handoff-template.md.seed process/features/active/CHG-XXX-your-
 # (Tùy chọn) Khi cần theo dõi hiệu năng hoặc số liệu benchmark:
 cp process/_seeds/results-template.tsv.seed process/features/active/CHG-XXX-your-feature/results.tsv
 
+# (Khi cần tạm dừng hoặc đóng băng task đang làm):
+cp process/_seeds/pause-template.md.seed process/features/active/CHG-XXX-your-feature/paused.md
+
 # (Khi cần hủy bỏ một task đang dang dở):
 cp process/_seeds/cancellation-template.md.seed process/features/active/CHG-XXX-your-feature/cancelled.md
 ```

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

@@ -0,0 +1,106 @@
+# Biên Bản Tạm Dừng Task: [TASK-ID] [Tiêu Đề Task]
+
+<pause_record task_id="[TASK-ID]" version="1.0" framework="RIPER-5">
+
+<!--
+  HƯỚNG DẪN TẠM DỪNG & ĐÓNG BĂNG TASK (TASK PAUSE):
+  - Mục đích: Đóng băng sạch sẽ task đang thực thi khi gặp blocker bên ngoài, thay đổi độ ưu tiên, hoặc chờ phản hồi từ con người.
+  - Tuyệt đối không bỏ dở task mà không lưu vết chính xác trạng thái git và điều kiện kích hoạt lại.
+  - Khởi tạo file này thành `paused.md` bên trong thư mục task đang làm.
+  - Nếu tạm dừng dài hạn (> 2 tuần), chuyển thư mục task từ `active/` sang `backlog/` (hoặc `paused/`) để giữ `active/` luôn sạch.
+-->
+
+<status>
+  <phase_at_pause>[RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW]</phase_at_pause>
+  <paused_date>[YYYY-MM-DD hoặc DD-MM-YY]</paused_date>
+  <paused_by>[@engineer_hoac_tech_lead]</paused_by>
+  <git_branch>[feature/CHG-XXX-mo-ta]</git_branch>
+  <git_state>[COMMITTED_WIP | STASHED | CLEAN]</git_state>
+  <git_commit_or_stash_ref>[ví dụ: commit hash a1b2c3d hoặc stash@{0}]</git_commit_or_stash_ref>
+</status>
+
+---
+
+## 1. Lý Do Tạm Dừng & Yếu Tố Chặn (Blockers)
+
+<pause_context>
+  <primary_reason>
+    <!-- [ví dụ: Bị chặn bởi API Task CHG-042 / Chờ review bảo mật / Ưu tiên khẩn cấp cho hotfix P0 / Chờ feedback sản phẩm] -->
+    [Tóm tắt ngắn gọn lý do tại sao task này phải tạm dừng.]
+  </primary_reason>
+
+  <blocker_details>
+    [Ngữ cảnh chi tiết về điều kiện chặn, ticket bên ngoài hoặc sự phụ thuộc kiến trúc.]
+  </blocker_details>
+</pause_context>
+
+---
+
+## 2. Tiến Độ Đang Làm & Snapshot Lát Cắt (Slice)
+
+<progress_snapshot>
+  <completed_slices>
+    <!-- Những slice nào trong plan.md đã vượt qua verifier thành công? -->
+    - [Slice 1: Mục tiêu — ĐÃ KIỂM THỬ XANH & COMMIT]
+  </completed_slices>
+
+  <active_slice_at_pause>
+    <!-- Slice nào đang dang dở khi dừng? -->
+    <slice_id>[ví dụ: Slice 2]</slice_id>
+    <state_summary>[ví dụ: Đã viết xong logic service, đang viết 2 unit test nhưng còn lỗi mock]</state_summary>
+  </active_slice_at_pause>
+
+  <touched_files>
+    <!-- Danh sách file đã sửa hoặc tạo mới trong quá trình thực thi -->
+    - `src/...`
+    - `tests/...`
+  </touched_files>
+</progress_snapshot>
+
+---
+
+## 3. Điều Kiện Kích Hoạt Lại (Resumption Criteria)
+
+<resumption_criteria>
+  <!-- Sự kiện, ticket hay điều kiện cụ thể nào sẽ mở khóa để tiếp tục task này? -->
+  <trigger_condition>
+    [ví dụ: CHG-042 được merge vào main và deploy lên môi trường staging]
+  </trigger_condition>
+
+  <responsible_owner>[@ky_su_phu_trach]</responsible_owner>
+</resumption_criteria>
+
+---
+
+## 4. Đánh Giá Nguy Cơ Lỗi Thời (Stale-Risk & Bit-Rot)
+
+<stale_risk_assessment>
+  <!-- Những gì có nguy cơ biến đổi hoặc xung đột nếu task bị đóng băng nhiều tuần/tháng? -->
+  <schema_drift_risk level="[LOW|MEDIUM|HIGH]">
+    [Nguy cơ database migration hoặc schema API thay đổi song song trên main.]
+  </schema_drift_risk>
+
+  <dependency_drift_risk level="[LOW|MEDIUM|HIGH]">
+    [Nguy cơ thư viện phụ thuộc hoặc module dùng chung được nâng cấp phiên bản.]
+  </dependency_drift_risk>
+
+  <architecture_drift_risk level="[LOW|MEDIUM|HIGH]">
+    [Nguy cơ quy chuẩn hoặc tái cấu trúc làm vô hiệu các giả thuyết trong research.md.]
+  </architecture_drift_risk>
+</stale_risk_assessment>
+
+---
+
+## 5. Checklist Kiểm Tra Trước Khi Khởi Động Lại (Pre-Flight Resumption)
+
+<resumption_checklist>
+  <!-- BẮT BUỘC thực hiện tuần tự trước khi mở lại vòng lặp EXECUTE -->
+  - [ ] 1. Chuyển thư mục task trở lại `active/` (nếu trước đó đã cất vào `backlog/`).
+  - [ ] 2. Checkout đúng branch và rebase/merge code mới nhất từ `main` (`git checkout <branch> && git pull --rebase origin main`).
+  - [ ] 3. Chạy lệnh kiểm thử gốc (`npm run test && npm run lint`) để đảm bảo codebase đang hoàn toàn xanh.
+  - [ ] 4. Kiểm tra độ tươi ngữ cảnh (Context Freshness): Đọc lại `task.md`, `state.md`, và xác nhận các giả thuyết trong `research.md` còn đúng không.
+  - [ ] 5. Nếu `<allowed_files>` bị thay đổi trên `main`, cập nhật lại phạm vi trong `plan.md`.
+  - [ ] 6. Xóa hoặc lưu trữ `paused.md`, cập nhật lại `state.md` và tiếp tục thực hiện slice đang dở.
+</resumption_checklist>
+
+</pause_record>