@damphuquy/agent-init 1.3.0 → 1.4.1

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.3.0",
+  "version": "1.4.1",
   "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/en/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

package/templates/{process → en/process}/README.md

@@ -13,6 +13,7 @@
 ```text
 process/
 ├── README.md                         # Operational guide (this file)
+├── .editorconfig                     # Unified format settings for markdown, tsv, json
 ├── _seeds/                           # Read-only archetype blueprints
 │   ├── _GUIDE.md                     # Full catalog, artifact chain, and instantiation commands
 │   ├── task-template.md.seed         # Master contract & RIPER state record
@@ -22,10 +23,13 @@ process/
 │   ├── state-template.md.seed        # Execute loop persistent memory
 │   ├── review-template.md.seed       # Review phase artifact (Gate 3)
 │   ├── handoff-template.md.seed      # Final projection (short)
+│   ├── cancellation-template.md.seed # Knowledge-preserving cancellation record
+│   ├── results-template.tsv.seed     # Benchmark & quantitative metrics tracker
 │   └── program-template.md.seed      # Multi-phase program blueprint
 ├── context/                          # Durable knowledge base & context routers
 │   ├── all-context.md                # Root context router
-│   └── planning/all-planning.md      # Planning calibration & vertical slicing rules
+│   ├── planning/all-planning.md      # Planning calibration & vertical slicing rules
+│   └── tests/all-tests.md            # Testing pyramid, harness policy & mock conventions
 ├── development-protocols/            # System rules & execution harness
 │   ├── all-development-protocols.md
 │   ├── orchestration.md              # Subagent delegation rules
@@ -39,7 +43,9 @@ process/
 │   │       ├── plan.md               # Plan phase output
 │   │       ├── state.md              # Execute loop memory
 │   │       ├── review.md             # Review phase output
-│   │       └── handoff.md            # Final projection
+│   │       ├── handoff.md            # Final projection
+│   │       ├── results.tsv           # (Optional) Benchmark & metric iteration tracking
+│   │       └── cancelled.md          # (If aborted) Cancellation findings & rollback status
 │   ├── completed/                    # Archived task workspaces
 │   └── backlog/                      # Backlog notes: {note_slug}_NOTE_{dd-mm-yy}.md
 └── general-plans/                    # Cross-cutting & standalone tasks
@@ -101,6 +107,8 @@ handoff.md       ← (Complete) Short final projection
 | Execute | source code + tests + `state.md` |
 | Review | `review.md` |
 | Handoff | `handoff.md` |
+| Cancellation | `cancelled.md` (knowledge preservation upon abort) |
+| Benchmark / Metrics | `results.tsv` (performance and eval metrics) |
 | Gate 1 | `decision.md` approval |
 | Gate 2 | `plan.md` approval |
 | Gate 3 | `review.md` approval |

package/templates/{process → en/process}/_seeds/_GUIDE.md

@@ -69,6 +69,16 @@
     blast radius registries, and phase gate rules.
   </seed>
 
+  <seed type="cancellation" path="cancellation-template.md.seed">
+    Task cancellation record. Preserves investigation findings, decision rationale,
+    reusable prototypes/tests, and rollback verification when an in-flight task is cancelled.
+  </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.
+  </seed>
+
 </catalog>
 
 ---
@@ -107,15 +117,28 @@ handoff.md      ← Final projection (short)
 
 ## 3. Recommended Task Workspace Layout
 
+### Standard Single-Project Layout
 ```text
 process/features/active/CHG-017-your-feature/
-├── task.md          ← instantiated from task-template.md.seed
-├── research.md      ← instantiated from context-group.md.seed
-├── decision.md      ← instantiated from decision-template.md.seed
-├── plan.md          ← instantiated from plan-template.md.seed
-├── state.md         ← instantiated from state-template.md.seed
-├── review.md        ← instantiated from review-template.md.seed
-└── handoff.md       ← instantiated from handoff-template.md.seed
+├── task.md          ← instantiated from task-template.md.seed (Master Spec & AC)
+├── research.md      ← instantiated from context-group.md.seed (Research Output)
+├── decision.md      ← instantiated from decision-template.md.seed (Gate 1 Options)
+├── plan.md          ← instantiated from plan-template.md.seed (Gate 2 Execution Contract)
+├── state.md         ← instantiated from state-template.md.seed (Execute Memory)
+├── 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)
+└── cancelled.md     ← (If cancelled) instantiated from cancellation-template.md.seed
+```
+
+### Monorepo / Multi-Domain Layout (Optional)
+When working in monorepos with independent domains (e.g. `mobile-app`, `billing-service`), partition features by domain:
+```text
+process/features/{domain-slug}/
+├── active/
+│   └── CHG-XXX-your-feature/
+├── backlog/
+└── completed/
 ```
 
 Not all artifacts are required at start. Create them progressively as the task advances through RIPER phases.
@@ -128,7 +151,7 @@ Not all artifacts are required at start. Create them progressively as the task a
 # Create a new task workspace
 mkdir -p process/features/active/CHG-XXX-your-feature
 
-# Instantiate seeds into the workspace
+# Instantiate primary seeds into the workspace
 cp process/_seeds/task-template.md.seed     process/features/active/CHG-XXX-your-feature/task.md
 cp process/_seeds/context-group.md.seed    process/features/active/CHG-XXX-your-feature/research.md
 cp process/_seeds/decision-template.md.seed process/features/active/CHG-XXX-your-feature/decision.md
@@ -136,6 +159,12 @@ cp process/_seeds/plan-template.md.seed    process/features/active/CHG-XXX-your-
 cp process/_seeds/state-template.md.seed   process/features/active/CHG-XXX-your-feature/state.md
 cp process/_seeds/review-template.md.seed  process/features/active/CHG-XXX-your-feature/review.md
 cp process/_seeds/handoff-template.md.seed process/features/active/CHG-XXX-your-feature/handoff.md
+
+# (Optional) Tracking performance or evaluation metrics:
+cp process/_seeds/results-template.tsv.seed process/features/active/CHG-XXX-your-feature/results.tsv
+
+# (When cancelling an in-flight task):
+cp process/_seeds/cancellation-template.md.seed process/features/active/CHG-XXX-your-feature/cancelled.md
 ```
 
 </seeds_guide>

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

@@ -0,0 +1,79 @@
+# Cancellation Record: [TASK-ID] [Task Title]
+
+<cancellation_record task_id="[TASK-ID]" version="1.0" framework="RIPER-5">
+
+<!--
+  TASK CANCELLATION GUIDELINES:
+  - Purpose: Preserve investigation knowledge, technical discoveries, and decision rationale when a task is aborted.
+  - Never delete a task workspace outright if research or partial planning has occurred.
+  - Instantiate this file as `cancelled.md` inside the task workspace.
+  - Complete the reversal checklist, then move the task directory to `completed/` (or `cancelled/`).
+-->
+
+<status>
+  <phase_at_cancellation>[RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW]</phase_at_cancellation>
+  <cancelled_date>[YYYY-MM-DD or 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. Rationale for Cancellation
+
+<cancellation_rationale>
+  <primary_reason>
+    <!-- [e.g. Pivot in product strategy / Architectural blocker / Excessive blast radius / Superseded by CHG-YYY] -->
+    [Concise summary of why this task was terminated prematurely.]
+  </primary_reason>
+
+  <decision_context>
+    [Detailed context, trade-offs evaluated, and key stakeholder guidance that led to cancellation.]
+  </decision_context>
+</cancellation_rationale>
+
+---
+
+## 2. Technical Findings & Preserved Knowledge
+
+<preserved_knowledge>
+  <codebase_discoveries>
+    <!-- What did we learn about the system, data models, or hidden dependencies during this task? -->
+    - [Discovery 1 — Component behavior, undocumented API limits, or legacy constraints]
+    - [Discovery 2 — Existing tests or subsystem boundaries uncovered]
+  </codebase_discoveries>
+
+  <invalidated_hypotheses>
+    <!-- What assumptions proved false during investigation? -->
+    - [Hypothesis that turned out incorrect or infeasible]
+  </invalidated_hypotheses>
+
+  <reusable_assets>
+    <!-- Are there test cases, draft schemas, benchmarks, or prototypes that future tasks can reuse? -->
+    - [Reusable asset 1: test cases or data models in draft branch / commit]
+  </reusable_assets>
+</preserved_knowledge>
+
+---
+
+## 3. Working Tree Reversal & Cleanup Checklist
+
+<cleanup_checklist>
+  - [ ] Uncommitted changes rolled back or stashed cleanly (`git status` clean)
+  - [ ] Temporary debug logs, scratch scripts, or test dumps deleted
+  - [ ] No phantom migrations or schema artifacts left in local database
+  - [ ] Task folder archived to `completed/` (or `cancelled/`)
+</cleanup_checklist>
+
+---
+
+## 4. Superseding Task or Follow-Up
+
+<follow_up>
+  <superseded_by>[Link to new task folder or CHG-YYY, or NONE]</superseded_by>
+  <recommended_next_action>
+    [Specific recommendations if this problem is revisited in the future.]
+  </recommended_next_action>
+</follow_up>
+
+</cancellation_record>

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

@@ -0,0 +1,5 @@
+# Benchmark & Metric Evaluation Registry (RIPER-5 Framework)
+# Instantiate as results.tsv in task workspace when tracking performance, latency, memory, or eval metrics.
+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	Initial baseline measurement
+1	2026-01-01T01:00:00Z	slice-01	p99_latency_ms	100.0	75.0	ms	-25.0%	PASS	Optimization slice 1 applied

package/templates/{process → en/process}/context/all-context.md

@@ -29,6 +29,12 @@
     <scope>Scaffolding seeds for tasks, research, decisions, plans, state, reviews, handoffs, and programs. Full artifact chain and instantiation commands.</scope>
   </group>
 
+  <group id="tests">
+    <title>Testing Standards & Harness Strategy</title>
+    <path>[`tests/all-tests.md`](tests/all-tests.md)</path>
+    <scope>Test pyramid, unit/integration isolation policies, mock conventions, and test fixtures</scope>
+  </group>
+
   <group id="protocols">
     <title>Development Protocols Index</title>
     <path>[`../development-protocols/all-development-protocols.md`](../development-protocols/all-development-protocols.md)</path>

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

@@ -0,0 +1,56 @@
+# Testing Standards & Harness Strategy Context
+
+<testing_context version="1.0">
+
+<overview>
+  Guidelines for test pyramid calibration, isolation policies, mock conventions, and automated verification harness across the system.
+</overview>
+
+## 1. Test Pyramid & Classification
+<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.
+  </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.
+  </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.
+  </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>
+
+  <policy name="Clean State">
+    Every test must seed its own data or fixtures. Tests must never assume pre-existing database rows.
+  </policy>
+
+  <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>
+
+## 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>
+</verification_commands>
+
+</testing_context>

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>