bmad-method 4.36.2 → 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.
Files changed (51) hide show
  1. package/.github/workflows/release.yaml +1 -0
  2. package/.releaserc.json +11 -8
  3. package/bmad-core/agents/analyst.md +1 -1
  4. package/bmad-core/agents/architect.md +3 -2
  5. package/bmad-core/agents/bmad-master.md +1 -0
  6. package/bmad-core/agents/bmad-orchestrator.md +10 -9
  7. package/bmad-core/agents/dev.md +10 -9
  8. package/bmad-core/agents/po.md +1 -1
  9. package/bmad-core/agents/qa.md +1 -1
  10. package/bmad-core/agents/sm.md +1 -1
  11. package/bmad-core/agents/ux-expert.md +1 -1
  12. package/bmad-core/checklists/architect-checklist.md +5 -0
  13. package/bmad-core/checklists/pm-checklist.md +5 -0
  14. package/bmad-core/checklists/po-master-checklist.md +9 -0
  15. package/bmad-core/checklists/story-dod-checklist.md +7 -0
  16. package/bmad-core/checklists/story-draft-checklist.md +3 -0
  17. package/bmad-core/data/bmad-kb.md +2 -5
  18. package/bmad-core/data/elicitation-methods.md +0 -20
  19. package/bmad-core/tasks/create-brownfield-story.md +3 -11
  20. package/bmad-core/tasks/create-deep-research-prompt.md +11 -0
  21. package/bmad-core/tasks/document-project.md +13 -15
  22. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  23. package/bmad-core/tasks/index-docs.md +6 -0
  24. package/bmad-core/tasks/kb-mode-interaction.md +3 -3
  25. package/bmad-core/tasks/review-story.md +1 -10
  26. package/bmad-core/tasks/shard-doc.md +2 -0
  27. package/common/tasks/execute-checklist.md +7 -0
  28. package/docs/GUIDING-PRINCIPLES.md +1 -1
  29. package/docs/working-in-the-brownfield.md +1 -1
  30. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +14 -14
  31. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +4 -0
  32. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +5 -3
  33. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +1 -0
  34. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +18 -0
  35. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +5 -0
  36. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +8 -0
  37. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +7 -0
  38. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +4 -0
  39. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +1 -0
  40. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +10 -0
  41. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +18 -0
  42. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +3 -0
  43. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +1 -0
  44. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +1 -0
  45. package/package.json +1 -1
  46. package/tools/installer/bin/bmad.js +58 -0
  47. package/tools/installer/config/install.config.yaml +1 -1
  48. package/tools/installer/lib/ide-setup.js +1 -1
  49. package/tools/installer/package.json +3 -2
  50. package/tools/upgraders/v3-to-v4-upgrader.js +1 -1
  51. package/bmad-core/bmad-core/user-guide.md +0 -0
@@ -3,6 +3,7 @@ name: Release
3
3
  push:
4
4
  branches:
5
5
  - main
6
+ - stable
6
7
  workflow_dispatch:
7
8
  inputs:
8
9
  version_type:
package/.releaserc.json CHANGED
@@ -1,18 +1,21 @@
1
1
  {
2
- "branches": ["main"],
2
+ "branches": [
3
+ {
4
+ "name": "main",
5
+ "prerelease": "beta",
6
+ "channel": "beta"
7
+ },
8
+ {
9
+ "name": "stable",
10
+ "channel": "latest"
11
+ }
12
+ ],
3
13
  "plugins": [
4
14
  "@semantic-release/commit-analyzer",
5
15
  "@semantic-release/release-notes-generator",
6
16
  "@semantic-release/changelog",
7
17
  "@semantic-release/npm",
8
18
  "./tools/semantic-release-sync-installer.js",
9
- [
10
- "@semantic-release/git",
11
- {
12
- "assets": ["package.json", "package-lock.json", "tools/installer/package.json", "CHANGELOG.md"],
13
- "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
14
- }
15
- ],
16
19
  "@semantic-release/github"
17
20
  ]
18
21
  }
@@ -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: use create-doc with brownfield-architecture-tmpl.yaml
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: # All commands require * prefix when used (e.g., *help, *agent pm)
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:
@@ -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
- - 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"
61
- - story-file-updates-ONLY:
62
- - CRITICAL: ONLY UPDATE THE STORY FILE WITH UPDATES TO SECTIONS INDICATED BELOW. DO NOT MODIFY ANY OTHER SECTIONS.
63
- - 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
64
- - CRITICAL: DO NOT modify Status, Story, Acceptance Criteria, Dev Notes, Testing sections, or any other sections not listed above
65
- - 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"
66
- - ready-for-review: "Code matches requirements + All validations pass + Follows standards + File List complete"
67
- - 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"
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:
@@ -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
@@ -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
@@ -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