@educa-corp/sdd-framework 0.5.0 → 0.7.0

package/scripts/init.sh

@@ -1,49 +0,0 @@
-#!/usr/bin/env bash
-# init.sh — First-time setup of SDD Framework framework in a consumer project.
-#
-# Usage:
-#   bash scripts/init.sh
-#   bash scripts/init.sh --module java-spring
-#   bash scripts/init.sh --module java-spring --hooks
-#
-# What it does:
-#   1. Copies framework files to .agent/ (commands, steps, hooks, rules, templates, modules)
-#   2. Creates lightweight shortcut files in .claude/commands/ that delegate to .agent/
-#   3. Writes .agent/FRAMEWORK_VERSION for upgrade.sh to track installed version
-#
-# After init:
-#   - Commit .agent/ to git so the entire team shares the framework
-#   - Run /setup-ai-first in Claude Code to complete project setup
-#   - To upgrade later: bash scripts/upgrade.sh
-
-set -euo pipefail
-
-echo ""
-echo "╔══════════════════════════════════════════╗"
-echo "║   SDD Framework — Project Init            ║"
-echo "╚══════════════════════════════════════════╝"
-echo ""
-
-# ── Prerequisite check ────────────────────────────────────────────────────────
-
-if ! command -v node &> /dev/null; then
-  echo "❌ Node.js is required. Install from https://nodejs.org"
-  exit 1
-fi
-
-# ── Run installer via npx ─────────────────────────────────────────────────────
-
-echo "Running: npx @educa-corp/sdd-framework --init $*"
-echo ""
-
-npx -y @educa-corp/sdd-framework --init "$@"
-
-echo ""
-echo "✅ Init complete!"
-echo ""
-echo "Recommended next steps:"
-echo "  git add .agent/ .claude/commands/"
-echo "  git commit -m 'chore: init spec-driven-docs framework'"
-echo ""
-echo "Then open Claude Code and run: /setup-ai-first"
-echo ""

package/scripts/upgrade.sh

@@ -1,94 +0,0 @@
-#!/usr/bin/env bash
-# upgrade.sh — Upgrade SDD Framework framework in an existing project.
-#
-# Usage:
-#   bash scripts/upgrade.sh
-#   bash scripts/upgrade.sh --module java-spring   # also upgrade a stack module
-#
-# What it does:
-#   1. Reads current installed version from .agent/FRAMEWORK_VERSION
-#   2. Checks npm registry for the latest published version
-#   3. If newer: runs npx @educa-corp/sdd-framework@latest --init to update .agent/
-#   4. Reports what changed so you can review before committing
-#
-# Requirements:
-#   - Project was set up with init.sh (or npx ... --init)
-#   - .agent/FRAMEWORK_VERSION exists
-
-set -euo pipefail
-
-AGENT_DIR=".agent"
-VERSION_FILE="${AGENT_DIR}/FRAMEWORK_VERSION"
-
-echo ""
-echo "╔══════════════════════════════════════════╗"
-echo "║   SDD Framework — Upgrade                 ║"
-echo "╚══════════════════════════════════════════╝"
-echo ""
-
-# ── Prerequisite checks ───────────────────────────────────────────────────────
-
-if ! command -v node &> /dev/null; then
-  echo "❌ Node.js is required. Install from https://nodejs.org"
-  exit 1
-fi
-
-if ! command -v npm &> /dev/null; then
-  echo "❌ npm is required. Install Node.js from https://nodejs.org"
-  exit 1
-fi
-
-if [ ! -f "$VERSION_FILE" ]; then
-  echo "❌ .agent/FRAMEWORK_VERSION not found."
-  echo ""
-  echo "   This project was not set up with --init."
-  echo "   To set up the new structure:"
-  echo ""
-  echo "     bash scripts/init.sh"
-  echo "   or:"
-  echo "     npx @educa-corp/sdd-framework --init"
-  echo ""
-  exit 1
-fi
-
-# ── Version comparison ────────────────────────────────────────────────────────
-
-CURRENT=$(cat "$VERSION_FILE" | tr -d '[:space:]')
-echo "Checking npm registry ..."
-
-LATEST=$(npm view @educa-corp/sdd-framework version 2>/dev/null || echo "unknown")
-
-echo ""
-echo "  Installed : v${CURRENT}"
-echo "  Latest    : v${LATEST}"
-echo ""
-
-if [ "$LATEST" = "unknown" ]; then
-  echo "⚠️  Could not reach npm registry. Check your internet connection."
-  exit 1
-fi
-
-if [ "$CURRENT" = "$LATEST" ]; then
-  echo "✅ Already up to date (v${CURRENT}). Nothing to do."
-  echo ""
-  exit 0
-fi
-
-# ── Upgrade ───────────────────────────────────────────────────────────────────
-
-echo "Upgrading v${CURRENT} → v${LATEST} ..."
-echo ""
-
-npx -y @educa-corp/sdd-framework@latest --init "$@"
-
-# ── Post-upgrade guidance ─────────────────────────────────────────────────────
-
-echo ""
-echo "✅ Upgraded to v${LATEST}!"
-echo ""
-echo "Review what changed in .agent/ before committing:"
-echo ""
-echo "  git diff .agent/"
-echo "  git add .agent/"
-echo "  git commit -m 'chore: upgrade spec-driven-docs v${CURRENT} → v${LATEST}'"
-echo ""

package/skills/code/SKILL.md

@@ -1,19 +0,0 @@
----
-description: Sinh implementation code từ BDD spec đã duyệt kèm tag traceability, hoặc review code read-only đối chiếu spec compliance và quy tắc kiến trúc. Trigger when: "/generate-code", "/review-code", "sinh code", "generate code", "viết code", "implement feature", "review code", "kiểm tra code", "code review", "check implementation".
----
-
-# Code Skills — Generate & Review
-
-Skill này xử lý `/generate-code` và `/review-code`. Để **không lệch schema/gate**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /generate-code — Sinh Implementation Code
-
-→ **Đọc và tuân theo `commands/generate-code.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard mềm BDD `@trace.status` approved + Design Spec (approved/độ-tươi/sanity) cho FE/App · `--phase=ui`/`--phase=integration` · branch + build verify · trace TSV (22 cột) `@trace.implements`.
-
-## /review-code — Code Review chỉ-đọc (READ-ONLY)
-
-→ **Đọc và tuân theo `commands/review-code.md`** với cùng `$ARGUMENTS`.
-
-Command lo: Pre-Review Scan · 4 lăng kính (Traceability · Layer Architecture · Coding Standards · Spec Compliance) · đề xuất ghi Lesson cho lỗi AI lặp.

package/skills/code/SKILL.tmpl

@@ -1,19 +0,0 @@
----
-description: Sinh implementation code từ BDD spec đã duyệt kèm tag traceability, hoặc review code read-only đối chiếu spec compliance và quy tắc kiến trúc. Trigger when: "/generate-code", "/review-code", "sinh code", "generate code", "viết code", "implement feature", "review code", "kiểm tra code", "code review", "check implementation".
----
-
-# Code Skills — Generate & Review
-
-Skill này xử lý `/generate-code` và `/review-code`. Để **không lệch schema/gate**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /generate-code — Sinh Implementation Code
-
-→ **Đọc và tuân theo `commands/generate-code.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard mềm BDD `@trace.status` approved + Design Spec (approved/độ-tươi/sanity) cho FE/App · `--phase=ui`/`--phase=integration` · branch + build verify · trace TSV (22 cột) `@trace.implements`.
-
-## /review-code — Code Review chỉ-đọc (READ-ONLY)
-
-→ **Đọc và tuân theo `commands/review-code.md`** với cùng `$ARGUMENTS`.
-
-Command lo: Pre-Review Scan · 4 lăng kính (Traceability · Layer Architecture · Coding Standards · Spec Compliance) · đề xuất ghi Lesson cho lỗi AI lặp.

package/skills/debug/SKILL.md

@@ -1,19 +0,0 @@
----
-description: Fix bug với full workflow (branch, test, commit), phân tích debug nhanh các lỗi hoặc hành vi bất ngờ, hoặc kiểm chứng độ phủ traceability giữa spec và code. Trigger when: "/fix-bug", "/debug", "/validate-traces", "fix bug", "sửa bug", "debug lỗi", "phân tích lỗi", "tại sao lỗi này", "validate traces", "kiểm tra traceability", "coverage matrix", "trace drift".
----
-
-# Debug & Quality Skills — Fix Bug, Debug, Validate Traces
-
-Skill này xử lý `/fix-bug`, `/debug`, `/validate-traces`. Để **không lệch schema/flow**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command.
-
-## /fix-bug — Full Bug Fix Workflow
-→ **Đọc và tuân theo `commands/fix-bug.md`** với cùng `$ARGUMENTS`.
-(Command lo: bug-type table theo platform · đọc `{BUG-ID}` report · regression test · build + push 2 tầng (umbrella) · BUG State `Open→Fixed`→`Closed` · đề xuất Lesson.)
-
-## /debug — Phân tích nhanh
-→ **Đọc và tuân theo `commands/debug.md`** với cùng `$ARGUMENTS`.
-(Command lo: 4 path (stack trace / reproduce / test fail / câu hỏi code) · bảng lỗi theo từng platform/module · stack-trace đọc dưới-lên.)
-
-## /validate-traces — Traceability Coverage
-→ **Đọc và tuân theo `commands/validate-traces.md`** với cùng `$ARGUMENTS`.
-(Command lo: đọc trace TSV 22 cột authoritative · tính OK/DRIFT/GAP/UNTRACKED + PRD/TECHDOC drift · sync `uc_status` ← `@trace.status` · aggregate dashboard.)

package/skills/debug/SKILL.tmpl

@@ -1,19 +0,0 @@
----
-description: Fix bug với full workflow (branch, test, commit), phân tích debug nhanh các lỗi hoặc hành vi bất ngờ, hoặc kiểm chứng độ phủ traceability giữa spec và code. Trigger when: "/fix-bug", "/debug", "/validate-traces", "fix bug", "sửa bug", "debug lỗi", "phân tích lỗi", "tại sao lỗi này", "validate traces", "kiểm tra traceability", "coverage matrix", "trace drift".
----
-
-# Debug & Quality Skills — Fix Bug, Debug, Validate Traces
-
-Skill này xử lý `/fix-bug`, `/debug`, `/validate-traces`. Để **không lệch schema/flow**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command.
-
-## /fix-bug — Full Bug Fix Workflow
-→ **Đọc và tuân theo `commands/fix-bug.md`** với cùng `$ARGUMENTS`.
-(Command lo: bug-type table theo platform · đọc `{BUG-ID}` report · regression test · build + push 2 tầng (umbrella) · BUG State `Open→Fixed`→`Closed` · đề xuất Lesson.)
-
-## /debug — Phân tích nhanh
-→ **Đọc và tuân theo `commands/debug.md`** với cùng `$ARGUMENTS`.
-(Command lo: 4 path (stack trace / reproduce / test fail / câu hỏi code) · bảng lỗi theo từng platform/module · stack-trace đọc dưới-lên.)
-
-## /validate-traces — Traceability Coverage
-→ **Đọc và tuân theo `commands/validate-traces.md`** với cùng `$ARGUMENTS`.
-(Command lo: đọc trace TSV 22 cột authoritative · tính OK/DRIFT/GAP/UNTRACKED + PRD/TECHDOC drift · sync `uc_status` ← `@trace.status` · aggregate dashboard.)

package/skills/design-spec/SKILL.md

@@ -1,11 +0,0 @@
----
-description: Sinh tài liệu Design Specification cho platform FE hoặc App từ một Business PRD. Trigger when: "/generate-design-spec", "tạo design spec", "generate design spec", "viết design spec", "tạo tài liệu thiết kế UI", "generate UI spec", "cần design spec cho", "tôi muốn spec UI", "tài liệu cho FE", "tài liệu cho app".
----
-
-# /generate-design-spec — Generate Design Specification (FE / App)
-
-Skill này xử lý `/generate-design-spec`. Để **không lệch gate/schema**, skill KHÔNG nhân bản — thực thi **y hệt** command.
-
-→ **Đọc và tuân theo `commands/generate-design-spec.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard PRD approved (mềm) · ghi `Built from PRD` + Version Check drift · Figma per-screen node-level link (`?node-id=`) fetch qua MCP, màn thiếu link → ❌ Missing → Status giữ `draft` · Screen Inventory/Specs/States · Interaction Patterns + Platform Considerations theo platform · AC-UI (Verified by) · **Self-Review Gate** trước khi ghi · chỉ FE/App (BE bị từ chối).

package/skills/design-spec/SKILL.tmpl

@@ -1,11 +0,0 @@
----
-description: Sinh tài liệu Design Specification cho platform FE hoặc App từ một Business PRD. Trigger when: "/generate-design-spec", "tạo design spec", "generate design spec", "viết design spec", "tạo tài liệu thiết kế UI", "generate UI spec", "cần design spec cho", "tôi muốn spec UI", "tài liệu cho FE", "tài liệu cho app".
----
-
-# /generate-design-spec — Generate Design Specification (FE / App)
-
-Skill này xử lý `/generate-design-spec`. Để **không lệch gate/schema**, skill KHÔNG nhân bản — thực thi **y hệt** command.
-
-→ **Đọc và tuân theo `commands/generate-design-spec.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard PRD approved (mềm) · ghi `Built from PRD` + Version Check drift · Figma per-screen node-level link (`?node-id=`) fetch qua MCP, màn thiếu link → ❌ Missing → Status giữ `draft` · Screen Inventory/Specs/States · Interaction Patterns + Platform Considerations theo platform · AC-UI (Verified by) · **Self-Review Gate** trước khi ghi · chỉ FE/App (BE bị từ chối).

package/skills/discovery/SKILL.md

@@ -1,14 +0,0 @@
----
-description: Dẫn dắt product discovery cho một feature mới qua Q&A có cấu trúc. Trigger when: "/define-product", "khám phá tính năng", "define new feature", "start new feature", "product discovery", "tôi muốn build tính năng mới", "let's define a feature", "begin feature discovery".
----
-
-# /define-product — Feature Discovery (Q&A theo phase)
-
-Lệnh này thực thi **y hệt** `commands/define-product.md` — không nhân bản logic ở đây để tránh lệch cấu trúc / phase / path output.
-
-`commands/define-product.md` dẫn PO qua các phase Q&A có checkpoint:
-Knowledge Sync → Feature Definition (Context/Problem/Goal/Actor/In&Out Scope/User Story/Phụ thuộc liên service) → User Flow (kèm Edge Cases) → Clarification Log → Business Rules → Business Logic → Acceptance Criteria → Validation Report.
-
-Output ghi `{paths.product_definitions_dir}/{TICKET-ID}-{slug}.md` theo `templates/product-definition.template.md` — input cho `/generate-prd`.
-
-→ **Đọc và tuân theo `commands/define-product.md`** với cùng `$ARGUMENTS`.

package/skills/discovery/SKILL.tmpl

@@ -1,14 +0,0 @@
----
-description: Dẫn dắt product discovery cho một feature mới qua Q&A có cấu trúc. Trigger when: "/define-product", "khám phá tính năng", "define new feature", "start new feature", "product discovery", "tôi muốn build tính năng mới", "let's define a feature", "begin feature discovery".
----
-
-# /define-product — Feature Discovery (Q&A theo phase)
-
-Lệnh này thực thi **y hệt** `commands/define-product.md` — không nhân bản logic ở đây để tránh lệch cấu trúc / phase / path output.
-
-`commands/define-product.md` dẫn PO qua các phase Q&A có checkpoint:
-Knowledge Sync → Feature Definition (Context/Problem/Goal/Actor/In&Out Scope/User Story/Phụ thuộc liên service) → User Flow (kèm Edge Cases) → Clarification Log → Business Rules → Business Logic → Acceptance Criteria → Validation Report.
-
-Output ghi `{paths.product_definitions_dir}/{TICKET-ID}-{slug}.md` theo `templates/product-definition.template.md` — input cho `/generate-prd`.
-
-→ **Đọc và tuân theo `commands/define-product.md`** với cùng `$ARGUMENTS`.

package/skills/prd/SKILL.md

@@ -1,19 +0,0 @@
----
-description: Sinh PRD từ một product definition, hoặc phân tích một PRD có sẵn qua 4 lăng kính review (QA, DEV, SA, PO) để tìm gap và rủi ro. Trigger when: "/generate-prd", "/refine-prd", "tạo PRD", "generate PRD", "phân tích PRD", "review PRD", "refine PRD", "PRD có vấn đề gì không", "check PRD quality".
----
-
-# PRD Skills — Generate & Refine
-
-Skill này xử lý `/generate-prd` và `/refine-prd`. Để **không lệch logic/schema**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /generate-prd — Sinh Product Requirements Document
-
-→ **Đọc và tuân theo `commands/generate-prd.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard discovery completed · phân giải API Source (existing/greenfield/partner) · Terminology Map · map §1c "Phụ thuộc liên service" + §4b Wireframe · slug kế thừa · template canonical (`templates/prd.template.md`) · Change Log rolling-window.
-
-## /refine-prd — Phân tích PRD qua 4 lăng kính review
-
-→ **Đọc và tuân theo `commands/refine-prd.md`** với cùng `$ARGUMENTS`.
-
-Command lo: 4 lăng kính fan-out đa sub-agent + completeness-critic (findings đầy đủ 1 lần chạy) · schema findings đầy đủ (`uc_id`, `quote`, `auto_fixable`) cho Review Board · Resume Mode (apply → bump version → reset draft → changelog).

package/skills/prd/SKILL.tmpl

@@ -1,19 +0,0 @@
----
-description: Sinh PRD từ một product definition, hoặc phân tích một PRD có sẵn qua 4 lăng kính review (QA, DEV, SA, PO) để tìm gap và rủi ro. Trigger when: "/generate-prd", "/refine-prd", "tạo PRD", "generate PRD", "phân tích PRD", "review PRD", "refine PRD", "PRD có vấn đề gì không", "check PRD quality".
----
-
-# PRD Skills — Generate & Refine
-
-Skill này xử lý `/generate-prd` và `/refine-prd`. Để **không lệch logic/schema**, skill KHÔNG nhân bản — mỗi lệnh thực thi **y hệt** command tương ứng.
-
-## /generate-prd — Sinh Product Requirements Document
-
-→ **Đọc và tuân theo `commands/generate-prd.md`** với cùng `$ARGUMENTS`.
-
-Command lo: guard discovery completed · phân giải API Source (existing/greenfield/partner) · Terminology Map · map §1c "Phụ thuộc liên service" + §4b Wireframe · slug kế thừa · template canonical (`templates/prd.template.md`) · Change Log rolling-window.
-
-## /refine-prd — Phân tích PRD qua 4 lăng kính review
-
-→ **Đọc và tuân theo `commands/refine-prd.md`** với cùng `$ARGUMENTS`.
-
-Command lo: 4 lăng kính fan-out đa sub-agent + completeness-critic (findings đầy đủ 1 lần chạy) · schema findings đầy đủ (`uc_id`, `quote`, `auto_fixable`) cho Review Board · Resume Mode (apply → bump version → reset draft → changelog).

package/skills/qc/qa-analyst/DOC_GAPS.template.md

@@ -1,63 +0,0 @@
----
-version: 1.1
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
----
-
-# Gap Analysis – <FEATURE>
-
-> File ghi lại các **khoảng trống của tài liệu** mà `qa-analyst` phát hiện sau khi
-> phân tích. Là đầu vào để hỏi dev/BA và cho `qa-planner`. Mỗi gap có ID `GAP-xx`
-> để business rule (BR-xx), acceptance criteria (AC-xx) và test case trace ngược về.
-
-| Trường | Giá trị |
-|---|---|
-| Feature | `<FEATURE>` |
-| Project / Service | `<project or service name / domain>` |
-| Tài liệu nguồn | `<đường dẫn / link PRD / user story>` |
-| Người phân tích | qa-analyst |
-| Ngày phân tích | `<YYYY-MM-DD>` |
-| Tổng số gap | `<N>` (Blocker: x · High: y · Medium: z · Low: w) |
-| Trạng thái chung | 🔴 Blocked / 🟡 Cần làm rõ / 🟢 Đủ rõ để thiết kế TC |
-
----
-
-## Bảng Gap
-
-| ID | Loại | Mô tả gap | Vị trí (mục/nguồn) | Ảnh hưởng (chức năng / BR / AC) | Mức độ | Người trả lời | Trạng thái | Câu trả lời |
-|---|---|---|---|---|---|---|---|---|
-| GAP-01 | MISSING | … | spec §x | chức năng A / BR-02 | 🔴 Blocker | Dev/BA | Open | — |
-| GAP-02 | AMBIGUOUS | … | mockup màn hình Y | AC-03 | 🟠 High | BA | Open | — |
-| GAP-03 | CONTRADICTORY | … | §2 vs §5 | BR-04 | 🟠 High | BA | Open | — |
-| GAP-04 | ASSUMPTION | … (giả định AI tự đưa, cần xác nhận) | — | chức năng B | 🟡 Medium | Dev | Open | — |
-
-### Loại gap
-- **MISSING** – thông tin/chức năng/field/rule chưa được mô tả.
-- **AMBIGUOUS** – mô tả mơ hồ, có ≥ 2 cách hiểu.
-- **CONTRADICTORY** – các phần tài liệu mâu thuẫn nhau.
-- **ASSUMPTION** – giả định do qa-analyst tự suy ra, cần dev/BA xác nhận.
-- **OPEN QUESTION** – câu hỏi mở cần trả lời trước khi thiết kế/triển khai.
-
-### Mức độ
-🔴 Blocker (chặn thiết kế TC) · 🟠 High · 🟡 Medium · 🟢 Low
-
----
-
-## Quy ước cập nhật
-- `qa-analyst` tạo & điền gap khi phân tích; **không tự bịa câu trả lời** cho gap Blocker.
-- Khi có phản hồi dev/BA: điền cột *Câu trả lời*, đổi *Trạng thái* → `Answered`.
-- Còn gap 🔴 Blocker `Open` ⇒ **chưa** chuyển sang `qa-designer`; đẩy sang `qa-planner`
-  (skill `questions-for-dev`) để chốt câu hỏi.
-
----
-
-## ⚠️ Checklist bắt buộc trước khi lưu file
-
-Trước khi lưu `DOC_GAPS.md`, kiểm tra **từng hàng** trong bảng gap:
-
-- [ ] **9 cột đủ** – đúng thứ tự: `ID | Loại | Mô tả gap | Vị trí (mục/nguồn) | Ảnh hưởng (chức năng / BR / AC) | Mức độ | Người trả lời | Trạng thái | Câu trả lời`
-- [ ] **Cột Vị trí không rỗng** – phải có tham chiếu cụ thể đến mục trong tài liệu nguồn (vd `§3 UC4 BR25`, `Appendix B loại 7`, `§4.b Screen 3`). Đây là cột hay bị bỏ thiếu nhất → gây lệch toàn bộ cột sau.
-- [ ] **Cột Ảnh hưởng = BR/AC references** – KHÔNG phải mức độ severity. Ví dụ đúng: `BR25, BR26 / AC-F01-33`. Nếu thấy "Blocker" / "High" ở đây → đang bị lệch cột.
-- [ ] **Cột Mức độ có emoji** – bắt buộc dùng: `🔴 Blocker` / `🟠 High` / `🟡 Medium` / `🟢 Low`. Không được ghi text thuần.
-- [ ] **Cột Người trả lời = vai trò** (PO / BA / Dev / Design / Content / DPO / QC Lead). Nếu thấy "Open" ở đây → đang bị lệch cột.
-- [ ] **Cột Trạng thái = Open / Answered**. Nếu thấy "—" ở đây → đang bị lệch cột.

package/skills/qc/qa-analyst/acceptance-criteria.md

@@ -1,60 +0,0 @@
----
-version: 1.0
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
----
-
-# Acceptance Criteria — Sinh tiêu chí chấp nhận
-
-Chuyển yêu cầu đã phân tích thành acceptance criteria (Given/When/Then) làm cơ sở thiết kế TC.
-
-## Khi nào trigger
-- "viết acceptance criteria cho [X]" / "định nghĩa tiêu chí pass"
-- Sau spec-breakdown + business-rules, là bước cuối của qa-analyst
-- Cần điều kiện chấp nhận rõ ràng để qa-designer trace TC ngược về
-
-## Khi KHÔNG trigger
-- Cần bóc tách spec → dùng spec-breakdown
-- Cần thiết kế test case chi tiết (steps cụ thể) → dùng qa-designer
-- Cần phân tích rủi ro → dùng qa-planner
-
----
-
-## Phase 1 — Tổng hợp
-
-Gom đầu vào từ spec-breakdown, business-rules, data-flow:
-- Mỗi chức năng/luồng → một nhóm acceptance criteria.
-- Mỗi business rule (BR-xx) → ít nhất một AC kiểm chứng.
-
----
-
-## Phase 2 — Viết AC
-
-Dùng format Given/When/Then, mỗi AC kiểm chứng MỘT điều:
-
-```
-AC-01 (chức năng / BR-xx):
-  Given <tiền điều kiện>
-  When  <hành động + dữ liệu cụ thể>
-  Then  <kết quả mong đợi CỤ THỂ>
-```
-
-Bắt buộc phủ:
-- Happy path (điều kiện hợp lệ).
-- Negative (vi phạm validation / authorization).
-- Boundary (giá trị biên của giới hạn trong business-rules).
-- Alternate flow (luồng phụ trong data-flow).
-
-Mỗi AC gắn mã trace: chức năng + BR-xx để TC sau này map 1-1.
-
----
-
-## Output
-
-Ghi vào **mục Acceptance Criteria** của `{paths.qc_dir}/{UC-ID}/REQUIREMENT_ANALYSIS.md`
-(KHÔNG tạo file riêng — qc-analyze chỉ trả 2 file: `REQUIREMENT_ANALYSIS.md` + `DOC_GAPS.md`):
-
-- Danh sách AC dạng Given/When/Then, có mã trace về chức năng, business rule (BR-xx)
-  và scenario chính thức `{UC-ID}-SC{N}` của `.feature`.
-- Bảng ma trận: BR / chức năng × AC để xác nhận không bỏ sót.
-- Đây là đầu vào trực tiếp cho `qa-designer` (mỗi AC → ≥1 test case) và `qa-reviewer` (đối chiếu coverage).

package/skills/qc/qa-analyst/business-rules.md

@@ -1,59 +0,0 @@
----
-version: 1.0
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
----
-
-# Business Rules — Trích xuất luật nghiệp vụ
-
-Trích xuất và liệt kê toàn bộ business rule, điều kiện và ràng buộc từ yêu cầu.
-
-## Khi nào trigger
-- "liệt kê business rule cho [X]" / "feature này có luật nghiệp vụ gì"
-- Sau spec-breakdown, khi cần làm rõ logic điều kiện trước khi thiết kế TC
-- Feature có nhiều điều kiện AND/OR, phân quyền, tính toán, giới hạn
-
-## Khi KHÔNG trigger
-- Cần bóc tách tổng thể spec → dùng spec-breakdown
-- Cần luồng dữ liệu → dùng data-flow
-- Cần phân tích rủi ro / lập test plan → thuộc qa-planner (skill test-plan)
-
----
-
-## Phase 1 — Quét
-
-1. Đọc spec đã bóc tách (output của spec-breakdown) hoặc tài liệu gốc.
-2. Quét tìm: điều kiện ("nếu… thì…"), ràng buộc field, giới hạn (min/max, rate limit),
-   quy tắc phân quyền, công thức tính, quy tắc trạng thái, default value.
-
----
-
-## Phase 2 — Cấu trúc hoá
-
-Mỗi rule ghi dưới dạng bảng:
-
-| ID | Rule | Điều kiện | Kết quả | Nguồn | Ghi chú/Ưu tiên |
-|---|---|---|---|---|---|
-| BR-01 | … | … | … | spec §x | … |
-
-Phân loại rule:
-- VALIDATION: ràng buộc input (định dạng, bắt buộc, độ dài, range).
-- AUTHORIZATION: ai được làm gì.
-- CALCULATION: công thức, làm tròn, đơn vị.
-- STATE: điều kiện chuyển trạng thái hợp lệ vs cấm.
-- LIMIT: rate limit, quota, concurrent.
-
-Với rule có nhiều điều kiện kết hợp → gợi ý dựng **Decision Table** (đầu vào cho qa-designer).
-
----
-
-## Output
-
-Ghi vào **mục Business Rules** của `{paths.qc_dir}/{UC-ID}/REQUIREMENT_ANALYSIS.md`
-(KHÔNG tạo file riêng — qc-analyze chỉ trả 2 file: `REQUIREMENT_ANALYSIS.md` + `DOC_GAPS.md`):
-
-- Bảng business rule có ID (BR-xx) để TC trace ngược về.
-- Gợi ý các rule cần Decision Table / BVA khi sang qa-designer.
-
-Rule MÂU THUẪN / KHÔNG RÕ → ghi vào `{paths.qc_dir}/{UC-ID}/DOC_GAPS.md`
-(loại CONTRADICTORY / AMBIGUOUS, cột "Ảnh hưởng" trỏ BR-xx).

package/skills/qc/qa-analyst/data-flow.md

@@ -1,64 +0,0 @@
----
-version: 1.0
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
----
-
-# Data Flow — Phân tích luồng dữ liệu
-
-Phân tích luồng dữ liệu, input/output, state và điểm tích hợp của feature.
-
-## Khi nào trigger
-- "phân tích data flow cho [X]" / "dữ liệu đi qua đâu"
-- Feature có nhiều bước, qua nhiều màn hình/API/DB, hoặc tích hợp Kafka/service khác
-- Cần xác định điểm tích hợp trước khi thiết kế integration/e2e TC
-
-## Khi KHÔNG trigger
-- Chỉ cần bóc tách spec tổng quan → dùng spec-breakdown
-- Chỉ cần luật nghiệp vụ → dùng business-rules
-- Thiết kế integration TC → dùng qa-designer/integration
-
----
-
-## Phase 1 — Lập bản đồ
-
-Với mỗi luồng nghiệp vụ, xác định:
-1. ĐIỂM BẮT ĐẦU: actor/sự kiện kích hoạt + dữ liệu đầu vào.
-2. CÁC CHẶNG: UI → API → service → DB → message queue → service ngoài.
-3. BIẾN ĐỔI: dữ liệu được tạo/sửa/xoá/validate ở mỗi chặng.
-4. ĐIỂM KẾT THÚC: output, side-effect (email, notification, audit log).
-
----
-
-## Phase 2 — Mô tả
-
-Thể hiện luồng dạng bước tuần tự hoặc sơ đồ text:
-
-```
-[User submit form]
-   → POST /api/... (payload: ...)
-   → Service validate (rule BR-xx)
-   → DB insert bảng X
-   → Kafka topic Y (event Z)
-   → UI hiển thị kết quả / trạng thái
-```
-
-Đánh dấu cho mỗi chặng:
-- INTEGRATION POINT (nơi cần integration test).
-- STATE CHANGE (dữ liệu/trạng thái thay đổi → cần verify + cleanup).
-- FAILURE POINT (nơi có thể lỗi: timeout, validation fail, partial commit).
-
----
-
-## Output
-
-Ghi vào **mục Data Flow** của `{paths.qc_dir}/{UC-ID}/REQUIREMENT_ANALYSIS.md`
-(KHÔNG tạo file riêng — qc-analyze chỉ trả 2 file: `REQUIREMENT_ANALYSIS.md` + `DOC_GAPS.md`):
-
-- Sơ đồ/list luồng dữ liệu cho mỗi kịch bản chính.
-- Danh sách integration point + state change + failure point.
-- Gợi ý loại test cần cho từng điểm (gui-feature / integration / e2e) khi sang qa-designer.
-- Dữ liệu/trạng thái cần chuẩn bị & cleanup → đầu vào fixture cho qa-runner.
-
-Chặng nào luồng/hành vi chưa rõ (vd lỗi xử lý ra sao, retry, partial commit) →
-ghi vào `{paths.qc_dir}/{UC-ID}/DOC_GAPS.md` (loại MISSING / OPEN QUESTION).

package/skills/qc/qa-analyst/spec-breakdown.md

@@ -1,61 +0,0 @@
----
-version: 1.0
-updated: 2026-06-11
-ported_from: ai-automation-qc-base
----
-
-# Spec Breakdown — Bóc tách yêu cầu
-
-Bóc tách spec/PRD/user story thô thành mô tả yêu cầu có cấu trúc cho QC.
-
-## Khi nào trigger
-- "phân tích spec/PRD cho feature [X]" / "bóc tách yêu cầu"
-- Nhận tài liệu thô (PRD, user story, mô tả Figma, email) cần làm rõ trước khi thiết kế TC
-- Là bước ĐẦU TIÊN của pipeline, trước qa-planner
-
-## Khi KHÔNG trigger
-- Cần phân tích rủi ro / what-if → dùng qa-planner
-- Cần trích riêng business rule → dùng business-rules
-- Cần thiết kế test case → dùng qa-designer
-
----
-
-## Phase 1 — Thu thập
-
-1. Đọc toàn bộ tài liệu nguồn QC cung cấp (PRD, user story, mockup, ghi chú).
-2. **Bỏ qua văn bản gạch ngang (strikethrough)** — đó là nội dung đã huỷ, KHÔNG đưa
-   vào phân tích/BR/AC. Với file Confluence/HTML/MHTML: phát hiện qua thẻ `<s>`,
-   `<strike>`, `<del>` hoặc style `text-decoration: line-through`.
-3. Xác định: feature name, actor/role, mục tiêu nghiệp vụ, phạm vi (in/out scope).
-4. Đánh dấu phần MƠ HỒ / THIẾU → ghi vào `DOC_GAPS.md` (gap GAP-xx).
-
----
-
-## Phase 2 — Bóc tách
-
-Tách yêu cầu thành các khối:
-
-A. TỔNG QUAN: mục tiêu, actor, giá trị nghiệp vụ.
-B. CHỨC NĂNG: list từng chức năng (visible + ẩn + integration point).
-C. INPUT/OUTPUT: mỗi chức năng có input gì, output gì, ràng buộc field.
-D. TRẠNG THÁI & LUỒNG: các state, điều kiện chuyển, happy path + alternate flow.
-E. PHỤ THUỘC: hệ thống/API/module liên quan.
-F. GIẢ ĐỊNH & CÂU HỎI MỞ: điều suy ra được vs điều cần dev/BA xác nhận.
-
----
-
-## Output
-
-⚠️ `/qc-analyze` chỉ ghi **ĐÚNG 2 FILE** cho mỗi UC, đặt trong thư mục QC **lộ ra ngoài**
-`{paths.qc_dir}/{UC-ID}/` (mặc định `docs/{UC-ID}/` — KHÔNG để trong `.agent/` ẩn):
-`REQUIREMENT_ANALYSIS.md` + `DOC_GAPS.md`. KHÔNG tách mỗi bước phân tích thành file riêng.
-
-Phần spec-breakdown là **mục đầu tiên** của `REQUIREMENT_ANALYSIS.md`:
-- Bảng chức năng + input/output/constraint
-- Sơ đồ/list luồng chính & phụ
-- Danh sách giả định và câu hỏi mở (đánh dấu rõ điều CHƯA chắc)
-
-Đồng thời ghi mọi khoảng trống phát hiện vào `{paths.qc_dir}/{UC-ID}/DOC_GAPS.md`
-(theo `{paths.qc_skills_dir}/qa-analyst/DOC_GAPS.template.md`), mỗi gap có ID `GAP-xx`.
-
-Kết thúc bằng gợi ý: feature đã đủ rõ để chuyển sang `qa-planner` (phân tích rủi ro) chưa.