@damphuquy/agent-init 1.4.3 → 1.4.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (10) hide show
  1. package/README.md +8 -7
  2. package/README.vi.md +2 -1
  3. package/dist/config.d.ts.map +1 -1
  4. package/dist/config.js +2 -0
  5. package/dist/config.js.map +1 -1
  6. package/package.json +1 -1
  7. package/templates/en/process/_seeds/_GUIDE.md +9 -0
  8. package/templates/en/process/_seeds/pause-template.md.seed +106 -0
  9. package/templates/vi/process/_seeds/_GUIDE.md +9 -0
  10. package/templates/vi/process/_seeds/pause-template.md.seed +106 -0
package/README.md CHANGED
@@ -17,17 +17,18 @@ npx @damphuquy/agent-init .
17
17
 
18
18
  ---
19
19
 
20
- ## 🚀 Documentation
20
+ ## Documentation
21
21
 
22
22
  Designed for minimal overhead, practical focus, and zero fluff:
23
23
 
24
24
  ### 1. For Daily Development (Start Here)
25
- * 📘 **[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.
26
- * ⚡ **[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).
25
+ * **[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.
26
+ * **[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).
27
+ * **[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`).
27
28
 
28
29
  ### 2. In-Depth Reference (For Tech Leads & Maintainers)
29
- * 🏛️ **[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).
30
- * 🚢 **[DevOps & Release Automation](docs/en/reference/devops-release.md)**: CI/CD release lifecycle, automated Semantic Versioning, and NPM package publishing.
30
+ * **[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).
31
+ * **[DevOps & Release Automation](docs/en/reference/devops-release.md)**: CI/CD release lifecycle, automated Semantic Versioning, and NPM package publishing.
31
32
 
32
33
  ---
33
34
 
@@ -47,7 +48,7 @@ Designed for minimal overhead, practical focus, and zero fluff:
47
48
 
48
49
  ---
49
50
 
50
- ## 📦 NPX CLI Commands
51
+ ## NPX CLI Commands
51
52
 
52
53
  ```bash
53
54
  # Bootstrap in current directory (interactive prompt: choose English or Tiếng Việt)
@@ -68,6 +69,6 @@ npx @damphuquy/agent-init . --force
68
69
 
69
70
  ---
70
71
 
71
- ## 📄 License
72
+ ## License
72
73
 
73
74
  Licensed under the [MIT License](LICENSE).
package/README.vi.md CHANGED
@@ -22,8 +22,9 @@ npx @damphuquy/agent-init .
22
22
  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à:
23
23
 
24
24
  ### 1. Dành cho công việc hằng ngày (Bắt đầu tại đây)
25
- * 📘 **[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.
25
+ * 📘 **[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.
26
26
  * ⚡ **[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).
27
+ * 🚀 **[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`).
27
28
 
28
29
  ### 2. Tài liệu Chuyên sâu & Tham khảo (Dành cho Lead / Maintainer)
29
30
  * 🏛️ **[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 CHANGED
@@ -1 +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"}
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,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 CHANGED
@@ -32,6 +32,7 @@ export const FILE_GROUPS_EN = [
32
32
  { path: 'process/_seeds/review-template.md.seed', desc: 'Review phase artifact & Gate 3' },
33
33
  { path: 'process/_seeds/handoff-template.md.seed', desc: 'Final projection (intentionally short)' },
34
34
  { path: 'process/_seeds/cancellation-template.md.seed', desc: 'Knowledge-preserving task cancellation record' },
35
+ { path: 'process/_seeds/pause-template.md.seed', desc: 'Task pause & parking record for temporary blockages' },
35
36
  { path: 'process/_seeds/results-template.tsv.seed', desc: 'Benchmark & quantitative metrics evaluation registry' },
36
37
  { path: 'process/_seeds/program-template.md.seed', desc: 'Multi-phase umbrella epic blueprint' },
37
38
  ],
@@ -94,6 +95,7 @@ export const FILE_GROUPS_VI = [
94
95
  { path: 'process/_seeds/review-template.md.seed', desc: 'Artifact giai đoạn Nghiệm thu (Review) & Gate 3' },
95
96
  { path: 'process/_seeds/handoff-template.md.seed', desc: 'Tóm tắt bàn giao cuối cùng (ngắn gọn)' },
96
97
  { path: 'process/_seeds/cancellation-template.md.seed', desc: 'Biên bản hủy task & lưu giữ tri thức' },
98
+ { path: 'process/_seeds/pause-template.md.seed', desc: 'Biên bản tạm dừng task & đóng băng an toàn' },
97
99
  { path: 'process/_seeds/results-template.tsv.seed', desc: 'Bảng theo dõi số liệu benchmark & định lượng' },
98
100
  { path: 'process/_seeds/program-template.md.seed', desc: 'Bản thiết kế chương trình lớn nhiều giai đoạn' },
99
101
  ],
package/dist/config.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"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"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@damphuquy/agent-init",
3
- "version": "1.4.3",
3
+ "version": "1.4.4",
4
4
  "description": "Scaffolding CLI to bootstrap RIPER-5 Coding Agents & Operational Workspace",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",
package/templates/en/process/_seeds/_GUIDE.md CHANGED
@@ -81,6 +81,11 @@
81
81
  reusable prototypes/tests, and rollback verification when an in-flight task is cancelled.
82
82
  </seed>
83
83
 
84
+ <seed type="pause" path="pause-template.md.seed">
85
+ Task pause and parking record. Preserves working tree state, slice snapshot,
86
+ resumption criteria, and stale-risk assessment when an in-flight task is temporarily frozen.
87
+ </seed>
88
+
84
89
  <seed type="results" path="results-template.tsv.seed">
85
90
  Benchmark and quantitative metrics evaluation registry.
86
91
  Use for tracking latency, throughput, memory, or eval scores across iterations and vertical slices.
@@ -135,6 +140,7 @@ process/features/active/CHG-017-your-feature/
135
140
  ├── review.md ← instantiated from review-template.md.seed (Gate 3 Audit)
136
141
  ├── handoff.md ← instantiated from handoff-template.md.seed (Final Projection)
137
142
  ├── results.tsv ← (Optional) instantiated from results-template.tsv.seed (Metrics/Benchmarks)
143
+ ├── paused.md ← (If paused) instantiated from pause-template.md.seed
138
144
  └── cancelled.md ← (If cancelled) instantiated from cancellation-template.md.seed
139
145
  ```
140
146
 
@@ -170,6 +176,9 @@ cp process/_seeds/handoff-template.md.seed process/features/active/CHG-XXX-your-
170
176
  # (Optional) Tracking performance or evaluation metrics:
171
177
  cp process/_seeds/results-template.tsv.seed process/features/active/CHG-XXX-your-feature/results.tsv
172
178
 
179
+ # (When pausing or parking an in-flight task):
180
+ cp process/_seeds/pause-template.md.seed process/features/active/CHG-XXX-your-feature/paused.md
181
+
173
182
  # (When cancelling an in-flight task):
174
183
  cp process/_seeds/cancellation-template.md.seed process/features/active/CHG-XXX-your-feature/cancelled.md
175
184
  ```
package/templates/en/process/_seeds/pause-template.md.seed ADDED
@@ -0,0 +1,106 @@
1
+ # Pause Record: [TASK-ID] [Task Title]
2
+
3
+ <pause_record task_id="[TASK-ID]" version="1.0" framework="RIPER-5">
4
+
5
+ <!--
6
+ TASK PAUSE & PARKING GUIDELINES:
7
+ - Purpose: Freeze in-flight tasks cleanly when blocked by external dependencies, shifting priorities, or waiting on human feedback.
8
+ - Never abandon an active task without recording the exact working tree state and resumption conditions.
9
+ - Instantiate this file as `paused.md` inside the task workspace.
10
+ - If the pause is long-term (> 2 weeks), move the task directory from `active/` to `backlog/` (or `paused/`) to keep `active/` clean.
11
+ -->
12
+
13
+ <status>
14
+ <phase_at_pause>[RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW]</phase_at_pause>
15
+ <paused_date>[YYYY-MM-DD or DD-MM-YY]</paused_date>
16
+ <paused_by>[@engineer_or_tech_lead]</paused_by>
17
+ <git_branch>[feature/CHG-XXX-description]</git_branch>
18
+ <git_state>[COMMITTED_WIP | STASHED | CLEAN]</git_state>
19
+ <git_commit_or_stash_ref>[e.g. git commit hash: a1b2c3d or stash@{0}]</git_commit_or_stash_ref>
20
+ </status>
21
+
22
+ ---
23
+
24
+ ## 1. Reason for Pause & Blockers
25
+
26
+ <pause_context>
27
+ <primary_reason>
28
+ <!-- [e.g. Blocked on upstream API Task CHG-042 / Awaiting security review / Priority preemption by P0 hotfix / Waiting on customer feedback] -->
29
+ [Concise description of why this task was paused.]
30
+ </primary_reason>
31
+
32
+ <blocker_details>
33
+ [Detailed context on blocking conditions, external tickets, or dependencies.]
34
+ </blocker_details>
35
+ </pause_context>
36
+
37
+ ---
38
+
39
+ ## 2. In-Flight Progress & Slice Snapshot
40
+
41
+ <progress_snapshot>
42
+ <completed_slices>
43
+ <!-- Which slices from plan.md have already passed their verifiers? -->
44
+ - [Slice 1: Objective — VERIFIED & COMMITTED]
45
+ </completed_slices>
46
+
47
+ <active_slice_at_pause>
48
+ <!-- What was being worked on when paused? -->
49
+ <slice_id>[e.g. Slice 2]</slice_id>
50
+ <state_summary>[e.g. Service logic implemented, 2 unit tests written but failing due to mock issue]</state_summary>
51
+ </active_slice_at_pause>
52
+
53
+ <touched_files>
54
+ <!-- List of files modified or created during active work -->
55
+ - `src/...`
56
+ - `tests/...`
57
+ </touched_files>
58
+ </progress_snapshot>
59
+
60
+ ---
61
+
62
+ ## 3. Resumption Criteria
63
+
64
+ <resumption_criteria>
65
+ <!-- What explicit event, ticket resolution, or condition unlocks this task? -->
66
+ <trigger_condition>
67
+ [e.g. CHG-042 merged to main and published to staging environment]
68
+ </trigger_condition>
69
+
70
+ <responsible_owner>[@engineer_to_notify]</responsible_owner>
71
+ </resumption_criteria>
72
+
73
+ ---
74
+
75
+ ## 4. Stale-Risk Assessment (Bit-Rot Warnings)
76
+
77
+ <stale_risk_assessment>
78
+ <!-- What might decay or drift if this task remains parked for weeks/months? -->
79
+ <schema_drift_risk level="[LOW|MEDIUM|HIGH]">
80
+ [Potential DB migration or API contract changes occurring in parallel.]
81
+ </schema_drift_risk>
82
+
83
+ <dependency_drift_risk level="[LOW|MEDIUM|HIGH]">
84
+ [Libraries or internal shared modules that may be upgraded in the interim.]
85
+ </dependency_drift_risk>
86
+
87
+ <architecture_drift_risk level="[LOW|MEDIUM|HIGH]">
88
+ [Refactorings or new conventions that might invalidate assumptions in research.md.]
89
+ </architecture_drift_risk>
90
+ </stale_risk_assessment>
91
+
92
+ ---
93
+
94
+ ## 5. Resumption Pre-Flight Checklist
95
+
96
+ <resumption_checklist>
97
+ <!-- MUST execute in order before restarting EXECUTE loop -->
98
+ - [ ] 1. Move task folder back to `active/` (if it was parked in `backlog/`).
99
+ - [ ] 2. Checkout feature branch and rebase/merge latest `main` (`git checkout <branch> && git pull --rebase origin main`).
100
+ - [ ] 3. Run validation commands on baseline (`npm run test && npm run lint`) to ensure codebase is green.
101
+ - [ ] 4. Perform Context Freshness Check: Re-read `task.md`, `state.md`, and verify if assumptions in `research.md` still hold.
102
+ - [ ] 5. If `<allowed_files>` were altered on `main`, update `plan.md` scope contract before executing code.
103
+ - [ ] 6. Delete or archive `paused.md` and resume the current slice in `state.md`.
104
+ </resumption_checklist>
105
+
106
+ </pause_record>
package/templates/vi/process/_seeds/_GUIDE.md CHANGED
@@ -81,6 +81,11 @@
81
81
  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.
82
82
  </seed>
83
83
 
84
+ <seed type="pause" path="pause-template.md.seed">
85
+ 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,
86
+ đ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.
87
+ </seed>
88
+
84
89
  <seed type="results" path="results-template.tsv.seed">
85
90
  Bảng đăng ký đánh giá số liệu benchmark và định lượng.
86
91
  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.
@@ -135,6 +140,7 @@ process/features/active/CHG-017-your-feature/
135
140
  ├── review.md ← khởi tạo từ review-template.md.seed (Biên bản kiểm toán Gate 3)
136
141
  ├── handoff.md ← khởi tạo từ handoff-template.md.seed (Tóm tắt bàn giao)
137
142
  ├── results.tsv ← (Tùy chọn) khởi tạo từ results-template.tsv.seed (Metrics/Benchmarks)
143
+ ├── paused.md ← (Nếu tạm dừng) khởi tạo từ pause-template.md.seed
138
144
  └── cancelled.md ← (Nếu hủy task) khởi tạo từ cancellation-template.md.seed
139
145
  ```
140
146
 
@@ -170,6 +176,9 @@ cp process/_seeds/handoff-template.md.seed process/features/active/CHG-XXX-your-
170
176
  # (Tùy chọn) Khi cần theo dõi hiệu năng hoặc số liệu benchmark:
171
177
  cp process/_seeds/results-template.tsv.seed process/features/active/CHG-XXX-your-feature/results.tsv
172
178
 
179
+ # (Khi cần tạm dừng hoặc đóng băng task đang làm):
180
+ cp process/_seeds/pause-template.md.seed process/features/active/CHG-XXX-your-feature/paused.md
181
+
173
182
  # (Khi cần hủy bỏ một task đang dang dở):
174
183
  cp process/_seeds/cancellation-template.md.seed process/features/active/CHG-XXX-your-feature/cancelled.md
175
184
  ```
package/templates/vi/process/_seeds/pause-template.md.seed ADDED
@@ -0,0 +1,106 @@
1
+ # Biên Bản Tạm Dừng Task: [TASK-ID] [Tiêu Đề Task]
2
+
3
+ <pause_record task_id="[TASK-ID]" version="1.0" framework="RIPER-5">
4
+
5
+ <!--
6
+ HƯỚNG DẪN TẠM DỪNG & ĐÓNG BĂNG TASK (TASK PAUSE):
7
+ - 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.
8
+ - 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.
9
+ - Khởi tạo file này thành `paused.md` bên trong thư mục task đang làm.
10
+ - 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.
11
+ -->
12
+
13
+ <status>
14
+ <phase_at_pause>[RESEARCH | INNOVATE | PLAN | EXECUTE | REVIEW]</phase_at_pause>
15
+ <paused_date>[YYYY-MM-DD hoặc DD-MM-YY]</paused_date>
16
+ <paused_by>[@engineer_hoac_tech_lead]</paused_by>
17
+ <git_branch>[feature/CHG-XXX-mo-ta]</git_branch>
18
+ <git_state>[COMMITTED_WIP | STASHED | CLEAN]</git_state>
19
+ <git_commit_or_stash_ref>[ví dụ: commit hash a1b2c3d hoặc stash@{0}]</git_commit_or_stash_ref>
20
+ </status>
21
+
22
+ ---
23
+
24
+ ## 1. Lý Do Tạm Dừng & Yếu Tố Chặn (Blockers)
25
+
26
+ <pause_context>
27
+ <primary_reason>
28
+ <!-- [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] -->
29
+ [Tóm tắt ngắn gọn lý do tại sao task này phải tạm dừng.]
30
+ </primary_reason>
31
+
32
+ <blocker_details>
33
+ [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.]
34
+ </blocker_details>
35
+ </pause_context>
36
+
37
+ ---
38
+
39
+ ## 2. Tiến Độ Đang Làm & Snapshot Lát Cắt (Slice)
40
+
41
+ <progress_snapshot>
42
+ <completed_slices>
43
+ <!-- Những slice nào trong plan.md đã vượt qua verifier thành công? -->
44
+ - [Slice 1: Mục tiêu — ĐÃ KIỂM THỬ XANH & COMMIT]
45
+ </completed_slices>
46
+
47
+ <active_slice_at_pause>
48
+ <!-- Slice nào đang dang dở khi dừng? -->
49
+ <slice_id>[ví dụ: Slice 2]</slice_id>
50
+ <state_summary>[ví dụ: Đã viết xong logic service, đang viết 2 unit test nhưng còn lỗi mock]</state_summary>
51
+ </active_slice_at_pause>
52
+
53
+ <touched_files>
54
+ <!-- Danh sách file đã sửa hoặc tạo mới trong quá trình thực thi -->
55
+ - `src/...`
56
+ - `tests/...`
57
+ </touched_files>
58
+ </progress_snapshot>
59
+
60
+ ---
61
+
62
+ ## 3. Điều Kiện Kích Hoạt Lại (Resumption Criteria)
63
+
64
+ <resumption_criteria>
65
+ <!-- Sự kiện, ticket hay điều kiện cụ thể nào sẽ mở khóa để tiếp tục task này? -->
66
+ <trigger_condition>
67
+ [ví dụ: CHG-042 được merge vào main và deploy lên môi trường staging]
68
+ </trigger_condition>
69
+
70
+ <responsible_owner>[@ky_su_phu_trach]</responsible_owner>
71
+ </resumption_criteria>
72
+
73
+ ---
74
+
75
+ ## 4. Đánh Giá Nguy Cơ Lỗi Thời (Stale-Risk & Bit-Rot)
76
+
77
+ <stale_risk_assessment>
78
+ <!-- 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? -->
79
+ <schema_drift_risk level="[LOW|MEDIUM|HIGH]">
80
+ [Nguy cơ database migration hoặc schema API thay đổi song song trên main.]
81
+ </schema_drift_risk>
82
+
83
+ <dependency_drift_risk level="[LOW|MEDIUM|HIGH]">
84
+ [Nguy cơ thư viện phụ thuộc hoặc module dùng chung được nâng cấp phiên bản.]
85
+ </dependency_drift_risk>
86
+
87
+ <architecture_drift_risk level="[LOW|MEDIUM|HIGH]">
88
+ [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.]
89
+ </architecture_drift_risk>
90
+ </stale_risk_assessment>
91
+
92
+ ---
93
+
94
+ ## 5. Checklist Kiểm Tra Trước Khi Khởi Động Lại (Pre-Flight Resumption)
95
+
96
+ <resumption_checklist>
97
+ <!-- BẮT BUỘC thực hiện tuần tự trước khi mở lại vòng lặp EXECUTE -->
98
+ - [ ] 1. Chuyển thư mục task trở lại `active/` (nếu trước đó đã cất vào `backlog/`).
99
+ - [ ] 2. Checkout đúng branch và rebase/merge code mới nhất từ `main` (`git checkout <branch> && git pull --rebase origin main`).
100
+ - [ ] 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.
101
+ - [ ] 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.
102
+ - [ ] 5. Nếu `<allowed_files>` bị thay đổi trên `main`, cập nhật lại phạm vi trong `plan.md`.
103
+ - [ ] 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ở.
104
+ </resumption_checklist>
105
+
106
+ </pause_record>