bmad-method 4.37.0-beta.1 → 4.37.0-beta.2
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.
- package/.releaserc.json +4 -2
- package/CHANGELOG.md +2 -15
- package/bmad-core/agents/analyst.md +1 -1
- package/bmad-core/agents/architect.md +3 -2
- package/bmad-core/agents/bmad-master.md +1 -0
- package/bmad-core/agents/bmad-orchestrator.md +10 -9
- package/bmad-core/agents/dev.md +10 -9
- package/bmad-core/agents/po.md +1 -1
- package/bmad-core/agents/qa.md +1 -1
- package/bmad-core/agents/sm.md +1 -1
- package/bmad-core/agents/ux-expert.md +1 -1
- package/bmad-core/checklists/architect-checklist.md +5 -0
- package/bmad-core/checklists/pm-checklist.md +5 -0
- package/bmad-core/checklists/po-master-checklist.md +9 -0
- package/bmad-core/checklists/story-dod-checklist.md +7 -0
- package/bmad-core/checklists/story-draft-checklist.md +3 -0
- package/bmad-core/data/bmad-kb.md +2 -5
- package/bmad-core/data/elicitation-methods.md +0 -20
- package/bmad-core/tasks/create-brownfield-story.md +3 -11
- package/bmad-core/tasks/create-deep-research-prompt.md +11 -0
- package/bmad-core/tasks/document-project.md +13 -15
- package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
- package/bmad-core/tasks/index-docs.md +6 -0
- package/bmad-core/tasks/kb-mode-interaction.md +3 -3
- package/bmad-core/tasks/review-story.md +1 -10
- package/bmad-core/tasks/shard-doc.md +2 -0
- package/common/tasks/execute-checklist.md +7 -0
- package/docs/working-in-the-brownfield.md +1 -1
- package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +14 -14
- package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +4 -0
- package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +5 -3
- package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +1 -0
- package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +18 -0
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +5 -0
- package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +8 -0
- package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +7 -0
- package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +4 -0
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +1 -0
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +10 -0
- package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +18 -0
- package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +3 -0
- package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +1 -0
- package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +1 -0
- package/package.json +1 -1
- package/tools/installer/package.json +3 -2
package/.releaserc.json
CHANGED
package/CHANGELOG.md
CHANGED
|
@@ -1,22 +1,9 @@
|
|
|
1
|
-
# [4.37.0-beta.1](https://github.com/bmadcode/BMAD-METHOD/compare/v4.36.2...v4.37.0-beta.1) (2025-08-16)
|
|
2
|
-
|
|
3
|
-
|
|
4
|
-
### Bug Fixes
|
|
5
|
-
|
|
6
|
-
* **docs:** fix broken link in GUIDING-PRINCIPLES.md ([#428](https://github.com/bmadcode/BMAD-METHOD/issues/428)) ([3efcfd5](https://github.com/bmadcode/BMAD-METHOD/commit/3efcfd54d47f4c3cdc6527a438f86fc615a8700c))
|
|
7
|
-
* remove git plugin to resolve branch protection conflicts ([8e324f6](https://github.com/bmadcode/BMAD-METHOD/commit/8e324f60b0dad2f385ff62bd63615afc73c575f8))
|
|
8
|
-
|
|
9
|
-
|
|
10
|
-
### Features
|
|
11
|
-
|
|
12
|
-
* implement dual NPM publishing strategy ([d92ba83](https://github.com/bmadcode/BMAD-METHOD/commit/d92ba835fa6e720059b943e352a03435f2a704c9))
|
|
13
|
-
* install Cursor rules to subdirectory ([#438](https://github.com/bmadcode/BMAD-METHOD/issues/438)) ([d563266](https://github.com/bmadcode/BMAD-METHOD/commit/d563266b9738b5d3c5ec1e31ab683aad517e2604)), closes [#376](https://github.com/bmadcode/BMAD-METHOD/issues/376) [#376](https://github.com/bmadcode/BMAD-METHOD/issues/376)
|
|
14
|
-
|
|
15
1
|
## [4.36.2](https://github.com/bmadcode/BMAD-METHOD/compare/v4.36.1...v4.36.2) (2025-08-10)
|
|
16
2
|
|
|
3
|
+
|
|
17
4
|
### Bug Fixes
|
|
18
5
|
|
|
19
|
-
|
|
6
|
+
* align installer dependencies with root package versions for ESM compatibility ([#420](https://github.com/bmadcode/BMAD-METHOD/issues/420)) ([3f6b674](https://github.com/bmadcode/BMAD-METHOD/commit/3f6b67443d61ae6add98656374bed27da4704644))
|
|
20
7
|
|
|
21
8
|
## [4.36.1](https://github.com/bmadcode/BMAD-METHOD/compare/v4.36.0...v4.36.1) (2025-08-09)
|
|
22
9
|
|
|
@@ -52,7 +52,7 @@ persona:
|
|
|
52
52
|
- Integrity of Information - Ensure accurate sourcing and representation
|
|
53
53
|
- Numbered Options Protocol - Always use numbered lists for selections
|
|
54
54
|
# All commands require * prefix when used (e.g., *help)
|
|
55
|
-
commands:
|
|
55
|
+
commands:
|
|
56
56
|
- help: Show numbered list of the following commands to allow selection
|
|
57
57
|
- create-project-brief: use task create-doc with project-brief-tmpl.yaml
|
|
58
58
|
- perform-market-research: use task create-doc with market-research-tmpl.yaml
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
# architect
|
|
2
2
|
|
|
3
|
+
|
|
3
4
|
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.
|
|
4
5
|
|
|
5
6
|
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:
|
|
@@ -52,12 +53,12 @@ persona:
|
|
|
52
53
|
- Cost-Conscious Engineering - Balance technical ideals with financial reality
|
|
53
54
|
- Living Architecture - Design for change and adaptation
|
|
54
55
|
# All commands require * prefix when used (e.g., *help)
|
|
55
|
-
commands:
|
|
56
|
+
commands:
|
|
56
57
|
- help: Show numbered list of the following commands to allow selection
|
|
57
58
|
- create-full-stack-architecture: use create-doc with fullstack-architecture-tmpl.yaml
|
|
58
59
|
- create-backend-architecture: use create-doc with architecture-tmpl.yaml
|
|
59
60
|
- create-front-end-architecture: use create-doc with front-end-architecture-tmpl.yaml
|
|
60
|
-
- create-brownfield-architecture:
|
|
61
|
+
- create-brownfield-architecture: use create-doc with brownfield-architecture-tmpl.yaml
|
|
61
62
|
- doc-out: Output full document to current destination file
|
|
62
63
|
- document-project: execute the task document-project.md
|
|
63
64
|
- execute-checklist {checklist}: Run task execute-checklist (default->architect-checklist)
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
# BMad Master
|
|
2
2
|
|
|
3
|
+
|
|
3
4
|
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.
|
|
4
5
|
|
|
5
6
|
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:
|
|
@@ -1,5 +1,6 @@
|
|
|
1
1
|
# BMad Web Orchestrator
|
|
2
2
|
|
|
3
|
+
|
|
3
4
|
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.
|
|
4
5
|
|
|
5
6
|
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:
|
|
@@ -51,9 +52,9 @@ persona:
|
|
|
51
52
|
- Always use numbered lists for choices
|
|
52
53
|
- Process commands starting with * immediately
|
|
53
54
|
- Always remind users that commands require * prefix
|
|
54
|
-
commands:
|
|
55
|
+
commands: # All commands require * prefix when used (e.g., *help, *agent pm)
|
|
55
56
|
help: Show this guide with available agents and workflows
|
|
56
|
-
chat-mode: Start conversational mode for detailed assistance
|
|
57
|
+
chat-mode: Start conversational mode for detailed assistance
|
|
57
58
|
kb-mode: Load full BMad knowledge base
|
|
58
59
|
status: Show current context, active agent, and progress
|
|
59
60
|
agent: Transform into a specialized agent (list if name not specified)
|
|
@@ -71,42 +72,42 @@ commands: # All commands require * prefix when used (e.g., *help, *agent pm)
|
|
|
71
72
|
help-display-template: |
|
|
72
73
|
=== BMad Orchestrator Commands ===
|
|
73
74
|
All commands must start with * (asterisk)
|
|
74
|
-
|
|
75
|
+
|
|
75
76
|
Core Commands:
|
|
76
77
|
*help ............... Show this guide
|
|
77
78
|
*chat-mode .......... Start conversational mode for detailed assistance
|
|
78
79
|
*kb-mode ............ Load full BMad knowledge base
|
|
79
80
|
*status ............. Show current context, active agent, and progress
|
|
80
81
|
*exit ............... Return to BMad or exit session
|
|
81
|
-
|
|
82
|
+
|
|
82
83
|
Agent & Task Management:
|
|
83
84
|
*agent [name] ....... Transform into specialized agent (list if no name)
|
|
84
85
|
*task [name] ........ Run specific task (list if no name, requires agent)
|
|
85
86
|
*checklist [name] ... Execute checklist (list if no name, requires agent)
|
|
86
|
-
|
|
87
|
+
|
|
87
88
|
Workflow Commands:
|
|
88
89
|
*workflow [name] .... Start specific workflow (list if no name)
|
|
89
90
|
*workflow-guidance .. Get personalized help selecting the right workflow
|
|
90
91
|
*plan ............... Create detailed workflow plan before starting
|
|
91
92
|
*plan-status ........ Show current workflow plan progress
|
|
92
93
|
*plan-update ........ Update workflow plan status
|
|
93
|
-
|
|
94
|
+
|
|
94
95
|
Other Commands:
|
|
95
96
|
*yolo ............... Toggle skip confirmations mode
|
|
96
97
|
*party-mode ......... Group chat with all agents
|
|
97
98
|
*doc-out ............ Output full document
|
|
98
|
-
|
|
99
|
+
|
|
99
100
|
=== Available Specialist Agents ===
|
|
100
101
|
[Dynamically list each agent in bundle with format:
|
|
101
102
|
*agent {id}: {title}
|
|
102
103
|
When to use: {whenToUse}
|
|
103
104
|
Key deliverables: {main outputs/documents}]
|
|
104
|
-
|
|
105
|
+
|
|
105
106
|
=== Available Workflows ===
|
|
106
107
|
[Dynamically list each workflow in bundle with format:
|
|
107
108
|
*workflow {id}: {name}
|
|
108
109
|
Purpose: {description}]
|
|
109
|
-
|
|
110
|
+
|
|
110
111
|
💡 Tip: Each agent has unique tasks, templates, and checklists. Switch to an agent to access their capabilities!
|
|
111
112
|
|
|
112
113
|
fuzzy-matching:
|
package/bmad-core/agents/dev.md
CHANGED
|
@@ -38,6 +38,7 @@ agent:
|
|
|
38
38
|
whenToUse: "Use for code implementation, debugging, refactoring, and development best practices"
|
|
39
39
|
customization:
|
|
40
40
|
|
|
41
|
+
|
|
41
42
|
persona:
|
|
42
43
|
role: Expert Senior Software Engineer & Implementation Specialist
|
|
43
44
|
style: Extremely concise, pragmatic, detail-oriented, solution-focused
|
|
@@ -51,20 +52,20 @@ core_principles:
|
|
|
51
52
|
- Numbered Options - Always use numbered lists when presenting choices to the user
|
|
52
53
|
|
|
53
54
|
# All commands require * prefix when used (e.g., *help)
|
|
54
|
-
commands:
|
|
55
|
+
commands:
|
|
55
56
|
- help: Show numbered list of the following commands to allow selection
|
|
56
57
|
- run-tests: Execute linting and tests
|
|
57
58
|
- explain: teach me what and why you did whatever you just did in detail so I can learn. Explain to me as if you were training a junior engineer.
|
|
58
59
|
- exit: Say goodbye as the Developer, and then abandon inhabiting this persona
|
|
59
60
|
- develop-story:
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
61
|
+
- order-of-execution: "Read (first or next) task→Implement Task and its subtasks→Write tests→Execute validations→Only if ALL pass, then update the task checkbox with [x]→Update story section File List to ensure it lists and new or modified or deleted source file→repeat order-of-execution until complete"
|
|
62
|
+
- story-file-updates-ONLY:
|
|
63
|
+
- CRITICAL: ONLY UPDATE THE STORY FILE WITH UPDATES TO SECTIONS INDICATED BELOW. DO NOT MODIFY ANY OTHER SECTIONS.
|
|
64
|
+
- CRITICAL: You are ONLY authorized to edit these specific sections of story files - Tasks / Subtasks Checkboxes, Dev Agent Record section and all its subsections, Agent Model Used, Debug Log References, Completion Notes List, File List, Change Log, Status
|
|
65
|
+
- CRITICAL: DO NOT modify Status, Story, Acceptance Criteria, Dev Notes, Testing sections, or any other sections not listed above
|
|
66
|
+
- blocking: "HALT for: Unapproved deps needed, confirm with user | Ambiguous after story check | 3 failures attempting to implement or fix something repeatedly | Missing config | Failing regression"
|
|
67
|
+
- ready-for-review: "Code matches requirements + All validations pass + Follows standards + File List complete"
|
|
68
|
+
- completion: "All Tasks and Subtasks marked [x] and have tests→Validations and full regression passes (DON'T BE LAZY, EXECUTE ALL TESTS and CONFIRM)→Ensure File List is Complete→run the task execute-checklist for the checklist story-dod-checklist→set story status: 'Ready for Review'→HALT"
|
|
68
69
|
|
|
69
70
|
dependencies:
|
|
70
71
|
tasks:
|
package/bmad-core/agents/po.md
CHANGED
|
@@ -51,7 +51,7 @@ persona:
|
|
|
51
51
|
- Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals
|
|
52
52
|
- Documentation Ecosystem Integrity - Maintain consistency across all documents
|
|
53
53
|
# All commands require * prefix when used (e.g., *help)
|
|
54
|
-
commands:
|
|
54
|
+
commands:
|
|
55
55
|
- help: Show numbered list of the following commands to allow selection
|
|
56
56
|
- execute-checklist-po: Run task execute-checklist (checklist po-master-checklist)
|
|
57
57
|
- shard-doc {document} {destination}: run the task shard-doc against the optionally provided document to the specified destination
|
package/bmad-core/agents/qa.md
CHANGED
|
@@ -55,7 +55,7 @@ story-file-permissions:
|
|
|
55
55
|
- CRITICAL: DO NOT modify any other sections including Status, Story, Acceptance Criteria, Tasks/Subtasks, Dev Notes, Testing, Dev Agent Record, Change Log, or any other sections
|
|
56
56
|
- CRITICAL: Your updates must be limited to appending your review results in the QA Results section only
|
|
57
57
|
# All commands require * prefix when used (e.g., *help)
|
|
58
|
-
commands:
|
|
58
|
+
commands:
|
|
59
59
|
- help: Show numbered list of the following commands to allow selection
|
|
60
60
|
- review {story}: execute the task review-story for the highest sequence story in docs/stories unless another is specified - keep any specified technical-preferences in mind as needed
|
|
61
61
|
- exit: Say goodbye as the QA Engineer, and then abandon inhabiting this persona
|
package/bmad-core/agents/sm.md
CHANGED
|
@@ -44,7 +44,7 @@ persona:
|
|
|
44
44
|
- Will ensure all information comes from the PRD and Architecture to guide the dumb dev agent
|
|
45
45
|
- You are NOT allowed to implement stories or modify code EVER!
|
|
46
46
|
# All commands require * prefix when used (e.g., *help)
|
|
47
|
-
commands:
|
|
47
|
+
commands:
|
|
48
48
|
- help: Show numbered list of the following commands to allow selection
|
|
49
49
|
- draft: Execute task create-next-story.md
|
|
50
50
|
- correct-course: Execute task correct-course.md
|
|
@@ -49,7 +49,7 @@ persona:
|
|
|
49
49
|
- You're particularly skilled at translating user needs into beautiful, functional designs.
|
|
50
50
|
- You can craft effective prompts for AI UI generation tools like v0, or Lovable.
|
|
51
51
|
# All commands require * prefix when used (e.g., *help)
|
|
52
|
-
commands:
|
|
52
|
+
commands:
|
|
53
53
|
- help: Show numbered list of the following commands to allow selection
|
|
54
54
|
- create-front-end-spec: run task create-doc.md with template front-end-spec-tmpl.yaml
|
|
55
55
|
- generate-ui-prompt: Run task generate-ai-frontend-prompt.md
|
|
@@ -403,28 +403,33 @@ Ask the user if they want to work through the checklist:
|
|
|
403
403
|
Now that you've completed the checklist, generate a comprehensive validation report that includes:
|
|
404
404
|
|
|
405
405
|
1. Executive Summary
|
|
406
|
+
|
|
406
407
|
- Overall architecture readiness (High/Medium/Low)
|
|
407
408
|
- Critical risks identified
|
|
408
409
|
- Key strengths of the architecture
|
|
409
410
|
- Project type (Full-stack/Frontend/Backend) and sections evaluated
|
|
410
411
|
|
|
411
412
|
2. Section Analysis
|
|
413
|
+
|
|
412
414
|
- Pass rate for each major section (percentage of items passed)
|
|
413
415
|
- Most concerning failures or gaps
|
|
414
416
|
- Sections requiring immediate attention
|
|
415
417
|
- Note any sections skipped due to project type
|
|
416
418
|
|
|
417
419
|
3. Risk Assessment
|
|
420
|
+
|
|
418
421
|
- Top 5 risks by severity
|
|
419
422
|
- Mitigation recommendations for each
|
|
420
423
|
- Timeline impact of addressing issues
|
|
421
424
|
|
|
422
425
|
4. Recommendations
|
|
426
|
+
|
|
423
427
|
- Must-fix items before development
|
|
424
428
|
- Should-fix items for better quality
|
|
425
429
|
- Nice-to-have improvements
|
|
426
430
|
|
|
427
431
|
5. AI Implementation Readiness
|
|
432
|
+
|
|
428
433
|
- Specific concerns for AI agent implementation
|
|
429
434
|
- Areas needing additional clarification
|
|
430
435
|
- Complexity hotspots to address
|
|
@@ -304,6 +304,7 @@ Ask the user if they want to work through the checklist:
|
|
|
304
304
|
Create a comprehensive validation report that includes:
|
|
305
305
|
|
|
306
306
|
1. Executive Summary
|
|
307
|
+
|
|
307
308
|
- Overall PRD completeness (percentage)
|
|
308
309
|
- MVP scope appropriateness (Too Large/Just Right/Too Small)
|
|
309
310
|
- Readiness for architecture phase (Ready/Nearly Ready/Not Ready)
|
|
@@ -311,22 +312,26 @@ Create a comprehensive validation report that includes:
|
|
|
311
312
|
|
|
312
313
|
2. Category Analysis Table
|
|
313
314
|
Fill in the actual table with:
|
|
315
|
+
|
|
314
316
|
- Status: PASS (90%+ complete), PARTIAL (60-89%), FAIL (<60%)
|
|
315
317
|
- Critical Issues: Specific problems that block progress
|
|
316
318
|
|
|
317
319
|
3. Top Issues by Priority
|
|
320
|
+
|
|
318
321
|
- BLOCKERS: Must fix before architect can proceed
|
|
319
322
|
- HIGH: Should fix for quality
|
|
320
323
|
- MEDIUM: Would improve clarity
|
|
321
324
|
- LOW: Nice to have
|
|
322
325
|
|
|
323
326
|
4. MVP Scope Assessment
|
|
327
|
+
|
|
324
328
|
- Features that might be cut for true MVP
|
|
325
329
|
- Missing features that are essential
|
|
326
330
|
- Complexity concerns
|
|
327
331
|
- Timeline realism
|
|
328
332
|
|
|
329
333
|
5. Technical Readiness
|
|
334
|
+
|
|
330
335
|
- Clarity of technical constraints
|
|
331
336
|
- Identified technical risks
|
|
332
337
|
- Areas needing architect investigation
|
|
@@ -8,10 +8,12 @@ PROJECT TYPE DETECTION:
|
|
|
8
8
|
First, determine the project type by checking:
|
|
9
9
|
|
|
10
10
|
1. Is this a GREENFIELD project (new from scratch)?
|
|
11
|
+
|
|
11
12
|
- Look for: New project initialization, no existing codebase references
|
|
12
13
|
- Check for: prd.md, architecture.md, new project setup stories
|
|
13
14
|
|
|
14
15
|
2. Is this a BROWNFIELD project (enhancing existing system)?
|
|
16
|
+
|
|
15
17
|
- Look for: References to existing codebase, enhancement/modification language
|
|
16
18
|
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
|
|
17
19
|
|
|
@@ -345,6 +347,7 @@ Ask the user if they want to work through the checklist:
|
|
|
345
347
|
Generate a comprehensive validation report that adapts to project type:
|
|
346
348
|
|
|
347
349
|
1. Executive Summary
|
|
350
|
+
|
|
348
351
|
- Project type: [Greenfield/Brownfield] with [UI/No UI]
|
|
349
352
|
- Overall readiness (percentage)
|
|
350
353
|
- Go/No-Go recommendation
|
|
@@ -354,36 +357,42 @@ Generate a comprehensive validation report that adapts to project type:
|
|
|
354
357
|
2. Project-Specific Analysis
|
|
355
358
|
|
|
356
359
|
FOR GREENFIELD:
|
|
360
|
+
|
|
357
361
|
- Setup completeness
|
|
358
362
|
- Dependency sequencing
|
|
359
363
|
- MVP scope appropriateness
|
|
360
364
|
- Development timeline feasibility
|
|
361
365
|
|
|
362
366
|
FOR BROWNFIELD:
|
|
367
|
+
|
|
363
368
|
- Integration risk level (High/Medium/Low)
|
|
364
369
|
- Existing system impact assessment
|
|
365
370
|
- Rollback readiness
|
|
366
371
|
- User disruption potential
|
|
367
372
|
|
|
368
373
|
3. Risk Assessment
|
|
374
|
+
|
|
369
375
|
- Top 5 risks by severity
|
|
370
376
|
- Mitigation recommendations
|
|
371
377
|
- Timeline impact of addressing issues
|
|
372
378
|
- [BROWNFIELD] Specific integration risks
|
|
373
379
|
|
|
374
380
|
4. MVP Completeness
|
|
381
|
+
|
|
375
382
|
- Core features coverage
|
|
376
383
|
- Missing essential functionality
|
|
377
384
|
- Scope creep identified
|
|
378
385
|
- True MVP vs over-engineering
|
|
379
386
|
|
|
380
387
|
5. Implementation Readiness
|
|
388
|
+
|
|
381
389
|
- Developer clarity score (1-10)
|
|
382
390
|
- Ambiguous requirements count
|
|
383
391
|
- Missing technical details
|
|
384
392
|
- [BROWNFIELD] Integration point clarity
|
|
385
393
|
|
|
386
394
|
6. Recommendations
|
|
395
|
+
|
|
387
396
|
- Must-fix before development
|
|
388
397
|
- Should-fix for quality
|
|
389
398
|
- Consider for improvement
|
|
@@ -25,12 +25,14 @@ The goal is quality delivery, not just checking boxes.]]
|
|
|
25
25
|
1. **Requirements Met:**
|
|
26
26
|
|
|
27
27
|
[[LLM: Be specific - list each requirement and whether it's complete]]
|
|
28
|
+
|
|
28
29
|
- [ ] All functional requirements specified in the story are implemented.
|
|
29
30
|
- [ ] All acceptance criteria defined in the story are met.
|
|
30
31
|
|
|
31
32
|
2. **Coding Standards & Project Structure:**
|
|
32
33
|
|
|
33
34
|
[[LLM: Code quality matters for maintainability. Check each item carefully]]
|
|
35
|
+
|
|
34
36
|
- [ ] All new/modified code strictly adheres to `Operational Guidelines`.
|
|
35
37
|
- [ ] All new/modified code aligns with `Project Structure` (file locations, naming, etc.).
|
|
36
38
|
- [ ] Adherence to `Tech Stack` for technologies/versions used (if story introduces or modifies tech usage).
|
|
@@ -42,6 +44,7 @@ The goal is quality delivery, not just checking boxes.]]
|
|
|
42
44
|
3. **Testing:**
|
|
43
45
|
|
|
44
46
|
[[LLM: Testing proves your code works. Be honest about test coverage]]
|
|
47
|
+
|
|
45
48
|
- [ ] All required unit tests as per the story and `Operational Guidelines` Testing Strategy are implemented.
|
|
46
49
|
- [ ] All required integration tests (if applicable) as per the story and `Operational Guidelines` Testing Strategy are implemented.
|
|
47
50
|
- [ ] All tests (unit, integration, E2E if applicable) pass successfully.
|
|
@@ -50,12 +53,14 @@ The goal is quality delivery, not just checking boxes.]]
|
|
|
50
53
|
4. **Functionality & Verification:**
|
|
51
54
|
|
|
52
55
|
[[LLM: Did you actually run and test your code? Be specific about what you tested]]
|
|
56
|
+
|
|
53
57
|
- [ ] Functionality has been manually verified by the developer (e.g., running the app locally, checking UI, testing API endpoints).
|
|
54
58
|
- [ ] Edge cases and potential error conditions considered and handled gracefully.
|
|
55
59
|
|
|
56
60
|
5. **Story Administration:**
|
|
57
61
|
|
|
58
62
|
[[LLM: Documentation helps the next developer. What should they know?]]
|
|
63
|
+
|
|
59
64
|
- [ ] All tasks within the story file are marked as complete.
|
|
60
65
|
- [ ] Any clarifications or decisions made during development are documented in the story file or linked appropriately.
|
|
61
66
|
- [ ] The story wrap up section has been completed with notes of changes or information relevant to the next story or overall project, the agent model that was primarily used during development, and the changelog of any changes is properly updated.
|
|
@@ -63,6 +68,7 @@ The goal is quality delivery, not just checking boxes.]]
|
|
|
63
68
|
6. **Dependencies, Build & Configuration:**
|
|
64
69
|
|
|
65
70
|
[[LLM: Build issues block everyone. Ensure everything compiles and runs cleanly]]
|
|
71
|
+
|
|
66
72
|
- [ ] Project builds successfully without errors.
|
|
67
73
|
- [ ] Project linting passes
|
|
68
74
|
- [ ] Any new dependencies added were either pre-approved in the story requirements OR explicitly approved by the user during development (approval documented in story file).
|
|
@@ -73,6 +79,7 @@ The goal is quality delivery, not just checking boxes.]]
|
|
|
73
79
|
7. **Documentation (If Applicable):**
|
|
74
80
|
|
|
75
81
|
[[LLM: Good documentation prevents future confusion. What needs explaining?]]
|
|
82
|
+
|
|
76
83
|
- [ ] Relevant inline code documentation (e.g., JSDoc, TSDoc, Python docstrings) for new public APIs or complex logic is complete.
|
|
77
84
|
- [ ] User-facing documentation updated, if changes impact users.
|
|
78
85
|
- [ ] Technical documentation (e.g., READMEs, system diagrams) updated if significant architectural changes were made.
|
|
@@ -117,16 +117,19 @@ Note: We don't need every file listed - just the important ones.]]
|
|
|
117
117
|
Generate a concise validation report:
|
|
118
118
|
|
|
119
119
|
1. Quick Summary
|
|
120
|
+
|
|
120
121
|
- Story readiness: READY / NEEDS REVISION / BLOCKED
|
|
121
122
|
- Clarity score (1-10)
|
|
122
123
|
- Major gaps identified
|
|
123
124
|
|
|
124
125
|
2. Fill in the validation table with:
|
|
126
|
+
|
|
125
127
|
- PASS: Requirements clearly met
|
|
126
128
|
- PARTIAL: Some gaps but workable
|
|
127
129
|
- FAIL: Critical information missing
|
|
128
130
|
|
|
129
131
|
3. Specific Issues (if any)
|
|
132
|
+
|
|
130
133
|
- List concrete problems to fix
|
|
131
134
|
- Suggest specific improvements
|
|
132
135
|
- Identify any blocking dependencies
|
|
@@ -542,7 +542,7 @@ Each status change requires user verification and approval before proceeding.
|
|
|
542
542
|
#### Greenfield Development
|
|
543
543
|
|
|
544
544
|
- Business analysis and market research
|
|
545
|
-
- Product requirements and feature definition
|
|
545
|
+
- Product requirements and feature definition
|
|
546
546
|
- System architecture and design
|
|
547
547
|
- Development execution
|
|
548
548
|
- Testing and deployment
|
|
@@ -651,11 +651,8 @@ Templates with Level 2 headings (`##`) can be automatically sharded:
|
|
|
651
651
|
|
|
652
652
|
```markdown
|
|
653
653
|
## Goals and Background Context
|
|
654
|
-
|
|
655
|
-
## Requirements
|
|
656
|
-
|
|
654
|
+
## Requirements
|
|
657
655
|
## User Interface Design Goals
|
|
658
|
-
|
|
659
656
|
## Success Metrics
|
|
660
657
|
```
|
|
661
658
|
|
|
@@ -3,19 +3,16 @@
|
|
|
3
3
|
## Core Reflective Methods
|
|
4
4
|
|
|
5
5
|
**Expand or Contract for Audience**
|
|
6
|
-
|
|
7
6
|
- Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
|
|
8
7
|
- Identify specific target audience if relevant
|
|
9
8
|
- Tailor content complexity and depth accordingly
|
|
10
9
|
|
|
11
10
|
**Explain Reasoning (CoT Step-by-Step)**
|
|
12
|
-
|
|
13
11
|
- Walk through the step-by-step thinking process
|
|
14
12
|
- Reveal underlying assumptions and decision points
|
|
15
13
|
- Show how conclusions were reached from current role's perspective
|
|
16
14
|
|
|
17
15
|
**Critique and Refine**
|
|
18
|
-
|
|
19
16
|
- Review output for flaws, inconsistencies, or improvement areas
|
|
20
17
|
- Identify specific weaknesses from role's expertise
|
|
21
18
|
- Suggest refined version reflecting domain knowledge
|
|
@@ -23,14 +20,12 @@
|
|
|
23
20
|
## Structural Analysis Methods
|
|
24
21
|
|
|
25
22
|
**Analyze Logical Flow and Dependencies**
|
|
26
|
-
|
|
27
23
|
- Examine content structure for logical progression
|
|
28
24
|
- Check internal consistency and coherence
|
|
29
25
|
- Identify and validate dependencies between elements
|
|
30
26
|
- Confirm effective ordering and sequencing
|
|
31
27
|
|
|
32
28
|
**Assess Alignment with Overall Goals**
|
|
33
|
-
|
|
34
29
|
- Evaluate content contribution to stated objectives
|
|
35
30
|
- Identify any misalignments or gaps
|
|
36
31
|
- Interpret alignment from specific role's perspective
|
|
@@ -39,14 +34,12 @@
|
|
|
39
34
|
## Risk and Challenge Methods
|
|
40
35
|
|
|
41
36
|
**Identify Potential Risks and Unforeseen Issues**
|
|
42
|
-
|
|
43
37
|
- Brainstorm potential risks from role's expertise
|
|
44
38
|
- Identify overlooked edge cases or scenarios
|
|
45
39
|
- Anticipate unintended consequences
|
|
46
40
|
- Highlight implementation challenges
|
|
47
41
|
|
|
48
42
|
**Challenge from Critical Perspective**
|
|
49
|
-
|
|
50
43
|
- Adopt critical stance on current content
|
|
51
44
|
- Play devil's advocate from specified viewpoint
|
|
52
45
|
- Argue against proposal highlighting weaknesses
|
|
@@ -55,14 +48,12 @@
|
|
|
55
48
|
## Creative Exploration Methods
|
|
56
49
|
|
|
57
50
|
**Tree of Thoughts Deep Dive**
|
|
58
|
-
|
|
59
51
|
- Break problem into discrete "thoughts" or intermediate steps
|
|
60
52
|
- Explore multiple reasoning paths simultaneously
|
|
61
53
|
- Use self-evaluation to classify each path as "sure", "likely", or "impossible"
|
|
62
54
|
- Apply search algorithms (BFS/DFS) to find optimal solution paths
|
|
63
55
|
|
|
64
56
|
**Hindsight is 20/20: The 'If Only...' Reflection**
|
|
65
|
-
|
|
66
57
|
- Imagine retrospective scenario based on current content
|
|
67
58
|
- Identify the one "if only we had known/done X..." insight
|
|
68
59
|
- Describe imagined consequences humorously or dramatically
|
|
@@ -71,7 +62,6 @@
|
|
|
71
62
|
## Multi-Persona Collaboration Methods
|
|
72
63
|
|
|
73
64
|
**Agile Team Perspective Shift**
|
|
74
|
-
|
|
75
65
|
- Rotate through different Scrum team member viewpoints
|
|
76
66
|
- Product Owner: Focus on user value and business impact
|
|
77
67
|
- Scrum Master: Examine process flow and team dynamics
|
|
@@ -79,14 +69,12 @@
|
|
|
79
69
|
- QA: Identify testing scenarios and quality concerns
|
|
80
70
|
|
|
81
71
|
**Stakeholder Round Table**
|
|
82
|
-
|
|
83
72
|
- Convene virtual meeting with multiple personas
|
|
84
73
|
- Each persona contributes unique perspective on content
|
|
85
74
|
- Identify conflicts and synergies between viewpoints
|
|
86
75
|
- Synthesize insights into actionable recommendations
|
|
87
76
|
|
|
88
77
|
**Meta-Prompting Analysis**
|
|
89
|
-
|
|
90
78
|
- Step back to analyze the structure and logic of current approach
|
|
91
79
|
- Question the format and methodology being used
|
|
92
80
|
- Suggest alternative frameworks or mental models
|
|
@@ -95,28 +83,24 @@
|
|
|
95
83
|
## Advanced 2025 Techniques
|
|
96
84
|
|
|
97
85
|
**Self-Consistency Validation**
|
|
98
|
-
|
|
99
86
|
- Generate multiple reasoning paths for same problem
|
|
100
87
|
- Compare consistency across different approaches
|
|
101
88
|
- Identify most reliable and robust solution
|
|
102
89
|
- Highlight areas where approaches diverge and why
|
|
103
90
|
|
|
104
91
|
**ReWOO (Reasoning Without Observation)**
|
|
105
|
-
|
|
106
92
|
- Separate parametric reasoning from tool-based actions
|
|
107
93
|
- Create reasoning plan without external dependencies
|
|
108
94
|
- Identify what can be solved through pure reasoning
|
|
109
95
|
- Optimize for efficiency and reduced token usage
|
|
110
96
|
|
|
111
97
|
**Persona-Pattern Hybrid**
|
|
112
|
-
|
|
113
98
|
- Combine specific role expertise with elicitation pattern
|
|
114
99
|
- Architect + Risk Analysis: Deep technical risk assessment
|
|
115
100
|
- UX Expert + User Journey: End-to-end experience critique
|
|
116
101
|
- PM + Stakeholder Analysis: Multi-perspective impact review
|
|
117
102
|
|
|
118
103
|
**Emergent Collaboration Discovery**
|
|
119
|
-
|
|
120
104
|
- Allow multiple perspectives to naturally emerge
|
|
121
105
|
- Identify unexpected insights from persona interactions
|
|
122
106
|
- Explore novel combinations of viewpoints
|
|
@@ -125,21 +109,18 @@
|
|
|
125
109
|
## Game-Based Elicitation Methods
|
|
126
110
|
|
|
127
111
|
**Red Team vs Blue Team**
|
|
128
|
-
|
|
129
112
|
- Red Team: Attack the proposal, find vulnerabilities
|
|
130
113
|
- Blue Team: Defend and strengthen the approach
|
|
131
114
|
- Competitive analysis reveals blind spots
|
|
132
115
|
- Results in more robust, battle-tested solutions
|
|
133
116
|
|
|
134
117
|
**Innovation Tournament**
|
|
135
|
-
|
|
136
118
|
- Pit multiple alternative approaches against each other
|
|
137
119
|
- Score each approach across different criteria
|
|
138
120
|
- Crowd-source evaluation from different personas
|
|
139
121
|
- Identify winning combination of features
|
|
140
122
|
|
|
141
123
|
**Escape Room Challenge**
|
|
142
|
-
|
|
143
124
|
- Present content as constraints to work within
|
|
144
125
|
- Find creative solutions within tight limitations
|
|
145
126
|
- Identify minimum viable approach
|
|
@@ -148,7 +129,6 @@
|
|
|
148
129
|
## Process Control
|
|
149
130
|
|
|
150
131
|
**Proceed / No Further Actions**
|
|
151
|
-
|
|
152
132
|
- Acknowledge choice to finalize current work
|
|
153
133
|
- Accept output as-is or move to next step
|
|
154
134
|
- Prepare to continue without additional elicitation
|