dw-kit 1.0.0

package/.claude/skills/dw-thinking/SKILL.md

@@ -0,0 +1,70 @@
+---
+name: dw-thinking
+description: "Áp dụng framework tư duy phản biện, hệ thống và đa góc nhìn vào vấn đề. Auto-load khi planning hoặc khi cần phân tích sâu. Dùng proactively."
+argument-hint: "[vấn đề cần phân tích]"
+user-invocable: true
+---
+
+# Framework Tư Duy — Áp Dụng Vào Task
+
+Vấn đề: **$ARGUMENTS**
+
+## Nạp Framework
+
+@THINKING.md
+
+---
+
+## Áp Dụng Vào Task Hiện Tại
+
+Sau khi đọc framework trên, áp dụng vào vấn đề `$ARGUMENTS`:
+
+### 1. Tư Duy Phản Biện
+
+**Giả định đang dùng:**
+- [ ] [Giả định 1] — Cách kiểm chứng: ...
+- [ ] [Giả định 2]
+
+**Rủi ro chính (top 3):**
+1. [Rủi ro] — Xác suất: Cao/TB/Thấp — Tác động: ...
+2. ...
+3. ...
+
+**Phương án thay thế đã loại:**
+- [Phương án A] — Loại vì: ...
+
+**Edge cases cần xử lý:**
+- [ ] [Edge case 1]
+
+### 2. Tư Duy Hệ Thống
+
+**Dependencies:**
+- Upstream: [ai/module gì phụ thuộc vào]
+- Downstream: [bị ảnh hưởng bởi thay đổi này]
+
+**Tác động cascade:**
+- Nếu thay đổi X → Y bị ảnh hưởng → Z cần cập nhật
+
+**Failure modes:**
+- [Nếu phần A fail → hệ thống phản ứng thế nào]
+
+### 3. Đa Góc Nhìn
+
+| Góc nhìn | Câu hỏi | Đánh giá |
+|----------|---------|----------|
+| User | [Ảnh hưởng UX?] | [OK / Concern] |
+| Developer | [Maintainable?] | |
+| Security | [Expose gì?] | |
+| Ops | [Deploy issues?] | |
+| Business | [Giá trị delivered?] | |
+
+### 4. Kết Luận
+
+**Quyết định:**
+[Approach được chọn và lý do]
+
+**Trade-offs chấp nhận:**
+[Điểm yếu nào của approach này được chấp nhận]
+
+**Điểm cần monitor:**
+[Theo dõi gì sau khi implement]

package/.claude/skills/dw-thinking/THINKING.md

@@ -0,0 +1,91 @@
+# Tư Duy Phản Biện, Hệ Thống & Đa Góc Nhìn
+
+Tài liệu này hướng dẫn cách áp dụng **tư duy phản biện tích cực**, **tư duy hệ thống** và **đa góc nhìn** khi lập kế hoạch, nghiên cứu và triển khai tasks — dùng cho cả người và agent.
+
+---
+
+## 1. Tư duy phản biện tích cực (Critical Thinking)
+
+**Mục đích:** Không chấp nhận giả định một chiều; đặt câu hỏi, xem xét rủi ro và phương án thay thế để ra quyết định tốt hơn.
+
+### 1.1 Câu hỏi nên đặt khi đọc/viết Research & Plan
+
+- **Giả định:** Những giả định nào đang được coi là đúng? Nếu sai thì ảnh hưởng thế nào?
+- **Bằng chứng:** Kết luận dựa trên đâu (code, doc, đo lường)? Thiếu bằng chứng ở đâu?
+- **Edge case:** Trường hợp biên nào có thể làm hỏng thiết kế (user xóa, group đổi, đồng thời, rollback)?
+- **Rủi ro:** Rủi ro kỹ thuật, vận hành, bảo mật nào? Xác suất và tác động?
+- **Phương án thay thế:** Còn cách nào khác đạt mục tiêu? Trade-off so với phương án hiện tại?
+- **Ngược lại:** Nếu *không* làm tính năng này thì sao? Có cách nào đơn giản hơn (workaround, process thủ công)?
+
+### 1.2 Áp dụng trong task
+
+- Trong **Research**: Ghi rõ "Giả định", "Hạn chế đã biết", "Chưa rõ / cần kiểm chứng".
+- Trong **Plan**: Có mục **Rủi ro & Giả định** và **Phương án thay thế đã xem xét**; **Edge cases / Điều kiện bất thường** cần xử lý.
+- Khi **thực hiện**: Nếu phát hiện giả định sai hoặc rủi ro mới → dừng lại ghi vào Changelog/Notes và (nếu cần) cập nhật plan.
+
+---
+
+## 2. Tư duy hệ thống (Systems Thinking)
+
+**Mục đích:** Xem task trong bối cảnh hệ thống lớn: phụ thuộc, tác động lan truyền, ranh giới, vòng lặp phản hồi.
+
+### 2.1 Các khía cạnh cần xem xét
+
+- **Phụ thuộc (Dependencies):** Task này phụ thuộc vào module/API/data nào? Ai phụ thuộc vào kết quả của task này (frontend, tích hợp, cron)?
+- **Biên giới (Boundaries):** Ranh giới rõ ràng giữa "bên trong task" và "bên ngoài" (upstream, admin, bên thứ ba)? Giao diện (API, schema) ổn định chưa?
+- **Luồng dữ liệu:** Dữ liệu đi từ đâu đến đâu? Có thêm DB, cache, queue không? Consistency và thứ tự cập nhật?
+- **Tác động ngược (Feedback):** Thay đổi có tạo vòng lặp không (vd: share → notification → user vào share → lại trigger)? Cần giới hạn hoặc debounce?
+- **Failure mode:** Một phần hệ thống lỗi thì task/hệ thống còn lại ứng xử thế nào (graceful degradation, rollback, alert)?
+- **Scale & performance:** Khi số lượng share/recipient/user tăng, điểm nghẽn ở đâu (query N+1, index, lock)?
+
+### 2.2 Áp dụng trong task
+
+- **Plan** có mục **Tác động hệ thống**: danh sách module/API bị ảnh hưởng; migration/backward compatibility.
+- **Research** nên vẽ (hoặc mô tả) luồng hiện tại và vị trí task trong bức tranh lớn.
+- **Subtasks** tách rõ "thay đổi schema", "thay đổi service", "thay đổi route", "ảnh hưởng frontend" để dễ review dependency.
+
+---
+
+## 3. Đa góc nhìn (Multiple Perspectives)
+
+**Mục đích:** Tránh tối ưu cho một vai duy nhất; cân bằng nhu cầu của nhiều bên liên quan và bối cảnh khác nhau.
+
+### 3.1 Các góc nhìn gợi ý
+
+| Góc nhìn | Câu hỏi điển hình |
+|----------|--------------------|
+| **End user** | Dễ dùng không? Hiểu rõ feature vs use cases? Thu hồi có rõ ràng không? |
+| **Admin** | Quản lý share/recipient toàn hệ thống thế nào? Audit, abuse (spam share)? |
+| **Developer / Maintainer** | Code dễ đọc, dễ test không? API nhất quán với phần còn lại? |
+| **Ops / Vận hành** | Backup, restore, migration? Log, metric, debug khi lỗi? |
+| **Bảo mật** | Ai được xem/tải gì? Lộ gì? lộ metadata? Rate limit, audit log? |
+| **Sản phẩm / Business** | Giải quyết đúng pain point chưa? Có thể launch từng phần (phase1, phase2,...)? |
+| **Thời gian:** ngắn hạn vs dài hạn | Ship nhanh vs kiến trúc bền vững; tech debt có chấp nhận tạm không? |
+
+### 3.2 Áp dụng trong task
+
+- Trong **Plan**: mục **Góc nhìn & Trade-off** — với mỗi quyết định lớn, ghi ngắn tác động lên user / admin / dev / security.
+- **Acceptance criteria** có thể tách: "User: ...", "Admin: ...", "Security: ...".
+- Khi **review** hoặc **agent thực hiện**: nếu chỉ làm đúng "yêu cầu kỹ thuật" mà bỏ qua góc admin/security → nhắc bổ sung.
+
+---
+
+## 4. Checklist nhanh khi tạo/cập nhật task
+
+- [ ] **Research:** Đã ghi giả định, hạn chế, chưa rõ?
+- [ ] **Plan:** Có mục Rủi ro & Giả định, Phương án thay thế, Edge cases?
+- [ ] **Plan:** Có mục Tác động hệ thống (module, API, migration)?
+- [ ] **Plan:** Có xem xét ít nhất 2–3 góc nhìn (user, admin, security hoặc dev)?
+- [ ] **Subtasks:** Thứ tự có tính đến dependency và failure mode không?
+- [ ] **Changelog:** Khi giả định sai hoặc rủi ro mới xuất hiện, đã ghi lại chưa?
+
+---
+
+## 5. Gợi ý prompt cho Agent
+
+Khi giao task cho agent, có thể thêm:
+
+- "Khi làm task nên áp dụng kết hợp tư duy trong `.claude/skills/dw-thinking/THINKING.md`: xem xét rủi ro và edge case, tác động lên các module khác, và ít nhất 2 góc nhìn (vd: user + security). Nếu phát hiện giả định sai hoặc thiếu, ghi vào Notes/Changelog của task."
+- "Trước khi implement, liệt kê ngắn: (1) giả định đang dùng, (2) 2 rủi ro chính, (3) 1 phương án thay thế đã loại và lý do."
+
+Như vậy agent vừa làm đúng spec vừa bổ sung tư duy phản biện và hệ thống vào doc, giúp người review và task sau có thêm ngữ cảnh.

package/.claude/skills/dw-upgrade/SKILL.md

@@ -0,0 +1,82 @@
+---
+name: dw-upgrade
+description: "Upgrade dv-workflow-kit lên version mới. So sánh toolkit files, báo cáo thay đổi, cho phép selective update mà không overwrite customizations."
+argument-hint: ""
+---
+
+# Upgrade dv-workflow-kit
+
+## Điều Kiện Tiên Quyết
+
+Skill này yêu cầu toolkit được cài qua git submodule tại `.dw-module/`.
+
+## Bước 1: Kiểm tra setup
+
+Kiểm tra `.dw-module/` có tồn tại và là git repo:
+```bash
+ls .dw-module/.git
+```
+
+Nếu không có → thông báo: "Toolkit chưa được cài dạng git submodule. Xem `examples/integration-guide/README.md`."
+
+## Bước 2: Pull version mới nhất
+
+```bash
+cd .dv-workflow && git fetch origin && git log origin/main --oneline -5
+```
+
+Hiển thị 5 commits mới nhất của upstream để user biết có gì thay đổi.
+
+## Bước 3: Backup config
+
+Trước khi update, backup config hiện tại:
+```bash
+cp .dw/config/dw.config.yml .dw/config/dw.config.yml.backup-$(date +%Y%m%d)
+```
+
+Thông báo: "Config đã backup tại `.dw/config/dw.config.yml.backup-[date]`"
+
+## Bước 4: Update submodule
+
+```bash
+cd .dv-workflow && git pull origin main
+```
+
+## Bước 5: So sánh và update files
+
+Chạy setup script với mode update (không overwrite):
+```bash
+bash .dw-module/examples/integration-guide/setup.sh
+```
+
+Script dùng `cp -n` (no-clobber) — chỉ copy files MỚI, không overwrite files đã customize.
+
+## Bước 6: Báo cáo kết quả
+
+```
+=== Upgrade Report ===
+
+Từ: [old version/commit]
+Đến: [new version/commit]
+
+Files mới (đã copy):
+  + .claude/skills/dw-[new-skill]/SKILL.md
+  + .claude/templates/en/task-context.md
+
+Files đã thay đổi trong toolkit (KHÔNG tự động update vì bạn có thể đã customize):
+  ~ .claude/skills/dw-task-init/SKILL.md   — xem diff: git diff .dw-module/.claude/skills/dw-task-init/SKILL.md
+  ~ .claude/agents/planner.md
+
+Files của bạn (giữ nguyên):
+  = .dw/config/dw.config.yml  (backup tại .backup-[date])
+
+Lưu ý:
+  - Review các files "đã thay đổi" và merge thủ công nếu cần
+  - Xem CHANGELOG tại .dw-module/CHANGELOG.md để biết breaking changes
+  - Chạy /dw-config-validate sau khi upgrade để kiểm tra config
+```
+
+## Bước 7: Cleanup backup (tùy chọn)
+
+Hỏi user: "Bạn có muốn xóa file backup config không? (y/n)"
+Nếu y: `rm .dw/config/dw.config.yml.backup-*`

package/.claude/templates/en/task-context.md

@@ -0,0 +1,73 @@
+# Context: [Task Name]
+
+## Survey date: [date]
+## Performed by: [dev / agent]
+
+---
+
+## Original Requirements
+
+> [Copy/paste requirements from user, ticket, or BA requirements doc]
+
+## Codebase Analysis
+
+### Related Files
+
+| # | File | Role | Needs change? | Notes |
+|---|------|------|---------------|-------|
+| 1 | | | | |
+
+### Current Architecture
+
+```
+[Describe current flow, ASCII diagram if needed]
+
+Input → [Module A] → [Module B] → Output
+                ↓
+          [Database]
+```
+
+### Data Flow
+
+- **Input**: [Where does input come from, what format]
+- **Processing**: [Main processing logic]
+- **Output**: [Where does output go, what format]
+- **Storage**: [Where is it stored, what schema]
+
+## Dependencies
+
+### Upstream (task depends on)
+- [ ] [Module/API/Service] — [role]
+
+### Downstream (affected by this task)
+- [ ] [Module/API/Service] — [how affected]
+
+## Patterns & Conventions Found
+
+| Pattern | Description | Example (file:line) |
+|---------|-------------|---------------------|
+| | | |
+
+## Current Test Coverage
+
+- [ ] Are there tests for the affected area? [Yes/No]
+- Test files: [list]
+- Coverage: [% or description]
+- Gaps: [where tests are missing]
+
+## Assumptions
+
+| # | Assumption | Needs verification? | If wrong, impact? |
+|---|-----------|---------------------|-------------------|
+| 1 | | Yes / No | |
+
+## Known Constraints
+- [Constraint 1]
+
+## Unclear / Needs Clarification
+- [ ] [Question 1] — who to ask?
+- [ ] [Question 2]
+
+## Additional Notes
+
+[Any other important information: gotchas, tech debt, recent change history]

package/.claude/templates/en/task-plan.md

@@ -0,0 +1,79 @@
+# Plan: [Task Name]
+
+## Created: [date]
+## Status: Draft | Approved | In Progress | Done
+## Approved by: [name / role]
+
+---
+
+## Solution Summary
+
+[1-2 paragraphs describing the goal and chosen approach]
+
+## Options Considered
+
+| # | Option | Pros | Cons | Selected? |
+|---|--------|------|------|-----------|
+| 1 | [Approach A] | | | **Selected** |
+| 2 | [Approach B] | | | Rejected — reason: |
+
+## Subtasks
+
+### ST-1: [Subtask name]
+- **Description**: [Specific, actionable]
+- **Files**: [List of files to change]
+- **Acceptance Criteria**:
+  - [ ] [Condition 1]
+  - [ ] [Condition 2]
+- **Dependencies**: none
+- **Estimate**: [effort — if estimation enabled]
+
+### ST-2: [Subtask name]
+- **Description**: ...
+- **Files**: ...
+- **Acceptance Criteria**:
+  - [ ] ...
+- **Dependencies**: ST-1
+- **Estimate**: ...
+
+<!-- Add more subtasks as needed -->
+
+## Risks & Assumptions
+
+| # | Type | Description | Probability | Impact | Mitigation |
+|---|------|-------------|-------------|--------|------------|
+| 1 | Assumption | | | | Verify by: |
+| 2 | Risk | | High/Med/Low | High/Med/Low | |
+
+## Edge Cases
+
+- [ ] [Edge case 1 — when it occurs, how to handle]
+- [ ] [Edge case 2]
+
+## System Impact
+
+- **Affected modules**: [list]
+- **API changes**: [new/modified/removed endpoints]
+- **Database changes**: [migrations needed]
+- **Backward compatibility**: [Yes/No — details]
+- **Breaking changes**: [if any]
+
+## Perspectives & Trade-offs
+
+| Decision | User impact | Developer impact | Security | Ops/Deploy |
+|----------|-------------|------------------|----------|------------|
+| [Decision 1] | | | | |
+
+<!-- Section below only shown when flags.estimation = true -->
+
+## Estimation Summary
+
+| Phase | Estimate | Notes |
+|-------|----------|-------|
+| Research | [done] | |
+| Planning | [done] | |
+| Coding | | |
+| Testing | | |
+| Review | | |
+| Documentation | | |
+| **Total** | **[sum]** | |

package/.claude/templates/en/task-progress.md

@@ -0,0 +1,65 @@
+# Progress: [Task Name]
+
+## Status: Not Started | In Progress | Blocked | Done
+## Branch: [branch-name]
+## Started: [date]
+## Completed: [date — when done]
+
+---
+
+## Subtask Progress
+
+| # | Subtask | Status | Commit | Owner | Notes |
+|---|---------|--------|--------|-------|-------|
+| ST-1 | | Pending | | | |
+| ST-2 | | Pending | | | |
+
+**Status values**: Pending → In Progress → Done | Blocked | Skipped
+
+## Changelog
+
+Record all deviations from the original plan.
+
+### [date] — [description of change]
+- **Reason**: [why the change was made]
+- **Impact**: [which subtasks are affected]
+- **Decision by**: [human / agent / both]
+
+## New Findings
+
+Record when assumptions are wrong, new risks appear, or scope changes.
+
+| # | Finding | Impact | Action | Status |
+|---|---------|--------|--------|--------|
+| 1 | | | | Resolved / Open |
+
+## Blockers
+
+- [ ] [Blocker 1] — owner: [who is responsible] — since: [date]
+
+<!-- Section below only shown when flags.log_work = true -->
+
+## Effort Log
+
+| Date | Subtask | Work type | Estimate | Actual | Notes |
+|------|---------|-----------|----------|--------|-------|
+| | | coding/testing/review | | | |
+
+### Effort Summary
+
+| Metric | Value |
+|--------|-------|
+| Total Estimate | |
+| Total Actual | |
+| Variance | |
+| Accuracy | % |
+
+## Handoff Notes
+
+Record at end of session so next person/agent can continue without asking.
+
+### Session [date]
+- **Currently at**: ST-[N] — [describe current state]
+- **Important context**: [decisions, gotchas]
+- **Next steps**: [what to do immediately]
+- **Watch out for**: [warnings, edge cases encountered]

package/.claude/templates/pr-template.md

@@ -0,0 +1,56 @@
+## Tóm Tắt
+
+[Mô tả ngắn: thay đổi gì, tại sao]
+
+## Loại Thay Đổi
+
+- [ ] Feature mới (feat)
+- [ ] Bug fix (fix)
+- [ ] Refactoring (refactor)
+- [ ] Tests (test)
+- [ ] Documentation (docs)
+- [ ] Performance (perf)
+- [ ] Chore/Config (chore)
+
+## Thay Đổi Chi Tiết
+
+- [Thay đổi 1]: [mô tả]
+- [Thay đổi 2]: [mô tả]
+
+## Task Documentation
+
+- Plan: `.dw/tasks/[task-name]/[task-name]-plan.md`
+- Context: `.dw/tasks/[task-name]/[task-name]-context.md`
+- Progress: `.dw/tasks/[task-name]/[task-name]-progress.md`
+
+## Testing
+
+- [ ] Unit tests pass
+- [ ] Integration tests pass (nếu applicable)
+- [ ] Manual testing done
+- [ ] Edge cases đã test: [liệt kê]
+
+## Checklist
+
+- [ ] Code tuân thủ conventions (`.claude/rules/code-style.md`)
+- [ ] Commit messages đúng format
+- [ ] Không có sensitive data (secrets, tokens, .env)
+- [ ] Không có debug code (console.log, debugger)
+- [ ] Documentation cập nhật (nếu applicable)
+- [ ] Breaking changes đã documented (nếu có)
+- [ ] Backward compatible (hoặc migration plan có sẵn)
+
+## Screenshots / Demo
+
+[Nếu UI changes — đính kèm screenshots]
+
+## Estimate vs Actual
+
+| Metric | Giá trị |
+|--------|---------|
+| Estimated | [hours/points] |
+| Actual | [hours/points] |
+| Notes | |
+
+---
+> PR này được tạo với sự hỗ trợ của AI Agent (dv-workflow-kit)

package/.claude/templates/task-context.md

@@ -0,0 +1,73 @@
+# Context: [Task Name]
+
+## Ngày khảo sát: [date]
+## Người thực hiện: [dev / agent]
+
+---
+
+## Yêu Cầu Gốc
+
+> [Copy/paste yêu cầu từ user, ticket, hoặc BA requirements doc]
+
+## Codebase Analysis
+
+### Files Liên Quan
+
+| # | File | Vai trò | Cần thay đổi? | Ghi chú |
+|---|------|---------|----------------|---------|
+| 1 | | | | |
+
+### Kiến Trúc Hiện Tại
+
+```
+[Mô tả luồng hiện tại, có thể dùng ASCII diagram]
+
+Input → [Module A] → [Module B] → Output
+                ↓
+          [Database]
+```
+
+### Data Flow
+
+- **Input**: [Dữ liệu đầu vào từ đâu, format gì]
+- **Processing**: [Logic xử lý chính]
+- **Output**: [Kết quả đi đâu, format gì]
+- **Storage**: [Lưu ở đâu, schema gì]
+
+## Dependencies
+
+### Upstream (task phụ thuộc vào)
+- [ ] [Module/API/Service] — [vai trò]
+
+### Downstream (bị ảnh hưởng bởi task)
+- [ ] [Module/API/Service] — [ảnh hưởng thế nào]
+
+## Patterns & Conventions Phát Hiện
+
+| Pattern | Mô tả | Ví dụ (file:line) |
+|---------|--------|--------------------|
+| | | |
+
+## Test Coverage Hiện Tại
+
+- [ ] Có tests cho khu vực liên quan? [Có/Không]
+- Test files: [danh sách]
+- Coverage: [% hoặc mô tả]
+- Gaps: [thiếu test ở đâu]
+
+## Giả Định
+
+| # | Giả định | Cần kiểm chứng? | Nếu sai thì sao? |
+|---|----------|------------------|-------------------|
+| 1 | | Có / Không | |
+
+## Hạn Chế Đã Biết
+- [Hạn chế 1]
+
+## Chưa Rõ / Cần Làm Rõ
+- [ ] [Câu hỏi 1] — cần hỏi ai?
+- [ ] [Câu hỏi 2]
+
+## Ghi Chú Bổ Sung
+
+[Bất kỳ thông tin quan trọng khác: gotchas, tech debt, lịch sử thay đổi gần đây]

package/.claude/templates/task-plan.md

@@ -0,0 +1,79 @@
+# Plan: [Task Name]
+
+## Ngày tạo: [date]
+## Trạng thái: Draft | Approved | In Progress | Done
+## Approved by: [tên / role]
+
+---
+
+## Tóm Tắt Giải Pháp
+
+[1-2 đoạn mô tả mục tiêu và approach đã chọn]
+
+## Phương Án Đã Xem Xét
+
+| # | Phương án | Ưu điểm | Nhược điểm | Chọn? |
+|---|-----------|---------|------------|-------|
+| 1 | [Approach A] | | | **Chọn** |
+| 2 | [Approach B] | | | Loại — lý do: |
+
+## Subtasks
+
+### ST-1: [Tên subtask]
+- **Mô tả**: [Cụ thể, actionable]
+- **Files**: [Danh sách files cần thay đổi]
+- **Acceptance Criteria**:
+  - [ ] [Điều kiện 1]
+  - [ ] [Điều kiện 2]
+- **Dependencies**: none
+- **Estimate**: [effort — nếu estimation enabled]
+
+### ST-2: [Tên subtask]
+- **Mô tả**: ...
+- **Files**: ...
+- **Acceptance Criteria**:
+  - [ ] ...
+- **Dependencies**: ST-1
+- **Estimate**: ...
+
+<!-- Thêm subtasks theo nhu cầu -->
+
+## Rủi Ro & Giả Định
+
+| # | Loại | Mô tả | Xác suất | Tác động | Giảm thiểu |
+|---|------|--------|----------|----------|------------|
+| 1 | Giả định | | | | Kiểm chứng bằng: |
+| 2 | Rủi ro | | Cao/TB/Thấp | Cao/TB/Thấp | |
+
+## Edge Cases
+
+- [ ] [Edge case 1 — khi nào xảy ra, xử lý thế nào]
+- [ ] [Edge case 2]
+
+## Tác Động Hệ Thống
+
+- **Modules bị ảnh hưởng**: [danh sách]
+- **API changes**: [endpoints mới/sửa/xóa]
+- **Database changes**: [migration cần thiết]
+- **Backward compatibility**: [Có/Không — chi tiết]
+- **Breaking changes**: [nếu có]
+
+## Góc Nhìn & Trade-offs
+
+| Quyết định | User impact | Developer impact | Security | Ops/Deploy |
+|-----------|-------------|------------------|----------|------------|
+| [Quyết định 1] | | | | |
+
+<!-- Section dưới chỉ hiển thị khi flags.estimation = true -->
+
+## Estimation Tổng
+
+| Phase | Estimate | Ghi chú |
+|-------|----------|---------|
+| Research | [done] | |
+| Planning | [done] | |
+| Coding | | |
+| Testing | | |
+| Review | | |
+| Documentation | | |
+| **Total** | **[sum]** | |