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

package/custom/skills/ba-skills/{skill-ba-phan-tich-ban-dau-v1.md → skill-ba-initial-analysis-v1.md}

@@ -31,7 +31,7 @@ Kỹ năng này giúp Business Analyst (hoặc Agent) quét, đọc hiểu và c
     - Có quy tắc nghiệp vụ (Business rules) ngầm định nào không?
     - Luồng thay thế (Alternative flows) hoặc luồng lỗi (Exception flows) là gì?
 - **Bước 4: Soạn dự thảo Kết quả phân tích ban đầu:**
-  Áp dụng template phân tích ban đầu (`skill-ba-template-phan-tich-ban-dau-v1.md`) để điền thông tin và lập bảng Gap/Assumption.
+  Áp dụng template phân tích ban đầu (`skill-ba-initial-analysis-template-v1.md`) để điền thông tin và lập bảng Gap/Assumption.
 
 ## 4. Checklist kiểm tra (Checklist for Verification)
 - [ ] Đã xác định rõ Mục tiêu hệ thống/chức năng chưa? (Hệ thống giải quyết bài toán gì?)
@@ -41,4 +41,4 @@ Kỹ năng này giúp Business Analyst (hoặc Agent) quét, đọc hiểu và c
 - [ ] Không tự tiện bổ sung các tính năng ngoài phạm vi yêu cầu của khách hàng khi chưa có thảo luận/Q&A.
 
 ## 5. Output mong đợi (Expected Output)
-- File tài liệu phân tích ban đầu định dạng markdown, cấu trúc thống nhất dựa theo `@skill-ba-template-phan-tich-ban-dau-v1.md`, đặt tên theo chuẩn: `Tên chức năng_Kết quả phân tích(n).md` trong thư mục `TÀI LIỆU/output/Kết quả phân tích/`.
+- File tài liệu phân tích ban đầu định dạng markdown, cấu trúc thống nhất dựa theo `@skill-ba-initial-analysis-template-v1.md`, đặt tên theo chuẩn: `Analysis_v(n).md` trong thư mục `02.BA-Specs/01.Analysis/[functionId]/`.

package/custom/skills/ba-skills/{skill-ba-qa-v1.md → skill-ba-qna-v1.md}

@@ -13,7 +13,7 @@ Kỹ năng này giúp BA thiết kế các câu hỏi rõ ràng, khách quan và
 ## 3. Quy trình thực hiện (Step-by-step Process)
 - **Bước 1: Chuyển đổi Gap thành câu hỏi Q&A:**
   Từ danh sách khoảng trống phát hiện ở bước Phân tích ban đầu, chuyển mỗi dòng thành một câu hỏi Q&A cụ thể.
-- **Bước 2: Chuẩn hóa câu hỏi theo mẫu `@skill-ba-qa-template-v1.md`:**
+- **Bước 2: Chuẩn hóa câu hỏi theo mẫu `@skill-ba-qna-template-v1.md`:**
   - Xác định phân vùng nghiệp vụ (Module/Screen).
   - Trích dẫn yêu cầu hiện tại (Current Status/Requirement).
   - Nêu rõ vấn đề mơ hồ.
@@ -31,5 +31,5 @@ Kỹ năng này giúp BA thiết kế các câu hỏi rõ ràng, khách quan và
 - [ ] Đã cập nhật đúng và đầy đủ tất cả câu trả lời của khách hàng vào tài liệu phân tích chưa? (Không bỏ sót bất kỳ điểm chốt nào).
 
 ## 5. Output mong đợi (Expected Output)
-- File danh sách câu hỏi Q&A định dạng markdown, cấu trúc thống nhất dựa theo `@skill-ba-qa-template-v1.md`, đặt tên theo chuẩn: `Tên chức năng_Q&A(m).md` trong thư mục `TÀI LIỆU/output/QA/`.
+- File danh sách câu hỏi Q&A định dạng markdown, cấu trúc thống nhất dựa theo `@skill-ba-qna-template-v1.md`, đặt tên theo chuẩn: `QnA-Log_v(m).md` trong thư mục `02.BA-Specs/02.QnA/[functionId]/`.
 - Tài liệu phân tích được cập nhật tương ứng với phiên bản mới tăng dần `(n+1)`.

package/custom/skills/ba-skills/{skill-ba-prototype-v1.md → skill-ba-ui-prototype-v1.md}

@@ -22,7 +22,7 @@ Kỹ năng này hướng dẫn BA thiết kế và hiện thực hóa giao diệ
   - Sử dụng bảng màu hiện đại (tránh màu đỏ/xanh lá gốc, dùng các màu trung tính, dịu mắt phối hợp hiệu ứng hover cho các nút bấm).
   - Đảm bảo thiết kế responsive cơ bản bằng media queries nếu cần.
 - **Bước 4: Kiểm tra và lưu trữ:**
-  Mở file HTML trên trình duyệt để kiểm tra trực quan. Lưu vào thư mục `TÀI LIỆU/output/design/`.
+  Mở file HTML trên trình duyệt để kiểm tra trực quan. Lưu vào thư mục `02.BA-Specs/03.UI-Prototypes/[functionId]/`.
 
 ## 4. Checklist kiểm tra (Checklist for Verification)
 - [ ] File HTML có tự chứa toàn bộ CSS không? (Không liên kết tới file CSS bên ngoài trừ font chữ hệ thống).
@@ -32,4 +32,4 @@ Kỹ năng này hướng dẫn BA thiết kế và hiện thực hóa giao diệ
 - [ ] Các phần tử tương tác (Button, Link, Input) có hiệu ứng trực quan khi hover hoặc focus không?
 
 ## 5. Output mong đợi (Expected Output)
-- Một file HTML độc lập chứa đầy đủ code HTML và CSS nội bộ, đặt tên theo chuẩn: `Tên chức năng_design.html` trong thư mục `TÀI LIỆU/output/design/`.
+- Một file HTML độc lập chứa đầy đủ code HTML và CSS nội bộ, đặt tên theo chuẩn: `UI-Prototype_v1.html` trong thư mục `02.BA-Specs/03.UI-Prototypes/[functionId]/`.

package/custom/skills/ba-skills/{skill-ba-viet-spec-uc-v1.md → skill-ba-write-uc-spec-v1.md}

@@ -23,16 +23,16 @@ Kỹ năng này giúp BA chuyển hóa toàn bộ các thông tin yêu cầu ngh
     - Giá trị mặc định (Default Value).
     - Mô tả hành vi (Description).
 - **Bước 4: Thiết kế sơ đồ Mermaid (Activity Flow):**
-  Áp dụng kỹ năng `@skill-ba-ve-luong-mermaid-v1.md` để vẽ và nhúng biểu đồ Mermaid.
+  Áp dụng kỹ năng `@skill-ba-mermaid-flowchart-v1.md` để vẽ và nhúng biểu đồ Mermaid.
 - **Bước 5: Đặc tả Business Rules (Quy tắc nghiệp vụ):**
-  Áp dụng kỹ năng `@skill-ba-xay-dung-business-rules-v1.md` để viết chi tiết các điều kiện kiểm tra, validation logic và câu thông báo lỗi đi kèm.
+  Áp dụng kỹ năng `@skill-ba-build-business-rules-v1.md` để viết chi tiết các điều kiện kiểm tra, validation logic và câu thông báo lỗi đi kèm.
 
 ## 4. Checklist kiểm tra (Checklist for Verification)
 - [ ] Luồng đi (Flow) có mô tả rõ ràng sự tương tác qua lại giữa Actor và System chưa?
 - [ ] Bảng mô tả UI Components có bị bỏ sót bất kỳ thành phần nào trên prototype HTML không?
 - [ ] Các Business Rules (BR) đã được đánh mã số rõ ràng (BR1, BR2, BR3...) để dễ tham chiếu chưa?
 - [ ] Mọi trường hợp báo lỗi đều có câu thông báo lỗi (Error message) đi kèm chi tiết chưa?
-- [ ] Tài liệu có sử dụng định dạng markdown chuẩn và cấu trúc thống nhất theo mẫu `@skill-ba-template-uc-v1.md` chưa?
+- [ ] Tài liệu có sử dụng định dạng markdown chuẩn và cấu trúc thống nhất theo mẫu `@skill-ba-uc-template-v1.md` chưa?
 
 ## 5. Output mong đợi (Expected Output)
-- Một tài liệu đặc tả Use Case hoàn chỉnh định dạng markdown, đặt tên theo chuẩn: `Tên chức năng_UC.md` trong thư mục `TÀI LIỆU/output/UC/`.
+- Một tài liệu đặc tả Use Case hoàn chỉnh định dạng markdown, đặt tên theo chuẩn: `UC-Spec_v1.md` trong thư mục `02.BA-Specs/04.UC-Specs/[functionId]/`.

package/custom/skills/test-skills/rules/directory-and-naming-convention.md

@@ -0,0 +1,158 @@
+# 00. Directory Structure & File Naming Convention
+
+## Objective
+
+Define and standardize directory organization and file naming rules for all Artifacts generated in the QA Workflow. Ensures consistency, traceability, and maintainability across the project.
+
+> **Important**: This document is the **mandatory reference** for the entire workflow. All generated Artifacts (Result, QA, TestCase) must strictly follow the rules defined here before executing any step in the workflow.
+
+---
+
+## 1. Directory Overview
+
+```text
+03.Testing/
+├── 01.Testcases/
+│   └── [functionId]/
+│       └── [functionId]_TestCase.md                  ← Gate 4 tạo
+└── 07.AI-Artifacts/
+    └── [functionId]/
+        ├── [functionId]_01_Requirement_Analysis_Result.md     ← Gate 1 tạo
+        ├── [functionId]_01_Requirement_Analysis_QA.md         ← Gate 1 tạo (nếu có issue)
+        ├── [functionId]_02_Test_Scenarios_Result.md           ← Gate 2 tạo
+        ├── [functionId]_02_Scenario_Building_QA.md            ← Gate 2 tạo (nếu có issue)
+        ├── [functionId]_03_Test_Cases_Draft_Result.md         ← Gate 3 tạo
+        ├── [functionId]_03_Test_Design_QA.md                  ← Gate 3 tạo (nếu có issue)
+        ├── [functionId]_04_Test_Cases_Final_Result.md         ← Gate 4 tạo (cùng TestCase)
+        └── [functionId]_04_Test_Review_QA.md                  ← Gate 4 tạo
+```
+
+Example: `functionId = AD06` → root folder is `03.Testing/`
+
+---
+
+## 2. 07.AI-Artifacts/ Directory Rules
+
+- **Root path**: `03.Testing/07.AI-Artifacts/[functionId]/`
+- **Purpose**: Store all official result artifacts and QA tracking files generated at each workflow gate.
+
+### 2.1. File Naming Convention
+
+Files are placed under `03.Testing/07.AI-Artifacts/[functionId]/` with the `[functionId]` as prefix:
+
+```
+[functionId]_[step]_Result.md
+[functionId]_[step]_QA.md
+```
+
+### 2.2. File Name Table by Gate
+
+| Gate | Step Name | Result File Name | QA File Name (if issues) |
+| :---: | :--- | :--- | :--- |
+| **01** | `01_Requirement_Analysis` | `[functionId]_01_Requirement_Analysis_Result.md` | `[functionId]_01_Requirement_Analysis_QA.md` |
+| **02** | `02_Test_Scenarios` | `[functionId]_02_Test_Scenarios_Result.md` | `[functionId]_02_Scenario_Building_QA.md` |
+| **03** | `03_Test_Cases_Draft` | `[functionId]_03_Test_Cases_Draft_Result.md` | `[functionId]_03_Test_Design_QA.md` |
+| **04** | `04_Test_Cases_Final` | `[functionId]_04_Test_Cases_Final_Result.md` | `[functionId]_04_Test_Review_QA.md` |
+
+### 2.3. Full Path Examples
+
+```
+03.Testing/07.AI-Artifacts/AD06/AD06_01_Requirement_Analysis_Result.md
+03.Testing/07.AI-Artifacts/AD06/AD06_01_Requirement_Analysis_QA.md
+03.Testing/07.AI-Artifacts/AD06/AD06_02_Test_Scenarios_Result.md
+03.Testing/07.AI-Artifacts/AD06/AD06_03_Test_Cases_Draft_Result.md
+03.Testing/07.AI-Artifacts/AD06/AD06_04_Test_Cases_Final_Result.md
+```
+
+> QA files are only created when there are issues (Critical/Major block, or Minor carry-forward).
+
+---
+
+## 3. 01.Testcases/ Directory Rules
+
+- **Root path**: `03.Testing/01.Testcases/[functionId]/`
+- **Purpose**: Store the final test case artifact ready for execution. This file contains only the **test case tables** (not review summaries, findings, or coverage validation) and is generated **simultaneously** with `04_Test_Cases_Final_Result.md` at the end of Gate 4.
+
+### 3.1. File Naming Convention
+
+```
+[functionId]_TestCase.md
+```
+
+### 3.2. Full Path Example
+
+```
+03.Testing/01.Testcases/AD06/AD06_TestCase.md
+```
+
+### 3.3. File Content
+
+The TestCase file follows the **standard template** at `.claude/skills/test-skills/template/testcase-template.md` and **only includes**:
+
+- **Section 1**: General Information (fill in functionId, creation date)
+- **Section 2**: Test Execution Summary (reset to 0, waiting for execution)
+- **Section 3**: Detailed Test Cases (all 5 groups and test case tables)
+
+> **Does NOT include**: Review Summary, Review Findings, Coverage Validation (RTM), Sign-off Status — these belong in `04_Test_Cases_Final_Result.md` within `07.AI-Artifacts/[functionId]/`.
+
+### 3.4. Generation Timing
+
+The TestCase file is generated **simultaneously** with `04_Test_Cases_Final_Result.md` at the end of Gate 4, after all Critical/Major issues are resolved and the test case set has been signed off.
+
+---
+
+## 4. Full Artifact Matrix
+
+| Gate | Description | Result Artifact | QA Artifact | TestCase Artifact |
+| :---: | :--- | :--- | :--- | :--- |
+| **01** | Requirement & Risk Analysis | `[fId]_01_Requirement_Analysis_Result.md` | `[fId]_01_Requirement_Analysis_QA.md` | — |
+| **02** | Scenario Building | `[fId]_02_Test_Scenarios_Result.md` | `[fId]_02_Scenario_Building_QA.md` | — |
+| **03** | Test Case Design | `[fId]_03_Test_Cases_Draft_Result.md` | `[fId]_03_Test_Design_QA.md` | — |
+| **04** | Review & Optimization | `[fId]_04_Test_Cases_Final_Result.md` | `[fId]_04_Test_Review_QA.md` | `[fId]_TestCase.md` |
+
+> `[fId]` = `[functionId]`
+
+---
+
+## 5. Additional Rules
+
+### 5.1. Update Rule
+
+- If a file already exists, **update and overwrite** with the latest content.
+- **Do not create duplicate files** with version suffixes (e.g. `_v1`, `_v2`, `_final`, `_new`).
+
+### 5.2. functionId Naming
+
+- Use the **exact functionId** determined in Gate 1 Pre-flight (e.g. `AD06`, `AD10`, `LOGIN`).
+- Valid examples: `AD06`, `AD10_Create_Product`, `LOGIN`, `ORD002`
+- **Invalid**: `product`, `login`, `tag_feature` (custom names diverging from the functionId)
+- The workflow **MUST** strictly require a `functionId` before starting.
+
+### 5.3. Consistency Principle
+
+- `07.AI-Artifacts/` and `01.Testcases/` artifacts for the same functionId **must all use the same functionId prefix** and be grouped in a `[functionId]` subfolder.
+- This ensures fast cross-lookup and traceability.
+
+---
+
+## 6. Application Checklist
+
+Before starting any workflow gate, verify:
+
+- [ ] functionId has been confirmed in Gate 1 Pre-flight?
+- [ ] Root folder `03.Testing/` exists?
+- [ ] `07.AI-Artifacts/[functionId]/` subfolder exists?
+- [ ] Result file name follows pattern `[functionId]_[step]_Result.md`?
+- [ ] QA file name follows pattern `[functionId]_[step]_QA.md`?
+- [ ] (After Gate 4) `01.Testcases/[functionId]/` subfolder exists?
+- [ ] (After Gate 4) TestCase file name follows pattern `[functionId]_TestCase.md`?
+- [ ] (After Gate 4) TestCase file contains only Section 1+2+3 per template (no review metadata)?
+- [ ] No duplicate or incorrectly named files?
+
+---
+
+## 7. References
+
+- `create-testcase-workflow.md` — Full 4-Gate QA workflow definition
+- `.claude/skills/test-skills/template/testcase-template.md` — Standard test case template
+- `.claude/skills/test-skills/rules/qa-writing-standards.md` — QA writing standards

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.