@longph2102/v-flow 1.5.0

package/templates/bugfix-report-template.md

@@ -0,0 +1,195 @@
+# Template: Bugfix Report — Báo cáo tổng kết Bug Fix
+
+> Được tạo sau khi fix hoàn tất và review APPROVED — Phase R.1
+> Mục đích: Trả lời 6 câu hỏi để check và review lại bất kỳ lúc nào
+> Bug ID: [BUG-ID]
+> Ngày fix: [YYYY-MM-DD]
+> Người fix: [Agent/Dev]
+
+---
+
+## 1. Bug là gì?
+
+### Mô tả bug
+<!-- 2-3 câu tóm tắt bug -->
+
+### Reproduction Steps
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### Severity & Impact
+| | Giá trị |
+|---|---|
+| **Severity** | P1 / P2 / P3 / P4 |
+| **Affected Users** | [mô tả ảnh hưởng] |
+| **Affected Module** | [tên module/domain] |
+
+### Behavior cũ (lỗi)
+- **BUG-B01**: Khi [điều kiện], hệ thống [hành vi sai]
+
+---
+
+## 2. Nguyên nhân gốc là gì?
+
+### Root Cause
+<!-- Mô tả nguyên nhân GỐC — KHÔNG phải symptom -->
+<!-- "API trả 500" là symptom. "SQL không escape ký tự đặc biệt" là root cause -->
+
+| | Giá trị |
+|---|---|
+| **Root Cause** | [Mô tả nguyên nhân gốc — cụ thể] |
+| **Confidence** | high / medium / low |
+| **Bug Location** | [file:line — vị trí chính xác code gây bug] |
+
+### Why It Happened
+<!-- Tại sao bug xuất hiện — thiếu validation, logic error, race condition, missing test, v.v. -->
+
+### Contributing Factors
+<!-- Yếu tố góp phần — nếu có: thiếu test, code review miss, spec không rõ, v.v. -->
+
+---
+
+## 3. Giải pháp sửa là gì?
+
+### Fix Approach
+<!-- Mô tả APPROACH tổng thể — không chi tiết code -->
+
+### Behavior mới (đúng)
+- **BUG-E01**: Khi [điều kiện], hệ thống phải [hành vi đúng]
+
+### Behavior giữ nguyên (không thay đổi)
+- **BUG-U01**: Khi [điều kiện], hệ thống phải TIẾP TỤC [behavior giữ nguyên]
+- **BUG-U02**: Khi [điều kiện], hệ thống phải TIẾP TỤC [behavior giữ nguyên]
+
+---
+
+## 4. Đã sửa như thế nào?
+
+### Thay đổi chi tiết
+
+| # | Thay đổi | Lý do |
+|---|----------|-------|
+| 1 | [Mô tả thay đổi cụ thể 1] | [Tại sao cần thay đổi này] |
+| 2 | [Mô tả thay đổi cụ thể 2] | [Tại sao] |
+
+### Code Changes Summary
+<!-- Tóm tắt thay đổi logic chính — không paste full code -->
+```
+Trước: [logic cũ — 1-2 dòng tóm tắt]
+Sau:   [logic mới — 1-2 dòng tóm tắt]
+```
+
+### Tests đã viết
+
+| Tier | Test ID | Mô tả | Kết quả |
+|------|---------|--------|---------|
+| T1 🔴 | TC-R01 | [Test reproduce bug] | ✅ PASS (sau fix) |
+| T2 🟢 | TC-G01 | [Test verify fix] | ✅ PASS |
+| T3 🛡️ | TC-P01 | [Test regression prevention] | ✅ PASS |
+| T3 🛡️ | TC-P02 | [Test regression prevention] | ✅ PASS |
+
+---
+
+## 5. File nào đã sửa?
+
+### Files Modified (Implementation)
+
+| # | File | Loại thay đổi | Lines changed |
+|---|------|---------------|---------------|
+| 1 | [path/to/file1] | Modified | [+N, -N] |
+| 2 | [path/to/file2] | Modified | [+N, -N] |
+
+### Files Created (Tests)
+
+| # | File | Mô tả |
+|---|------|-------|
+| 1 | [path/to/test1] | [Test gì] |
+
+### Files NOT Modified (Confirmed unchanged)
+
+| # | File | Lý do giữ nguyên |
+|---|------|-------------------|
+| 1 | [path/to/file3] | [Nằm trong BUG-U scope, không cần thay đổi] |
+
+---
+
+## 6. File nào bị ảnh hưởng?
+
+### Direct Impact (files sửa trực tiếp)
+
+| File | Ảnh hưởng | Đã test? |
+|------|-----------|----------|
+| [file1] | [mô tả ảnh hưởng] | ✅ T2 |
+| [file2] | [mô tả ảnh hưởng] | ✅ T2 |
+
+### Indirect Impact (files phụ thuộc / callers)
+
+| File | Quan hệ | Ảnh hưởng | Đã test? |
+|------|---------|-----------|----------|
+| [file3] | Calls [function đã sửa] | [mô tả ảnh hưởng] | ✅ T3 |
+| [file4] | Imports [module đã sửa] | [mô tả ảnh hưởng] | ✅ T3 |
+
+### No Impact (confirmed safe)
+
+| File/Module | Lý do không ảnh hưởng |
+|-------------|----------------------|
+| [module X] | Không depend vào code đã sửa |
+
+---
+
+## 7. Verification Summary
+
+### Test Results
+
+| Loại | Passed | Total | Coverage |
+|------|--------|-------|----------|
+| T1 (Red → Green) | [N] | [N] | 100% |
+| T2 (Verify fix) | [N] | [N] | 100% |
+| T3 (No regression) | [N] | [N] | 100% |
+| Full test suite | [N] | [N] | [XX]% |
+
+### Acceptance Criteria
+
+| AC | Mô tả | Kết quả |
+|----|-------|---------|
+| AC-1 | Bug behavior không còn xảy ra | ✅ / ❌ |
+| AC-2 | Expected behavior hoạt động đúng | ✅ / ❌ |
+| AC-3 | Unchanged behaviors vẫn hoạt động | ✅ / ❌ |
+| AC-4 | Tất cả 3-tier tests pass | ✅ / ❌ |
+| AC-5 | Full test suite pass | ✅ / ❌ |
+
+---
+
+## 8. Review Decision
+
+| | Kết quả |
+|---|---|
+| **Review Verdict** | ✅ APPROVED / ⚠️ APPROVED WITH NOTES / ❌ CHANGES REQUIRED |
+| **Reviewed by** | [Agent/Human] |
+| **Review date** | [YYYY-MM-DD] |
+
+### Notes (nếu APPROVED WITH NOTES)
+<!-- Tech debt, follow-up tasks, monitoring needed -->
+
+---
+
+## 9. Lessons Learned (Optional)
+
+### Cần cải thiện
+<!-- Nếu bug có thể tránh được — làm sao? -->
+
+| Cải thiện | Loại | Action |
+|-----------|------|--------|
+| [Thêm validation cho input X] | Prevention | [tạo task / update constitution] |
+| [Thêm test cho case Y] | Detection | [tạo test / update test suite] |
+
+### Cập nhật Knowledge Base
+- [ ] Thêm vào `knowledge/lessons-learned/` nếu có pattern mới
+- [ ] Cập nhật `constitution.md` nếu cần rule mới
+- [ ] Cập nhật `context.md` nếu phát hiện No-Go Zone mới
+
+---
+
+> **Generated by**: Bugfix Flow (`/v.bugfix`)
+> **Template**: `templates/bugfix-report-template.md`

package/templates/bugfix-spec-template.md

@@ -0,0 +1,134 @@
+# Template: Bugfix Spec — Phân tích Bug có cấu trúc
+
+> 📌 **Lấy cảm hứng từ Kiro Bugfix Specs** — 3-behavior model + root cause analysis
+> Được tạo bởi **Bugfix Analyst Agent** — Phase S.1
+> Bug ID: [BUG-ID]
+
+---
+
+## 1. Bug Report
+
+### 1.1 Mô tả ngắn
+<!-- 1-2 câu mô tả bug -->
+
+### 1.2 Reproduction Steps
+1. [Step 1]
+2. [Step 2]
+3. [Step 3]
+
+### 1.3 Environment
+- **OS/Browser/Device**: [...]
+- **App version/commit**: [...]
+- **Reproduced?**: ✅ Có / ❌ Chưa reproduce được
+
+### 1.4 Evidence
+<!-- Screenshots, logs, error messages -->
+
+---
+
+## 2. Bugfix Analysis (3-Behavior Model)
+
+### 2.1 Current Behavior (Defect) 🔴
+<!-- EARS notation: Khi [điều kiện], hệ thống [hành vi sai hiện tại] -->
+
+- **BUG-B01**: Khi [điều kiện cụ thể], hệ thống [hành vi sai]
+- **BUG-B02**: [nếu có thêm defect — optional]
+
+### 2.2 Expected Behavior (Correct) 🟢
+<!-- EARS notation: Khi [điều kiện], hệ thống phải [hành vi đúng] -->
+<!-- BUG-E phải mapping 1:1 với BUG-B -->
+
+- **BUG-E01**: Khi [điều kiện cụ thể], hệ thống phải [hành vi đúng]
+- **BUG-E02**: [mapping với BUG-B02 — nếu có]
+
+### 2.3 Unchanged Behavior (Regression Prevention) 🛡️
+<!-- EARS notation: Khi [điều kiện], hệ thống phải TIẾP TỤC [hành vi giữ nguyên] -->
+<!-- Tối thiểu 2 BUG-U -->
+
+- **BUG-U01**: Khi [điều kiện liên quan], hệ thống phải TIẾP TỤC [behavior phải giữ nguyên]
+- **BUG-U02**: Khi [điều kiện khác], hệ thống phải TIẾP TỤC [behavior phải giữ nguyên]
+
+---
+
+## 3. Root Cause Analysis
+
+### 3.1 Root Cause Hypothesis
+- **Nguyên nhân gốc**: [Mô tả tại sao bug xảy ra — KHÔNG phải symptom]
+- **Confidence**: high | medium | low
+- **Evidence**: [Dẫn chứng cụ thể — log, code trace, test result]
+
+### 3.2 Affected Code
+| File | Line(s) | Mô tả vấn đề |
+|------|---------|---------------|
+| [path/to/file] | [L-xx] | [vấn đề cụ thể trong code] |
+
+### 3.3 Why It Happened
+<!-- Giải thích nguyên nhân sâu: thiếu validation, logic sai, race condition, v.v. -->
+
+---
+
+## 4. Scope
+
+### 4.1 Files cần thay đổi
+- [ ] [file 1] — [mô tả change]
+- [ ] [file 2] — [mô tả change]
+
+### 4.2 Files KHÔNG được đụng (Constraints)
+- [file/module] — [lý do không đụng]
+
+### 4.3 No-Go Check
+- [ ] Đã đọc `context.md`, không đụng No-Go Zones ✅
+- [ ] Scope không lan rộng sang module không liên quan ✅
+
+---
+
+## 5. Test Plan (3-Tier)
+
+### T1: Bug Reproducible (Red 🔴)
+<!-- Test phải FAIL trước fix, PASS sau fix -->
+- [ ] **TC-R01**: [Test reproduce BUG-B01]
+- [ ] **TC-R02**: [Test reproduce BUG-B02 — nếu có]
+
+### T2: Bug Fixed (Green 🟢)
+<!-- Test phải PASS sau fix -->
+- [ ] **TC-G01**: [Test verify BUG-E01]
+- [ ] **TC-G02**: [Test verify BUG-E02 — nếu có]
+
+### T3: No Regression (Protect 🛡️)
+<!-- Test phải PASS cả trước VÀ sau fix -->
+- [ ] **TC-P01**: [Test verify BUG-U01 vẫn đúng]
+- [ ] **TC-P02**: [Test verify BUG-U02 vẫn đúng]
+
+### Mapping Matrix
+
+| Behavior | Test Tier | Test ID | Trước fix | Sau fix |
+|----------|-----------|---------|-----------|---------|
+| BUG-B01 | T1 (Red) | TC-R01 | ❌ FAIL | ✅ PASS |
+| BUG-E01 | T2 (Green) | TC-G01 | ❌ FAIL | ✅ PASS |
+| BUG-U01 | T3 (Protect) | TC-P01 | ✅ PASS | ✅ PASS |
+| BUG-U02 | T3 (Protect) | TC-P02 | ✅ PASS | ✅ PASS |
+
+---
+
+## 6. Acceptance Criteria
+
+- [ ] **AC-1**: Current behavior (BUG-B*) không còn xảy ra
+- [ ] **AC-2**: Expected behavior (BUG-E*) hoạt động đúng
+- [ ] **AC-3**: Unchanged behaviors (BUG-U*) vẫn hoạt động
+- [ ] **AC-4**: Tất cả tests 3-tier pass (T1 + T2 + T3)
+- [ ] **AC-5**: Full test suite pass (no regression bên ngoài)
+
+---
+
+## 7. Status
+
+| Thông tin | Giá trị |
+|-----------|--------|
+| **Severity** | P1 / P2 / P3 / P4 |
+| **Spec Version** | v1.0 |
+| **Trạng thái** | `Draft` / `Approved` |
+| **Người approve** | [Tên] |
+| **Ngày approve** | [YYYY-MM-DD] |
+
+### Routing
+- Human approve → Phase tiếp theo (Design hoặc Implement)

package/templates/code-review-report-template.md

@@ -0,0 +1,119 @@
+# Template: Code Review Report — Báo cáo Adversarial Review
+
+> Được tạo bởi **Review Agent** — Phase R.1
+> Feature: [TÊN FEATURE]
+> Spec Version: [vX.Y]
+> Ngày review: [YYYY-MM-DD]
+
+---
+
+## Kết quả tổng hợp
+
+| | Kết quả |
+|---|---|
+| **PHÁN QUYẾT** | ✅ **APPROVED** / ⚠️ **APPROVED WITH NOTES** / ❌ **CHANGES REQUIRED** |
+| **Spec Version** | vX.Y |
+| **Issues tìm được** | [N] (bắt buộc ≥ 3) |
+| **Concerns từ R.0 verified** | [N]/[N] |
+
+---
+
+## 1. Spec Compliance — Code có đúng spec không?
+
+| Requirement | Implemented? | Test? | Ghi chú |
+|------------|:-----------:|:-----:|---------|
+| REQ-U01 | ✅ / ❌ | ✅ / ❌ | |
+| REQ-E01 | ✅ / ❌ | ✅ / ❌ | |
+
+**Coverage**: [X/Y] requirements implemented → [XX]%
+
+---
+
+## 2. Architecture Compliance — Đúng plan không?
+
+| Kiểm tra | Kết quả | Ghi chú |
+|---------|---------|---------|
+| Code theo architecture trong plan.md | ✅ / ❌ | |
+| File paths khớp với plan.md | ✅ / ❌ | |
+| Dependencies đúng plan | ✅ / ❌ | |
+| Không có code ngoài scope | ✅ / ❌ | |
+
+---
+
+## 3. Constitution Compliance
+
+| Nguyên tắc | Tuân thủ? | Ghi chú |
+|-----------|:--------:|---------| 
+| Naming convention | ✅ / ❌ | |
+| Error handling pattern | ✅ / ❌ | |
+| Testing standards | ✅ / ❌ | |
+| Code documentation | ✅ / ❌ | |
+
+---
+
+## 4. Code Quality
+
+| Kiểm tra | Kết quả | Ghi chú |
+|---------|---------|---------|
+| No hardcoded values | ✅ / ❌ | |
+| Proper error handling | ✅ / ❌ | |
+| No code duplication | ✅ / ❌ | |
+| Edge cases handled | ✅ / ❌ | |
+| Performance acceptable | ✅ / ❌ | |
+| Security concerns | ✅ / ❌ | |
+
+---
+
+## 5. Concerns Verification (từ R.0)
+
+> Kiểm tra tất cả concerns từ `validation-report.md`
+
+| Concern ID | Mô tả | Resolved? | Cách resolve |
+|-----------|-------|:---------:|-------------|
+| W-001 | [mô tả] | ✅ / ❌ | [cách giải quyết] |
+| W-002 | [mô tả] | ✅ / ❌ | [cách giải quyết] |
+
+---
+
+## 6. Issues Found (≥ 3 bắt buộc)
+
+### 🔴 Critical — Block merge
+*(Không có)* / Liệt kê nếu có:
+- **[CR-001]** `file:line` — [Mô tả] → Fix: [Đề xuất]
+
+### 🟠 Major — Block merge
+*(Không có)* / Liệt kê nếu có:
+- **[MJ-001]** `file:line` — [Mô tả] → Fix: [Đề xuất]
+
+### 🟡 Minor — Nên fix
+- **[MN-001]** `file:line` — [Mô tả] → Suggestion: [Đề xuất]
+
+### 🔵 Suggestions — Nice to have
+- **[SG-001]** [Gợi ý cải thiện]
+
+---
+
+## 7. Routing Decision
+
+**PHÁN QUYẾT**: ✅ APPROVED / ⚠️ APPROVED WITH NOTES / ❌ CHANGES REQUIRED
+
+```yaml
+# Dùng để cập nhật .flow-state.yaml
+verdict: "APPROVED"
+route_decision: "deploy"                # deploy | fix_and_re_review | escalate
+concerns_all_resolved: true
+```
+
+**Route cụ thể**:
+
+| Verdict | → Làm gì tiếp |
+|---------|---------------|
+| APPROVED | 🚀 Deploy → `/v.retrospective` → `/v.metrics` |
+| APPROVED_WITH_NOTES | 🚀 Deploy + track notes → `/v.retrospective` |
+| CHANGES_REQUIRED | Fix issues → `/v.review` lại |
+| CHANGES_REQUIRED (lần 3+) | Escalate → human review toàn bộ |
+
+---
+
+> **Reviewer**: Review Agent
+> **Principle**: ≥ 3 issues bắt buộc — không bao giờ "LGTM"

package/templates/constitution-template.md

@@ -0,0 +1,234 @@
+# Template: Constitution — Hiến pháp Dự án
+
+> Tài liệu này thiết lập các nguyên tắc BẤT DI BẤT DỊCH cho dự án.
+> Mọi Agent và thành viên đều phải tuân thủ.
+
+## Thông tin dự án
+
+| Mục | Giá trị |
+|-----|--------|
+| **Tên dự án** | [TÊN DỰ ÁN] |
+| **Ngày tạo** | [YYYY-MM-DD] |
+| **Phiên bản** | 1.0 |
+| **Người tạo** | [Tech Lead / Architect] |
+| **Lần cập nhật cuối** | [YYYY-MM-DD] |
+
+---
+
+## 1. Nguyên tắc Kiến trúc
+
+### 1.1 Architecture Pattern
+<!-- Ví dụ: Clean Architecture, MVVM, MVC, Microservices... -->
+- [ ] Mô tả architecture pattern được sử dụng
+- [ ] Định nghĩa layer structure và dependency rules
+
+### 1.2 State Management
+<!-- Ví dụ: Riverpod, BLoC, Redux, Vuex... -->
+- [ ] Framework/library quản lý state
+
+### 1.3 Module Structure
+<!-- Ví dụ: Feature-first, Layer-first... -->
+- [ ] Cách tổ chức module/package
+
+---
+
+## 2. Quy chuẩn Code
+
+### 2.1 Naming Convention
+<!-- Ví dụ: camelCase cho biến, PascalCase cho class... -->
+<!-- Thêm [LINT:naming] tag để tự động enforce: v-flow validate --constitution -->
+- [ ] Quy tắc đặt tên biến, hàm, class
+- [ ] Ngôn ngữ dùng cho naming (Tiếng Anh bắt buộc?)
+<!-- Ví dụ lintable rule:
+- [LINT:naming] Tất cả files phải dùng kebab-case: `my-component.js`
+- [LINT:naming] Components phải dùng PascalCase
+-->
+
+### 2.2 Testing
+<!-- Ví dụ: Unit test coverage ≥ 80%, mọi API phải có integration test... -->
+<!-- Thêm [LINT:test] tag để tự động kiểm tra test coverage -->
+- [ ] Yêu cầu test coverage tối thiểu
+- [ ] Loại test bắt buộc
+<!-- Ví dụ lintable rule:
+- [LINT:test:warn] Mỗi module trong src/ phải có test file tương ứng
+-->
+
+### 2.3 Linting & Formatting
+<!-- Ví dụ: ESLint, Prettier, dart analyze... -->
+- [ ] Tool linting
+- [ ] Quy tắc format
+
+### 2.4 Documentation
+<!-- Ví dụ: JSDoc cho public API, README cho mỗi module... -->
+- [ ] Yêu cầu documentation
+
+---
+
+## 3. Quy chuẩn UI/UX
+
+### 3.1 Design System
+<!-- Ví dụ: Material Design, Custom Design Kit... -->
+- [ ] Design system / Component library
+
+### 3.2 Spacing & Layout
+<!-- Ví dụ: Bội số 4px, Grid 12 columns... -->
+- [ ] Hệ thống spacing
+- [ ] Layout grid
+
+### 3.3 Typography
+<!-- Ví dụ: Font Inter, 5 cấp heading... -->
+- [ ] Font family
+- [ ] Heading hierarchy
+
+### 3.4 Color Palette
+<!-- Ví dụ: Primary #1A73E8, Secondary #34A853... -->
+- [ ] Bảng màu chính
+
+---
+
+## 4. Quy chuẩn API & Backend
+
+### 4.1 API Design
+<!-- Ví dụ: RESTful, GraphQL, gRPC... -->
+- [ ] Kiểu API
+- [ ] Format request/response
+
+### 4.2 Error Handling
+<!-- Ví dụ: RFC 7807, custom error codes... -->
+- [ ] Chuẩn error response
+
+### 4.3 Authentication & Security
+<!-- Ví dụ: JWT, OAuth2, mã hóa bcrypt... -->
+- [ ] Cơ chế authentication
+- [ ] Quy tắc bảo mật
+
+---
+
+## 5. Quy chuẩn DevOps
+
+### 5.1 Version Control
+<!-- Ví dụ: Git Flow, Trunk-based... -->
+- [ ] Branching strategy
+- [ ] Commit message convention
+
+### 5.2 CI/CD
+<!-- Ví dụ: GitHub Actions, Jenkins... -->
+- [ ] Pipeline CI/CD
+
+### 5.3 Environments
+<!-- Ví dụ: dev, staging, production... -->
+- [ ] Các môi trường và quy tắc deploy
+
+---
+
+## 6. Quy tắc đặc biệt
+
+<!-- Các quy tắc riêng của tổ chức/dự án không nằm trong các mục trên -->
+- [ ] [Thêm quy tắc đặc biệt nếu có]
+
+---
+
+## 7. AI Agent Configuration Defaults
+
+### 7.1 Preferred Models
+<!-- Ví dụ: GPT-4o cho reasoning, Claude 3.5 cho coding... -->
+- [ ] Model mặc định cho pipeline
+- [ ] Có cần on-premise/private deployment không?
+
+### 7.2 Agent Guidelines
+<!-- Ví dụ: Output phải bằng tiếng Việt, dùng template bắt buộc... -->
+- [ ] Ngôn ngữ output cho agents
+- [ ] Yêu cầu format output đặc biệt
+
+### 7.3 Privacy & Security
+<!-- Ví dụ: Không gửi source code lên cloud API, dùng API key riêng... -->
+- [ ] Dữ liệu nhạy cảm — cần model on-premise?
+- [ ] API key management
+
+> 📎 Xem chi tiết cấu hình Agent: [agent-config-template.md](agent-config-template.md)
+> 📎 Xem hướng dẫn chọn model: [model-selection-guide.md](../docs/model-selection-guide.md)
+
+---
+
+## 8. AI Compliance & Model Risk
+
+### 8.1 Model Risk Policy
+<!-- Ví dụ: Chỉ dùng models đã được approved, không dùng models mới chưa evaluate... -->
+- [ ] Danh sách models được phép sử dụng (approved list)
+- [ ] Quy trình evaluate model mới trước khi đưa vào pipeline
+- [ ] Yêu cầu tối thiểu: model phải pass golden test dataset
+
+### 8.2 Data Handling
+<!-- Ví dụ: Không gửi customer data lên cloud API... -->
+- [ ] Loại dữ liệu nào KHÔNG được gửi cho AI model?
+- [ ] Yêu cầu anonymize/mask data trước khi gửi?
+- [ ] Data retention policy cho AI interactions?
+
+### 8.3 Audit Trail
+<!-- Ví dụ: Lưu lại tất cả AI interactions cho compliance review... -->
+- [ ] Lưu decision logs cho mỗi Agent run?
+- [ ] Retention period cho logs?
+- [ ] Ai có quyền access audit logs?
+
+### 8.4 Responsible AI
+- [ ] Bias testing — kiểm tra output có bias không?
+- [ ] Fairness requirements cụ thể?
+- [ ] Transparency — agent phải giải thích reasoning?
+
+---
+
+## 9. Spec Change Policy (Double-texting)
+
+> Quy tắc xử lý khi spec thay đổi trong lúc pipeline đang hoạt động.
+> Lấy cảm hứng từ LangGraph's concurrency policies: Enqueue, Reject, Interrupt, Rollback.
+
+### 9.1 Policy theo Phase
+
+| Phase đang chạy | Spec thay đổi loại | Policy | Hành động |
+|---|---|---|---|
+| **S.1** Specify | Bất kỳ | **Accept** | Spec đang draft — tự do sửa |
+| **B.0** Plan + Test | Minor (typo, clarification) | **Enqueue** | Kết thúc Plan/Test → `/v.sync` |
+| **B.0** Plan + Test | Major (requirement mới/xóa) | **Interrupt** | Dừng Plan/Test → bump version → `/v.sync` → restart B.0 |
+| **R.0** Master Check | Bất kỳ | **Rollback** | Hủy Check → `/v.sync` → restart `/v.check` |
+| **B.1** Implement | Minor (clarification, wording) | **Enqueue** | Hoàn thành task đang làm → `/v.sync` → tiếp tục implement |
+| **B.1** Implement | Major (requirement thay đổi) | **Interrupt** | Dừng implement → ghi chú task đang dang dở → `/v.sync` → re-evaluate impacts |
+| **B.1** Implement | Critical (requirement xóa) | **Rollback** | Dừng implement → `/v.sync` → `/v.check` → có thể cần re-plan |
+| **R.1** Review | Bất kỳ | **Reject** | KHÔNG ĐỔI spec khi đang review — hoàn thành review trước |
+
+### 9.2 Phân loại Spec Change
+
+```
+Minor:
+  - Typo, wording, clarification của requirement hiện có
+  - Thêm/sửa acceptance criteria mà không đổi intent
+  - → Chỉ cần /v.sync
+
+Major:
+  - Thêm requirement mới
+  - Thay đổi behavior của requirement hiện có  
+  - Thay đổi scope đáng kể
+  - → /v.sync + có thể cần re-plan hoặc re-check
+
+Critical:
+  - Xóa requirement đang được implement
+  - Thay đổi kiến trúc (e.g., REST → GraphQL)
+  - → /v.sync + /v.check + có thể cần re-plan
+```
+
+### 9.3 Conflict Detection
+
+Khi spec thay đổi, ghi vào `_session.md`:
+
+```markdown
+## ⚠️ Spec Change Detected
+- **Spec version**: v1.2 → v1.3
+- **Phase khi thay đổi**: B.1 (Implement, task T-007)
+- **Change type**: Major — thêm REQ-E05 (email verification)
+- **Policy áp dụng**: Interrupt
+- **Impact**: T-007 (đang làm) + T-008 bị ảnh hưởng
+- **Action**: Pause implement → /v.sync → re-evaluate
+```
+
+---
+
+> **Lưu ý**: Constitution được tạo 1 lần và hiếm khi thay đổi. Mọi thay đổi phải được team review và đồng thuận.