agentvibes 2.4.3-beta.2 → 2.4.3

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 (129) hide show
  1. package/README.md +7 -7
  2. package/RELEASE_NOTES.md +94 -119
  3. package/package.json +1 -1
  4. package/.bmad-core/agent-teams/team-all.yaml +0 -15
  5. package/.bmad-core/agent-teams/team-fullstack.yaml +0 -19
  6. package/.bmad-core/agent-teams/team-ide-minimal.yaml +0 -11
  7. package/.bmad-core/agent-teams/team-no-ui.yaml +0 -14
  8. package/.bmad-core/agents/analyst.md +0 -84
  9. package/.bmad-core/agents/architect.md +0 -85
  10. package/.bmad-core/agents/bmad-master.md +0 -110
  11. package/.bmad-core/agents/bmad-orchestrator.md +0 -147
  12. package/.bmad-core/agents/dev.md +0 -81
  13. package/.bmad-core/agents/pm.md +0 -84
  14. package/.bmad-core/agents/po.md +0 -79
  15. package/.bmad-core/agents/qa.md +0 -87
  16. package/.bmad-core/agents/sm.md +0 -65
  17. package/.bmad-core/agents/ux-expert.md +0 -69
  18. package/.bmad-core/checklists/architect-checklist.md +0 -440
  19. package/.bmad-core/checklists/change-checklist.md +0 -184
  20. package/.bmad-core/checklists/pm-checklist.md +0 -372
  21. package/.bmad-core/checklists/po-master-checklist.md +0 -434
  22. package/.bmad-core/checklists/story-dod-checklist.md +0 -96
  23. package/.bmad-core/checklists/story-draft-checklist.md +0 -155
  24. package/.bmad-core/core-config.yaml +0 -22
  25. package/.bmad-core/data/bmad-kb.md +0 -809
  26. package/.bmad-core/data/brainstorming-techniques.md +0 -38
  27. package/.bmad-core/data/elicitation-methods.md +0 -156
  28. package/.bmad-core/data/technical-preferences.md +0 -5
  29. package/.bmad-core/data/test-levels-framework.md +0 -148
  30. package/.bmad-core/data/test-priorities-matrix.md +0 -174
  31. package/.bmad-core/enhanced-ide-development-workflow.md +0 -248
  32. package/.bmad-core/install-manifest.yaml +0 -230
  33. package/.bmad-core/tasks/advanced-elicitation.md +0 -119
  34. package/.bmad-core/tasks/apply-qa-fixes.md +0 -150
  35. package/.bmad-core/tasks/brownfield-create-epic.md +0 -162
  36. package/.bmad-core/tasks/brownfield-create-story.md +0 -149
  37. package/.bmad-core/tasks/correct-course.md +0 -72
  38. package/.bmad-core/tasks/create-brownfield-story.md +0 -314
  39. package/.bmad-core/tasks/create-deep-research-prompt.md +0 -280
  40. package/.bmad-core/tasks/create-doc.md +0 -103
  41. package/.bmad-core/tasks/create-next-story.md +0 -114
  42. package/.bmad-core/tasks/document-project.md +0 -345
  43. package/.bmad-core/tasks/execute-checklist.md +0 -88
  44. package/.bmad-core/tasks/facilitate-brainstorming-session.md +0 -138
  45. package/.bmad-core/tasks/generate-ai-frontend-prompt.md +0 -53
  46. package/.bmad-core/tasks/index-docs.md +0 -175
  47. package/.bmad-core/tasks/kb-mode-interaction.md +0 -77
  48. package/.bmad-core/tasks/nfr-assess.md +0 -345
  49. package/.bmad-core/tasks/qa-gate.md +0 -163
  50. package/.bmad-core/tasks/review-story.md +0 -316
  51. package/.bmad-core/tasks/risk-profile.md +0 -355
  52. package/.bmad-core/tasks/shard-doc.md +0 -187
  53. package/.bmad-core/tasks/test-design.md +0 -176
  54. package/.bmad-core/tasks/trace-requirements.md +0 -266
  55. package/.bmad-core/tasks/validate-next-story.md +0 -136
  56. package/.bmad-core/templates/architecture-tmpl.yaml +0 -651
  57. package/.bmad-core/templates/brainstorming-output-tmpl.yaml +0 -156
  58. package/.bmad-core/templates/brownfield-architecture-tmpl.yaml +0 -477
  59. package/.bmad-core/templates/brownfield-prd-tmpl.yaml +0 -281
  60. package/.bmad-core/templates/competitor-analysis-tmpl.yaml +0 -307
  61. package/.bmad-core/templates/front-end-architecture-tmpl.yaml +0 -219
  62. package/.bmad-core/templates/front-end-spec-tmpl.yaml +0 -350
  63. package/.bmad-core/templates/fullstack-architecture-tmpl.yaml +0 -824
  64. package/.bmad-core/templates/market-research-tmpl.yaml +0 -253
  65. package/.bmad-core/templates/prd-tmpl.yaml +0 -203
  66. package/.bmad-core/templates/project-brief-tmpl.yaml +0 -222
  67. package/.bmad-core/templates/qa-gate-tmpl.yaml +0 -103
  68. package/.bmad-core/templates/story-tmpl.yaml +0 -138
  69. package/.bmad-core/user-guide.md +0 -577
  70. package/.bmad-core/utils/bmad-doc-template.md +0 -327
  71. package/.bmad-core/utils/workflow-management.md +0 -71
  72. package/.bmad-core/workflows/brownfield-fullstack.yaml +0 -298
  73. package/.bmad-core/workflows/brownfield-service.yaml +0 -188
  74. package/.bmad-core/workflows/brownfield-ui.yaml +0 -198
  75. package/.bmad-core/workflows/greenfield-fullstack.yaml +0 -241
  76. package/.bmad-core/workflows/greenfield-service.yaml +0 -207
  77. package/.bmad-core/workflows/greenfield-ui.yaml +0 -236
  78. package/.bmad-core/working-in-the-brownfield.md +0 -606
  79. package/.claude/commands/BMad/analyst.md +0 -88
  80. package/.claude/commands/BMad/architect.md +0 -89
  81. package/.claude/commands/BMad/bmad-master.md +0 -114
  82. package/.claude/commands/BMad/bmad-orchestrator.md +0 -151
  83. package/.claude/commands/BMad/dev.md +0 -85
  84. package/.claude/commands/BMad/pm.md +0 -88
  85. package/.claude/commands/BMad/po.md +0 -83
  86. package/.claude/commands/BMad/qa.md +0 -91
  87. package/.claude/commands/BMad/sm.md +0 -69
  88. package/.claude/commands/BMad/tasks/advanced-elicitation.md +0 -123
  89. package/.claude/commands/BMad/tasks/apply-qa-fixes.md +0 -154
  90. package/.claude/commands/BMad/tasks/brownfield-create-epic.md +0 -166
  91. package/.claude/commands/BMad/tasks/brownfield-create-story.md +0 -153
  92. package/.claude/commands/BMad/tasks/correct-course.md +0 -76
  93. package/.claude/commands/BMad/tasks/create-brownfield-story.md +0 -318
  94. package/.claude/commands/BMad/tasks/create-deep-research-prompt.md +0 -284
  95. package/.claude/commands/BMad/tasks/create-doc.md +0 -107
  96. package/.claude/commands/BMad/tasks/create-next-story.md +0 -118
  97. package/.claude/commands/BMad/tasks/document-project.md +0 -349
  98. package/.claude/commands/BMad/tasks/execute-checklist.md +0 -92
  99. package/.claude/commands/BMad/tasks/facilitate-brainstorming-session.md +0 -142
  100. package/.claude/commands/BMad/tasks/generate-ai-frontend-prompt.md +0 -57
  101. package/.claude/commands/BMad/tasks/index-docs.md +0 -179
  102. package/.claude/commands/BMad/tasks/kb-mode-interaction.md +0 -81
  103. package/.claude/commands/BMad/tasks/nfr-assess.md +0 -349
  104. package/.claude/commands/BMad/tasks/qa-gate.md +0 -167
  105. package/.claude/commands/BMad/tasks/review-story.md +0 -320
  106. package/.claude/commands/BMad/tasks/risk-profile.md +0 -359
  107. package/.claude/commands/BMad/tasks/shard-doc.md +0 -191
  108. package/.claude/commands/BMad/tasks/test-design.md +0 -180
  109. package/.claude/commands/BMad/tasks/trace-requirements.md +0 -270
  110. package/.claude/commands/BMad/tasks/validate-next-story.md +0 -140
  111. package/.claude/commands/BMad/ux-expert.md +0 -73
  112. package/.claude/github-star-reminder.txt +0 -1
  113. package/.claude/piper-voices-dir.txt +0 -1
  114. package/.claude/plugins/bmad-voices-enabled.flag +0 -0
  115. package/.mcp.json +0 -88
  116. package/RELEASE_NOTES_v2.4.0_DRAFT.md +0 -116
  117. package/RELEASE_NOTES_v2.4.1_DRAFT.md +0 -61
  118. package/docs/2025-11-15_15-14-33.snagx +0 -0
  119. package/docs/Screenshot 2025-11-15 151325.png +0 -0
  120. package/docs/Screenshot 2025-11-15 151432.png +0 -0
  121. package/docs/macos-piper-issue.md +0 -172
  122. package/docs/stargazer-cms-prd.md +0 -1918
  123. package/docs/whatsapp-plugin-github-issue.md +0 -393
  124. package/docs/whatsapp-tts-plugin-feasibility.md +0 -418
  125. package/docs/whatsapp-tts-standalone-plugin.md +0 -628
  126. package/github-profile-draft.md +0 -57
  127. package/linkedin/vibe-coding-and-pulseaudio.md +0 -121
  128. package/mcp-server/agentvibes.db +0 -0
  129. package/scripts/audio-tunnel.config +0 -17
@@ -1,180 +0,0 @@
1
- # /test-design Task
2
-
3
- When this command is used, execute the following task:
4
-
5
- <!-- Powered by BMAD™ Core -->
6
-
7
- # test-design
8
-
9
- Create comprehensive test scenarios with appropriate test level recommendations for story implementation.
10
-
11
- ## Inputs
12
-
13
- ```yaml
14
- required:
15
- - story_id: '{epic}.{story}' # e.g., "1.3"
16
- - story_path: '{devStoryLocation}/{epic}.{story}.*.md' # Path from core-config.yaml
17
- - story_title: '{title}' # If missing, derive from story file H1
18
- - story_slug: '{slug}' # If missing, derive from title (lowercase, hyphenated)
19
- ```
20
-
21
- ## Purpose
22
-
23
- Design a complete test strategy that identifies what to test, at which level (unit/integration/e2e), and why. This ensures efficient test coverage without redundancy while maintaining appropriate test boundaries.
24
-
25
- ## Dependencies
26
-
27
- ```yaml
28
- data:
29
- - test-levels-framework.md # Unit/Integration/E2E decision criteria
30
- - test-priorities-matrix.md # P0/P1/P2/P3 classification system
31
- ```
32
-
33
- ## Process
34
-
35
- ### 1. Analyze Story Requirements
36
-
37
- Break down each acceptance criterion into testable scenarios. For each AC:
38
-
39
- - Identify the core functionality to test
40
- - Determine data variations needed
41
- - Consider error conditions
42
- - Note edge cases
43
-
44
- ### 2. Apply Test Level Framework
45
-
46
- **Reference:** Load `test-levels-framework.md` for detailed criteria
47
-
48
- Quick rules:
49
-
50
- - **Unit**: Pure logic, algorithms, calculations
51
- - **Integration**: Component interactions, DB operations
52
- - **E2E**: Critical user journeys, compliance
53
-
54
- ### 3. Assign Priorities
55
-
56
- **Reference:** Load `test-priorities-matrix.md` for classification
57
-
58
- Quick priority assignment:
59
-
60
- - **P0**: Revenue-critical, security, compliance
61
- - **P1**: Core user journeys, frequently used
62
- - **P2**: Secondary features, admin functions
63
- - **P3**: Nice-to-have, rarely used
64
-
65
- ### 4. Design Test Scenarios
66
-
67
- For each identified test need, create:
68
-
69
- ```yaml
70
- test_scenario:
71
- id: '{epic}.{story}-{LEVEL}-{SEQ}'
72
- requirement: 'AC reference'
73
- priority: P0|P1|P2|P3
74
- level: unit|integration|e2e
75
- description: 'What is being tested'
76
- justification: 'Why this level was chosen'
77
- mitigates_risks: ['RISK-001'] # If risk profile exists
78
- ```
79
-
80
- ### 5. Validate Coverage
81
-
82
- Ensure:
83
-
84
- - Every AC has at least one test
85
- - No duplicate coverage across levels
86
- - Critical paths have multiple levels
87
- - Risk mitigations are addressed
88
-
89
- ## Outputs
90
-
91
- ### Output 1: Test Design Document
92
-
93
- **Save to:** `qa.qaLocation/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md`
94
-
95
- ```markdown
96
- # Test Design: Story {epic}.{story}
97
-
98
- Date: {date}
99
- Designer: Quinn (Test Architect)
100
-
101
- ## Test Strategy Overview
102
-
103
- - Total test scenarios: X
104
- - Unit tests: Y (A%)
105
- - Integration tests: Z (B%)
106
- - E2E tests: W (C%)
107
- - Priority distribution: P0: X, P1: Y, P2: Z
108
-
109
- ## Test Scenarios by Acceptance Criteria
110
-
111
- ### AC1: {description}
112
-
113
- #### Scenarios
114
-
115
- | ID | Level | Priority | Test | Justification |
116
- | ------------ | ----------- | -------- | ------------------------- | ------------------------ |
117
- | 1.3-UNIT-001 | Unit | P0 | Validate input format | Pure validation logic |
118
- | 1.3-INT-001 | Integration | P0 | Service processes request | Multi-component flow |
119
- | 1.3-E2E-001 | E2E | P1 | User completes journey | Critical path validation |
120
-
121
- [Continue for all ACs...]
122
-
123
- ## Risk Coverage
124
-
125
- [Map test scenarios to identified risks if risk profile exists]
126
-
127
- ## Recommended Execution Order
128
-
129
- 1. P0 Unit tests (fail fast)
130
- 2. P0 Integration tests
131
- 3. P0 E2E tests
132
- 4. P1 tests in order
133
- 5. P2+ as time permits
134
- ```
135
-
136
- ### Output 2: Gate YAML Block
137
-
138
- Generate for inclusion in quality gate:
139
-
140
- ```yaml
141
- test_design:
142
- scenarios_total: X
143
- by_level:
144
- unit: Y
145
- integration: Z
146
- e2e: W
147
- by_priority:
148
- p0: A
149
- p1: B
150
- p2: C
151
- coverage_gaps: [] # List any ACs without tests
152
- ```
153
-
154
- ### Output 3: Trace References
155
-
156
- Print for use by trace-requirements task:
157
-
158
- ```text
159
- Test design matrix: qa.qaLocation/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md
160
- P0 tests identified: {count}
161
- ```
162
-
163
- ## Quality Checklist
164
-
165
- Before finalizing, verify:
166
-
167
- - [ ] Every AC has test coverage
168
- - [ ] Test levels are appropriate (not over-testing)
169
- - [ ] No duplicate coverage across levels
170
- - [ ] Priorities align with business risk
171
- - [ ] Test IDs follow naming convention
172
- - [ ] Scenarios are atomic and independent
173
-
174
- ## Key Principles
175
-
176
- - **Shift left**: Prefer unit over integration, integration over E2E
177
- - **Risk-based**: Focus on what could go wrong
178
- - **Efficient coverage**: Test once at the right level
179
- - **Maintainability**: Consider long-term test maintenance
180
- - **Fast feedback**: Quick tests run first
@@ -1,270 +0,0 @@
1
- # /trace-requirements Task
2
-
3
- When this command is used, execute the following task:
4
-
5
- <!-- Powered by BMAD™ Core -->
6
-
7
- # trace-requirements
8
-
9
- Map story requirements to test cases using Given-When-Then patterns for comprehensive traceability.
10
-
11
- ## Purpose
12
-
13
- Create a requirements traceability matrix that ensures every acceptance criterion has corresponding test coverage. This task helps identify gaps in testing and ensures all requirements are validated.
14
-
15
- **IMPORTANT**: Given-When-Then is used here for documenting the mapping between requirements and tests, NOT for writing the actual test code. Tests should follow your project's testing standards (no BDD syntax in test code).
16
-
17
- ## Prerequisites
18
-
19
- - Story file with clear acceptance criteria
20
- - Access to test files or test specifications
21
- - Understanding of the implementation
22
-
23
- ## Traceability Process
24
-
25
- ### 1. Extract Requirements
26
-
27
- Identify all testable requirements from:
28
-
29
- - Acceptance Criteria (primary source)
30
- - User story statement
31
- - Tasks/subtasks with specific behaviors
32
- - Non-functional requirements mentioned
33
- - Edge cases documented
34
-
35
- ### 2. Map to Test Cases
36
-
37
- For each requirement, document which tests validate it. Use Given-When-Then to describe what the test validates (not how it's written):
38
-
39
- ```yaml
40
- requirement: 'AC1: User can login with valid credentials'
41
- test_mappings:
42
- - test_file: 'auth/login.test.ts'
43
- test_case: 'should successfully login with valid email and password'
44
- # Given-When-Then describes WHAT the test validates, not HOW it's coded
45
- given: 'A registered user with valid credentials'
46
- when: 'They submit the login form'
47
- then: 'They are redirected to dashboard and session is created'
48
- coverage: full
49
-
50
- - test_file: 'e2e/auth-flow.test.ts'
51
- test_case: 'complete login flow'
52
- given: 'User on login page'
53
- when: 'Entering valid credentials and submitting'
54
- then: 'Dashboard loads with user data'
55
- coverage: integration
56
- ```
57
-
58
- ### 3. Coverage Analysis
59
-
60
- Evaluate coverage for each requirement:
61
-
62
- **Coverage Levels:**
63
-
64
- - `full`: Requirement completely tested
65
- - `partial`: Some aspects tested, gaps exist
66
- - `none`: No test coverage found
67
- - `integration`: Covered in integration/e2e tests only
68
- - `unit`: Covered in unit tests only
69
-
70
- ### 4. Gap Identification
71
-
72
- Document any gaps found:
73
-
74
- ```yaml
75
- coverage_gaps:
76
- - requirement: 'AC3: Password reset email sent within 60 seconds'
77
- gap: 'No test for email delivery timing'
78
- severity: medium
79
- suggested_test:
80
- type: integration
81
- description: 'Test email service SLA compliance'
82
-
83
- - requirement: 'AC5: Support 1000 concurrent users'
84
- gap: 'No load testing implemented'
85
- severity: high
86
- suggested_test:
87
- type: performance
88
- description: 'Load test with 1000 concurrent connections'
89
- ```
90
-
91
- ## Outputs
92
-
93
- ### Output 1: Gate YAML Block
94
-
95
- **Generate for pasting into gate file under `trace`:**
96
-
97
- ```yaml
98
- trace:
99
- totals:
100
- requirements: X
101
- full: Y
102
- partial: Z
103
- none: W
104
- planning_ref: 'qa.qaLocation/assessments/{epic}.{story}-test-design-{YYYYMMDD}.md'
105
- uncovered:
106
- - ac: 'AC3'
107
- reason: 'No test found for password reset timing'
108
- notes: 'See qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md'
109
- ```
110
-
111
- ### Output 2: Traceability Report
112
-
113
- **Save to:** `qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md`
114
-
115
- Create a traceability report with:
116
-
117
- ```markdown
118
- # Requirements Traceability Matrix
119
-
120
- ## Story: {epic}.{story} - {title}
121
-
122
- ### Coverage Summary
123
-
124
- - Total Requirements: X
125
- - Fully Covered: Y (Z%)
126
- - Partially Covered: A (B%)
127
- - Not Covered: C (D%)
128
-
129
- ### Requirement Mappings
130
-
131
- #### AC1: {Acceptance Criterion 1}
132
-
133
- **Coverage: FULL**
134
-
135
- Given-When-Then Mappings:
136
-
137
- - **Unit Test**: `auth.service.test.ts::validateCredentials`
138
- - Given: Valid user credentials
139
- - When: Validation method called
140
- - Then: Returns true with user object
141
-
142
- - **Integration Test**: `auth.integration.test.ts::loginFlow`
143
- - Given: User with valid account
144
- - When: Login API called
145
- - Then: JWT token returned and session created
146
-
147
- #### AC2: {Acceptance Criterion 2}
148
-
149
- **Coverage: PARTIAL**
150
-
151
- [Continue for all ACs...]
152
-
153
- ### Critical Gaps
154
-
155
- 1. **Performance Requirements**
156
- - Gap: No load testing for concurrent users
157
- - Risk: High - Could fail under production load
158
- - Action: Implement load tests using k6 or similar
159
-
160
- 2. **Security Requirements**
161
- - Gap: Rate limiting not tested
162
- - Risk: Medium - Potential DoS vulnerability
163
- - Action: Add rate limit tests to integration suite
164
-
165
- ### Test Design Recommendations
166
-
167
- Based on gaps identified, recommend:
168
-
169
- 1. Additional test scenarios needed
170
- 2. Test types to implement (unit/integration/e2e/performance)
171
- 3. Test data requirements
172
- 4. Mock/stub strategies
173
-
174
- ### Risk Assessment
175
-
176
- - **High Risk**: Requirements with no coverage
177
- - **Medium Risk**: Requirements with only partial coverage
178
- - **Low Risk**: Requirements with full unit + integration coverage
179
- ```
180
-
181
- ## Traceability Best Practices
182
-
183
- ### Given-When-Then for Mapping (Not Test Code)
184
-
185
- Use Given-When-Then to document what each test validates:
186
-
187
- **Given**: The initial context the test sets up
188
-
189
- - What state/data the test prepares
190
- - User context being simulated
191
- - System preconditions
192
-
193
- **When**: The action the test performs
194
-
195
- - What the test executes
196
- - API calls or user actions tested
197
- - Events triggered
198
-
199
- **Then**: What the test asserts
200
-
201
- - Expected outcomes verified
202
- - State changes checked
203
- - Values validated
204
-
205
- **Note**: This is for documentation only. Actual test code follows your project's standards (e.g., describe/it blocks, no BDD syntax).
206
-
207
- ### Coverage Priority
208
-
209
- Prioritize coverage based on:
210
-
211
- 1. Critical business flows
212
- 2. Security-related requirements
213
- 3. Data integrity requirements
214
- 4. User-facing features
215
- 5. Performance SLAs
216
-
217
- ### Test Granularity
218
-
219
- Map at appropriate levels:
220
-
221
- - Unit tests for business logic
222
- - Integration tests for component interaction
223
- - E2E tests for user journeys
224
- - Performance tests for NFRs
225
-
226
- ## Quality Indicators
227
-
228
- Good traceability shows:
229
-
230
- - Every AC has at least one test
231
- - Critical paths have multiple test levels
232
- - Edge cases are explicitly covered
233
- - NFRs have appropriate test types
234
- - Clear Given-When-Then for each test
235
-
236
- ## Red Flags
237
-
238
- Watch for:
239
-
240
- - ACs with no test coverage
241
- - Tests that don't map to requirements
242
- - Vague test descriptions
243
- - Missing edge case coverage
244
- - NFRs without specific tests
245
-
246
- ## Integration with Gates
247
-
248
- This traceability feeds into quality gates:
249
-
250
- - Critical gaps → FAIL
251
- - Minor gaps → CONCERNS
252
- - Missing P0 tests from test-design → CONCERNS
253
-
254
- ### Output 3: Story Hook Line
255
-
256
- **Print this line for review task to quote:**
257
-
258
- ```text
259
- Trace matrix: qa.qaLocation/assessments/{epic}.{story}-trace-{YYYYMMDD}.md
260
- ```
261
-
262
- - Full coverage → PASS contribution
263
-
264
- ## Key Principles
265
-
266
- - Every requirement must be testable
267
- - Use Given-When-Then for clarity
268
- - Identify both presence and absence
269
- - Prioritize based on risk
270
- - Make recommendations actionable
@@ -1,140 +0,0 @@
1
- # /validate-next-story Task
2
-
3
- When this command is used, execute the following task:
4
-
5
- <!-- Powered by BMAD™ Core -->
6
-
7
- # Validate Next Story Task
8
-
9
- ## Purpose
10
-
11
- To comprehensively validate a story draft before implementation begins, ensuring it is complete, accurate, and provides sufficient context for successful development. This task identifies issues and gaps that need to be addressed, preventing hallucinations and ensuring implementation readiness.
12
-
13
- ## SEQUENTIAL Task Execution (Do not proceed until current Task is complete)
14
-
15
- ### 0. Load Core Configuration and Inputs
16
-
17
- - Load `.bmad-core/core-config.yaml`
18
- - If the file does not exist, HALT and inform the user: "core-config.yaml not found. This file is required for story validation."
19
- - Extract key configurations: `devStoryLocation`, `prd.*`, `architecture.*`
20
- - Identify and load the following inputs:
21
- - **Story file**: The drafted story to validate (provided by user or discovered in `devStoryLocation`)
22
- - **Parent epic**: The epic containing this story's requirements
23
- - **Architecture documents**: Based on configuration (sharded or monolithic)
24
- - **Story template**: `bmad-core/templates/story-tmpl.md` for completeness validation
25
-
26
- ### 1. Template Completeness Validation
27
-
28
- - Load `.bmad-core/templates/story-tmpl.yaml` and extract all section headings from the template
29
- - **Missing sections check**: Compare story sections against template sections to verify all required sections are present
30
- - **Placeholder validation**: Ensure no template placeholders remain unfilled (e.g., `{{EpicNum}}`, `{{role}}`, `_TBD_`)
31
- - **Agent section verification**: Confirm all sections from template exist for future agent use
32
- - **Structure compliance**: Verify story follows template structure and formatting
33
-
34
- ### 2. File Structure and Source Tree Validation
35
-
36
- - **File paths clarity**: Are new/existing files to be created/modified clearly specified?
37
- - **Source tree relevance**: Is relevant project structure included in Dev Notes?
38
- - **Directory structure**: Are new directories/components properly located according to project structure?
39
- - **File creation sequence**: Do tasks specify where files should be created in logical order?
40
- - **Path accuracy**: Are file paths consistent with project structure from architecture docs?
41
-
42
- ### 3. UI/Frontend Completeness Validation (if applicable)
43
-
44
- - **Component specifications**: Are UI components sufficiently detailed for implementation?
45
- - **Styling/design guidance**: Is visual implementation guidance clear?
46
- - **User interaction flows**: Are UX patterns and behaviors specified?
47
- - **Responsive/accessibility**: Are these considerations addressed if required?
48
- - **Integration points**: Are frontend-backend integration points clear?
49
-
50
- ### 4. Acceptance Criteria Satisfaction Assessment
51
-
52
- - **AC coverage**: Will all acceptance criteria be satisfied by the listed tasks?
53
- - **AC testability**: Are acceptance criteria measurable and verifiable?
54
- - **Missing scenarios**: Are edge cases or error conditions covered?
55
- - **Success definition**: Is "done" clearly defined for each AC?
56
- - **Task-AC mapping**: Are tasks properly linked to specific acceptance criteria?
57
-
58
- ### 5. Validation and Testing Instructions Review
59
-
60
- - **Test approach clarity**: Are testing methods clearly specified?
61
- - **Test scenarios**: Are key test cases identified?
62
- - **Validation steps**: Are acceptance criteria validation steps clear?
63
- - **Testing tools/frameworks**: Are required testing tools specified?
64
- - **Test data requirements**: Are test data needs identified?
65
-
66
- ### 6. Security Considerations Assessment (if applicable)
67
-
68
- - **Security requirements**: Are security needs identified and addressed?
69
- - **Authentication/authorization**: Are access controls specified?
70
- - **Data protection**: Are sensitive data handling requirements clear?
71
- - **Vulnerability prevention**: Are common security issues addressed?
72
- - **Compliance requirements**: Are regulatory/compliance needs addressed?
73
-
74
- ### 7. Tasks/Subtasks Sequence Validation
75
-
76
- - **Logical order**: Do tasks follow proper implementation sequence?
77
- - **Dependencies**: Are task dependencies clear and correct?
78
- - **Granularity**: Are tasks appropriately sized and actionable?
79
- - **Completeness**: Do tasks cover all requirements and acceptance criteria?
80
- - **Blocking issues**: Are there any tasks that would block others?
81
-
82
- ### 8. Anti-Hallucination Verification
83
-
84
- - **Source verification**: Every technical claim must be traceable to source documents
85
- - **Architecture alignment**: Dev Notes content matches architecture specifications
86
- - **No invented details**: Flag any technical decisions not supported by source documents
87
- - **Reference accuracy**: Verify all source references are correct and accessible
88
- - **Fact checking**: Cross-reference claims against epic and architecture documents
89
-
90
- ### 9. Dev Agent Implementation Readiness
91
-
92
- - **Self-contained context**: Can the story be implemented without reading external docs?
93
- - **Clear instructions**: Are implementation steps unambiguous?
94
- - **Complete technical context**: Are all required technical details present in Dev Notes?
95
- - **Missing information**: Identify any critical information gaps
96
- - **Actionability**: Are all tasks actionable by a development agent?
97
-
98
- ### 10. Generate Validation Report
99
-
100
- Provide a structured validation report including:
101
-
102
- #### Template Compliance Issues
103
-
104
- - Missing sections from story template
105
- - Unfilled placeholders or template variables
106
- - Structural formatting issues
107
-
108
- #### Critical Issues (Must Fix - Story Blocked)
109
-
110
- - Missing essential information for implementation
111
- - Inaccurate or unverifiable technical claims
112
- - Incomplete acceptance criteria coverage
113
- - Missing required sections
114
-
115
- #### Should-Fix Issues (Important Quality Improvements)
116
-
117
- - Unclear implementation guidance
118
- - Missing security considerations
119
- - Task sequencing problems
120
- - Incomplete testing instructions
121
-
122
- #### Nice-to-Have Improvements (Optional Enhancements)
123
-
124
- - Additional context that would help implementation
125
- - Clarifications that would improve efficiency
126
- - Documentation improvements
127
-
128
- #### Anti-Hallucination Findings
129
-
130
- - Unverifiable technical claims
131
- - Missing source references
132
- - Inconsistencies with architecture documents
133
- - Invented libraries, patterns, or standards
134
-
135
- #### Final Assessment
136
-
137
- - **GO**: Story is ready for implementation
138
- - **NO-GO**: Story requires fixes before implementation
139
- - **Implementation Readiness Score**: 1-10 scale
140
- - **Confidence Level**: High/Medium/Low for successful implementation
@@ -1,73 +0,0 @@
1
- # /ux-expert Command
2
-
3
- When this command is used, adopt the following agent persona:
4
-
5
- <!-- Powered by BMAD™ Core -->
6
-
7
- # ux-expert
8
-
9
- ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
10
-
11
- CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
12
-
13
- ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
14
-
15
- ```yaml
16
- IDE-FILE-RESOLUTION:
17
- - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
18
- - Dependencies map to .bmad-core/{type}/{name}
19
- - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
20
- - Example: create-doc.md → .bmad-core/tasks/create-doc.md
21
- - IMPORTANT: Only load these files when user requests specific command execution
22
- REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
23
- activation-instructions:
24
- - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
25
- - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
26
- - STEP 3: Load and read `.bmad-core/core-config.yaml` (project configuration) before any greeting
27
- - STEP 4: Greet user with your name/role and immediately run `*help` to display available commands
28
- - DO NOT: Load any other agent files during activation
29
- - ONLY load dependency files when user selects them for execution via command or request of a task
30
- - The agent.customization field ALWAYS takes precedence over any conflicting instructions
31
- - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
32
- - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
33
- - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
34
- - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
35
- - STAY IN CHARACTER!
36
- - CRITICAL: On activation, ONLY greet user, auto-run `*help`, and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
37
- agent:
38
- name: Sally
39
- id: ux-expert
40
- title: UX Expert
41
- icon: 🎨
42
- whenToUse: Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization
43
- customization: null
44
- persona:
45
- role: User Experience Designer & UI Specialist
46
- style: Empathetic, creative, detail-oriented, user-obsessed, data-informed
47
- identity: UX Expert specializing in user experience design and creating intuitive interfaces
48
- focus: User research, interaction design, visual design, accessibility, AI-powered UI generation
49
- core_principles:
50
- - User-Centric above all - Every design decision must serve user needs
51
- - Simplicity Through Iteration - Start simple, refine based on feedback
52
- - Delight in the Details - Thoughtful micro-interactions create memorable experiences
53
- - Design for Real Scenarios - Consider edge cases, errors, and loading states
54
- - Collaborate, Don't Dictate - Best solutions emerge from cross-functional work
55
- - You have a keen eye for detail and a deep empathy for users.
56
- - You're particularly skilled at translating user needs into beautiful, functional designs.
57
- - You can craft effective prompts for AI UI generation tools like v0, or Lovable.
58
- # All commands require * prefix when used (e.g., *help)
59
- commands:
60
- - help: Show numbered list of the following commands to allow selection
61
- - create-front-end-spec: run task create-doc.md with template front-end-spec-tmpl.yaml
62
- - generate-ui-prompt: Run task generate-ai-frontend-prompt.md
63
- - exit: Say goodbye as the UX Expert, and then abandon inhabiting this persona
64
- dependencies:
65
- data:
66
- - technical-preferences.md
67
- tasks:
68
- - create-doc.md
69
- - execute-checklist.md
70
- - generate-ai-frontend-prompt.md
71
- templates:
72
- - front-end-spec-tmpl.yaml
73
- ```
@@ -1 +0,0 @@
1
- 20251115
@@ -1 +0,0 @@
1
- /home/fire/.claude/piper-voices
File without changes