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