@ngocsangairvds/vsaf 4.0.7 → 4.0.8

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.
Files changed (38) hide show
  1. package/README.md +7 -5
  2. package/package.json +2 -2
  3. package/packages/cli/dist/commands/init.d.ts.map +1 -1
  4. package/packages/cli/dist/commands/init.js +25 -14
  5. package/packages/cli/dist/commands/init.js.map +1 -1
  6. package/packages/cli/dist/commands/skill.js +8 -8
  7. package/packages/cli/dist/commands/skill.js.map +1 -1
  8. package/packages/core/dist/skills/skill-loader.d.ts.map +1 -1
  9. package/packages/core/dist/skills/skill-loader.js +9 -4
  10. package/packages/core/dist/skills/skill-loader.js.map +1 -1
  11. package/skills/sdlc/architecture/SKILL.md +22 -8
  12. package/skills/sdlc/bmad-checkpoint-preview/SKILL.md +29 -0
  13. package/skills/sdlc/bmad-checkpoint-preview/generate-trail.md +38 -0
  14. package/skills/sdlc/bmad-checkpoint-preview/step-01-orientation.md +105 -0
  15. package/skills/sdlc/bmad-checkpoint-preview/step-02-walkthrough.md +89 -0
  16. package/skills/sdlc/bmad-checkpoint-preview/step-03-detail-pass.md +106 -0
  17. package/skills/sdlc/bmad-checkpoint-preview/step-04-testing.md +74 -0
  18. package/skills/sdlc/bmad-checkpoint-preview/step-05-wrapup.md +24 -0
  19. package/skills/sdlc/bmad-correct-course/SKILL.md +6 -0
  20. package/skills/sdlc/bmad-correct-course/checklist.md +288 -0
  21. package/skills/sdlc/bmad-correct-course/workflow.md +267 -0
  22. package/skills/sdlc/discovery/SKILL.md +2 -2
  23. package/skills/sdlc/pack.yaml +3 -1
  24. package/skills/sdlc/prd/SKILL.md +20 -5
  25. package/skills/sdlc/review/SKILL.md +9 -5
  26. package/skills/sdlc/sdlc-health/SKILL.md +5 -3
  27. package/skills/sdlc/setup/SKILL.md +1 -1
  28. package/skills/sdlc/srs/SKILL.md +7 -6
  29. package/skills/sdlc/test-design/SKILL.md +10 -6
  30. package/skills/sdlc/workflows/hotfix-tdd.yaml +2 -2
  31. package/skills/sdlc/workflows/hotfix.yaml +5 -5
  32. package/skills/sdlc/workflows/master-sdlc.yaml +9 -9
  33. package/skills/sdlc/workflows/onboarding.yaml +2 -2
  34. package/skills/sdlc/workflows/sdlc-build.yaml +1 -1
  35. package/skills/sdlc/workflows/sdlc-design.yaml +2 -2
  36. package/skills/sdlc/workflows/sdlc-qa.yaml +3 -3
  37. package/skills/sdlc/workflows/sdlc-testcase.yaml +1 -1
  38. package/skills/sdlc/workflows/sdlc-thinking.yaml +2 -2
@@ -0,0 +1,267 @@
1
+ # Correct Course - Sprint Change Management Workflow
2
+
3
+ **Goal:** Manage significant changes during sprint execution by analyzing impact across all project artifacts and producing a structured Sprint Change Proposal.
4
+
5
+ **Your Role:** You are a Developer navigating change management. Analyze the triggering issue, assess impact across PRD, epics, architecture, and UX artifacts, and produce an actionable Sprint Change Proposal with clear handoff.
6
+
7
+ ---
8
+
9
+ ## INITIALIZATION
10
+
11
+ ### Configuration Loading
12
+
13
+ Load config from `{project-root}/_bmad/bmm/config.yaml` and resolve:
14
+
15
+ - `project_name`, `user_name`
16
+ - `communication_language`, `document_output_language`
17
+ - `user_skill_level`
18
+ - `implementation_artifacts`
19
+ - `planning_artifacts`
20
+ - `project_knowledge`
21
+ - `date` as system-generated current datetime
22
+ - YOU MUST ALWAYS SPEAK OUTPUT in your Agent communication style with the config `{communication_language}`
23
+ - Language MUST be tailored to `{user_skill_level}`
24
+ - Generate all documents in `{document_output_language}`
25
+ - DOCUMENT OUTPUT: Updated epics, stories, or PRD sections. Clear, actionable changes. User skill level (`{user_skill_level}`) affects conversation style ONLY, not document updates.
26
+
27
+ ### Paths
28
+
29
+ - `default_output_file` = `{planning_artifacts}/sprint-change-proposal-{date}.md`
30
+
31
+ ### Input Files
32
+
33
+ | Input | Path | Load Strategy |
34
+ |-------|------|---------------|
35
+ | PRD | `{planning_artifacts}/*prd*.md` (whole) or `{planning_artifacts}/*prd*/*.md` (sharded) | FULL_LOAD |
36
+ | Epics | `{planning_artifacts}/*epic*.md` (whole) or `{planning_artifacts}/*epic*/*.md` (sharded) | FULL_LOAD |
37
+ | Architecture | `{planning_artifacts}/*architecture*.md` (whole) or `{planning_artifacts}/*architecture*/*.md` (sharded) | FULL_LOAD |
38
+ | UX Design | `{planning_artifacts}/*ux*.md` (whole) or `{planning_artifacts}/*ux*/*.md` (sharded) | FULL_LOAD |
39
+ | Spec | `{planning_artifacts}/*spec-*.md` (whole) | FULL_LOAD |
40
+ | Document Project | `{project_knowledge}/index.md` (sharded) | INDEX_GUIDED |
41
+
42
+ ### Context
43
+
44
+ - Load `**/project-context.md` if it exists
45
+
46
+ ---
47
+
48
+ ## EXECUTION
49
+
50
+ ### Document Discovery - Loading Project Artifacts
51
+
52
+ **Strategy**: Course correction needs broad project context to assess change impact accurately. Load all available planning artifacts.
53
+
54
+ **Discovery Process for FULL_LOAD documents (PRD, Epics, Architecture, UX Design, Spec):**
55
+
56
+ 1. **Search for whole document first** - Look for files matching the whole-document pattern (e.g., `*prd*.md`, `*epic*.md`, `*architecture*.md`, `*ux*.md`, `*spec-*.md`)
57
+ 2. **Check for sharded version** - If whole document not found, look for a directory with `index.md` (e.g., `prd/index.md`, `epics/index.md`)
58
+ 3. **If sharded version found**:
59
+ - Read `index.md` to understand the document structure
60
+ - Read ALL section files listed in the index
61
+ - Process the combined content as a single document
62
+ 4. **Priority**: If both whole and sharded versions exist, use the whole document
63
+
64
+ **Discovery Process for INDEX_GUIDED documents (Document Project):**
65
+
66
+ 1. **Search for index file** - Look for `{project_knowledge}/index.md`
67
+ 2. **If found**: Read the index to understand available documentation sections
68
+ 3. **Selectively load sections** based on relevance to the change being analyzed — do NOT load everything, only sections that relate to the impacted areas
69
+ 4. **This document is optional** — skip if `{project_knowledge}` does not exist (greenfield projects)
70
+
71
+ **Fuzzy matching**: Be flexible with document names — users may use variations like `prd.md`, `bmm-prd.md`, `product-requirements.md`, etc.
72
+
73
+ **Missing documents**: Not all documents may exist. PRD and Epics are essential; Architecture, UX Design, Spec, and Document Project are loaded if available. HALT if PRD or Epics cannot be found.
74
+
75
+ <workflow>
76
+
77
+ <step n="1" goal="Initialize Change Navigation">
78
+ <action>Load **/project-context.md for coding standards and project-wide patterns (if exists)</action>
79
+ <action>Confirm change trigger and gather user description of the issue</action>
80
+ <action>Ask: "What specific issue or change has been identified that requires navigation?"</action>
81
+ <action>Verify access to required project documents:</action>
82
+ - PRD (Product Requirements Document)
83
+ - Current Epics and Stories
84
+ - Architecture documentation
85
+ - UI/UX specifications
86
+ <action>Ask user for mode preference:</action>
87
+ - **Incremental** (recommended): Refine each edit collaboratively
88
+ - **Batch**: Present all changes at once for review
89
+ <action>Store mode selection for use throughout workflow</action>
90
+
91
+ <action if="change trigger is unclear">HALT: "Cannot navigate change without clear understanding of the triggering issue. Please provide specific details about what needs to change and why."</action>
92
+
93
+ <action if="core documents are unavailable">HALT: "Need access to project documents (PRD, Epics, Architecture, UI/UX) to assess change impact. Please ensure these documents are accessible."</action>
94
+ </step>
95
+
96
+ <step n="2" goal="Execute Change Analysis Checklist">
97
+ <action>Read fully and follow the systematic analysis from: checklist.md</action>
98
+ <action>Work through each checklist section interactively with the user</action>
99
+ <action>Record status for each checklist item:</action>
100
+ - [x] Done - Item completed successfully
101
+ - [N/A] Skip - Item not applicable to this change
102
+ - [!] Action-needed - Item requires attention or follow-up
103
+ <action>Maintain running notes of findings and impacts discovered</action>
104
+ <action>Present checklist progress after each major section</action>
105
+
106
+ <action if="checklist cannot be completed">Identify blocking issues and work with user to resolve before continuing</action>
107
+ </step>
108
+
109
+ <step n="3" goal="Draft Specific Change Proposals">
110
+ <action>Based on checklist findings, create explicit edit proposals for each identified artifact</action>
111
+
112
+ <action>For Story changes:</action>
113
+
114
+ - Show old → new text format
115
+ - Include story ID and section being modified
116
+ - Provide rationale for each change
117
+ - Example format:
118
+
119
+ ```
120
+ Story: [STORY-123] User Authentication
121
+ Section: Acceptance Criteria
122
+
123
+ OLD:
124
+ - User can log in with email/password
125
+
126
+ NEW:
127
+ - User can log in with email/password
128
+ - User can enable 2FA via authenticator app
129
+
130
+ Rationale: Security requirement identified during implementation
131
+ ```
132
+
133
+ <action>For PRD modifications:</action>
134
+
135
+ - Specify exact sections to update
136
+ - Show current content and proposed changes
137
+ - Explain impact on MVP scope and requirements
138
+
139
+ <action>For Architecture changes:</action>
140
+
141
+ - Identify affected components, patterns, or technology choices
142
+ - Describe diagram updates needed
143
+ - Note any ripple effects on other components
144
+
145
+ <action>For UI/UX specification updates:</action>
146
+
147
+ - Reference specific screens or components
148
+ - Show wireframe or flow changes needed
149
+ - Connect changes to user experience impact
150
+
151
+ <check if="mode is Incremental">
152
+ <action>Present each edit proposal individually</action>
153
+ <ask>Review and refine this change? Options: Approve [a], Edit [e], Skip [s]</ask>
154
+ <action>Iterate on each proposal based on user feedback</action>
155
+ </check>
156
+
157
+ <action if="mode is Batch">Collect all edit proposals and present together at end of step</action>
158
+
159
+ </step>
160
+
161
+ <step n="4" goal="Generate Sprint Change Proposal">
162
+ <action>Compile comprehensive Sprint Change Proposal document with following sections:</action>
163
+
164
+ <action>Section 1: Issue Summary</action>
165
+
166
+ - Clear problem statement describing what triggered the change
167
+ - Context about when/how the issue was discovered
168
+ - Evidence or examples demonstrating the issue
169
+
170
+ <action>Section 2: Impact Analysis</action>
171
+
172
+ - Epic Impact: Which epics are affected and how
173
+ - Story Impact: Current and future stories requiring changes
174
+ - Artifact Conflicts: PRD, Architecture, UI/UX documents needing updates
175
+ - Technical Impact: Code, infrastructure, or deployment implications
176
+
177
+ <action>Section 3: Recommended Approach</action>
178
+
179
+ - Present chosen path forward from checklist evaluation:
180
+ - Direct Adjustment: Modify/add stories within existing plan
181
+ - Potential Rollback: Revert completed work to simplify resolution
182
+ - MVP Review: Reduce scope or modify goals
183
+ - Provide clear rationale for recommendation
184
+ - Include effort estimate, risk assessment, and timeline impact
185
+
186
+ <action>Section 4: Detailed Change Proposals</action>
187
+
188
+ - Include all refined edit proposals from Step 3
189
+ - Group by artifact type (Stories, PRD, Architecture, UI/UX)
190
+ - Ensure each change includes before/after and justification
191
+
192
+ <action>Section 5: Implementation Handoff</action>
193
+
194
+ - Categorize change scope:
195
+ - Minor: Direct implementation by Developer agent
196
+ - Moderate: Backlog reorganization needed (PO/DEV)
197
+ - Major: Fundamental replan required (PM/Architect)
198
+ - Specify handoff recipients and their responsibilities
199
+ - Define success criteria for implementation
200
+
201
+ <action>Present complete Sprint Change Proposal to user</action>
202
+ <action>Write Sprint Change Proposal document to {default_output_file}</action>
203
+ <ask>Review complete proposal. Continue [c] or Edit [e]?</ask>
204
+ </step>
205
+
206
+ <step n="5" goal="Finalize and Route for Implementation">
207
+ <action>Get explicit user approval for complete proposal</action>
208
+ <ask>Do you approve this Sprint Change Proposal for implementation? (yes/no/revise)</ask>
209
+
210
+ <check if="no or revise">
211
+ <action>Gather specific feedback on what needs adjustment</action>
212
+ <action>Return to appropriate step to address concerns</action>
213
+ <goto step="3">If changes needed to edit proposals</goto>
214
+ <goto step="4">If changes needed to overall proposal structure</goto>
215
+
216
+ </check>
217
+
218
+ <check if="yes the proposal is approved by the user">
219
+ <action>Finalize Sprint Change Proposal document</action>
220
+ <action>Determine change scope classification:</action>
221
+
222
+ - **Minor**: Can be implemented directly by Developer agent
223
+ - **Moderate**: Requires backlog reorganization and PO/DEV coordination
224
+ - **Major**: Needs fundamental replan with PM/Architect involvement
225
+
226
+ <action>Provide appropriate handoff based on scope:</action>
227
+
228
+ </check>
229
+
230
+ <check if="Minor scope">
231
+ <action>Route to: Developer agent for direct implementation</action>
232
+ <action>Deliverables: Finalized edit proposals and implementation tasks</action>
233
+ </check>
234
+
235
+ <check if="Moderate scope">
236
+ <action>Route to: Product Owner / Developer agents</action>
237
+ <action>Deliverables: Sprint Change Proposal + backlog reorganization plan</action>
238
+ </check>
239
+
240
+ <check if="Major scope">
241
+ <action>Route to: Product Manager / Solution Architect</action>
242
+ <action>Deliverables: Complete Sprint Change Proposal + escalation notice</action>
243
+
244
+ <action>Confirm handoff completion and next steps with user</action>
245
+ <action>Document handoff in workflow execution log</action>
246
+ </check>
247
+
248
+ </step>
249
+
250
+ <step n="6" goal="Workflow Completion">
251
+ <action>Summarize workflow execution:</action>
252
+ - Issue addressed: {{change_trigger}}
253
+ - Change scope: {{scope_classification}}
254
+ - Artifacts modified: {{list_of_artifacts}}
255
+ - Routed to: {{handoff_recipients}}
256
+
257
+ <action>Confirm all deliverables produced:</action>
258
+
259
+ - Sprint Change Proposal document
260
+ - Specific edit proposals with before/after
261
+ - Implementation handoff plan
262
+
263
+ <action>Report workflow completion to user with personalized message: "Correct Course workflow complete, {user_name}!"</action>
264
+ <action>Remind user of success criteria and next steps for Developer agent</action>
265
+ </step>
266
+
267
+ </workflow>
@@ -93,9 +93,9 @@ Use `/bmad-advanced-elicitation` — grill questions BASED ON system understandi
93
93
 
94
94
  Two complementary brainstorming approaches:
95
95
 
96
- **4a — Structured brainstorm (Superpowers)**
96
+ **4a — Structured brainstorm**
97
97
 
98
- Use `/superpowers:brainstorming` for structured exploration:
98
+ Based on grill answers + system analysis, propose:
99
99
  - 2-3 viable approaches with trade-offs
100
100
  - Risk/constraint evaluation per approach
101
101
  - Recommended option with reasoning
@@ -34,7 +34,7 @@ skills:
34
34
 
35
35
  # Bundled external skills — deployed WITHOUT pack prefix (as-is)
36
36
  bundled:
37
- # BMAD skills (15) — used by discovery, prd, architecture, srs, test-design, review
37
+ # BMAD skills (17) — used by discovery, prd, architecture, srs, test-design, implement, review
38
38
  - bmad-advanced-elicitation
39
39
  - bmad-brainstorming
40
40
  - bmad-domain-research
@@ -50,6 +50,8 @@ bundled:
50
50
  - bmad-code-review
51
51
  - bmad-party-mode
52
52
  - bmad-qa-generate-e2e-tests
53
+ - bmad-checkpoint-preview
54
+ - bmad-correct-course
53
55
 
54
56
  # mattpocock skills (5) — lean alternative for bugfix/known-domain flows
55
57
  - grill-me
@@ -63,8 +63,15 @@ Record results in `02-prd.md` §Grill Log.
63
63
  [PRD] [3/5] Creating PRD from grill results... ⏳
64
64
  ```
65
65
 
66
- Use `/bmad-create-prd` generate PRD from grill results.
67
- Write to `02-prd.md` §Requirements: goals, user stories, FRs, NFRs, success metrics.
66
+ Based on grill results from Step 2, create structured PRD:
67
+
68
+ 1. **Goals** — business goals + success metrics
69
+ 2. **User Stories** — each MUST have acceptance criteria (Given/When/Then)
70
+ 3. **Functional Requirements** — unique ID per requirement (FR-001, FR-002...)
71
+ 4. **Non-Functional Requirements** — unique ID (NFR-001, NFR-002...) — performance, security, scalability
72
+ 5. **Success Metrics** — measurable KPIs tied to goals
73
+
74
+ Write to `02-prd.md` §Requirements.
68
75
 
69
76
  ```
70
77
  [PRD] [3/5] Creating PRD from grill results... ✅
@@ -76,9 +83,17 @@ Write to `02-prd.md` §Requirements: goals, user stories, FRs, NFRs, success met
76
83
  [PRD] [4/5] Validate + adversarial review... ⏳
77
84
  ```
78
85
 
79
- Use `/bmad-validate-prd` validate completeness, clarity, testability.
80
- Write to `02-prd.md` §Validation.
81
- If FAIL fix inline, re-validate.
86
+ **4aValidate PRD:**
87
+
88
+ Check the PRD for:
89
+ - Completeness — all user stories covered by FRs? All FRs traceable to a user story?
90
+ - Clarity — any ambiguous requirements? Can each FR be implemented without guessing?
91
+ - Testability — can each FR be verified with a test case?
92
+ - Consistency — any FRs that contradict each other?
93
+
94
+ Write to `02-prd.md` §Validation. If FAIL → fix inline, re-validate.
95
+
96
+ **4b — Adversarial review:**
82
97
 
83
98
  Use `/bmad-review-adversarial-general` — cynical review to find gaps.
84
99
  Write to `02-prd.md` §Adversarial.
@@ -69,11 +69,15 @@ Write to `08-review.md` §Verification.
69
69
  [REVIEW] [3/5] Adversarial code review... ⏳
70
70
  ```
71
71
 
72
- Use `/bmad-code-review` adversarial code review:
73
- - Security vulnerabilities
74
- - Data integrity risks
75
- - SOLID violations
76
- - Naming consistency with CONTEXT.md
72
+ Perform adversarial code review on the feature branch diff:
73
+
74
+ 1. **Security scan** — SQL injection, XSS, command injection, hardcoded secrets, insecure deserialization
75
+ 2. **Data integrity** — null dereference, resource leaks, race conditions, missing transactions
76
+ 3. **SOLID violations** god classes, leaky abstractions, interface segregation
77
+ 4. **Naming consistency** — verify against CONTEXT.md terminology
78
+ 5. **SRS compliance** — every FR/NFR implemented? Any extra scope not in SRS?
79
+
80
+ Classify each finding: MUST FIX / SHOULD FIX / NOTED.
77
81
  Write to `08-review.md` §Code Review.
78
82
 
79
83
  #### Quality Gate Re-check (SonarQube)
@@ -38,7 +38,7 @@ Use the Read tool to check each of these 16 skill files (sdlc-health is excluded
38
38
 
39
39
  ### Check 2: BMAD Skills (filesystem)
40
40
 
41
- Check these 15 BMAD skills — required by discovery, prd, architecture, srs, test-design, review:
41
+ Check these 17 BMAD skills — required by discovery, prd, architecture, srs, test-design, review:
42
42
 
43
43
  ```
44
44
  .claude/skills/bmad-advanced-elicitation/SKILL.md
@@ -56,6 +56,8 @@ Check these 15 BMAD skills — required by discovery, prd, architecture, srs, te
56
56
  .claude/skills/bmad-code-review/SKILL.md
57
57
  .claude/skills/bmad-party-mode/SKILL.md
58
58
  .claude/skills/bmad-qa-generate-e2e-tests/SKILL.md
59
+ .claude/skills/bmad-checkpoint-preview/SKILL.md
60
+ .claude/skills/bmad-correct-course/SKILL.md
59
61
  ```
60
62
 
61
63
  ### Check 3: mattpocock Skills (filesystem)
@@ -136,7 +138,7 @@ After completing all checks, print this summary:
136
138
  | Category | Status | Details |
137
139
  |----------------------|--------|-----------------------------------------|
138
140
  | SDLC Skills (16) | {s} | {deployed}/{16} deployed |
139
- | BMAD Skills (15) | {s} | {deployed}/{15} deployed |
141
+ | BMAD Skills (17) | {s} | {deployed}/{17} deployed |
140
142
  | mattpocock Skills (5)| {s} | {deployed}/{5} deployed |
141
143
  | Plugins | {s} | superpowers {s} |
142
144
  | MCP tools | {s} | vsaf {s}, gitnexus {s} |
@@ -161,5 +163,5 @@ Replace `{s}` with: ✓ (pass), ✗ (required missing), ⚠ (optional missing).
161
163
  - ✗ = required missing → must fix before using SDLC
162
164
  - ⚠ = optional missing → SDLC works but some features unavailable
163
165
 
164
- **Required:** all 16 SDLC skills, all 15 BMAD skills, all 5 mattpocock skills, superpowers plugin, gh binary, graphify binary + skill, gitnexus MCP, .mcp.json entries
166
+ **Required:** all 16 SDLC skills, all 17 BMAD skills, all 5 mattpocock skills, superpowers plugin, gh binary, graphify binary + skill, gitnexus MCP, .mcp.json entries
165
167
  **Optional:** docker, sonar-scanner, vsaf MCP (only for coroutine engine)
@@ -28,7 +28,7 @@ Run the install script:
28
28
  node "$(vsaf skill path sdlc)/install-deps.mjs"
29
29
  ```
30
30
 
31
- If `vsaf skill path` is not available, find `install-deps.mjs` in the SDLC skill pack directory (`.vsaf/skills/` or the installed pack location) and run it with `node`.
31
+ If `vsaf skill path` is not available, find `install-deps.mjs` in the SDLC skill pack directory (`.claude/skills/` or the installed pack location) and run it with `node`.
32
32
 
33
33
  This script will:
34
34
  - Ensure `package.json` exists
@@ -45,12 +45,13 @@ All output documents (05-srs.md) MUST be written in Vietnamese. Section headers,
45
45
  [SRS] [2/3] Writing SRS from PRD + ADR... ⏳
46
46
  ```
47
47
 
48
- Use `/bmad-agent-analyst` — derive SRS from PRD + ADR.
49
- Each FR/NFR must have:
50
- - Unique ID (FR-001, NFR-001)
51
- - Trace to PRD user story (US-xxx)
52
- - Input/Output spec
53
- - Constraints
48
+ Derive SRS from PRD + ADR. For each FR/NFR:
49
+
50
+ 1. **Unique ID** FR-001, NFR-001 (sequential, no gaps)
51
+ 2. **Traceability** — trace to PRD user story (US-xxx)
52
+ 3. **Input/Output spec** — `{class}.{method}({params}): {return}` or API contract
53
+ 4. **Constraints** — performance, security, data validation rules
54
+ 5. **Pre/Post conditions** — system state before and after execution
54
55
 
55
56
  Write to `05-srs.md`.
56
57
 
@@ -37,12 +37,16 @@ You are a QA Lead. Your mission: design test cases FROM the SRS (spec), NOT from
37
37
  [TEST-DESIGN] [2/4] Generating test cases from SRS... ⏳
38
38
  ```
39
39
 
40
- Use `/bmad-qa-generate-e2e-tests` derive tests from SRS FRs/NFRs.
41
- Each test case must have:
42
- - Unique ID (TC-001)
43
- - Trace to FR/NFR → PRD user story
44
- - Type: unit / integration / e2e
45
- - Precondition, Steps, Expected result
40
+ Derive test cases from SRS FRs/NFRs. For each requirement, design ≥1 test case:
41
+
42
+ 1. **Unique ID** TC-001 (sequential)
43
+ 2. **Traceability** TC → FR/NFR → PRD user story (US-xxx)
44
+ 3. **Type** unit / integration / e2e (based on requirement scope)
45
+ 4. **Precondition** system state before test
46
+ 5. **Steps** — exact actions to execute
47
+ 6. **Expected result** — concrete, verifiable outcome (not "should work")
48
+
49
+ Prioritize: happy path first, then error paths, then edge cases.
46
50
 
47
51
  ```
48
52
  [TEST-DESIGN] [2/4] Generating test cases from SRS... ✅
@@ -3,11 +3,11 @@ description: "Sub-flow: TDD RED → GREEN → Test Gate — write failing test,
3
3
 
4
4
  nodes:
5
5
  - id: red
6
- command: hotfix-red
6
+ command: sdlc-hotfix-red
7
7
  depends_on: []
8
8
 
9
9
  - id: green
10
- command: hotfix-green
10
+ command: sdlc-hotfix-green
11
11
  depends_on: [red]
12
12
 
13
13
  - id: test-gate
@@ -3,15 +3,15 @@ description: "Hotfix — Bug report → Analyze → TDD (RED → GREEN) → Test
3
3
 
4
4
  nodes:
5
5
  - id: analyze
6
- command: hotfix-analyze
6
+ command: sdlc-hotfix-analyze
7
7
  workspace: false
8
8
 
9
9
  - id: red
10
- command: hotfix-red
10
+ command: sdlc-hotfix-red
11
11
  depends_on: [analyze]
12
12
 
13
13
  - id: green
14
- command: hotfix-green
14
+ command: sdlc-hotfix-green
15
15
  depends_on: [red]
16
16
 
17
17
  - id: test-gate
@@ -24,11 +24,11 @@ nodes:
24
24
  inject_error: true
25
25
 
26
26
  - id: review
27
- command: hotfix-review
27
+ command: sdlc-hotfix-review
28
28
  depends_on: [test-gate]
29
29
  workspace: false
30
30
 
31
31
  - id: ship
32
- command: ship
32
+ command: sdlc-ship
33
33
  depends_on: [review]
34
34
  workspace: false
@@ -2,26 +2,26 @@ name: master-sdlc
2
2
  description: "Full SDLC pipeline — Discovery → PRD → Architecture → SRS → Test Design → Implement → Review → Feature Complete → Ship"
3
3
  nodes:
4
4
  - id: discovery
5
- command: discovery
5
+ command: sdlc-discovery
6
6
  workspace: false
7
7
  - id: prd
8
- command: prd
8
+ command: sdlc-prd
9
9
  depends_on: [discovery]
10
10
  workspace: false
11
11
  - id: architecture
12
- command: architecture
12
+ command: sdlc-architecture
13
13
  depends_on: [prd]
14
14
  workspace: false
15
15
  - id: srs
16
- command: srs
16
+ command: sdlc-srs
17
17
  depends_on: [architecture]
18
18
  workspace: false
19
19
  - id: test-design
20
- command: test-design
20
+ command: sdlc-test-design
21
21
  depends_on: [srs]
22
22
  workspace: false
23
23
  - id: implement
24
- command: implement
24
+ command: sdlc-implement
25
25
  depends_on: [test-design]
26
26
  - id: test-gate
27
27
  bash: |
@@ -32,14 +32,14 @@ nodes:
32
32
  max_retries: 3
33
33
  inject_error: true
34
34
  - id: review
35
- command: review
35
+ command: sdlc-review
36
36
  depends_on: [test-gate]
37
37
  workspace: false
38
38
  - id: complete
39
- command: feature-complete
39
+ command: sdlc-feature-complete
40
40
  depends_on: [review]
41
41
  workspace: false
42
42
  - id: ship
43
- command: ship
43
+ command: sdlc-ship
44
44
  depends_on: [complete]
45
45
  workspace: false
@@ -2,8 +2,8 @@ name: onboarding
2
2
  description: "Utility — Onboarding: docs graph + code graph + env setup (not part of main flow)"
3
3
  nodes:
4
4
  - id: docs
5
- command: onboard-docs
5
+ command: sdlc-onboard-docs
6
6
  workspace: false
7
7
  - id: code
8
- command: onboard-code
8
+ command: sdlc-onboard-code
9
9
  workspace: false
@@ -3,7 +3,7 @@ description: "Sub-flow: Implement → Test Gate — TDD code + automated test ve
3
3
 
4
4
  nodes:
5
5
  - id: implement
6
- command: implement
6
+ command: sdlc-implement
7
7
  depends_on: []
8
8
 
9
9
  - id: test-gate
@@ -3,10 +3,10 @@ description: "Sub-flow: Architecture → SRS — design solution and write detai
3
3
 
4
4
  nodes:
5
5
  - id: architecture
6
- command: architecture
6
+ command: sdlc-architecture
7
7
  workspace: false
8
8
 
9
9
  - id: srs
10
- command: srs
10
+ command: sdlc-srs
11
11
  depends_on: [architecture]
12
12
  workspace: false
@@ -3,15 +3,15 @@ description: "Sub-flow: Review → Feature Complete → Ship — quality gate +
3
3
 
4
4
  nodes:
5
5
  - id: review
6
- command: review
6
+ command: sdlc-review
7
7
  workspace: false
8
8
 
9
9
  - id: complete
10
- command: feature-complete
10
+ command: sdlc-feature-complete
11
11
  depends_on: [review]
12
12
  workspace: false
13
13
 
14
14
  - id: ship
15
- command: ship
15
+ command: sdlc-ship
16
16
  depends_on: [complete]
17
17
  workspace: false
@@ -3,5 +3,5 @@ description: "Sub-flow: Test Design — generate test cases from SRS (tests befo
3
3
 
4
4
  nodes:
5
5
  - id: test-design
6
- command: test-design
6
+ command: sdlc-test-design
7
7
  workspace: false
@@ -3,10 +3,10 @@ description: "Sub-flow: Discovery → PRD — understand the problem space befor
3
3
 
4
4
  nodes:
5
5
  - id: discovery
6
- command: discovery
6
+ command: sdlc-discovery
7
7
  workspace: false
8
8
 
9
9
  - id: prd
10
- command: prd
10
+ command: sdlc-prd
11
11
  depends_on: [discovery]
12
12
  workspace: false