Khi nào dùng skill nào

Định hình cả sản phẩm: tầm nhìn, người dùng, giá trị, rồi bóc ra Feature Map.

Cần

Ý tưởng sản phẩm

Ra

docs/_product/prd.md

Xếp ưu tiên Feature Map thành Now / Next / Later hoặc chia theo quý.

Cần

/prd

Ra

docs/_product/roadmap.md

Một feature còn phân vân: điều tra nhu cầu + đối thủ rồi khuyến nghị build / skip.

Cần

Feature Map (khuyến khích)

Ra

docs/_research/{date}-{slug}.md

Có ý tưởng thô cho một feature, cần phỏng vấn làm rõ trước khi viết tài liệu.

Cần

Một câu mô tả ý tưởng

Ra

docs/{feature}/brainstorms/{idea}.md

Có transcript hoặc ghi chú họp, cần biến thành biên bản có decision / action / RAID.

Cần

Transcript hoặc note thô

Ra

docs/meetings/{date}-{type}-{slug}.md

Ghi rõ người dùng là ai, cần gì, hành trình ra sao, thế nào là thành công.

Cần

/brainstorm

Ra

docs/{feature}/{feature}-urd.md

Ghi lý do kinh doanh, mục tiêu SMART, ROI, stakeholder, rủi ro.

Cần

/brainstorm hoặc /urd

Ra

docs/{feature}/{feature}-brd.md

Chốt phạm vi một feature: capability P0/P1/P2, luồng chính, kế hoạch release.

Cần

/urd hoặc /brd

Ra

docs/{feature}/{feature}-prd.md

Tài liệu lõi. Kỹ thuật hoá scope thành FR / NFR / Business Rule / bảng mã lỗi.

Cần

/prd-epic (mềm)

Ra

docs/{feature}/srs/{feature}-spec.md

Quản lý 6 tài liệu dùng chung cấp dự án: thuật ngữ, quy ước, môi trường, bối cảnh.

Cần

Có ít nhất một feature

Ra

docs/_shared/

Vẽ trình tự trao đổi giữa các hệ thống trong một luồng (login, checkout, webhook).

Cần

/srs

Ra

docs/{feature}/srs/{feature}-flows.md

Vẽ luồng xử lý có nhiều nhánh quyết định, bằng Mermaid nhúng thẳng vào file.

Cần

/srs

Ra

docs/{feature}/srs/{feature}-flows.md

Quy trình đa vai trò cần lane thẳng cột thật — PlantUML, không phải subgraph giả.

Cần

/srs hoặc /usecase

Ra

docs/{feature}/srs/{feature}-{slug}-swimlane.puml

Cần BPMN 2.0 chuẩn OMG để import Camunda / Bizagi (approval, onboarding, refund).

Cần

/usecase hoặc /srs

Ra

docs/{feature}/bpmn/{process}.bpmn

Một đối tượng có nhiều trạng thái và chuyển đổi (Account, Order, Subscription).

Cần

/srs

Ra

docs/{feature}/srs/{feature}-states.md

Mô hình dữ liệu nghiệp vụ, Mermaid nhúng inline. Bản gốc của họ ERD.

Cần

/srs

Ra

docs/{feature}/srs/{feature}-erd.md

Cùng ERD nhưng vẽ đẹp bằng D2, file ảnh riêng để đưa vào slide.

Cần

/erd

Ra

docs/{feature}/d2-erd/{feature}.d2

Activity nhiều nhánh mà Mermaid dàn xấu — D2 layout ELK gọn hơn.

Cần

/srs

Ra

docs/{feature}/d2/{slug}.d2

Sơ đồ kiến trúc hệ thống: component, service, DB lồng nhau.

Cần

/srs

Ra

docs/{feature}/d2-architect/{slug}.d2

Tầng gần dev nhất: schema DBML với kiểu DB thật, enum, index.

Cần

/erd

Ra

docs/{feature}/dbdiagram/{feature}.dbml

Sơ đồ tổng quan actor và use case để chốt phạm vi bằng hình.

Cần

/usecase

Ra

docs/{feature}/usecases/{feature}-usecase-diagram.svg

Chạy đầu tiên trong nhóm màn hình. Chia feature thành các flow, phủ happy / error / edge.

Cần

/srs

Ra

docs/{feature}/srs/{feature}-userflow.md

Phác màn bằng ký tự, gộp theo flow, kèm bảng mô tả 5 cột dùng chung.

Cần

/user-flow

Ra

docs/{feature}/ascii-wireframe/{flow}.md

Cùng màn đó nhưng render element HTML thật, đen trắng, mở bằng trình duyệt.

Cần

/user-flow

Ra

docs/{feature}/html-wireframe/{flow}.html

Vẽ thật lên Figma qua MCP, tuân design token. Cần cài Reqwise Figma MCP.

Cần

/wireframe-ascii

Ra

File trên Figma

Bậc cao nhất: một file HTML bấm được như app thật, giữ state, có lớp góp ý.

Cần

/user-flow + /wireframe-ascii

Ra

docs/{feature}/html-design/{feature}-prototype.html

Prototype chạy được bằng Next.js, sinh code thật, tự build và smoke test.

Cần

/user-flow + /usecase

Ra

prototype/

Viết use case chuẩn Cockburn: actor, tiền đề, luồng chính, nhánh mở rộng.

Cần

/srs (hoặc chạy chế độ khám phá)

Ra

docs/{feature}/usecases/uc-{slug}.md

Bóc FR / use case / màn hình thành user story đưa vào backlog.

Cần

/srs

Ra

docs/{feature}/userstories/us-{NNN}.md

Viết, sửa hoặc soi lại Acceptance Criteria dạng Given / When / Then.

Cần

/userstory

Ra

Ghi thẳng vào us-{NNN}.md

Đồng bộ hai chiều backlog với Jira Cloud. Không cờ = chỉ xem drift, an toàn.

Cần

/userstory + Atlassian MCP

Ra

Jira + docs/_shared/jira-map.md

Đồng bộ hai chiều tài liệu với Confluence Cloud.

Cần

Tài liệu + Atlassian MCP

Ra

Confluence page

Đóng gói tài liệu một feature gửi stakeholder: PDF, DOCX hoặc HTML.

Cần

Tài liệu đã duyệt

Ra

docs/exports/{date}-{slug}-package.pdf

Viết cẩm nang vận hành cho admin / CSKH, có thể tự chụp ảnh màn hình thật.

Cần

Tài liệu feature

Ra

docs/userguide/{feature}-userguide.html

Gộp mọi file Markdown của một feature thành một trang HTML xem được.

Cần

Có tài liệu

Ra

docs/{feature}/{feature}-preview.html

Chưa chốt đối tác, hoặc còn cân nhắc tự làm hay mua. Scorecard rồi khuyến nghị.

Cần

Nhu cầu tích hợp

Ra

docs/{feature}/integration/api-assess.md

Đọc hiểu tài liệu API đối tác (OpenAPI / PDF / URL) thành doc nghiệp vụ.

Cần

Tài liệu API của đối tác

Ra

docs/{feature}/integration/api-summary.md

Bước quan trọng nhất họ API: thiết kế cách các hệ thống phối hợp, retry, đối soát.

Cần

/api-doc + /srs

Ra

docs/{feature}/integration/api-design.md

Bảng ánh xạ field ba tầng: API ↔ entity hệ thống ↔ field trên UI.

Cần

/api-design

Ra

docs/{feature}/integration/api-map.md

Phỏng vấn discovery để ra outline kịch bản cần test, chưa cần data chi tiết.

Cần

/api-design

Ra

docs/{feature}/test/api/api-checklist.md

Biến checklist thành file .bru chạy được bằng Bruno. Secret chỉ nằm trong .env.

Cần

/api-checklist

Ra

docs/{feature}/test/api/bruno/

Cổng go-live: cutover, feature flag, monitoring, rollback, bảng go / no-go.

Cần

/api-test

Ra

docs/{feature}/integration/api-readiness.md

Outline kịch bản cần test để review trước, chưa viết test case đầy đủ.

Cần

/srs + /userstory

Ra

docs/{feature}/test/checklist/

Sinh test case chi tiết 1:1 từ checklist. Bắt buộc có checklist trước.

Cần

/test-checklist

Ra

docs/{feature}/test/testcases/

Codegen script Playwright .spec.ts chạy được từ test case UI.

Cần

/test-cases

Ra

docs/{feature}/test/e2e/

Soi feature còn thiếu luồng nghiệp vụ gì: vào được trạng thái mà không ra được.

Cần

Tài liệu feature

Ra

docs/_shared/traceability.md

Hỏi thẳng nghiệp vụ này đang chạy thế nào. Trả lời ngay trong chat, không ghi file.

Cần

Tài liệu feature

Ra

Không ghi file

Code dev có khớp tài liệu BA không. Ra một báo cáo, không tự sửa gì.

Cần

Tài liệu + đường dẫn source code

Ra

docs/reports/doc-drift/

Sửa một thay đổi vào tài liệu đã có: phân tích tác động rồi mới áp dụng.

Cần

Tài liệu đã duyệt

Ra

docs/cr/CR-{id}.md

Xem toàn cảnh workspace: kanban, coverage, funnel, tài liệu quá hạn.

Cần

Có tài liệu

Ra

docs/_shared/dashboard.html

Dựng bản đồ liên hệ giữa mọi thứ trong tài liệu. Hạ tầng cho /gap, /cr, /dashboard.

Cần

Có tài liệu

Ra

docs/_shared/kg/graph.json

San tải quota sang CLI AI khác (Codex, Gemini). Không đụng vào tài liệu.

Cần

—

Ra

Không ghi file

Dựng lại bộ SRS từ đống tài liệu rời rạc: docx, pdf, xlsx, ảnh chụp màn hình.

Cần

Tài liệu nguồn

Ra

docs/_reverse/{feature}/

Dựng lại bộ SRS từ chính source code. Cái code khẳng định thì gắn nhãn chắc.

Cần

Đường dẫn repo

Ra

docs/_reverse/{feature}/

Xem bộ SRS vừa dựng lại, giữ nguyên nhãn độ tin cậy và phần Gap / Open Question.

Cần

/reverse-doc hoặc /code-to-srs

Ra

docs/_reverse/{feature}/{feature}-reverse-preview.html

Skill nền, không gọi bằng lệnh. Map codebase lạ rồi gom thành feature nghiệp vụ.

Cần

Được /code-to-srs nạp

Ra

—

Skill nền. Recipe bóc route / model / guard theo từng stack: Next, Nest, Django, Spring…

Cần

Được /code-to-srs nạp

Ra

—