@damphuquy/agent-init 1.4.0 → 1.4.2

package/dist/ui.js

@@ -1,3 +1,5 @@
+import readline from 'node:readline';
+import process from 'node:process';
 export function stripAnsi(str) {
     return String(str).replace(/\x1b\[[0-9;]*m/g, '');
 }
@@ -58,6 +60,62 @@ export function renderBanner(pkgInfo, colors) {
     console.log(renderBox(bannerLines, colors));
     console.log();
 }
+export function askQuestion(query) {
+    if (process.stdin.destroyed || !process.stdin.readable) {
+        return Promise.resolve('');
+    }
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout,
+    });
+    return new Promise((resolve) => {
+        let resolved = false;
+        const onDone = (val) => {
+            if (!resolved) {
+                resolved = true;
+                rl.close();
+                resolve(val);
+            }
+        };
+        rl.question(query, (answer) => {
+            onDone(answer);
+        });
+        rl.on('close', () => {
+            onDone('');
+        });
+        rl.on('error', () => {
+            onDone('');
+        });
+    });
+}
+export async function promptLanguage(colors) {
+    if (process.env.CI || process.stdin.destroyed || !process.stdin.readable) {
+        return 'en';
+    }
+    const promptLines = [
+        colors.purple(colors.bold('SELECT TEMPLATE LANGUAGE / CHỌN NGÔN NGỮ TEMPLATE')),
+        '',
+        `  ${colors.cyan(colors.bold('1) English (eng / en)'))} ${colors.green('[Default]')}`,
+        `     ${colors.comment('Standard template set in English for international teams')}`,
+        '',
+        `  ${colors.teal(colors.bold('2) Tiếng Việt (vi)'))}`,
+        `     ${colors.comment('Bộ mẫu chuẩn hóa hoàn toàn bằng Tiếng Việt cho kỹ sư Việt Nam')}`,
+    ];
+    console.log(renderBox(promptLines, colors, { minWidth: 74 }));
+    console.log();
+    const answer = await askQuestion(`  ${colors.purple('?')} ${colors.bold('Choice / Lựa chọn')} ${colors.yellow('[1: English, 2: Tiếng Việt]')}${colors.dim(', default: 1')}: `);
+    console.log();
+    const trimmed = answer.trim().toLowerCase();
+    if (trimmed === '2' ||
+        trimmed === 'vi' ||
+        trimmed === 'vie' ||
+        trimmed === 'vietnamese' ||
+        trimmed === 'tieng viet' ||
+        trimmed === 'tiếng việt') {
+        return 'vi';
+    }
+    return 'en';
+}
 export function showHelp(pkgInfo, colors) {
     renderBanner(pkgInfo, colors);
     console.log(colors.purple(colors.bold('  USAGE')));
@@ -68,16 +126,23 @@ export function showHelp(pkgInfo, colors) {
     console.log(`    ${colors.cyan('target_directory')}  Destination path for workspace ${colors.comment('(default: .)')}`);
     console.log();
     console.log(colors.purple(colors.bold('  OPTIONS')));
-    console.log(`    ${colors.yellow('-f, --force')}       Overwrite existing files if already present`);
-    console.log(`    ${colors.yellow('-h, --help')}        Display this help documentation`);
-    console.log(`    ${colors.yellow('-v, --version')}     Display version number`);
+    console.log(`    ${colors.yellow('-l, --lang <en|vi>')}  Template language: 'en' / 'eng' (English) or 'vi' (Tiếng Việt)`);
+    console.log(`    ${colors.yellow('-f, --force')}        Overwrite existing files if already present`);
+    console.log(`    ${colors.yellow('-h, --help')}         Display this help documentation`);
+    console.log(`    ${colors.yellow('-v, --version')}      Display version number`);
     console.log();
     console.log(colors.purple(colors.bold('  EXAMPLES')));
-    console.log(`    ${colors.comment('# Scaffold into current directory:')}`);
+    console.log(`    ${colors.comment('# Interactive mode (prompts for English / Vietnamese):')}`);
     console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init .`);
     console.log();
-    console.log(`    ${colors.comment('# Scaffold into a specific project or subsystem:')}`);
-    console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init ./services/ai-agent`);
+    console.log(`    ${colors.comment('# Bootstrap directly with Vietnamese templates:')}`);
+    console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init . --lang vi`);
+    console.log();
+    console.log(`    ${colors.comment('# Bootstrap directly with English templates:')}`);
+    console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init . --lang en`);
+    console.log();
+    console.log(`    ${colors.comment('# Scaffold into a specific project:')}`);
+    console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init ./services/ai-agent --lang vi`);
     console.log();
     console.log(`    ${colors.comment('# Force overwrite existing files:')}`);
     console.log(`    ${colors.cyan('$')} npx @damphuquy/agent-init . --force`);

package/dist/ui.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@damphuquy/agent-init",
-  "version": "1.4.0",
+  "version": "1.4.2",
   "description": "Scaffolding CLI to bootstrap RIPER-5 Coding Agents & Operational Workspace",
   "type": "module",
   "main": "./dist/index.js",
@@ -23,7 +23,7 @@
     "prepublishOnly": "npm run build",
     "start": "node ./dist/cli.js",
     "scaffold": "node ./dist/cli.js",
-    "test": "node ./dist/cli.js --help"
+    "test": "node --test test/test-runner.js"
   },
   "keywords": [
     "ai-agent",

package/templates/vi/.agents/README.md

@@ -0,0 +1,29 @@
+# Tầng Điều Khiển Agent (`.agents/`)
+
+<agent_control_layer version="1.0">
+
+<purpose>
+  Quy chuẩn điều khiển Agent dùng chung, độc lập với dự án. Các tệp này định nghĩa
+  CÁCH Agent tư duy và hành xử — không quyết định những gì Agent xây dựng hay cách theo dõi task.
+
+  Sao chép nguyên vẹn thư mục này vào bất kỳ repository nào. Không cần chỉnh sửa riêng theo dự án.
+</purpose>
+
+<boundary>
+  `.agents/` quản lý: khai báo chế độ hoạt động (mode), giao thức khởi động session, ngân sách thử lại (retry budget),
+  điều kiện dừng khẩn cấp (escalation triggers), cổng hoàn thành (completion gate), và quy ước đặt tên / mã nguồn.
+
+  `.agents/` TUYỆT ĐỐI KHÔNG quản lý: quy trình task (→ `process/`), chuỗi artifact
+  (→ `process/_seeds/`), lệnh kiểm thử/build của dự án (→ `AGENTS.md`), hay ngữ cảnh nghiệp vụ
+  (→ `process/context/`).
+</boundary>
+
+## Danh Mục Tệp
+
+| Tệp | Mục đích |
+|-----|---------|
+| [`behavior.md`](behavior.md) | Khai báo mode, khởi động session, nạp lại trạng thái bền vững từ file |
+| [`guardrails.md`](guardrails.md) | Ngân sách thử lại, điều kiện kích hoạt dừng, điều kiện dừng, cổng hoàn thành |
+| [`conventions/naming.md`](conventions/naming.md) | Quy chuẩn đặt tên biến/hàm và vệ sinh mã nguồn phổ quát |
+
+</agent_control_layer>

package/templates/vi/.agents/behavior.md

@@ -0,0 +1,72 @@
+# Giao Thức Hành Vi Của Agent (Behavior Protocol)
+
+<behavior_protocol version="1.0">
+
+<description>
+  Quy tắc phổ quát quy định CÁCH Agent khai báo chế độ hoạt động (mode),
+  nạp lại trạng thái khi khởi động session và điều hướng ngữ cảnh. Dùng chung cho mọi dự án.
+</description>
+
+---
+
+## 1. Khai Báo Chế Độ Hoạt Động (Mode Declaration)
+
+Mọi phản hồi thúc đẩy tiến độ task BẮT BUỘC phải mở đầu bằng dòng khai báo mode
+ở ngay dòng đầu tiên. Chế độ khai báo phải khớp với giai đoạn hiện tại được ghi trong `task.md`.
+
+```
+[MODE: RESEARCH]   — chỉ đọc, không chỉnh sửa mã nguồn
+[MODE: INNOVATE]   — tạo phương án đề xuất, không chỉnh sửa mã nguồn
+[MODE: PLAN]       — lập kế hoạch lát cắt, không chỉnh sửa mã nguồn
+[MODE: EXECUTE]    — thực thi thay đổi mã nguồn trong phạm vi cho phép
+[MODE: REVIEW]     — nghiệm thu, không sửa mã nguồn trong lúc review
+```
+
+Chỉ lược bỏ khai báo mode đối với các trao đổi mang tính đàm thoại thuần túy không
+làm thay đổi tiến độ task (ví dụ: giải đáp câu hỏi kỹ thuật, làm rõ phạm vi yêu cầu).
+
+---
+
+## 2. Giao Thức Khởi Động Session (Session Startup Protocol)
+
+Trước khi tiếp tục bất kỳ task đang dang dở nào, nạp lại trạng thái bền vững theo đúng thứ tự sau:
+
+<startup_sequence>
+  1. Đọc `task.md` — xác nhận giai đoạn hiện tại và các cổng đang mở.
+  2. Đọc `research.md` nếu giai đoạn Research đã hoàn thành.
+  3. Đọc `decision.md` nếu giai đoạn Innovate đã hoàn thành — xác nhận các quyết định đã được duyệt.
+  4. Đọc `plan.md` — xác nhận chỉ số lát cắt (slice) hiện tại và hợp đồng phạm vi file.
+  5. Đọc `state.md` — xác nhận các slice đã xong, bộ nhớ lỗi (failure memory), ngân sách thử lại và hành động tiếp theo.
+  6. Đọc lại bất kỳ tệp mã nguồn nào đã thay đổi kể từ lần nạp ngữ cảnh gần nhất.
+</startup_sequence>
+
+**KHÔNG phụ thuộc vào bộ nhớ cửa sổ chat.** Luôn đối chiếu và xác thực
+dựa trên các tệp artifact được liệt kê ở trên.
+
+---
+
+## 3. Quy Tắc Điều Hướng Ngữ Cảnh (Context Navigation Rules)
+
+<context_rules>
+  <rule id="minimum_context">
+    Chỉ thu thập ngữ cảnh tối thiểu đủ dùng (Minimum Sufficient Context). Không quét toàn bộ repository
+    hay tự ý refactor ngoài phạm vi task đang thực thi.
+  </rule>
+
+  <rule id="information_priority">
+    Nạp ngữ cảnh theo đúng thứ tự ưu tiên sau:
+    1. Đặc tả task và tiêu chí nghiệm thu (`task.md`)
+    2. Artifact khảo sát và quyết định (`research.md`, `decision.md`)
+    3. Bộ kiểm thử liên quan (test suites)
+    4. Domain models và giao diện cổng (port interfaces)
+    5. Cấu hình và thiết lập dependency injection
+    6. Triển khai cụ thể hạ tầng (infrastructure implementations)
+  </rule>
+
+  <rule id="no_stale_context">
+    Đọc lại các tệp liên quan sau bất kỳ thay đổi nào trong repository. Tuyệt đối không
+    hành động dựa trên dữ liệu tạm đã lỗi thời trong bộ nhớ.
+  </rule>
+</context_rules>
+
+</behavior_protocol>

package/templates/vi/.agents/conventions/naming.md

@@ -0,0 +1,55 @@
+# Quy Chuẩn Đặt Tên & Vệ Sinh Mã Nguồn (Naming & Code Conventions)
+
+<naming_conventions version="1.0">
+
+<description>
+  Quy tắc vệ sinh mã nguồn phổ quát áp dụng cho mọi ngôn ngữ và dự án.
+  Quy tắc linting/formatting riêng của dự án nằm trong `AGENTS.md` và
+  `process/development-protocols/implementation-standards.md`.
+</description>
+
+---
+
+## 1. Quy Tắc Đặt Tên (Naming Rules)
+
+<naming_rules>
+  <rule id="no_leading_underscore">
+    Không dùng dấu gạch dưới mở đầu `_` cho tên hàm hoặc phương thức để ám chỉ
+    "private". Viết các hàm public rõ ràng, phẳng với tên tự giải thích mục đích.
+    Ngoại lệ: các dunder/magic methods bắt buộc của ngôn ngữ (ví dụ: `__init__` trong Python).
+  </rule>
+
+  <rule id="self_explanatory">
+    Tên gọi phải bộc lộ rõ ý định mà không cần comment giải thích thêm.
+    Ưu tiên `calculate_retry_delay()` thay vì `calc()` hay `do_thing()`.
+  </rule>
+
+  <rule id="no_abbreviations">
+    Tránh viết tắt khó hiểu. Viết `connection_timeout` thay vì `conn_to`,
+    `maximum_retry_count` thay vì `max_rtry_cnt`.
+    Ngoại lệ: các từ viết tắt phổ quát được hiểu chung (ví dụ: `url`, `id`, `api`).
+  </rule>
+</naming_rules>
+
+---
+
+## 2. Vệ Sinh Cấu Trúc (Structural Hygiene)
+
+<structural_rules>
+  <rule id="single_responsibility">
+    Mỗi hàm hoặc class chỉ có duy nhất một trách nhiệm được nêu rõ ràng.
+    Tách nhỏ khi một đơn vị làm nhiều hơn một việc.
+  </rule>
+
+  <rule id="no_magic_values">
+    Trích xuất toàn bộ giá trị số/chuỗi trực tiếp (magic literals) thành hằng số có tên hoặc file cấu hình.
+  </rule>
+
+  <rule id="no_suppression">
+    Tuyệt đối không tắt cảnh báo linter hoặc type checker bằng comment bỏ qua nội dòng
+    (`# type: ignore`, `# noqa`, `eslint-disable`, `@SuppressWarnings`, v.v.)
+    trừ khi chính việc bỏ qua đó được review rõ ràng và chú thích lý do cụ thể.
+  </rule>
+</structural_rules>
+
+</naming_conventions>

package/templates/vi/.agents/guardrails.md

@@ -0,0 +1,113 @@
+# Ranh Giới An Toàn Của Agent (Guardrails)
+
+<agent_guardrails version="1.0">
+
+<description>
+  Ranh giới an toàn phổ quát cho quá trình thực thi của Agent: ngân sách thử lại (retry budget),
+  điều kiện kích hoạt dừng khẩn cấp (escalation triggers), điều kiện dừng (stop conditions) và cổng hoàn thành.
+  Độc lập với dự án — áp dụng cho mọi ngôn ngữ, framework hoặc toolchain.
+</description>
+
+---
+
+## 1. Ngân Sách Thử Lại (Retry Budget)
+
+<retry_budget max_attempts="3">
+  Tối đa 3 lần thử lại liên tiếp cho cùng một triệu chứng lỗi.
+
+  Quy tắc:
+  - Tuyệt đối không giấu lỗi bằng các cờ bỏ qua kiểm tra (ví dụ: `# type: ignore`, `eslint-disable`,
+    `@SuppressWarnings`) để vượt qua cổng một cách giả tạo.
+  - Ghi nhận mọi lần thất bại vào `state.md > <failure_memory>` với:
+    - failure signature (mô tả triệu chứng lỗi duy nhất)
+    - hypothesis tested (giả thuyết nguyên nhân đã đặt ra)
+    - experiment run (thử nghiệm đã thực hiện)
+    - result observed (kết quả quan sát thực tế)
+  - Nếu hết ngân sách thử lại: DỪNG LẠI (HALT), ghi vào `<open_decisions>` trong `task.md`,
+    và yêu cầu con người hướng dẫn xử lý.
+</retry_budget>
+
+---
+
+## 2. Điều Kiện Kích Hoạt Dừng Khẩn Cấp (Escalation & Stop Conditions)
+
+<escalation_triggers>
+  Dừng lại ngay lập tức và yêu cầu con người hướng dẫn nếu BẤT KỲ điều nào sau đây xảy ra:
+
+  1. Ngân sách thử lại đã cạn kiệt cho một lỗi lặp đi lặp lại.
+  2. Thay đổi cần thiết chạm vào Public API, database schema, hoặc chính sách bảo mật
+     chưa được khai báo trong kế hoạch đã duyệt.
+  3. Thay đổi cần thiết chạm vào tệp nằm ngoài phạm vi được định nghĩa trong `plan.md`.
+  4. Cần một quyết định nghiệp vụ hoặc chính sách chưa có trong `<approved_decisions>`.
+  5. Cần mở rộng phạm vi ra ngoài mục `<out_of_scope>` trong `task.md`.
+
+  Ngoại lệ: KHÔNG dừng nếu thay đổi đã được người dùng ủy quyền rõ ràng
+  trong prompt/spec, hoặc nếu đó là tệp test đi kèm bắt buộc hay cập nhật import.
+</escalation_triggers>
+
+---
+
+## 3. Cổng Hoàn Thành (Completion Gate)
+
+<completion_gate>
+  Một task CHỈ ĐƯỢC COI LÀ HOÀN THÀNH khi TẤT CẢ các điều sau đồng thời thỏa mãn:
+
+  1. Mọi Tiêu chí nghiệm thu (AC) trong `task.md` đều được kiểm chứng (`- [x]`) kèm
+     bằng chứng được ghi lại trong `review.md`.
+  2. Mọi lệnh kiểm tra tự động (như định nghĩa trong `AGENTS.md`) thực thi với
+     0 lỗi (zero errors) và 0 cảnh báo (zero warnings).
+  3. Gate 3 trong `review.md` được đánh dấu đạt và quyết định review là PASS.
+  4. Lệnh `git diff` cuối cùng không chứa bất kỳ sửa đổi ngoài luồng hay chưa được review nào,
+     đồng thời mọi mã debug tạm thời / artifact scratch đã được dọn sạch 100%.
+  5. Thư mục task được di chuyển sang `completed/` và tệp `handoff.md` đã được tạo.
+</completion_gate>
+
+---
+
+## 4. Bảo Toàn Tính Bất Biến (Invariant Preservation)
+
+<invariants>
+  - Tuyệt đối không ghi đè hoặc xóa nội dung đặc tả do con người viết trong `task.md`.
+  - Chỉ đánh dấu `- [x]` sau khi lệnh kiểm chứng tương ứng thực sự pass —
+    không bao giờ tích trước.
+  - Giữ các chỉnh sửa trong phạm vi subsystem đã khai báo trừ khi có yêu cầu
+    phối hợp liên hệ thống rõ ràng và đã được phê duyệt.
+</invariants>
+
+---
+
+## 5. Ranh Giới An Toàn Lệnh & Danh Sách Cấm Phá Hủy (Command Safety & Blacklist)
+
+<command_safety>
+  Agent TUYỆT ĐỐI KHÔNG BAO GIỜ thực thi các lệnh có tính phá hủy, không thể hoàn nguyên hoặc làm rò rỉ thông tin xác thực:
+
+  - **Thao tác Git:** Không bao giờ chạy `git push --force`, `git push -f`, `git reset --hard`,
+    hoặc `git clean -fdx` trừ khi được kỹ sư con người ủy quyền rõ ràng trong session hiện tại.
+  - **Xóa File Hệ Thống:** Không bao giờ chạy lệnh xóa đệ quy không giới hạn (ví dụ: `rm -rf /`,
+    `rm -rf ~`, `rm -rf .`) hoặc xóa các tệp nằm ngoài phạm vi task đang hoạt động.
+  - **DDL/DML Cơ Sở Dữ Liệu:** Không bao giờ chạy các thao tác phá hủy dữ liệu khi chưa có sự chấp thuận rõ ràng
+    (`DROP DATABASE`, `DROP TABLE`, `TRUNCATE`, hoặc câu lệnh `DELETE` thiếu mệnh đề `WHERE` cụ thể).
+  - **Bí Mật & Chứng Thư (Secrets):** Không bao giờ đọc, in ra màn hình, ghi log hoặc export nội dung
+    `.env*`, `*.pem`, `*.key`, SSH keys hoặc credential cloud vào artifact task hoặc cửa sổ chat.
+  - **Cô Lập Môi Trường:** Chỉ thực thi lệnh thông qua khung kiểm thử chỉ định
+    `<validation_commands>` hoặc trình quản lý gói chuẩn. Không bao giờ tải và chạy các script
+    nhị phân từ xa tùy tiện (`curl ... | bash`).
+</command_safety>
+
+---
+
+## 6. Giao Thức Dọn Dẹp & Giải Phóng Phiên (Housekeeping & Teardown)
+
+<housekeeping_protocol>
+  Trước khi đề nghị ký duyệt Gate 3 hoặc đánh dấu task là COMPLETE, Agent phải dọn dẹp toàn diện:
+
+  1. **Xóa Debug Tạm Thời:** Gỡ bỏ toàn bộ các dòng log tạm (`console.log`, `print()`,
+     `debugger`, `dump()`, `pprint()`, hoặc các đoạn code thử nghiệm bị comment lại) sinh ra trong lúc làm việc.
+  2. **Dọn Dẹp Scratch:** Xóa các tệp mock tạm, script test nháp và tệp SQLite / dump dữ liệu tạm sinh ra
+     trong vòng lặp thực thi.
+  3. **Làm Sạch Git Diff:** Chạy `git status` và `git diff` để đảm bảo chỉ có các tệp
+     có chủ đích nằm trong phạm vi đã thống nhất ở `plan.md` bị thay đổi.
+  4. **Chốt Trạng Thái:** Đảm bảo `state.md` được đồng bộ sạch sẽ và tạo tệp `handoff.md`.
+</housekeeping_protocol>
+
+</agent_guardrails>

package/templates/vi/AGENTS.md

@@ -0,0 +1,133 @@
+# Hướng dẫn Điều phối Agent trong Repository (RIPER-5 Framework)
+
+<agent_guidelines version="4.0">
+
+<overview>
+  Cấu hình điểm khởi đầu (Entry-point) cho các AI Agent trong subsystem/project này.
+  Thiết lập các cài đặt riêng của dự án và kết nối 2 tầng quy chuẩn dùng chung:
+  - **`.agents/`** — quy tắc điều khiển hành vi của Agent (behavior, guardrails, conventions)
+  - **`process/`** — quy trình thực thi task, chuỗi artifact và cơ sở tri thức dài hạn
+
+  Tệp này CHỈ chứa những gì đặc thù của dự án: lệnh kiểm thử/build,
+  hiệu chỉnh ranh giới kiến trúc và tham chiếu đường dẫn.
+</overview>
+
+---
+
+## 1. Tham chiếu Tầng Điều khiển Agent (.agents/)
+
+<agent_control_ref>
+  Các quy tắc điều khiển Agent dùng chung nằm trong [`.agents/`](.agents/README.md):
+
+  | Tệp | Phạm vi quản lý |
+  |-----|----------------|
+  | [`.agents/behavior.md`](.agents/behavior.md) | Khai báo chế độ (Mode), khởi động session, thứ tự ưu tiên ngữ cảnh |
+  | [`.agents/guardrails.md`](.agents/guardrails.md) | Ngân sách thử lại (Retry budget), điều kiện kích hoạt dừng khẩn cấp, cổng hoàn thành |
+  | [`.agents/conventions/naming.md`](.agents/conventions/naming.md) | Quy chuẩn đặt tên và vệ sinh cấu trúc mã nguồn |
+
+  Đọc các tệp này khi bắt đầu session. Chúng không yêu cầu chỉnh sửa riêng cho từng dự án.
+</agent_control_ref>
+
+---
+
+## 2. 4 Trụ cột Cốt lõi (Core Pillars)
+
+<foundations>
+  <!-- Trụ cột 1: Task & Specification -->
+  <pillar id="task_spec" title="Task & Đặc tả (Specification)">
+    <rule>Nguồn sự thật duy nhất (Single Source of Truth): Tệp task đang thực thi trong [`process/features/active/{feature}/task.md`](process/features/) hoặc [`process/general-plans/active/{task}/task.md`](process/general-plans/) (khởi tạo từ [`process/_seeds/task-template.md.seed`](process/_seeds/task-template.md.seed)).</rule>
+    <rule>Định nghĩa thay đổi thông qua Mục tiêu (Goal), Hành vi hiện tại (Current Behavior), Hành vi kỳ vọng (Expected Behavior), Bất biến (Invariants) và Ngoài phạm vi (`<out_of_scope>`).</rule>
+    <rule>Tiêu chí nghiệm thu (Acceptance Criteria - AC) phải rõ ràng, kiểm chứng được dưới dạng checkbox markdown (`- [ ]`).</rule>
+    <rule>Mỗi task đều có bản hợp đồng master (`task.md`) và chuỗi artifact hoàn chỉnh: `research.md → decision.md → plan.md → state.md → review.md → handoff.md`.</rule>
+  </pillar>
+
+  <!-- Trụ cột 2: Context Navigation -->
+  <pillar id="context" title="Điều hướng & Nạp ngữ cảnh (Context Navigation)">
+    <rule>Chỉ thu thập ngữ cảnh tối thiểu đủ dùng (Minimum Sufficient Context). Tuyệt đối không quét toàn bộ repo hay tự ý refactor ngoài phạm vi.</rule>
+    <rule>Tuân thủ thứ tự ưu tiên thông tin được định nghĩa trong [`.agents/behavior.md`](.agents/behavior.md).</rule>
+    <rule>Định tuyến ngữ cảnh dự án thông qua [`process/context/all-context.md`](process/context/all-context.md).</rule>
+  </pillar>
+
+  <!-- Trụ cột 3: Engineering Harness & Guardrails -->
+  <pillar id="harness" title="Khung kiểm thử & Ranh giới an toàn (Harness & Guardrails)">
+    <validation_commands>
+      # ── Tùy chỉnh theo dự án: điều chỉnh các lệnh sau phù hợp với toolchain của bạn ──
+      # Python:  uv run pytest && uv run mypy --strict . && uv run ruff check . && uv run ruff format --check .
+      # Node/TS: npm run test && npm run typecheck && npm run lint
+      # Go:      go test ./... && go vet ./...
+    </validation_commands>
+    <architecture_guardrail>
+      Clean Architecture & Dependency Injection cung cấp định hướng cấu trúc, KHÔNG PHẢI
+      chỉ thị để làm phức tạp hóa quá mức các hàm tiện ích đơn giản.
+    </architecture_guardrail>
+  </pillar>
+</foundations>
+
+---
+
+## 3. Giao thức Vận hành RIPER-5 (Trụ cột 4: Vòng lặp)
+
+<riper5_protocol>
+
+  <!-- ─────────────────── RÀNG BUỘC TỪNG GIAI ĐOẠN ─────────────────── -->
+
+  <phase name="RESEARCH" order="1">
+    <constraint>CHỈ ĐỌC (READ-ONLY). Không chỉnh sửa mã nguồn.</constraint>
+    <constraint>Không tự ý ra quyết định triển khai.</constraint>
+    <constraint>Không tự ý chọn lựa kiến trúc.</constraint>
+    <output>Tạo/cập nhật `research.md`. Phân loại bằng chứng thành Đã xác nhận (Confirmed) / Quan sát thấy (Observed) / Giả thuyết (Hypothesized).</output>
+    <gate id="G0">Đánh dấu đạt tất cả Tiêu chí rời khỏi Khảo sát (Research Exit Criteria) trong `research.md` trước khi chuyển tiếp.</gate>
+  </phase>
+
+  <phase name="INNOVATE" order="2">
+    <constraint>CHỈ ĐỌC (READ-ONLY). Không chỉnh sửa mã nguồn.</constraint>
+    <constraint>Đề xuất 2–3 phương án khả thi kèm ma trận đánh đổi (Trade-off). KHÔNG tự ý đơn phương quyết định.</constraint>
+    <constraint>Tuyệt đối không tự ý quyết định Public API / DB schema / chính sách bảo mật / quy tắc nghiệp vụ khi chưa có sự phê duyệt của con người.</constraint>
+    <output>Tạo `decision.md`. Để trống phần `<engineer_decision>` — kỹ sư sẽ điền phần này.</output>
+    <gate id="G1">Gate 1 trong `decision.md` phải được kỹ sư kiểm tra và ký duyệt trước khi chuyển sang Plan.</gate>
+  </phase>
+
+  <phase name="PLAN" order="3">
+    <constraint>Chỉ tạo/sửa artifact lập kế hoạch. Không chỉnh sửa mã nguồn.</constraint>
+    <constraint>Mỗi lát cắt (slice) phải có công cụ kiểm chứng (verifier), bằng chứng kỳ vọng và điểm hoàn nguyên (rollback point).</constraint>
+    <constraint>Hợp đồng phạm vi (danh sách file được phép / cấm sửa) phải tường minh.</constraint>
+    <output>Tạo `plan.md`. Điền sẵn các tiêu đề của Ma trận Kiểm chứng (Verification Matrix).</output>
+    <gate id="G2">Gate 2 trong `plan.md` phải được kỹ sư kiểm tra và ký duyệt trước khi chuyển sang Execute.</gate>
+  </phase>
+
+  <phase name="EXECUTE" order="4">
+    <constraint>Chỉ đọc/ghi trong phạm vi file đã được phê duyệt trong `plan.md`.</constraint>
+    <constraint>Thực hiện từng lát cắt một. Chạy verifier sau mỗi slice. Kiểm tra diff sau mỗi slice.</constraint>
+    <constraint>Không refactor lan man. Không sửa các file bị cấm.</constraint>
+    <constraint>Cập nhật `state.md` ngay sau mỗi slice hoàn thành.</constraint>
+    <output>Mã nguồn + kiểm thử + cập nhật `state.md` kèm bằng chứng kiểm chứng.</output>
+  </phase>
+
+  <phase name="REVIEW" order="5">
+    <constraint>CHỈ ĐỌC (READ-ONLY). Có thể chạy các lệnh kiểm thử tự động.</constraint>
+    <constraint>Không sửa mã nguồn trong lúc review. Ghi nhận các phát hiện vào `review.md`.</constraint>
+    <constraint>Bao quát: hành vi (behavior), kiến trúc (architecture), dữ liệu (data), bảo mật (security), hồi quy (regression).</constraint>
+    <output>Tạo `review.md` với các phát hiện được phân loại theo danh mục/mức độ/loại và checklist Gate 3.</output>
+    <gate id="G3">Gate 3 trong `review.md` phải được ký duyệt trước khi bàn giao. Quyết định review phải là PASS.</gate>
+  </phase>
+
+  <!-- Quy tắc hành vi (khai báo mode, retry, escalation, cổng hoàn thành) →
+       xem .agents/behavior.md và .agents/guardrails.md -->
+
+</riper5_protocol>
+
+---
+
+## 4. Quy tắc Không gian Làm việc (Workspace Protocols)
+
+<workspace_rules>
+  <rule id="env">Thực thi mọi lệnh bên trong môi trường ảo / khung runtime được chỉ định.</rule>
+  <rule id="sync">Chỉ đánh dấu `- [x]` sau khi lệnh kiểm chứng tương ứng thực sự pass. Tuyệt đối không ghi đè đặc tả do con người viết.</rule>
+  <rule id="isolation">Giữ các chỉnh sửa trong phạm vi subsystem này trừ khi có yêu cầu phối hợp liên hệ thống rõ ràng.</rule>
+  <rule id="subagents">Việc phân công subagent phải tuân thủ [`process/development-protocols/orchestration.md`](process/development-protocols/orchestration.md).</rule>
+  <rule id="no_stale_context">Đọc lại các tệp liên quan sau khi mã nguồn trong repository thay đổi. Không dựa vào ngữ cảnh hội thoại đã cũ.</rule>
+  <rule id="command_safety">Không bao giờ chạy các lệnh phá hủy (force push, hard reset, rm -rf bừa bãi, DDL drop DB, đọc secrets). Xem .agents/guardrails.md.</rule>
+  <rule id="housekeeping">Dọn dẹp sạch sẽ toàn bộ debug log, artifact tạm (scratch) và kiểm tra git diff tinh gọn trước khi đề nghị Gate G3.</rule>
+</workspace_rules>
+
+</agent_guidelines>

package/templates/vi/process/.editorconfig

@@ -0,0 +1,15 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+indent_style = space
+indent_size = 2
+insert_final_newline = true
+trim_trailing_whitespace = true
+
+[*.tsv]
+indent_style = tab
+
+[*.md]
+trim_trailing_whitespace = false