@relipa/ai-flow-kit 0.1.4 → 0.1.5-beta.1

package/custom/templates/shared/coding-workflow.md

@@ -0,0 +1,15 @@
+## /coding — Manual Trigger for the DEV Coding Workflow
+
+**Why this command exists:** the `[DEV] 5-Gate Development Workflow` (for `taskType`: `bug-fix`, `feature`, `refactor`, `investigation`, `documentation`) normally auto-starts via the `SessionStart` hook, which only fires when a Claude Code session **starts, resumes, or is cleared**. If a ticket was loaded with `ak use <TICKET-ID>` while this chat session was already open, the hook never re-ran — so this session has no ticket context yet, and typing "start" does nothing because nothing told the AI what "start" means. `/coding` fixes that by loading the ticket context manually, right now.
+
+**Steps — do these now, in order:**
+
+1. Read `.aiflow/context/current.json`.
+   - Missing, or no `taskId` field → tell the developer to run `ak use <TICKET-ID>` first, then stop here.
+2. Read `.aiflow/tasks/[taskId]/task-state.json` if it exists.
+   - If `currentGate > 1` (task already in progress) → **resume at that gate** — do NOT restart from Gate 1. List which gates are already `APPROVED` before continuing.
+   - Otherwise → start fresh at Gate 1.
+3. In this project's main AI instruction file (`CLAUDE.md`, `AGENTS.md`, `GEMINI.md`, or `.github/copilot-instructions.md` — whichever is present), find the section **`## [DEV] 5-Gate Development Workflow`** and follow it exactly, beginning at the gate identified in step 2.
+4. This workflow applies regardless of the ticket's `taskType` value — `bug-fix`, `feature`, `refactor`, `investigation`, and `documentation` all share this same 5-gate flow (see the "Workflow Selection" table above that section for the full routing).
+
+Do not wait for further confirmation from the developer before starting — begin the identified gate immediately.

package/custom/templates/shared/create-spec-workflow.md

@@ -13,53 +13,53 @@ Các skill sau đây được cài tự động vào `.claude/skills/ba-skills/`
 
 | Skill | File |
 |---|---|
-| `skill-ba-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-phan-tich-ban-dau-v1.md` |
-| `skill-ba-qa` | `.claude/skills/ba-skills/skill-ba-qa-v1.md` |
-| `skill-ba-prototype` | `.claude/skills/ba-skills/skill-ba-prototype-v1.md` |
-| `skill-ba-ve-luong-mermaid` | `.claude/skills/ba-skills/skill-ba-ve-luong-mermaid-v1.md` |
-| `skill-ba-xay-dung-business-rules` | `.claude/skills/ba-skills/skill-ba-xay-dung-business-rules-v1.md` |
-| `skill-ba-viet-spec-uc` | `.claude/skills/ba-skills/skill-ba-viet-spec-uc-v1.md` |
-| `template-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-template-phan-tich-ban-dau-v1.md` |
-| `template-qa` | `.claude/skills/ba-skills/skill-ba-qa-template-v1.md` |
-| `template-uc` | `.claude/skills/ba-skills/skill-ba-template-uc-v1.md` |
+| `skill-ba-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-initial-analysis-v1.md` |
+| `skill-ba-qa` | `.claude/skills/ba-skills/skill-ba-qna-v1.md` |
+| `skill-ba-prototype` | `.claude/skills/ba-skills/skill-ba-ui-prototype-v1.md` |
+| `skill-ba-ve-luong-mermaid` | `.claude/skills/ba-skills/skill-ba-mermaid-flowchart-v1.md` |
+| `skill-ba-xay-dung-business-rules` | `.claude/skills/ba-skills/skill-ba-build-business-rules-v1.md` |
+| `skill-ba-viet-spec-uc` | `.claude/skills/ba-skills/skill-ba-write-uc-spec-v1.md` |
+| `template-phan-tich-ban-dau` | `.claude/skills/ba-skills/skill-ba-initial-analysis-template-v1.md` |
+| `template-qa` | `.claude/skills/ba-skills/skill-ba-qna-template-v1.md` |
+| `template-uc` | `.claude/skills/ba-skills/skill-ba-uc-template-v1.md` |
 
 ---
 
 ### Cấu trúc thư mục đầu ra
 
 ```
-docs/ak-{project}/spec/
-├── phan-tich/
-│   ├── [functionId]_phan-tich(1).md     ← Gate 1 tạo
-│   └── [functionId]_phan-tich(n).md     ← Gate 2 cập nhật (tăng version)
-├── QA/
-│   ├── [functionId]_QA(1).md            ← Gate 1 tạo
-│   └── [functionId]_QA(m).md            ← Gate 2 tạo thêm nếu còn Open
-├── design/
-│   └── [functionId]_design.html         ← Gate 3 tạo
-└── UC/
-    └── [functionId]_UC.md               ← Gate 4 tạo
+02.BA-Specs/
+├── 01.Analysis/
+│   ├── [functionId]/Analysis_v1.md      ← Gate 1 tạo
+│   └── [functionId]/Analysis_vn.md      ← Gate 2 cập nhật (tăng version)
+├── 02.QnA/
+│   ├── [functionId]/QnA-Log_v1.md       ← Gate 1 tạo
+│   └── [functionId]/QnA-Log_vm.md       ← Gate 2 tạo thêm nếu còn Open
+├── 03.UI-Prototypes/
+│   └── [functionId]/UI-Prototype_v1.html← Gate 3 tạo
+└── 04.UC-Specs/
+    └── [functionId]/UC-Spec_v1.md       ← Gate 4 tạo
 ```
 
-Ví dụ: `functionId = AD10`, `project = coinbook` → thư mục gốc là `docs/ak-coinbook/spec/`
+Ví dụ: `functionId = AD10` → thư mục gốc là `02.BA-Specs/`
 
 ---
 
 ### Quy trình tổng quan 4 Gates
 
 ```
-(spec/ = docs/ak-{project}/spec/ — viết tắt cho ngắn gọn)
+(BA-Specs/ = 02.BA-Specs/ — viết tắt cho ngắn gọn)
 
-[Input: Jira / Backlog / file] → Pre-flight: xác định functionId + thư mục đầu ra
+[Input: Jira / Backlog / file] → Pre-flight: BẮT BUỘC xác định functionId
     ↓
-Gate 1: Phân tích yêu cầu & Tạo Q&A       → spec/phan-tich/ + spec/QA/
+Gate 1: Phân tích yêu cầu & Tạo Q&A       → BA-Specs/01.Analysis/ + BA-Specs/02.QnA/
     ↓ APPROVED
 Gate 2: Cập nhật phản hồi Q&A ←─────────────────────────────────────────┐
-    ↓ còn Open → tạo QA(m+1) → đợi BA phản hồi → lặp lại ───────────────┘
+    ↓ còn Open → tạo QnA-Log_v(m+1) → đợi BA phản hồi → lặp lại ────────┘
     ↓ tất cả Confirmed + APPROVED
-Gate 3: Thiết kế UI Prototype HTML/CSS     → spec/design/
+Gate 3: Thiết kế UI Prototype HTML/CSS     → BA-Specs/03.UI-Prototypes/
     ↓ APPROVED
-Gate 4: Viết đặc tả Use Case Spec          → spec/UC/
+Gate 4: Viết đặc tả Use Case Spec          → BA-Specs/04.UC-Specs/
     ↓ APPROVED
 Bàn giao Dev/Test
 ```
@@ -71,55 +71,46 @@ Bàn giao Dev/Test
 **Mục tiêu:** Tiếp nhận đầu vào, hiểu nghiệp vụ, phát hiện khoảng trống (Gaps), lập bản phân tích sơ bộ và danh sách Q&A.
 
 **Đầu ra (Outputs):**
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(1).md`
-- `docs/ak-{project}/spec/QA/[functionId]_QA(1).md`
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v1.md`
+- `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v1.md`
 
 **Bước thực hiện:**
 
 #### Bước 0: Pre-flight — Xác định functionId và thư mục đầu ra
 
-**Xác định `functionId`:**
+**Xác định `functionId` (BẮT BUỘC):**
 
 Kiểm tra theo thứ tự ưu tiên:
 1. Trường `functionId` hoặc `screenId` trong `.aiflow/context/current.json`
 2. Rút gọn từ `ticketId` — bỏ dấu gạch, giữ ký hiệu (ví dụ: `AD-10` → `AD10`)
-3. Nếu không tìm thấy → **hỏi BA ngay**:
+3. Nếu không tìm thấy → **BẮT BUỘC hỏi BA ngay**:
 
 ```
 Không tìm thấy functionId trong context.
 Vui lòng cung cấp mã định danh cho chức năng này (ví dụ: AD10, UC-LOGIN, PM-003):
 ```
 
-→ Đợi BA trả lời, ghi nhận giá trị, dùng cho toàn bộ workflow.
+→ Đợi BA trả lời, ghi nhận giá trị, dùng cho toàn bộ workflow. KHÔNG ĐƯỢC TIẾP TỤC NẾU CHƯA CÓ functionId.
 
-**Xác định `{project}` và thư mục đầu ra:**
+**Xác định thư mục đầu ra:**
 
-1. Lấy `{project}` theo thứ tự ưu tiên:
-   - Trường `project` trong `.aiflow/context/current.json`
-   - Tên thư mục gốc workspace (chuyển lowercase, thay space bằng `-`)
-
-2. Kiểm tra tồn tại thư mục `docs/ak-{project}/spec/` trong root dự án:
+1. Kiểm tra tồn tại thư mục `02.BA-Specs/` trong root dự án:
    - **Tìm thấy** → thông báo xác nhận:
      ```
-     ✓ Thư mục đầu ra: docs/ak-{project}/spec/
+     ✓ Thư mục đầu ra: 02.BA-Specs/
      ✓ functionId: [functionId]
      → Bắt đầu Gate 1...
      ```
-   - **Không tìm thấy** → **hỏi BA**:
-     ```
-     Không tìm thấy thư mục docs/ak-{project}/spec/.
-     Tên project là gì? (ví dụ: coinbook, crm-app)
-     ```
-     → Nhận tên project từ BA → chuyển lowercase → tạo toàn bộ cây thư mục:
+   - **Không tìm thấy** → tạo toàn bộ cây thư mục:
      ```
-     docs/ak-{project}/spec/phan-tich/
-     docs/ak-{project}/spec/QA/
-     docs/ak-{project}/spec/design/
-     docs/ak-{project}/spec/UC/
+     02.BA-Specs/01.Analysis/
+     02.BA-Specs/02.QnA/
+     02.BA-Specs/03.UI-Prototypes/
+     02.BA-Specs/04.UC-Specs/
      ```
      → Thông báo:
      ```
-     ✓ Đã tạo thư mục: docs/ak-{project}/spec/
+     ✓ Đã tạo thư mục: 02.BA-Specs/
      ✓ functionId: [functionId]
      → Bắt đầu Gate 1...
      ```
@@ -129,6 +120,7 @@ Vui lòng cung cấp mã định danh cho chức năng này (ví dụ: AD10, UC-
 - Nếu description có URL → chạy `ak fetch-links <url>` để tải nội dung
 - Nếu có `supplementaryContext[]` → đọc từng item (file đính kèm, ticket liên quan, comment PM)
 - Nếu có file yêu cầu thô được chỉ định → đọc file đó
+- **READ skill:** `.superpowers/skills/brainstorming/SKILL.md` (hoặc `brainstorming` skill) để chủ động làm rõ các yêu cầu thô, khơi gợi ý tưởng trước khi phân tích.
 
 #### Bước 1b: Đọc Source Code
 
@@ -160,25 +152,25 @@ Nếu workspace mở dạng parent folder chứa cả `ak docs` lẫn source cod
 - Nếu có điểm mơ hồ cốt yếu → hỏi ONE câu làm rõ, đợi BA trả lời trước khi tiếp tục
 
 #### Bước 3: Soạn thảo Kết quả phân tích sơ bộ
-- **READ template:** `.claude/skills/ba-skills/skill-ba-template-phan-tich-ban-dau-v1.md`
+- **READ template:** `.claude/skills/ba-skills/skill-ba-initial-analysis-template-v1.md`
 - Điền đầy đủ các mục theo template: Actors, Facts, Assumptions, Gap Analysis table
-- Lưu: `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(1).md`
+- Lưu: `02.BA-Specs/01.Analysis/[functionId]/Analysis_v1.md`
 
 #### Bước 4: Soạn thảo danh sách Q&A
-- **READ skill:** `.claude/skills/ba-skills/skill-ba-qa-v1.md`
-- **READ template:** `.claude/skills/ba-skills/skill-ba-qa-template-v1.md`
+- **READ skill:** `.claude/skills/ba-skills/skill-ba-qna-v1.md`
+- **READ template:** `.claude/skills/ba-skills/skill-ba-qna-template-v1.md`
 - Chuyển từng Gap thành câu hỏi cụ thể, khách quan, không định hướng
 - Mỗi câu hỏi tương ứng với ít nhất một Gap. Trạng thái ban đầu: **Open**
-- Lưu: `docs/ak-{project}/spec/QA/[functionId]_QA(1).md`
+- Lưu: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v1.md`
 
 #### Bước 5: Gate Review & Pause
 - **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-1-[functionId].md`
-- **Kiểm tra Q&A bắt buộc:** Đọc `QA(1).md` — đếm số câu có trạng thái **Open**
+- **Kiểm tra Q&A bắt buộc:** Đọc `QnA-Log_v1.md` — đếm số câu có trạng thái **Open**
 - Hiển thị gate pause message — chờ phản hồi từ BA
 
-**Nếu nhận được APPROVED mà QA(1).md còn câu hỏi Open → từ chối ngay, hiển thị:**
+**Nếu nhận được APPROVED mà QnA-Log_v1.md còn câu hỏi Open → từ chối ngay, hiển thị:**
 
-⛔ GATE 1 BLOCKED — Còn [N] câu hỏi chưa được trả lời trong QA(1).md.
+⛔ GATE 1 BLOCKED — Còn [N] câu hỏi chưa được trả lời trong QnA-Log_v1.md.
 
 | ID | Câu hỏi còn Open |
 |----|-----------------|
@@ -187,7 +179,7 @@ Nếu workspace mở dạng parent folder chứa cả `ak docs` lẫn source cod
 Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 → Option A: nhập trực tiếp — `Q1: [trả lời], Q2: [trả lời]`
 → Option B: paste nội dung bảng Q&A đã điền vào chat
-→ Option C: đặt file `[functionId]_QA(1)_response.md` vào thư mục QA/ rồi gõ NEXT
+→ Option C: đặt file `QnA-Log_v1_response.md` vào thư mục `02.QnA/[functionId]/` rồi gõ NEXT
 
 ❌ APPROVED không được chấp nhận cho đến khi 100% câu hỏi đã Confirmed.
 
@@ -197,9 +189,9 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 → Nếu blocked: làm theo gate-review skill response protocol
 
 **Definition of Done:**
-- [ ] `functionId` và `{project}` đã được xác định và thư mục đầu ra đã sẵn sàng
-- [ ] File `phan-tich(1).md` tạo đúng vị trí, cấu trúc đúng template, có bảng Gap Analysis
-- [ ] File `QA(1).md` có ít nhất 1 câu hỏi cho mỗi Gap, tất cả trạng thái **Open**
+- [ ] `functionId` đã được xác định và thư mục đầu ra đã sẵn sàng
+- [ ] File `Analysis_v1.md` tạo đúng vị trí, cấu trúc đúng template, có bảng Gap Analysis
+- [ ] File `QnA-Log_v1.md` có ít nhất 1 câu hỏi cho mỗi Gap, tất cả trạng thái **Open**
 - [ ] Không có giả định nào được tự ý chốt thành Spec mà không đưa vào Q&A
 
 > **Telemetry:** Run `ak gate 1 start --ticket [functionId]` khi bắt đầu gate này.
@@ -213,33 +205,32 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 
 **Đầu vào (Inputs):**
 - Phản hồi Q&A từ BA (xem 3 option bên dưới)
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n).md` — phiên bản hiện tại
-- `docs/ak-{project}/spec/QA/[functionId]_QA(m).md` — danh sách câu hỏi hiện tại
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n).md` — phiên bản hiện tại
+- `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m).md` — danh sách câu hỏi hiện tại
 
 **Cách BA cung cấp phản hồi (BA chọn một trong 3):**
 - **Option A** — Nhập trực tiếp vào chat: `Q&A: Q1: [trả lời], Q2: [trả lời]`
 - **Option B** — Paste nội dung bảng Q&A đã điền vào chat
-- **Option C** — Đặt file tại: `docs/ak-{project}/spec/QA/[functionId]_QA(m)_response.md`
+- **Option C** — Đặt file tại: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m)_response.md`
 
 **Bước thực hiện:**
 
 #### Bước 1: Tiếp nhận và đánh giá câu trả lời
-- **READ skill:** `.claude/skills/ba-skills/skill-ba-qa-v1.md` và làm theo
-- Đối chiếu từng câu trả lời với câu hỏi trong `QA(m).md`
+- Đối chiếu từng câu trả lời với câu hỏi trong `QnA-Log_v(m).md`
 - Phân loại:
   - Đủ thông tin → cập nhật trạng thái: **Confirmed**
   - Chưa rõ hoặc phát sinh nghiệp vụ mới → giữ trạng thái **Open**, bổ sung ghi chú
 
 #### Bước 2: Tích hợp thông tin vào tài liệu phân tích
-- Lấy thông tin từ các câu Confirmed → cập nhật vào `phan-tich(n).md`
+- Lấy thông tin từ các câu Confirmed → cập nhật vào `Analysis_v(n).md`
 - Xóa các Gap đã được giải quyết khỏi bảng Gap Analysis
-- Tạo phiên bản mới: `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1).md`
+- Tạo phiên bản mới: `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md`
 
 #### Bước 3: Rẽ nhánh theo trạng thái Q&A
 
 **Kịch bản A — Vẫn còn câu hỏi Open:**
-1. Dùng `skill-ba-phan-tich-ban-dau` kiểm tra `phan-tich(n+1).md` có phát sinh Gap mới không
-2. Tạo: `docs/ak-{project}/spec/QA/[functionId]_QA(m+1).md` theo `skill-ba-qa` — chỉ giữ câu Open và câu mới phát sinh
+1. Kiểm tra `Analysis_v(n+1).md` có phát sinh Gap mới không
+2. Tạo: `02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md` — chỉ giữ câu Open và câu mới phát sinh
 3. **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-2-[functionId]-round-[m+1].md`
 4. Hiển thị:
 
@@ -247,8 +238,8 @@ Vui lòng cung cấp câu trả lời theo một trong 3 cách:
 ⏸️  GATE 2 — VÒNG Q&A [m+1]
 
 Câu hỏi còn Open: [N]
-File Q&A mới:     [docs/ak-{project}/spec/QA/[functionId]_QA(m+1).md](docs/ak-{project}/spec/QA/[functionId]_QA(m+1).md)
-File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1).md](docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1).md)
+File Q&A mới:     [02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md](02.BA-Specs/02.QnA/[functionId]/QnA-Log_v(m+1).md)
+File phân tích:   [02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md](02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n+1).md)
 
 → BA điền câu trả lời và cung cấp theo một trong 3 option (A/B/C)
 → Sau khi cung cấp phản hồi, type NEXT để AI xử lý vòng tiếp theo
@@ -294,10 +285,10 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 **Điều kiện vào Gate 3:** Tất cả Q&A đã **Confirmed** và Gate 2 đã **APPROVED**.
 
 **Đầu vào (Inputs):**
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n).md` — phiên bản cuối
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n).md` — phiên bản cuối
 
 **Đầu ra (Outputs):**
-- `docs/ak-{project}/spec/design/[functionId]_design.html`
+- `02.BA-Specs/03.UI-Prototypes/[functionId]/UI-Prototype_v1.html`
 
 **Bước thực hiện:**
 
@@ -317,7 +308,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 - CSS nổi bật lỗi (chữ đỏ, viền đỏ), mặc định ẩn (`display: none`)
 
 #### Bước 4: Lưu file
-- `docs/ak-{project}/spec/design/[functionId]_design.html`
+- `02.BA-Specs/03.UI-Prototypes/[functionId]/UI-Prototype_v1.html`
 
 #### Bước 5: Gate Review & Pause
 - **INVOKE** `gate-review` skill (generate mode) — ghi `.aiflow/review/gate-3-[functionId].md`
@@ -329,7 +320,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 → Nếu blocked: làm theo gate-review skill response protocol
 
 **Definition of Done:**
-- [ ] File `[functionId]_design.html` tạo đúng vị trí
+- [ ] File `UI-Prototype_v1.html` tạo đúng vị trí
 - [ ] Giao diện hiển thị đủ tất cả thành phần nghiệp vụ
 - [ ] 100% thẻ tương tác có `id` duy nhất
 - [ ] CSS tự chứa trong file HTML
@@ -346,18 +337,18 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 **Điều kiện vào Gate 4:** Gate 3 đã **APPROVED** và `design.html` đã hoàn chỉnh.
 
 **Đầu vào (Inputs):**
-- `docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n).md` — phiên bản cuối
-- `docs/ak-{project}/spec/design/[functionId]_design.html`
+- `02.BA-Specs/01.Analysis/[functionId]/Analysis_v(n).md` — phiên bản cuối
+- `02.BA-Specs/03.UI-Prototypes/[functionId]/UI-Prototype_v1.html`
 
 **Đầu ra (Outputs):**
-- `docs/ak-{project}/spec/UC/[functionId]_UC.md`
+- `02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v1.md`
 
 **Bước thực hiện:**
 
 #### Bước 1: Khởi tạo Spec từ Template
-- **READ template:** `.claude/skills/ba-skills/skill-ba-template-uc-v1.md`
-- **READ skill:** `.claude/skills/ba-skills/skill-ba-viet-spec-uc-v1.md`
-- Tạo: `docs/ak-{project}/spec/UC/[functionId]_UC.md`
+- **READ template:** `.claude/skills/ba-skills/skill-ba-uc-template-v1.md`
+- **READ skill:** `.claude/skills/ba-skills/skill-ba-write-uc-spec-v1.md`
+- Tạo: `02.BA-Specs/04.UC-Specs/[functionId]/UC-Spec_v1.md`
 - Điền General Information: Use Case ID, Title, Version, Actors, Preconditions, Postconditions
 
 #### Bước 2: Mô tả luồng sự kiện (Flow of Events)
@@ -367,7 +358,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 - Viết rõ tương tác Actor ↔ System ở từng bước
 
 #### Bước 3: Tích hợp giao diện Prototype
-- Copy toàn bộ mã HTML/CSS từ `design.html` vào phần Screen Description
+- Copy toàn bộ mã HTML/CSS từ `UI-Prototype_v1.html` vào phần Screen Description
 
 #### Bước 4: Mô tả chi tiết UI Components
 - Lập bảng: Tên | Loại | Bắt buộc | Độ dài tối đa | Giá trị mặc định | Ràng buộc validation
@@ -399,7 +390,7 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 - BA gõ `REVISION: [nội dung]` → cập nhật section liên quan → re-generate review file → hiển thị lại gate pause
 
 **Definition of Done:**
-- [ ] File `[functionId]_UC.md` đúng vị trí và cấu trúc template
+- [ ] File `UC-Spec_v1.md` đúng vị trí và cấu trúc template
 - [ ] 100% element HTML được mô tả trong bảng UI Components (id, loại, ràng buộc)
 - [ ] Mã Mermaid hợp lệ, thể hiện đủ Main/Alternative/Exception Flow
 - [ ] Business Rules đầy đủ với mã `[BR-NNN]` và thông báo lỗi chính xác
@@ -414,10 +405,10 @@ File phân tích:   [docs/ak-{project}/spec/phan-tich/[functionId]_phan-tich(n+1
 
 | Gate | Skills đọc | Output |
 |---|---|---|
-| Gate 1 | `skill-ba-phan-tich-ban-dau`, `template-phan-tich-ban-dau`, `skill-ba-qa`, `template-qa` | `phan-tich(1).md`, `QA(1).md` |
-| Gate 2 | `skill-ba-qa`, `skill-ba-phan-tich-ban-dau` | `phan-tich(n+1).md`, `QA(m+1).md` (nếu còn Open) |
-| Gate 3 | `skill-ba-prototype` | `design.html` |
-| Gate 4 | `skill-ba-viet-spec-uc`, `template-uc`, `skill-ba-ve-luong-mermaid`, `skill-ba-xay-dung-business-rules` | `_UC.md` |
+| Gate 1 | `brainstorming`, `skill-ba-initial-analysis`, `skill-ba-initial-analysis-template`, `skill-ba-qna`, `skill-ba-qna-template` | `Analysis_v1.md`, `QnA-Log_v1.md` |
+| Gate 2 | `skill-ba-qna`, `skill-ba-initial-analysis` | `Analysis_v(n+1).md`, `QnA-Log_v(m+1).md` (nếu còn Open) |
+| Gate 3 | `skill-ba-ui-prototype` | `UI-Prototype_v1.html` |
+| Gate 4 | `skill-ba-write-uc-spec`, `skill-ba-uc-template`, `skill-ba-mermaid-flowchart`, `skill-ba-build-business-rules` | `UC-Spec_v1.md` |
 
 ---