@damphuquy/agent-init 1.4.3 → 2.0.0

package/README.md

@@ -1,6 +1,6 @@
 # agent-instructions (@damphuquy/agent-init)
 
-> **AI Coding Agent Scaffolding & Orchestration System (RIPER-5 Framework)**
+> **AI Coding Agent Scaffolding & Orchestration System v2.0 (RIPER-5 Framework)**
 
 <p align="center">
   <b>English</b> • <a href="README.vi.md">Tiếng Việt</a>
@@ -8,7 +8,13 @@
 
 ---
 
-A structured scaffolding framework for AI Coding Agents following the **RIPER-5 Framework** — cleanly separated into three layers: `AGENTS.md` (project configuration), `.agents/` (agent behavioral controls), and `process/` (task execution and verification workflow).
+A structured scaffolding framework for AI Coding Agents following the **RIPER-5 Framework v2.0** — cleanly separated into three layers: `AGENTS.md` (project configuration), `.agents/` (agent behavioral controls), and `process/` (task execution and verification workflow).
+
+Featuring four core **v2.0 Engineering Protocols**:
+* **Subagent Orchestration v2.0:** Parallel vertical slicing with zero write collision and reactive wakeup.
+* **Implementation Standards v2.0:** Strict typing (zero `any`), domain purity, fail-fast boundary validation, and deterministic teardown.
+* **Planning & Slicing Standards v2.0:** INVEST-compliant vertical slices (2–5 per task) with mandatory automated verifiers.
+* **Testing Standards & Harness v2.0:** Deterministic test pyramid with frozen clocks, fixture factories, and strict mocking boundaries.
 
 ```bash
 # Bootstrap immediately into your project (takes 30 seconds)
@@ -17,17 +23,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), subagent delegation prompts, and v2.0 protocol matrix.
+* **[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 (v2.0)](docs/en/reference/architecture.md)**: Deep dive into the 3-layer decoupled architecture, the 11-seed catalog, and the v2.0 Engineering Protocols.
+* **[DevOps & Release Automation](docs/en/reference/devops-release.md)**: CI/CD release lifecycle, automated Semantic Versioning, and NPM package publishing.
 
 ---
 
@@ -47,7 +54,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 +75,6 @@ npx @damphuquy/agent-init . --force
 
 ---
 
-## 📄 License
+## License
 
 Licensed under the [MIT License](LICENSE).

package/README.vi.md

@@ -1,6 +1,6 @@
 # agent-instructions (@damphuquy/agent-init)
 
-> **Hệ thống điều phối và khởi tạo AI Coding Agent theo chuẩn RIPER-5**
+> **Hệ thống điều phối và khởi tạo AI Coding Agent v2.0 theo chuẩn RIPER-5**
 
 <p align="center">
   <a href="README.md">English</a> • <b>Tiếng Việt</b>
@@ -8,7 +8,13 @@
 
 ---
 
-Hệ thống mẫu (scaffold) điều phối AI Coding Agent theo chuẩn **RIPER-5 Framework** — phân tách thành ba layer rõ ràng: `AGENTS.md` (cấu hình dự án), `.agents/` (quy chuẩn hành vi của Agent), và `process/` (quy trình thực thi task và kiểm thử).
+Hệ thống mẫu (scaffold) điều phối AI Coding Agent theo chuẩn **RIPER-5 Framework v2.0** — phân tách thành ba layer rõ ràng: `AGENTS.md` (cấu hình dự án), `.agents/` (quy chuẩn hành vi của Agent), và `process/` (quy trình thực thi task và kiểm thử).
+
+Tích hợp 4 **Giao thức Kỹ thuật v2.0** cốt lõi:
+* **Điều phối Subagent v2.0:** Chia lát cắt song song, không xung đột ghi (zero write collision) và đánh thức phản ứng.
+* **Quy chuẩn Hiện thực Mã nguồn v2.0:** Kiểm soát kiểu nghiêm ngặt (không `any`), domain thuần khiết, fail-fast tại ranh giới và dọn dẹp tài nguyên xác định.
+* **Quy chuẩn Lập kế hoạch & Cắt lát v2.0:** Lát cắt dọc theo chuẩn INVEST (2–5 slice/task) với lệnh kiểm chứng tự động bắt buộc.
+* **Quy chuẩn Kiểm thử & Test Harness v2.0:** Kim tự tháp kiểm thử xác định với đóng băng thời gian (frozen clocks), fixture factories và mock có kiểm soát.
 
 ```bash
 # Khởi tạo ngay vào project của bạn (chỉ mất 30 giây)
@@ -22,11 +28,12 @@ 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.
-* ⚡ **[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).
+* 📘 **[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), prompt ủy quyền subagent và ma trận giao thức v2.0.
+* 🚀 **[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).
+* 🏛️ **[Kiến trúc 3 Tầng & Cơ chế Context Router (v2.0)](docs/vi/reference/architecture.md)**: Giải thích sâu về thiết kế tách rời 3 layer, danh mục 11 seed template và 4 Giao thức Kỹ thuật v2.0.
 * 🚢 **[Cẩm nang DevOps & Tự động hóa Phát hành](docs/vi/reference/devops-release.md)**: Quy trình CI/CD tự động tính Semantic Versioning và publish package lên NPM.
 
 ---

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":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,OAAO,MAAM,cAAc,CAAC;AACnC,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,MAAM,CAAC,MAAM,cAAc,GAAyB;IAClD;QACE,KAAK,EAAE,iCAAiC;QACxC,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,gDAAgD,EAAE;SAC9E;KACF;IACD;QACE,KAAK,EAAE,gCAAgC;QACvC,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,kDAAkD,EAAE;YACvF,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,uDAAuD,EAAE;YAC9F,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,oDAAoD,EAAE;YAC7F,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,6CAA6C,EAAE;SAC/F;KACF;IACD;QACE,KAAK,EAAE,iDAAiD;QACxD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,sCAAsC,EAAE;YAC3E,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,0DAA0D,EAAE;YACnG,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,yCAAyC,EAAE;YACrF,EAAE,IAAI,EAAE,sCAAsC,EAAE,IAAI,EAAE,+CAA+C,EAAE;YACvG,EAAE,IAAI,EAAE,sCAAsC,EAAE,IAAI,EAAE,mCAAmC,EAAE;YAC3F,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,yCAAyC,EAAE;YACrG,EAAE,IAAI,EAAE,sCAAsC,EAAE,IAAI,EAAE,mDAAmD,EAAE;YAC3G,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,gCAAgC,EAAE;YACzF,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,gCAAgC,EAAE;YAC1F,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,wCAAwC,EAAE;YACnG,EAAE,IAAI,EAAE,8CAA8C,EAAE,IAAI,EAAE,+CAA+C,EAAE;YAC/G,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,qDAAqD,EAAE;YAC9G,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,sDAAsD,EAAE;YAClH,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,qCAAqC,EAAE;SACjG;KACF;IACD;QACE,KAAK,EAAE,iDAAiD;QACxD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,gCAAgC,EAAE,IAAI,EAAE,2CAA2C,EAAE;YAC7F,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,8CAA8C,EAAE;YAC1G,EAAE,IAAI,EAAE,oCAAoC,EAAE,IAAI,EAAE,wDAAwD,EAAE;SAC/G;KACF;IACD;QACE,KAAK,EAAE,0DAA0D;QACjE,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,4DAA4D,EAAE,IAAI,EAAE,oCAAoC,EAAE;YAClH,EAAE,IAAI,EAAE,gDAAgD,EAAE,IAAI,EAAE,uCAAuC,EAAE;YACzG,EAAE,IAAI,EAAE,2DAA2D,EAAE,IAAI,EAAE,yCAAyC,EAAE;SACvH;KACF;IACD;QACE,KAAK,EAAE,mDAAmD;QAC1D,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,kCAAkC,EAAE,IAAI,EAAE,8BAA8B,EAAE;YAClF,EAAE,IAAI,EAAE,mCAAmC,EAAE,IAAI,EAAE,iCAAiC,EAAE;YACtF,EAAE,IAAI,EAAE,qCAAqC,EAAE,IAAI,EAAE,oCAAoC,EAAE;YAC3F,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,+BAA+B,EAAE;YACxF,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,gCAAgC,EAAE;YAC1F,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,iCAAiC,EAAE;SAC9F;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAyB;IAClD;QACE,KAAK,EAAE,oDAAoD;QAC3D,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,0DAA0D,EAAE;SACxF;KACF;IACD;QACE,KAAK,EAAE,kCAAkC;QACzC,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,8CAA8C,EAAE;YACnF,EAAE,IAAI,EAAE,qBAAqB,EAAE,IAAI,EAAE,gDAAgD,EAAE;YACvF,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,mDAAmD,EAAE;YAC5F,EAAE,IAAI,EAAE,+BAA+B,EAAE,IAAI,EAAE,sCAAsC,EAAE;SACxF;KACF;IACD;QACE,KAAK,EAAE,0CAA0C;QACjD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,0CAA0C,EAAE;YAC/E,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,4CAA4C,EAAE;YACrF,EAAE,IAAI,EAAE,0BAA0B,EAAE,IAAI,EAAE,+CAA+C,EAAE;YAC3F,EAAE,IAAI,EAAE,sCAAsC,EAAE,IAAI,EAAE,6CAA6C,EAAE;YACrG,EAAE,IAAI,EAAE,sCAAsC,EAAE,IAAI,EAAE,qDAAqD,EAAE;YAC7G,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,wDAAwD,EAAE;YACpH,EAAE,IAAI,EAAE,sCAAsC,EAAE,IAAI,EAAE,sDAAsD,EAAE;YAC9G,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,mDAAmD,EAAE;YAC5G,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,iDAAiD,EAAE;YAC3G,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,uCAAuC,EAAE;YAClG,EAAE,IAAI,EAAE,8CAA8C,EAAE,IAAI,EAAE,sCAAsC,EAAE;YACtG,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,4CAA4C,EAAE;YACrG,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,8CAA8C,EAAE;YAC1G,EAAE,IAAI,EAAE,yCAAyC,EAAE,IAAI,EAAE,+CAA+C,EAAE;SAC3G;KACF;IACD;QACE,KAAK,EAAE,qDAAqD;QAC5D,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,gCAAgC,EAAE,IAAI,EAAE,2CAA2C,EAAE;YAC7F,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,yCAAyC,EAAE;YACrG,EAAE,IAAI,EAAE,oCAAoC,EAAE,IAAI,EAAE,2DAA2D,EAAE;SAClH;KACF;IACD;QACE,KAAK,EAAE,8DAA8D;QACrE,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,4DAA4D,EAAE,IAAI,EAAE,8BAA8B,EAAE;YAC5G,EAAE,IAAI,EAAE,gDAAgD,EAAE,IAAI,EAAE,sCAAsC,EAAE;YACxG,EAAE,IAAI,EAAE,2DAA2D,EAAE,IAAI,EAAE,qDAAqD,EAAE;SACnI;KACF;IACD;QACE,KAAK,EAAE,8CAA8C;QACrD,KAAK,EAAE;YACL,EAAE,IAAI,EAAE,kCAAkC,EAAE,IAAI,EAAE,kCAAkC,EAAE;YACtF,EAAE,IAAI,EAAE,mCAAmC,EAAE,IAAI,EAAE,uCAAuC,EAAE;YAC5F,EAAE,IAAI,EAAE,qCAAqC,EAAE,IAAI,EAAE,qCAAqC,EAAE;YAC5F,EAAE,IAAI,EAAE,uCAAuC,EAAE,IAAI,EAAE,kCAAkC,EAAE;YAC3F,EAAE,IAAI,EAAE,wCAAwC,EAAE,IAAI,EAAE,kCAAkC,EAAE;YAC5F,EAAE,IAAI,EAAE,0CAA0C,EAAE,IAAI,EAAE,0CAA0C,EAAE;SACvG;KACF;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAyB,cAAc,CAAC;AAEhE,MAAM,UAAU,aAAa,CAAC,IAAI,GAAsB,IAAI;IAC1D,OAAO,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,cAAc,CAAC;AACzD,CAAC;AAGD,MAAM,UAAU,cAAc;IAC5B,IAAI,CAAC;QACH,MAAM,eAAe,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;QACvD,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC;QACjD,8CAA8C;QAC9C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC,GAAG,EAAE,CAAC;IACvB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,cAAc,GAAW,cAAc,EAAE;IACtE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAC7D,IAAI,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;YAC3B,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACjD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAyB,CAAC;YAC3D,OAAO;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,uBAAuB;gBAC5C,OAAO,EAAE,MAAM,CAAC,OAAO,IAAI,OAAO;gBAClC,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,WAAW;IACb,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;AAC7D,CAAC"}

package/package.json

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

package/templates/en/process/README.md

@@ -24,6 +24,7 @@ process/
 │   ├── review-template.md.seed       # Review phase artifact (Gate 3)
 │   ├── handoff-template.md.seed      # Final projection (short)
 │   ├── cancellation-template.md.seed # Knowledge-preserving cancellation record
+│   ├── pause-template.md.seed        # Task pause & parking record (temporary blockages)
 │   ├── results-template.tsv.seed     # Benchmark & quantitative metrics tracker
 │   └── program-template.md.seed      # Multi-phase program blueprint
 ├── context/                          # Durable knowledge base & context routers
@@ -45,6 +46,7 @@ process/
 │   │       ├── review.md             # Review phase output
 │   │       ├── handoff.md            # Final projection
 │   │       ├── results.tsv           # (Optional) Benchmark & metric iteration tracking
+│   │       ├── paused.md             # (If paused) Parking record & resumption criteria
 │   │       └── cancelled.md          # (If aborted) Cancellation findings & rollback status
 │   ├── completed/                    # Archived task workspaces
 │   └── backlog/                      # Backlog notes: {note_slug}_NOTE_{dd-mm-yy}.md
@@ -107,8 +109,10 @@ handoff.md       ← (Complete) Short final projection
 | Execute | source code + tests + `state.md` |
 | Review | `review.md` |
 | Handoff | `handoff.md` |
+| Pause / Park | `paused.md` (clean freeze & resumption criteria upon temporary block) |
 | Cancellation | `cancelled.md` (knowledge preservation upon abort) |
 | Benchmark / Metrics | `results.tsv` (performance and eval metrics) |
+| Program | `program.md` (multi-phase umbrella epic blueprint) |
 | Gate 1 | `decision.md` approval |
 | Gate 2 | `plan.md` approval |
 | Gate 3 | `review.md` approval |

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

@@ -81,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.
@@ -116,6 +121,10 @@ handoff.md      ← Final projection (short)
 | Execute | source code + tests + `state.md` |
 | Review | `review.md` |
 | Handoff | `handoff.md` |
+| Pause / Park | `paused.md` (clean freeze & resumption checklist) |
+| Cancellation | `cancelled.md` (knowledge preservation upon abort) |
+| Benchmark / Metrics | `results.tsv` (performance and eval metrics) |
+| Program | `program.md` (multi-phase umbrella epic blueprint) |
 | Gate 1 | `decision.md` approval |
 | Gate 2 | `plan.md` approval |
 | Gate 3 | `review.md` approval |
@@ -135,6 +144,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
 ```
 
@@ -170,6 +180,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/en/process/_seeds/task-template.md.seed

@@ -6,9 +6,11 @@
      SECTION 0 — TASK CONTROL (master state record)
      ════════════════════════════════════════════ -->
 <task_control>
-  <status>BACKLOG</status>  <!-- BACKLOG | ACTIVE | BLOCKED | REVIEW | COMPLETED -->
+  <status>BACKLOG</status>  <!-- BACKLOG | ACTIVE | BLOCKED | PAUSED | REVIEW | COMPLETED | CANCELLED -->
   <spec_level>S1</spec_level>  <!-- S0=sketch | S1=defined | S2=verified | S3=locked -->
+  <priority>P2</priority>  <!-- P0=urgent | P1=high | P2=normal | P3=low -->
   <risk>MEDIUM</risk>  <!-- LOW | MEDIUM | HIGH -->
+  <estimated_story_points>2</estimated_story_points>  <!-- 1 SP ≈ 2-4 focused engineering hours -->
   <working_mode>PAIR</working_mode>  <!-- MANUAL | PAIR | DELEGATED | DIAGNOSE-ONLY -->
   <current_phase>RESEARCH</current_phase>  <!-- RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW -->
   <owner>@engineer</owner>
@@ -63,6 +65,11 @@
     - `tests/[path/to/test_file]` — [Target assertions and test fixtures]
   </target_files>
 
+  <context_groups>
+    <!-- References to registered context groups from process/context/all-context.md -->
+    - [planning | tests | protocols | domain-specific-group]
+  </context_groups>
+
   <source_of_truth>
     <requirement>[Link to requirement or spec]</requirement>
     <architecture>[Link to architecture doc or ADR]</architecture>
@@ -154,6 +161,7 @@
     - [ ] Run verifier after each slice.
     - [ ] Inspect diff after each slice.
     - [ ] Update `state.md` after each slice.
+    - [ ] (Optional) Record quantitative metric deltas in `results.tsv` if tracking benchmarks/performance.
   </phase>
 
   <phase name="Review" order="5">

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

@@ -26,7 +26,7 @@
   <group id="seeds">
     <title>Seeds & Archetypes Guide</title>
     <path>[`../_seeds/_GUIDE.md`](../_seeds/_GUIDE.md)</path>
-    <scope>Scaffolding seeds for tasks, research, decisions, plans, state, reviews, handoffs, and programs. Full artifact chain and instantiation commands.</scope>
+    <scope>Scaffolding seeds for tasks, research, decisions, plans, state, reviews, handoffs, pause, cancellation, benchmarks, and programs. Full artifact chain and instantiation commands.</scope>
   </group>
 
   <group id="tests">

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

@@ -1,31 +1,87 @@
 # Planning Standards & Calibration Context
 
-<planning_context version="1.0">
+<planning_context version="2.0">
 
 <overview>
-  Guidelines for story point estimation, vertical slicing, and capacity calibration.
+  Engineering guidelines for story point estimation, vertical slicing, rollback checkpointing, and capacity calibration.
 </overview>
 
-## 1. Quality Standards
+---
+
+## 1. Quality Standards (INVEST Criteria)
+
 <quality_standards>
   <standard name="INVEST">
-    - **Independent:** Deliverable without cross-story blockers.
-    - **Negotiable:** Implementation details are flexibly refined.
-    - **Valuable:** Delivers measurable user or business value.
-    - **Estimable:** Scoped clearly to estimate effort.
-    - **Small:** Fits within 1-3 engineering days.
-    - **Testable:** Concrete Acceptance Criteria defined.
-  </standard>
-
-  <standard name="Vertical Slicing">
-    Avoid horizontal silos. Deliver end-to-end vertical slices across API, logic, and persistence.
+    - **Independent:** Deliverable and verifiable without cross-story circular blockers.
+    - **Negotiable:** Implementation details and technical approaches can be flexibly evaluated during the Innovate phase.
+    - **Valuable:** Delivers demonstrable capability or verifiable engineering progress.
+    - **Estimable:** Scoped tightly enough that effort and file touchpoints can be calculated.
+    - **Small:** Sized to fit comfortably within 1–3 engineering days (or 1–3 Story Points).
+    - **Testable:** Accompanied by unambiguous, verifiable Acceptance Criteria (`- [ ]`).
   </standard>
 </quality_standards>
 
-## 2. Capacity Calibration
+---
+
+## 2. Vertical Slicing Discipline
+
+<vertical_slicing>
+  ### Vertical Slice vs Horizontal Silo
+  - **The Vertical Slice Rule:** Each slice must cut through all required technical layers (e.g. Domain Model $\rightarrow$ Service/Logic $\rightarrow$ Port Adapter/API $\rightarrow$ Automated Test) to deliver one complete, verifiable increment of behavior.
+  - **The Horizontal Silo Anti-Pattern:** Never slice horizontally (e.g., Slice 1: create all database tables, Slice 2: create all services, Slice 3: create all endpoints). Horizontal layers cannot be verified independently, leaving the system in a broken or unprovable state until the final slice.
+
+  ### Vertical Slicing Workflow
+  ```text
+  [Slice 1: Thin End-to-End Core] ──► Domain Entity + In-Memory Repo + Minimal Endpoint + Passing Test
+  [Slice 2: Persistence & Boundary] ──► Real Database Adapter + Migration + Integration Verifier
+  [Slice 3: Edge Cases & Validation] ──► Strict Input Sanitization + Error Handlers + Boundary Tests
+  ```
+</vertical_slicing>
+
+---
+
+## 3. Slice Sizing, Atomic Verifiability & Checkpoints
+
+<slice_sizing>
+  <rule id="slice_cardinality">
+    A standard task should contain between **2 and 5 vertical slices**. If a task requires more than 5 slices, it has high blast radius and must be decomposed into a Multi-Phase Program (`program-template.md.seed`).
+  </rule>
+
+  <rule id="autonomous_verifier">
+    Every single slice in `plan.md` must have an explicit, executable `<verifier>` command (e.g. `npm run test -- test/path/test.js` or `pytest tests/unit/test_slice.py`). A slice is NOT complete until its verifier exits with code 0.
+  </rule>
+
+  <rule id="atomic_checkpoint">
+    Commit or checkpoint each slice atomically upon verification passing. This guarantees clean git history and enables instant rollback if subsequent slices encounter irrecoverable regressions.
+  </rule>
+</slice_sizing>
+
+---
+
+## 4. Rollback Strategy per Slice
+
+<rollback_strategy>
+  Every slice in `plan.md` MUST specify a concrete `<rollback_point>`:
+  - **Git Checkpoint:** `git checkout -- <allowed_files>` or revert commit hash.
+  - **Stash Checkpoint:** `git stash pop` or dedicated WIP branch.
+  - **Data/Schema Rollback:** Down-migration script or drop ephemeral test container.
+
+  If the agent exhausts its 3-attempt retry budget on a slice, it must execute the rollback point before halting and escalating to human guidance.
+</rollback_strategy>
+
+---
+
+## 5. Story Point Capacity Calibration
+
 <capacity_calibration>
-  <unit>1 Story Point ≈ 2-4 focused engineering hours</unit>
-  <max_task_size>3-5 Story Points (larger tasks must be decomposed)</max_task_size>
+  <unit>1 Story Point (SP) ≈ 2–4 focused engineering hours</unit>
+  <scale>
+    - **1 SP:** Straightforward change with clear scope (1-3 files touched, 1-2 slices).
+    - **2 SP:** Standard feature or refactoring (3-5 files touched, 2-3 slices).
+    - **3 SP:** Moderately complex task touching domain contracts and persistence (4-7 files, 3-4 slices).
+    - **5 SP:** Maximum size for a single active task in `process/features/active/`.
+    - **> 5 SP:** Oversized. Must be split into multiple standalone tasks or organized under `program-template.md.seed`.
+  </scale>
 </capacity_calibration>
 
 </planning_context>

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

@@ -1,56 +1,113 @@
 # Testing Standards & Harness Strategy Context
 
-<testing_context version="1.0">
+<testing_context version="2.0">
 
 <overview>
-  Guidelines for test pyramid calibration, isolation policies, mock conventions, and automated verification harness across the system.
+  Guidelines for test pyramid calibration, isolation policies, mock conventions, fixture hygiene, and automated verification harness across the system.
 </overview>
 
-## 1. Test Pyramid & Classification
+---
+
+## 1. Test Pyramid & Layer Calibration
+
 <test_pyramid>
   <layer name="Unit Tests" path="tests/unit/">
-    - Scope: Pure business logic, domain models, utility functions, edge case branching.
-    - Execution speed: Fast (< 50ms per test), zero network/disk/external I/O.
-    - Mock policy: Mock all I/O boundaries, external clients, and port interfaces.
+    - **Scope:** Pure domain models, business logic calculations, utility functions, edge-case branching.
+    - **Speed & Constraints:** Ultra-fast (< 50ms per test). Zero network calls, zero disk I/O, zero real database connections.
+    - **Mocking Policy:** Mock all port interfaces, external clients, and I/O boundaries.
   </layer>
 
   <layer name="Integration Tests" path="tests/integration/">
-    - Scope: Database persistence, external API client adapters, framework wiring.
-    - Isolation: Ephemeral test containers (e.g. Testcontainers) or dedicated isolated test database per suite.
-    - Teardown: Must guarantee zero state leakage across test runs.
+    - **Scope:** Repository persistence adapters, database queries, migration scripts, HTTP client wrappers, framework wiring.
+    - **Isolation:** Ephemeral test containers (e.g. Testcontainers), in-memory databases, or isolated schema instances per test worker.
+    - **Teardown:** Must guarantee 100% state cleanup with zero leakage across test runs.
   </layer>
 
   <layer name="End-to-End Tests" path="tests/e2e/">
-    - Scope: Critical user journeys, full HTTP/gRPC API lifecycle, regression smoke tests.
-    - Verification: Validates end-to-end contract integrity across subsystems.
+    - **Scope:** Critical user journeys, public API lifecycle, full authentication flows, regression smoke tests.
+    - **Verification:** Validates end-to-end contract integrity across the entire system.
   </layer>
 </test_pyramid>
 
-## 2. Test Harness Policies
-<test_policies>
-  <policy name="Determinism">
-    Zero flaky tests. Tests must not depend on real wall-clock time (use frozen clocks or fake timers) or randomized execution order.
-  </policy>
+---
+
+## 2. Mocking Boundaries & Anti-Patterns
+
+<mocking_boundaries>
+  <rule id="mock_at_architectural_boundary">
+    **Mock at the boundaries, never at the core.** Only mock external infrastructure: third-party HTTP APIs, message brokers, email services, or system clock.
+  </rule>
+
+  <rule id="do_not_mock_domain_or_sut">
+    Never mock the System Under Test (SUT) or pure domain entities/value objects. If a domain entity is hard to instantiate without mocks, its design is coupled and requires refactoring.
+  </rule>
+
+  <rule id="verify_mock_interactions_sparingly">
+    Prefer asserting on return values and observable state changes rather than verifying exact method call counts (`toHaveBeenCalledTimes`), which couples tests to private implementation details.
+  </rule>
+</mocking_boundaries>
+
+---
+
+## 3. Test Fixture & Data Factory Hygiene
+
+<fixture_hygiene>
+  <rule id="data_factories_over_preseeded_db">
+    Use explicit test factories (or builder functions) with sensible defaults rather than relying on brittle, shared SQL seed dumps.
+  </rule>
+
+  <rule id="no_shared_mutable_fixtures">
+    Every test must instantiate its own data fixtures. Never share mutable state or global test variables between tests.
+  </rule>
+
+  <rule id="deterministic_teardown">
+    Always clean up database records, temp files, or mock registries in `afterEach` / `teardown` hooks to prevent cascading cross-test failures.
+  </rule>
+</fixture_hygiene>
+
+---
+
+## 4. Determinism & Flaky Test Zero-Tolerance
+
+<determinism>
+  <rule id="frozen_clock">
+    Never use real wall-clock time (`Date.now()`, `datetime.now()`) in time-sensitive assertions. Use frozen clocks or fake timers to ensure absolute reproducibility.
+  </rule>
+
+  <rule id="order_independence">
+    Tests must pass when run individually or in random order (`--randomize`). Never rely on one test running before another.
+  </rule>
+
+  <rule id="no_arbitrary_sleeps">
+    Never use arbitrary `sleep(1000)` in async tests. Use explicit polling helpers with timeouts (`waitFor`, `eventually`) that resolve as soon as the expected condition is met.
+  </rule>
+</determinism>
+
+---
+
+## 5. Assertion Precision & Failure Clarity
+
+<assertion_precision>
+  <rule id="exact_assertions">
+    Avoid vague assertions (e.g. `expect(res).toBeTruthy()`). Always assert exact expected values, HTTP status codes, and error codes.
+  </rule>
 
-  <policy name="Clean State">
-    Every test must seed its own data or fixtures. Tests must never assume pre-existing database rows.
-  </policy>
+  <rule id="actionable_failure_messages">
+    When custom assertions are used, provide clear error messages indicating what input was given and what specific invariant was violated.
+  </rule>
+</assertion_precision>
 
-  <policy name="Assertion Precision">
-    Avoid vague assertions (e.g. `expect(res).toBeTruthy()`). Always assert exact expected structures, status codes, and error types.
-  </policy>
+---
 
-  <policy name="Fast Feedback">
-    Unit tests must execute in under 30 seconds for the entire suite. Slow integration suites must be cleanly partitioned.
-  </policy>
-</test_policies>
+## 6. Verification Commands Mapping
 
-## 3. Verification Commands Mapping
 <verification_commands>
   <!-- Keep aligned with AGENTS.md <validation_commands> -->
-  <command type="unit">Run fast unit test suite</command>
-  <command type="integration">Run integration/e2e tests</command>
-  <command type="coverage">Run test coverage check</command>
+  <command type="unit">Run fast unit test suite (< 30 seconds total)</command>
+  <command type="integration">Run isolated integration/e2e tests</command>
+  <command type="typecheck">Run static type checker (zero errors, strict mode)</command>
+  <command type="lint">Run linter and format checker (zero warnings)</command>
+  <command type="coverage">Run test coverage report and threshold check</command>
 </verification_commands>
 
 </testing_context>