@ngocsangairvds/vsaf 3.1.0 → 3.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,4 +1,4 @@
1
1
  ---
2
2
  name: graphify
3
- description: DEPRECATED — skill đã bị loại bỏ khỏi dự án. Không sử dụng.
3
+ description: DEPRECATED — skill has been removed from the project. Do not use.
4
4
  ---
@@ -1,86 +1,116 @@
1
1
  ---
2
2
  name: vsaf-build
3
- description: Implement code theo SRS + testcase đã có. Dùng sau /vsaf-doc-srs /vsaf-test.
3
+ description: Implement code following existing PRD + SRS + testcases. Use after /vsaf-doc-srs and /vsaf-test. Brainstorm before plan, TDD with verification after each task.
4
4
  ---
5
5
 
6
6
  # VSAF Build
7
7
 
8
- ## Mục tiêu
9
- Implement code đúng theo SRS testcase, từng task một, với TDD — đảm bảo mỗi commit tests pass.
8
+ ## Objective
9
+ Implement code strictly following PRD, SRS, and testcases, one task at a time, with TDD — ensuring each commit has tests passing AND is verified against spec.
10
10
 
11
- ## Điều kiện tiên quyết
12
- - Đã chạy `/vsaf-doc-srs` SRS được approve
13
- - Đã chạy `/vsaf-test` testcase docs (implementation readiness = PASS)
14
- - User đã xác nhận phạm vi implement
11
+ ## Prerequisites
12
+ - Have run `/vsaf-doc-prd` and have an approved PRD
13
+ - Have run `/vsaf-doc-srs` and have an approved SRS
14
+ - Have run `/vsaf-test` and have testcase docs (implementation readiness = PASS)
15
+ - User has confirmed the implementation scope
15
16
 
16
- ## Các bước thực hiện
17
+ ## Execution Steps
17
18
 
18
- ### Bước 0 — Kiểm tra Superpowers (bắt buộc kiểm tra)
19
- - Kiểm tra xem Superpowers plugin đã được cài trong Claude Code chưa
20
- - Nếu **chưa cài** → hiển thị:
19
+ ### Step 0 — Check Superpowers (mandatory check)
20
+ - Check whether the Superpowers plugin is installed in Claude Code
21
+ - If **not installed** → display:
21
22
  ```
22
- ⚠️ Superpowers chưa được cài đặt.
23
- Superpowers giúp tăng chất lượng implement (TDD execution, plan execution, debugging, code review).
24
- Để cài, chạy trong Claude Code:
23
+ ⚠️ Superpowers is not installed.
24
+ Superpowers improves implementation quality (TDD execution, plan execution, debugging, code review).
25
+ To install, run in Claude Code:
25
26
  /plugin install superpowers@claude-plugins-official
26
- Sau đó restart Claude Code.
27
+ Then restart Claude Code.
27
28
 
28
- Tiếp tục build không Superpowers (fallback mode).
29
+ Continuing build without Superpowers (fallback mode).
29
30
  ```
30
- - Nếu **đã cài** → ghi nhận `HAS_SUPERPOWERS = true`, hiển thị:
31
+ - If **installed**record `HAS_SUPERPOWERS = true`, display:
31
32
  ```
32
- ✓ Superpowers available — sẽ sử dụng: execute-plan, test-driven-development, code-review
33
+ ✓ Superpowers available — will use: brainstorming, writing-plans, executing-plans, test-driven-development, verification-before-completion
33
34
  ```
34
35
 
35
- ### Bước 1 — Đọc SRS + testcase
36
- - Đọc file SRS trong `docs/project/srs/`
37
- - Đọc file testcase trong `docs/project/testcases/`
38
- - Xác nhận mapping FR/NFR -> testcase trước khi bắt đầu
39
-
40
- ### Bước 2 Sinh plan từ SRS (có/không Superpowers)
41
- - **Nếu HAS_SUPERPOWERS**: dùng `superpowers:write-plan` để sinh atomic task list từ SRS + testcase
42
- - **Nếu không**: tự tạo task list thủ công từ FR/NFR → testcase mapping
43
- - Mỗi task phải verification step rõ ràng
44
-
45
- ### Bước 3 Implement từng task (TDD)
46
- - **Nếu HAS_SUPERPOWERS**: dùng `superpowers:execute-plan` tự động chạy TDD cycles (RED → GREEN → REFACTOR) theo plan
47
- - Superpowers sẽ gọi `superpowers:test-driven-development` cho mỗi task
48
- - Nếu plan lớn (20+ tasks): dùng `superpowers:subagent-driven-development` để dispatch song song
49
- - **Nếu không**: implement thủ công theo TDD:
50
- 1. **RED**: Viết test trước, chạy test → phải fail
51
- 2. **GREEN**: Viết code tối thiểu để test pass
52
- 3. **REFACTOR**: Clean up code, giữ test vẫn pass
53
- - Sau mỗi task: chạy `mcp__gitnexus__detect_changes` để verify chỉ đúng files thay đổi
54
- - Commit: `git commit -m "<type>: <task description>"`
55
-
56
- ### Bước 3.5 Checkpoint review (mỗi 3-5 tasks)
57
- - Sau mỗi 3-5 tasks hoàn thành: dùng skill `bmad-checkpoint-preview`
58
- - Mục đích: human-in-the-loop review — "walk me through changes so far"
59
- - Checkpoint sẽ:
60
- - Tóm tắt: đã làm gì, files nào thay đổi, tests status
61
- - Highlight: điểm cần chú ý, potential issues
62
- - Hỏi user: tiếp tục / điều chỉnh / dừng?
63
- - **Bỏ qua checkpoint nếu**: plan < 5 tasks tổng (chỉ checkpoint cuối)
64
-
65
- ### Bước 4Xử khi fail hoặc scope drift
66
- - **Nếu HAS_SUPERPOWERS**: dùng `superpowers:systematic-debugging` — bắt buộc hypothesis experiment conclusion
67
- - **Nếu không**: thử approach khác thủ công
68
- - Fail 3 lần cùng 1 task: DỪNG, báo user, quay lại `/vsaf-plan`
69
- - **Nếu phát hiện scope drift** (feature cần thay đổi lớn so với SRS):
70
- - Dùng skill `bmad-correct-course` để đánh giá impact + đề xuất điều chỉnh
71
- - DỪNG trình bày cho user: tiếp tục với điều chỉnh / quay lại `/vsaf-plan` re-plan
72
-
73
- ### Bước 5 Output sau mỗi task
36
+ ### Step 1 — Read PRD + SRS + testcase (mandatory — must read all 3 fully)
37
+ - Read the PRD file in `docs/project/planning-artifacts/` — understand WHY and WHAT
38
+ - Read the SRS file in `docs/project/srs/` — understand HOW, FRs/NFRs
39
+ - Read the testcase file in `docs/project/testcases/` understand acceptance criteria
40
+ - Confirm FR/NFR → testcase mapping before starting
41
+ - If a gap is found (FR/NFR without testcase, or testcase contradicts SRS): NOTIFY USER before continuing
42
+ - **Do NOT start coding without having read all 3 documents**
43
+
44
+ ### Step 1b Brainstorm implementation approaches (mandatory)
45
+ - **If HAS_SUPERPOWERS**: use `superpowers:brainstorming` — structured exploration:
46
+ - Brainstorm 2-3 implementation approaches
47
+ - Evaluate trade-offs, risks, constraints for each approach
48
+ - Choose the best approach before committing to a plan
49
+ - **If not**: brainstorm manually list at least 2 approaches, choose 1 with clear reasoning
50
+ - **Do NOT jump straight into planning without brainstorming**
51
+
52
+ ### Step 2 Generate plan from SRS (with/without Superpowers)
53
+ - **If HAS_SUPERPOWERS**: use `superpowers:writing-plans` to generate an atomic task list from SRS + testcase
54
+ - **If not**: manually create a task list from FR/NFR testcase mapping
55
+ - Each task must:
56
+ - Map to ≥1 FR/NFR
57
+ - Have a clear verification step
58
+ - Be small enough for 1 commit
59
+
60
+ ### Step 2b — Subagent dispatch (large plans, optional)
61
+ - If plan has 20 tasks AND HAS_SUPERPOWERS: use `superpowers:subagent-driven-development`
62
+ - Dispatch tasks to sub-agents with a two-phase review pipeline
63
+ - Each sub-agent still runs its own TDD cycle (RED → GREEN → REFACTOR)
64
+ - Review phase ensures consistent output
65
+
66
+ ### Step 3Implement each task (TDD + Verification)
67
+ - **If HAS_SUPERPOWERS**: use `superpowers:executing-plans` — automatically runs TDD cycles following the plan
68
+ - Superpowers will call `superpowers:test-driven-development` for each task
69
+ - **If not**: implement manually following TDD:
70
+ 1. **RED**: Write test first, run test must fail
71
+ 2. **GREEN**: Write minimal code to make the test pass
72
+ 3. **REFACTOR**: Clean up code, keep tests passing
73
+
74
+ - After each task, run sequentially:
75
+ 1. `mcp__gitnexus__detect_changes` — verify only the expected files changed
76
+ 2. **Verification against spec** (mandatory):
77
+ - **If HAS_SUPERPOWERS**: use `superpowers:verification-before-completion` — confirm outcome matches SRS intent, not just "tests pass"
78
+ - **If not**: self-verify: re-read the corresponding FR/NFR in SRS, confirm behavior is correct, record verification result
79
+ 3. Commit: `git commit -m "<type>: <task description>"`
80
+
81
+ ### Step 3.5 — Checkpoint review (every 3-5 tasks)
82
+ - After every 3-5 completed tasks: use skill `bmad-checkpoint-preview`
83
+ - Purpose: human-in-the-loop review — "walk me through changes so far"
84
+ - Checkpoint will:
85
+ - Summarize: what was done, which files changed, tests status
86
+ - Highlight: points of concern, potential issues
87
+ - Ask user: continue / adjust / stop?
88
+ - **Skip checkpoint if**: plan has < 5 tasks total (only checkpoint at the end)
89
+
90
+ ### Step 4 — Handling failures or scope drift
91
+ - **If HAS_SUPERPOWERS**: use `superpowers:systematic-debugging` — mandatory hypothesis → experiment → conclusion
92
+ - **If not**: try a different approach manually
93
+ - Fail 3 times on the same task: **STOP** — this is an architecture problem, not an execution one. Re-read SRS + testcase, redesign the task. If still failing: go back to `/vsaf-plan`
94
+ - **If scope drift is detected** (feature requires major changes compared to SRS):
95
+ - Use skill `bmad-correct-course` to assess impact + propose adjustments
96
+ - If requirements have changed → STOP, update SRS first (`/vsaf-doc-srs` EDIT mode), re-run `/vsaf-test`
97
+ - STOP and present to user: continue with adjustments / go back to `/vsaf-plan` to re-plan
98
+
99
+ ### Step 5 — Output after each task
74
100
  ```
75
- ✓ Task [N]: [tên task]
76
- - Files changed: [danh sách]
101
+ ✓ Task [N]: [task name]
102
+ - FR/NFR: [mapped requirement IDs]
103
+ - Files changed: [list]
77
104
  - Tests: [X passed]
105
+ - Verification: [PASS — outcome matches SRS intent / FAIL — details]
78
106
  - Commit: [hash]
79
- - Superpowers: [used/not available]
107
+ - Superpowers: [brainstorming ✓ / writing-plans ✓ / executing-plans ✓ / verification ✓]
80
108
  - Checkpoint: [due at task N+X / completed]
81
109
  ```
82
110
 
83
- ## Lưu ý
84
- - 1 commit = 1 task, không gộp nhiều tasks vào 1 commit
85
- - Không sửa file ngoài scope của task hiện tại
86
- - Sau khi hoàn thành tất cả tasks: chạy `/vsaf-ship`
111
+ ## Notes
112
+ - 1 commit = 1 task, do not bundle multiple tasks into 1 commit
113
+ - Do not modify files outside the scope of the current task
114
+ - Brainstorm is mandatory before planning do not skip
115
+ - Verification is mandatory after each task — do not skip
116
+ - After completing all tasks: run `/vsaf-test run` then `/vsaf-ship`
@@ -1,70 +1,70 @@
1
1
  ---
2
2
  name: vsaf-discover
3
- description: Product discovery — nghiên cứu domain, market, feasibility trước khi plan feature. Dùng khi bắt đầu dự án mới hoặc explore hướng phát triển sản phẩm.
3
+ description: Product discovery — research domain, market, feasibility before planning a feature. Use when starting a new project or exploring product development directions.
4
4
  ---
5
5
 
6
6
  # VSAF Discover
7
7
 
8
- ## Mục tiêu
9
- Hiểu domain, market, user needs, technical feasibility trước khi commit vào bất kỳ feature nào. Đảm bảo build đúng thứ.
8
+ ## Objective
9
+ Thoroughly understand the domain, market, user needs, and technical feasibility before committing to any feature. Ensure we build the right thing.
10
10
 
11
11
  ## Input
12
- `$ARGUMENTS` — tả product/domain cần khám phá ( dụ: "nền tảng quản đơn hàng cho SME")
12
+ `$ARGUMENTS` — description of the product/domain to explore (e.g.: "order management platform for SMEs")
13
13
 
14
- ## Khi nào dùng
15
- - Bắt đầu dự án mới (chưa PRD/SRS)
16
- - Explore hướng phát triển sản phẩm mới
17
- - Trước khi chạy `/vsaf-plan` cho feature lớn chưa hiểu domain
14
+ ## When to Use
15
+ - Starting a new project (no PRD/SRS yet)
16
+ - Exploring new product development directions
17
+ - Before running `/vsaf-plan` for a large feature where the domain is not well understood
18
18
 
19
- ## Các bước thực hiện
19
+ ## Execution Steps
20
20
 
21
- ### Bước 1 — Domain Research
22
- - Dùng skill `bmad-domain-research` để deep dive domain/industry
21
+ ### Step 1 — Domain Research
22
+ - Use skill `bmad-domain-research` to deep dive into the domain/industry
23
23
  - Output: terminology, business rules, regulatory constraints, domain patterns
24
- - Lưu vào `docs/project/planning-artifacts/domain-research-[topic].md`
24
+ - Save to `docs/project/planning-artifacts/domain-research-[topic].md`
25
25
 
26
- ### Bước 2 — Market Research
27
- - Dùng skill `bmad-market-research` để phân tích:
28
- - Competition landscape: ai đang làm gì, strengths/weaknesses
26
+ ### Step 2 — Market Research
27
+ - Use skill `bmad-market-research` to analyze:
28
+ - Competition landscape: who is doing what, strengths/weaknesses
29
29
  - Customer needs: pain points, underserved segments
30
- - Market trends: hướng đi nào đang tăng trưởng
31
- - Lưu vào `docs/project/planning-artifacts/market-research-[topic].md`
30
+ - Market trends: which directions are growing
31
+ - Save to `docs/project/planning-artifacts/market-research-[topic].md`
32
32
 
33
- ### Bước 3 — Technical Feasibility
34
- - Dùng skill `bmad-technical-research` để đánh giá:
33
+ ### Step 3 — Technical Feasibility
34
+ - Use skill `bmad-technical-research` to assess:
35
35
  - Tech stack options + trade-offs
36
36
  - Integration constraints
37
37
  - Performance/scale requirements
38
38
  - Build vs buy decisions
39
- - Lưu vào `docs/project/planning-artifacts/tech-research-[topic].md`
40
-
41
- ### Bước 4 — Product Brief
42
- - Dùng skill `bmad-product-brief` để tổng hợp findings thành product brief
43
- - Product brief = bản tóm tắt: vấn đề gì, cho ai, giải pháp gì, tại sao bây giờ
44
- - Lưu vào `docs/project/planning-artifacts/product-brief-[name].md`
45
-
46
- ### Bước 5 — PRFAQ Challenge (Working Backwards)
47
- - Dùng skill `bmad-prfaq` để stress-test product concept
48
- - Viết press release giả lập: nếu product thành công, bài báo sẽ nói gì?
49
- - Viết FAQ: internal FAQ (team hỏi ) + external FAQ (customer hỏi )
50
- - Mục đích: phát hiện concept yếu **trước khi** đầu thời gian code
51
-
52
- ### Bước 6 — Tạo PRD (Product Requirements Document)
53
- - Dùng skill `bmad-agent-pm` (John) để dẫn dắt quá trình tạo PRD
54
- - John sẽ gọi skill `bmad-create-prd` để sinh PRD chuẩn từ product brief
55
- - PRD bao gồm: vision, goals, FRs, NFRs, epics, user stories, success metrics
56
- - Sau khi tạo xong: dùng skill `bmad-validate-prd` để validate PRD đạt chuẩn
57
- - Nếu validate FAIL: John sẽ dùng `bmad-edit-prd` để fix issues ngay
58
- - Lưu vào `docs/project/planning-artifacts/prd-[name].md`
59
-
60
- ### Bước 7 — Multi-agent Review (Party Mode)
61
- - Dùng skill `bmad-party-mode` để tổ chức roundtable:
62
- - PM (John) trình bày PRD
63
- - Analyst (Mary) challenge requirements
64
- - Architect (Winston) challenge feasibility
65
- - Ghi nhận consensus open questions
66
-
67
- ### Bước 8 — Output cho user
39
+ - Save to `docs/project/planning-artifacts/tech-research-[topic].md`
40
+
41
+ ### Step 4 — Product Brief
42
+ - Use skill `bmad-product-brief` to synthesize findings into a product brief
43
+ - Product brief = summary of: what problem, for whom, what solution, why now
44
+ - Save to `docs/project/planning-artifacts/product-brief-[name].md`
45
+
46
+ ### Step 5 — PRFAQ Challenge (Working Backwards)
47
+ - Use skill `bmad-prfaq` to stress-test the product concept
48
+ - Write a simulated press release: if the product succeeds, what would the article say?
49
+ - Write FAQ: internal FAQ (what the team would ask) + external FAQ (what customers would ask)
50
+ - Purpose: discover weak concepts **before** investing time in code
51
+
52
+ ### Step 6 — Create PRD (Product Requirements Document)
53
+ - Use skill `bmad-agent-pm` (John) to lead the PRD creation process
54
+ - John will call skill `bmad-create-prd` to generate a standard PRD from the product brief
55
+ - PRD includes: vision, goals, FRs, NFRs, epics, user stories, success metrics
56
+ - After creation: use skill `bmad-validate-prd` to validate the PRD meets standards
57
+ - If validation FAILs: John will use `bmad-edit-prd` to fix issues immediately
58
+ - Save to `docs/project/planning-artifacts/prd-[name].md`
59
+
60
+ ### Step 7 — Multi-agent Review (Party Mode)
61
+ - Use skill `bmad-party-mode` to organize a roundtable:
62
+ - PM (John) presents the PRD
63
+ - Analyst (Mary) challenges requirements
64
+ - Architect (Winston) challenges feasibility
65
+ - Record consensus and open questions
66
+
67
+ ### Step 8 — Output to user
68
68
  ```
69
69
  ## Discovery Complete: [product/domain]
70
70
 
@@ -76,17 +76,17 @@ Hiểu rõ domain, market, user needs, và technical feasibility trước khi co
76
76
  - PRD: docs/project/planning-artifacts/prd-[name].md
77
77
 
78
78
  ### Key findings
79
- - [3-5 bullet points tóm tắt]
79
+ - [3-5 bullet point summary]
80
80
 
81
81
  ### Open questions
82
- - [Những cần validate thêm]
82
+ - [Items that need further validation]
83
83
 
84
84
  ### Recommended next steps
85
- - Chạy /vsaf-sprint để break PRD thành epics + stories
86
- - Hoặc: chạy /vsaf-plan <first-feature> để bắt đầu feature đầu tiên
85
+ - Run /vsaf-sprint to break PRD into epics + stories
86
+ - Or: run /vsaf-plan <first-feature> to start the first feature
87
87
  ```
88
88
 
89
- ## Lưu ý
90
- - Flow này **không sinh code** — chỉ research + document
91
- - Nếu domain quá rộng: đề nghị focus vào 1 vertical/segment trước
92
- - Commit docs sau mỗi bước: `git commit -m "docs: discovery [topic]"`
89
+ ## Notes
90
+ - This flow **does not generate code** — research + documentation only
91
+ - If the domain is too broad: suggest focusing on 1 vertical/segment first
92
+ - Commit docs after each step: `git commit -m "docs: discovery [topic]"`
@@ -1,22 +1,22 @@
1
1
  ---
2
2
  name: vsaf-doc
3
- description: DEPRECATED — Đã được tách thành 2 lệnh riêng. Dùng /vsaf-doc-prd để viết PRD, sau đó /vsaf-doc-srs để viết SRS.
3
+ description: DEPRECATED — Has been split into 2 separate commands. Use /vsaf-doc-prd to write the PRD, then /vsaf-doc-srs to write the SRS.
4
4
  ---
5
5
 
6
6
  # VSAF Doc — DEPRECATED
7
7
 
8
- Skill này đã được tách thành 2 lệnh riêng biệt:
8
+ This skill has been split into 2 separate commands:
9
9
 
10
- 1. `/vsaf-doc-prd` — Viết PRD (Product Requirements Document) từ kết quả `/vsaf-plan`
11
- 2. `/vsaf-doc-srs` — Viết SRS (Software Requirements Specification) từ PRD đã
10
+ 1. `/vsaf-doc-prd` — Write PRD (Product Requirements Document) from `/vsaf-plan` output
11
+ 2. `/vsaf-doc-srs` — Write SRS (Software Requirements Specification) from the existing PRD
12
12
 
13
- ## Quy trình mới
13
+ ## New Workflow
14
14
 
15
15
  ```
16
16
  /vsaf-plan <requirement> # scope + impact + approach
17
- /vsaf-doc-prd # viết PRD từ approved scope
18
- /vsaf-doc-srs # viết SRS từ PRD
19
- /vsaf-test <path/to/srs> # sinh testcase từ SRS
17
+ /vsaf-doc-prd # write PRD from approved scope
18
+ /vsaf-doc-srs # write SRS from PRD
19
+ /vsaf-test <path/to/srs> # generate testcases from SRS
20
20
  ```
21
21
 
22
- Vui lòng dùng `/vsaf-doc-prd` hoặc `/vsaf-doc-srs` thay cho skill này.
22
+ Please use `/vsaf-doc-prd` or `/vsaf-doc-srs` instead of this skill.
@@ -1,57 +1,57 @@
1
1
  ---
2
2
  name: vsaf-doc-prd
3
- description: Viết tài liệu PRD (Product Requirements Document) từ kết quả /vsaf-plan. Dùng sau /vsaf-plan khi đã có scope approach ràng.
3
+ description: Write PRD (Product Requirements Document) from /vsaf-plan output. Use after /vsaf-plan when scope and approach are clear.
4
4
  ---
5
5
 
6
6
  # VSAF Doc PRD
7
7
 
8
- ## Mục tiêu
9
- Chuyển kết quả plan thành PRD chính thức: vision, goals, FRs, NFRs, epics, user stories, success metrics.
8
+ ## Goal
9
+ Convert plan output into a formal PRD: vision, goals, FRs, NFRs, epics, user stories, success metrics.
10
10
 
11
- ## Điều kiện tiên quyết
12
- Phải đã chạy `/vsaf-plan` output trước khi chạy skill này.
11
+ ## Prerequisites
12
+ Must have run `/vsaf-plan` and have its output before running this skill.
13
13
 
14
- ## Các bước thực hiện
14
+ ## Steps
15
15
 
16
- ### Bước 0 — Xác định mode: Tạo mới hay Chỉnh sửa
17
- - Kiểm tra xem đã PRD trong `docs/project/planning-artifacts/` cho feature này chưa
18
- - **Nếu chưa có** → Mode: CREATE (tạo mới từ đầu)
19
- - **Nếu đã có** → Mode: EDIT (chỉnh sửa dựa trên feedback/changes)
20
- - Hỏi user: "PRD đã tồn tại. Bạn muốn tạo mới hoàn toàn hay chỉnh sửa?"
16
+ ### Step 0 — Determine mode: Create or Edit
17
+ - Check if a PRD already exists in `docs/project/planning-artifacts/` for this feature
18
+ - **If none exists** → Mode: CREATE (create from scratch)
19
+ - **If one exists** → Mode: EDIT (edit based on feedback/changes)
20
+ - Ask user: "A PRD already exists. Do you want to create a new one from scratch or edit the existing one?"
21
21
 
22
- ### Bước 1 — Sinh hoặc Chỉnh sửa PRD
22
+ ### Step 1 — Generate or Edit PRD
23
23
 
24
24
  #### Mode CREATE:
25
- - Dùng skill `bmad-agent-pm` (John) để dẫn dắt quá trình tạo PRD từ output `/vsaf-plan`
26
- - John sẽ gọi skill `bmad-create-prd` để sinh PRD chuẩn
27
- - PRD phải bao gồm: vision, goals, FRs, NFRs, epics, user stories, success metrics, scope, out-of-scope, assumptions
28
- - Lưu vào `docs/project/planning-artifacts/prd-[feature].md`
25
+ - Use skill `bmad-agent-pm` (John) to guide the PRD creation process from `/vsaf-plan` output
26
+ - John will call skill `bmad-create-prd` to generate a standard PRD
27
+ - PRD must include: vision, goals, FRs, NFRs, epics, user stories, success metrics, scope, out-of-scope, assumptions
28
+ - Save to `docs/project/planning-artifacts/prd-[feature].md`
29
29
 
30
30
  #### Mode EDIT:
31
- - Dùng skill `bmad-edit-prd` để chỉnh sửa PRD đã có
32
- - Giữ nguyên structure IDs đã có chỉ thêm/sửa/xoá sections cần thiết
33
- - Nếu thay đổi lớn: cảnh báo user rằng SRS testcases cần re-run
31
+ - Use skill `bmad-edit-prd` to edit the existing PRD
32
+ - Preserve existing structure and IDs — only add/modify/remove sections as needed
33
+ - If changes are significant: warn user that SRS and testcases need to be re-run
34
34
 
35
- ### Bước 2 — Validate PRD (BMAD validate)
36
- - Dùng skill `bmad-validate-prd` để validate PRD vừa sinh/sửa
37
- - Kiểm tra: FRs đủ rõ ràng? NFRs đo lường được? Acceptance criteria kiểm chứng được?
38
- - Nếu issues: fix ngay trong PRD, không chờ đến build
39
- - Ghi nhận validation result (PASS/FAIL + findings)
35
+ ### Step 2 — Validate PRD (BMAD validate)
36
+ - Use skill `bmad-validate-prd` to validate the generated/edited PRD
37
+ - Check: Are FRs clear enough? Are NFRs measurable? Are acceptance criteria verifiable?
38
+ - If issues found: fix immediately in the PRD, do not wait until build
39
+ - Record validation result (PASS/FAIL + findings)
40
40
 
41
- ### Bước 3 — Output cho user
41
+ ### Step 3 — Output to user
42
42
  ```
43
- ## PRD đã tạo/cập nhật
43
+ ## PRD Created/Updated
44
44
 
45
45
  ### File
46
46
  - docs/project/planning-artifacts/prd-[feature].md
47
47
  - Mode: [CREATE / EDIT]
48
- - Validation: [PASS / FAIL — chi tiết nếu fail]
48
+ - Validation: [PASS / FAIL — details if fail]
49
49
 
50
50
  ## Next step
51
- Chạy /vsaf-doc-srs để viết tài liệu SRS từ PRD này
51
+ Run /vsaf-doc-srs to write SRS from this PRD
52
52
  ```
53
53
 
54
- ## Lưu ý
55
- - Không bắt đầu code trong bước này
56
- - Nếu scope quá lớn (>3 modules): đề nghị split thành nhiều PRs
57
- - Commit docs trước khi chuyển sang SRS: `git commit -m "docs: prd for <feature>"`
54
+ ## Notes
55
+ - Do not start coding in this step
56
+ - If scope is too large (>3 modules): suggest splitting into multiple PRs
57
+ - Commit docs before moving to SRS: `git commit -m "docs: prd for <feature>"`