@posx/core 5.5.166 → 5.5.168

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 (108) hide show
  1. package/build/index.d.ts +6 -3
  2. package/build/index.js +1 -1
  3. package/package.json +1 -1
  4. package/package.publish.json +1 -1
  5. package/.bmad-core/agent-teams/team-all.yaml +0 -14
  6. package/.bmad-core/agent-teams/team-fullstack.yaml +0 -18
  7. package/.bmad-core/agent-teams/team-ide-minimal.yaml +0 -10
  8. package/.bmad-core/agent-teams/team-no-ui.yaml +0 -13
  9. package/.bmad-core/agents/analyst.md +0 -81
  10. package/.bmad-core/agents/architect.md +0 -83
  11. package/.bmad-core/agents/bmad-master.md +0 -107
  12. package/.bmad-core/agents/bmad-orchestrator.md +0 -149
  13. package/.bmad-core/agents/dev.md +0 -75
  14. package/.bmad-core/agents/pm.md +0 -81
  15. package/.bmad-core/agents/po.md +0 -76
  16. package/.bmad-core/agents/qa.md +0 -69
  17. package/.bmad-core/agents/sm.md +0 -62
  18. package/.bmad-core/agents/ux-expert.md +0 -66
  19. package/.bmad-core/bmad-core/user-guide.md +0 -0
  20. package/.bmad-core/checklists/architect-checklist.md +0 -443
  21. package/.bmad-core/checklists/change-checklist.md +0 -182
  22. package/.bmad-core/checklists/pm-checklist.md +0 -375
  23. package/.bmad-core/checklists/po-master-checklist.md +0 -441
  24. package/.bmad-core/checklists/story-dod-checklist.md +0 -101
  25. package/.bmad-core/checklists/story-draft-checklist.md +0 -156
  26. package/.bmad-core/core-config.yaml +0 -20
  27. package/.bmad-core/data/bmad-kb.md +0 -813
  28. package/.bmad-core/data/brainstorming-techniques.md +0 -36
  29. package/.bmad-core/data/elicitation-methods.md +0 -154
  30. package/.bmad-core/data/technical-preferences.md +0 -3
  31. package/.bmad-core/enhanced-ide-development-workflow.md +0 -43
  32. package/.bmad-core/install-manifest.yaml +0 -207
  33. package/.bmad-core/tasks/advanced-elicitation.md +0 -119
  34. package/.bmad-core/tasks/brownfield-create-epic.md +0 -160
  35. package/.bmad-core/tasks/brownfield-create-story.md +0 -147
  36. package/.bmad-core/tasks/correct-course.md +0 -70
  37. package/.bmad-core/tasks/create-brownfield-story.md +0 -321
  38. package/.bmad-core/tasks/create-deep-research-prompt.md +0 -289
  39. package/.bmad-core/tasks/create-doc.md +0 -101
  40. package/.bmad-core/tasks/create-next-story.md +0 -112
  41. package/.bmad-core/tasks/document-project.md +0 -347
  42. package/.bmad-core/tasks/execute-checklist.md +0 -93
  43. package/.bmad-core/tasks/facilitate-brainstorming-session.md +0 -136
  44. package/.bmad-core/tasks/generate-ai-frontend-prompt.md +0 -51
  45. package/.bmad-core/tasks/index-docs.md +0 -178
  46. package/.bmad-core/tasks/kb-mode-interaction.md +0 -75
  47. package/.bmad-core/tasks/review-story.md +0 -162
  48. package/.bmad-core/tasks/shard-doc.md +0 -187
  49. package/.bmad-core/tasks/validate-next-story.md +0 -134
  50. package/.bmad-core/templates/architecture-tmpl.yaml +0 -650
  51. package/.bmad-core/templates/brainstorming-output-tmpl.yaml +0 -156
  52. package/.bmad-core/templates/brownfield-architecture-tmpl.yaml +0 -476
  53. package/.bmad-core/templates/brownfield-prd-tmpl.yaml +0 -280
  54. package/.bmad-core/templates/competitor-analysis-tmpl.yaml +0 -293
  55. package/.bmad-core/templates/front-end-architecture-tmpl.yaml +0 -206
  56. package/.bmad-core/templates/front-end-spec-tmpl.yaml +0 -349
  57. package/.bmad-core/templates/fullstack-architecture-tmpl.yaml +0 -805
  58. package/.bmad-core/templates/market-research-tmpl.yaml +0 -252
  59. package/.bmad-core/templates/prd-tmpl.yaml +0 -202
  60. package/.bmad-core/templates/project-brief-tmpl.yaml +0 -221
  61. package/.bmad-core/templates/story-tmpl.yaml +0 -137
  62. package/.bmad-core/user-guide.md +0 -251
  63. package/.bmad-core/utils/bmad-doc-template.md +0 -325
  64. package/.bmad-core/utils/workflow-management.md +0 -69
  65. package/.bmad-core/workflows/brownfield-fullstack.yaml +0 -297
  66. package/.bmad-core/workflows/brownfield-service.yaml +0 -187
  67. package/.bmad-core/workflows/brownfield-ui.yaml +0 -197
  68. package/.bmad-core/workflows/greenfield-fullstack.yaml +0 -240
  69. package/.bmad-core/workflows/greenfield-service.yaml +0 -206
  70. package/.bmad-core/workflows/greenfield-ui.yaml +0 -235
  71. package/.bmad-core/working-in-the-brownfield.md +0 -364
  72. package/.claude/commands/BMad/agents/analyst.md +0 -85
  73. package/.claude/commands/BMad/agents/architect.md +0 -87
  74. package/.claude/commands/BMad/agents/bmad-master.md +0 -111
  75. package/.claude/commands/BMad/agents/bmad-orchestrator.md +0 -153
  76. package/.claude/commands/BMad/agents/dev.md +0 -79
  77. package/.claude/commands/BMad/agents/pm.md +0 -85
  78. package/.claude/commands/BMad/agents/po.md +0 -80
  79. package/.claude/commands/BMad/agents/qa.md +0 -73
  80. package/.claude/commands/BMad/agents/sm.md +0 -66
  81. package/.claude/commands/BMad/agents/ux-expert.md +0 -70
  82. package/.claude/commands/BMad/tasks/advanced-elicitation.md +0 -123
  83. package/.claude/commands/BMad/tasks/brownfield-create-epic.md +0 -164
  84. package/.claude/commands/BMad/tasks/brownfield-create-story.md +0 -151
  85. package/.claude/commands/BMad/tasks/correct-course.md +0 -74
  86. package/.claude/commands/BMad/tasks/create-brownfield-story.md +0 -325
  87. package/.claude/commands/BMad/tasks/create-deep-research-prompt.md +0 -293
  88. package/.claude/commands/BMad/tasks/create-doc.md +0 -105
  89. package/.claude/commands/BMad/tasks/create-next-story.md +0 -116
  90. package/.claude/commands/BMad/tasks/document-project.md +0 -351
  91. package/.claude/commands/BMad/tasks/execute-checklist.md +0 -97
  92. package/.claude/commands/BMad/tasks/facilitate-brainstorming-session.md +0 -140
  93. package/.claude/commands/BMad/tasks/generate-ai-frontend-prompt.md +0 -55
  94. package/.claude/commands/BMad/tasks/index-docs.md +0 -182
  95. package/.claude/commands/BMad/tasks/kb-mode-interaction.md +0 -79
  96. package/.claude/commands/BMad/tasks/review-story.md +0 -166
  97. package/.claude/commands/BMad/tasks/shard-doc.md +0 -191
  98. package/.claude/commands/BMad/tasks/validate-next-story.md +0 -138
  99. package/.cursor/rules/analyst.mdc +0 -95
  100. package/.cursor/rules/architect.mdc +0 -97
  101. package/.cursor/rules/bmad-master.mdc +0 -121
  102. package/.cursor/rules/bmad-orchestrator.mdc +0 -163
  103. package/.cursor/rules/dev.mdc +0 -89
  104. package/.cursor/rules/pm.mdc +0 -95
  105. package/.cursor/rules/po.mdc +0 -90
  106. package/.cursor/rules/qa.mdc +0 -83
  107. package/.cursor/rules/sm.mdc +0 -76
  108. package/.cursor/rules/ux-expert.mdc +0 -80
@@ -1,123 +0,0 @@
1
- # /advanced-elicitation Task
2
-
3
- When this command is used, execute the following task:
4
-
5
- # Advanced Elicitation Task
6
-
7
- ## Purpose
8
-
9
- - Provide optional reflective and brainstorming actions to enhance content quality
10
- - Enable deeper exploration of ideas through structured elicitation techniques
11
- - Support iterative refinement through multiple analytical perspectives
12
- - Usable during template-driven document creation or any chat conversation
13
-
14
- ## Usage Scenarios
15
-
16
- ### Scenario 1: Template Document Creation
17
-
18
- After outputting a section during document creation:
19
-
20
- 1. **Section Review**: Ask user to review the drafted section
21
- 2. **Offer Elicitation**: Present 9 carefully selected elicitation methods
22
- 3. **Simple Selection**: User types a number (0-8) to engage method, or 9 to proceed
23
- 4. **Execute & Loop**: Apply selected method, then re-offer choices until user proceeds
24
-
25
- ### Scenario 2: General Chat Elicitation
26
-
27
- User can request advanced elicitation on any agent output:
28
-
29
- - User says "do advanced elicitation" or similar
30
- - Agent selects 9 relevant methods for the context
31
- - Same simple 0-9 selection process
32
-
33
- ## Task Instructions
34
-
35
- ### 1. Intelligent Method Selection
36
-
37
- **Context Analysis**: Before presenting options, analyze:
38
-
39
- - **Content Type**: Technical specs, user stories, architecture, requirements, etc.
40
- - **Complexity Level**: Simple, moderate, or complex content
41
- - **Stakeholder Needs**: Who will use this information
42
- - **Risk Level**: High-impact decisions vs routine items
43
- - **Creative Potential**: Opportunities for innovation or alternatives
44
-
45
- **Method Selection Strategy**:
46
-
47
- 1. **Always Include Core Methods** (choose 3-4):
48
-
49
- - Expand or Contract for Audience
50
- - Critique and Refine
51
- - Identify Potential Risks
52
- - Assess Alignment with Goals
53
-
54
- 2. **Context-Specific Methods** (choose 4-5):
55
-
56
- - **Technical Content**: Tree of Thoughts, ReWOO, Meta-Prompting
57
- - **User-Facing Content**: Agile Team Perspective, Stakeholder Roundtable
58
- - **Creative Content**: Innovation Tournament, Escape Room Challenge
59
- - **Strategic Content**: Red Team vs Blue Team, Hindsight Reflection
60
-
61
- 3. **Always Include**: "Proceed / No Further Actions" as option 9
62
-
63
- ### 2. Section Context and Review
64
-
65
- When invoked after outputting a section:
66
-
67
- 1. **Provide Context Summary**: Give a brief 1-2 sentence summary of what the user should look for in the section just presented
68
-
69
- 2. **Explain Visual Elements**: If the section contains diagrams, explain them briefly before offering elicitation options
70
-
71
- 3. **Clarify Scope Options**: If the section contains multiple distinct items, inform the user they can apply elicitation actions to:
72
- - The entire section as a whole
73
- - Individual items within the section (specify which item when selecting an action)
74
-
75
- ### 3. Present Elicitation Options
76
-
77
- **Review Request Process:**
78
-
79
- - Ask the user to review the drafted section
80
- - In the SAME message, inform them they can suggest direct changes OR select an elicitation method
81
- - Present 9 intelligently selected methods (0-8) plus "Proceed" (9)
82
- - Keep descriptions short - just the method name
83
- - Await simple numeric selection
84
-
85
- **Action List Presentation Format:**
86
-
87
- ```text
88
- **Advanced Elicitation Options**
89
- Choose a number (0-8) or 9 to proceed:
90
-
91
- 0. [Method Name]
92
- 1. [Method Name]
93
- 2. [Method Name]
94
- 3. [Method Name]
95
- 4. [Method Name]
96
- 5. [Method Name]
97
- 6. [Method Name]
98
- 7. [Method Name]
99
- 8. [Method Name]
100
- 9. Proceed / No Further Actions
101
- ```
102
-
103
- **Response Handling:**
104
-
105
- - **Numbers 0-8**: Execute the selected method, then re-offer the choice
106
- - **Number 9**: Proceed to next section or continue conversation
107
- - **Direct Feedback**: Apply user's suggested changes and continue
108
-
109
- ### 4. Method Execution Framework
110
-
111
- **Execution Process:**
112
-
113
- 1. **Retrieve Method**: Access the specific elicitation method from the elicitation-methods data file
114
- 2. **Apply Context**: Execute the method from your current role's perspective
115
- 3. **Provide Results**: Deliver insights, critiques, or alternatives relevant to the content
116
- 4. **Re-offer Choice**: Present the same 9 options again until user selects 9 or gives direct feedback
117
-
118
- **Execution Guidelines:**
119
-
120
- - **Be Concise**: Focus on actionable insights, not lengthy explanations
121
- - **Stay Relevant**: Tie all elicitation back to the specific content being analyzed
122
- - **Identify Personas**: For multi-persona methods, clearly identify which viewpoint is speaking
123
- - **Maintain Flow**: Keep the process moving efficiently
@@ -1,164 +0,0 @@
1
- # /brownfield-create-epic Task
2
-
3
- When this command is used, execute the following task:
4
-
5
- # Create Brownfield Epic Task
6
-
7
- ## Purpose
8
-
9
- Create a single epic for smaller brownfield enhancements that don't require the full PRD and Architecture documentation process. This task is for isolated features or modifications that can be completed within a focused scope.
10
-
11
- ## When to Use This Task
12
-
13
- **Use this task when:**
14
-
15
- - The enhancement can be completed in 1-3 stories
16
- - No significant architectural changes are required
17
- - The enhancement follows existing project patterns
18
- - Integration complexity is minimal
19
- - Risk to existing system is low
20
-
21
- **Use the full brownfield PRD/Architecture process when:**
22
-
23
- - The enhancement requires multiple coordinated stories
24
- - Architectural planning is needed
25
- - Significant integration work is required
26
- - Risk assessment and mitigation planning is necessary
27
-
28
- ## Instructions
29
-
30
- ### 1. Project Analysis (Required)
31
-
32
- Before creating the epic, gather essential information about the existing project:
33
-
34
- **Existing Project Context:**
35
-
36
- - [ ] Project purpose and current functionality understood
37
- - [ ] Existing technology stack identified
38
- - [ ] Current architecture patterns noted
39
- - [ ] Integration points with existing system identified
40
-
41
- **Enhancement Scope:**
42
-
43
- - [ ] Enhancement clearly defined and scoped
44
- - [ ] Impact on existing functionality assessed
45
- - [ ] Required integration points identified
46
- - [ ] Success criteria established
47
-
48
- ### 2. Epic Creation
49
-
50
- Create a focused epic following this structure:
51
-
52
- #### Epic Title
53
-
54
- {{Enhancement Name}} - Brownfield Enhancement
55
-
56
- #### Epic Goal
57
-
58
- {{1-2 sentences describing what the epic will accomplish and why it adds value}}
59
-
60
- #### Epic Description
61
-
62
- **Existing System Context:**
63
-
64
- - Current relevant functionality: {{brief description}}
65
- - Technology stack: {{relevant existing technologies}}
66
- - Integration points: {{where new work connects to existing system}}
67
-
68
- **Enhancement Details:**
69
-
70
- - What's being added/changed: {{clear description}}
71
- - How it integrates: {{integration approach}}
72
- - Success criteria: {{measurable outcomes}}
73
-
74
- #### Stories
75
-
76
- List 1-3 focused stories that complete the epic:
77
-
78
- 1. **Story 1:** {{Story title and brief description}}
79
- 2. **Story 2:** {{Story title and brief description}}
80
- 3. **Story 3:** {{Story title and brief description}}
81
-
82
- #### Compatibility Requirements
83
-
84
- - [ ] Existing APIs remain unchanged
85
- - [ ] Database schema changes are backward compatible
86
- - [ ] UI changes follow existing patterns
87
- - [ ] Performance impact is minimal
88
-
89
- #### Risk Mitigation
90
-
91
- - **Primary Risk:** {{main risk to existing system}}
92
- - **Mitigation:** {{how risk will be addressed}}
93
- - **Rollback Plan:** {{how to undo changes if needed}}
94
-
95
- #### Definition of Done
96
-
97
- - [ ] All stories completed with acceptance criteria met
98
- - [ ] Existing functionality verified through testing
99
- - [ ] Integration points working correctly
100
- - [ ] Documentation updated appropriately
101
- - [ ] No regression in existing features
102
-
103
- ### 3. Validation Checklist
104
-
105
- Before finalizing the epic, ensure:
106
-
107
- **Scope Validation:**
108
-
109
- - [ ] Epic can be completed in 1-3 stories maximum
110
- - [ ] No architectural documentation is required
111
- - [ ] Enhancement follows existing patterns
112
- - [ ] Integration complexity is manageable
113
-
114
- **Risk Assessment:**
115
-
116
- - [ ] Risk to existing system is low
117
- - [ ] Rollback plan is feasible
118
- - [ ] Testing approach covers existing functionality
119
- - [ ] Team has sufficient knowledge of integration points
120
-
121
- **Completeness Check:**
122
-
123
- - [ ] Epic goal is clear and achievable
124
- - [ ] Stories are properly scoped
125
- - [ ] Success criteria are measurable
126
- - [ ] Dependencies are identified
127
-
128
- ### 4. Handoff to Story Manager
129
-
130
- Once the epic is validated, provide this handoff to the Story Manager:
131
-
132
- ---
133
-
134
- **Story Manager Handoff:**
135
-
136
- "Please develop detailed user stories for this brownfield epic. Key considerations:
137
-
138
- - This is an enhancement to an existing system running {{technology stack}}
139
- - Integration points: {{list key integration points}}
140
- - Existing patterns to follow: {{relevant existing patterns}}
141
- - Critical compatibility requirements: {{key requirements}}
142
- - Each story must include verification that existing functionality remains intact
143
-
144
- The epic should maintain system integrity while delivering {{epic goal}}."
145
-
146
- ---
147
-
148
- ## Success Criteria
149
-
150
- The epic creation is successful when:
151
-
152
- 1. Enhancement scope is clearly defined and appropriately sized
153
- 2. Integration approach respects existing system architecture
154
- 3. Risk to existing functionality is minimized
155
- 4. Stories are logically sequenced for safe implementation
156
- 5. Compatibility requirements are clearly specified
157
- 6. Rollback plan is feasible and documented
158
-
159
- ## Important Notes
160
-
161
- - This task is specifically for SMALL brownfield enhancements
162
- - If the scope grows beyond 3 stories, consider the full brownfield PRD process
163
- - Always prioritize existing system integrity over new functionality
164
- - When in doubt about scope or complexity, escalate to full brownfield planning
@@ -1,151 +0,0 @@
1
- # /brownfield-create-story Task
2
-
3
- When this command is used, execute the following task:
4
-
5
- # Create Brownfield Story Task
6
-
7
- ## Purpose
8
-
9
- Create a single user story for very small brownfield enhancements that can be completed in one focused development session. This task is for minimal additions or bug fixes that require existing system integration awareness.
10
-
11
- ## When to Use This Task
12
-
13
- **Use this task when:**
14
-
15
- - The enhancement can be completed in a single story
16
- - No new architecture or significant design is required
17
- - The change follows existing patterns exactly
18
- - Integration is straightforward with minimal risk
19
- - Change is isolated with clear boundaries
20
-
21
- **Use brownfield-create-epic when:**
22
-
23
- - The enhancement requires 2-3 coordinated stories
24
- - Some design work is needed
25
- - Multiple integration points are involved
26
-
27
- **Use the full brownfield PRD/Architecture process when:**
28
-
29
- - The enhancement requires multiple coordinated stories
30
- - Architectural planning is needed
31
- - Significant integration work is required
32
-
33
- ## Instructions
34
-
35
- ### 1. Quick Project Assessment
36
-
37
- Gather minimal but essential context about the existing project:
38
-
39
- **Current System Context:**
40
-
41
- - [ ] Relevant existing functionality identified
42
- - [ ] Technology stack for this area noted
43
- - [ ] Integration point(s) clearly understood
44
- - [ ] Existing patterns for similar work identified
45
-
46
- **Change Scope:**
47
-
48
- - [ ] Specific change clearly defined
49
- - [ ] Impact boundaries identified
50
- - [ ] Success criteria established
51
-
52
- ### 2. Story Creation
53
-
54
- Create a single focused story following this structure:
55
-
56
- #### Story Title
57
-
58
- {{Specific Enhancement}} - Brownfield Addition
59
-
60
- #### User Story
61
-
62
- As a {{user type}},
63
- I want {{specific action/capability}},
64
- So that {{clear benefit/value}}.
65
-
66
- #### Story Context
67
-
68
- **Existing System Integration:**
69
-
70
- - Integrates with: {{existing component/system}}
71
- - Technology: {{relevant tech stack}}
72
- - Follows pattern: {{existing pattern to follow}}
73
- - Touch points: {{specific integration points}}
74
-
75
- #### Acceptance Criteria
76
-
77
- **Functional Requirements:**
78
-
79
- 1. {{Primary functional requirement}}
80
- 2. {{Secondary functional requirement (if any)}}
81
- 3. {{Integration requirement}}
82
-
83
- **Integration Requirements:** 4. Existing {{relevant functionality}} continues to work unchanged 5. New functionality follows existing {{pattern}} pattern 6. Integration with {{system/component}} maintains current behavior
84
-
85
- **Quality Requirements:** 7. Change is covered by appropriate tests 8. Documentation is updated if needed 9. No regression in existing functionality verified
86
-
87
- #### Technical Notes
88
-
89
- - **Integration Approach:** {{how it connects to existing system}}
90
- - **Existing Pattern Reference:** {{link or description of pattern to follow}}
91
- - **Key Constraints:** {{any important limitations or requirements}}
92
-
93
- #### Definition of Done
94
-
95
- - [ ] Functional requirements met
96
- - [ ] Integration requirements verified
97
- - [ ] Existing functionality regression tested
98
- - [ ] Code follows existing patterns and standards
99
- - [ ] Tests pass (existing and new)
100
- - [ ] Documentation updated if applicable
101
-
102
- ### 3. Risk and Compatibility Check
103
-
104
- **Minimal Risk Assessment:**
105
-
106
- - **Primary Risk:** {{main risk to existing system}}
107
- - **Mitigation:** {{simple mitigation approach}}
108
- - **Rollback:** {{how to undo if needed}}
109
-
110
- **Compatibility Verification:**
111
-
112
- - [ ] No breaking changes to existing APIs
113
- - [ ] Database changes (if any) are additive only
114
- - [ ] UI changes follow existing design patterns
115
- - [ ] Performance impact is negligible
116
-
117
- ### 4. Validation Checklist
118
-
119
- Before finalizing the story, confirm:
120
-
121
- **Scope Validation:**
122
-
123
- - [ ] Story can be completed in one development session
124
- - [ ] Integration approach is straightforward
125
- - [ ] Follows existing patterns exactly
126
- - [ ] No design or architecture work required
127
-
128
- **Clarity Check:**
129
-
130
- - [ ] Story requirements are unambiguous
131
- - [ ] Integration points are clearly specified
132
- - [ ] Success criteria are testable
133
- - [ ] Rollback approach is simple
134
-
135
- ## Success Criteria
136
-
137
- The story creation is successful when:
138
-
139
- 1. Enhancement is clearly defined and appropriately scoped for single session
140
- 2. Integration approach is straightforward and low-risk
141
- 3. Existing system patterns are identified and will be followed
142
- 4. Rollback plan is simple and feasible
143
- 5. Acceptance criteria include existing functionality verification
144
-
145
- ## Important Notes
146
-
147
- - This task is for VERY SMALL brownfield changes only
148
- - If complexity grows during analysis, escalate to brownfield-create-epic
149
- - Always prioritize existing system integrity
150
- - When in doubt about integration complexity, use brownfield-create-epic instead
151
- - Stories should take no more than 4 hours of focused development work
@@ -1,74 +0,0 @@
1
- # /correct-course Task
2
-
3
- When this command is used, execute the following task:
4
-
5
- # Correct Course Task
6
-
7
- ## Purpose
8
-
9
- - Guide a structured response to a change trigger using the `.bmad-core/checklists/change-checklist`.
10
- - Analyze the impacts of the change on epics, project artifacts, and the MVP, guided by the checklist's structure.
11
- - Explore potential solutions (e.g., adjust scope, rollback elements, re-scope features) as prompted by the checklist.
12
- - Draft specific, actionable proposed updates to any affected project artifacts (e.g., epics, user stories, PRD sections, architecture document sections) based on the analysis.
13
- - Produce a consolidated "Sprint Change Proposal" document that contains the impact analysis and the clearly drafted proposed edits for user review and approval.
14
- - Ensure a clear handoff path if the nature of the changes necessitates fundamental replanning by other core agents (like PM or Architect).
15
-
16
- ## Instructions
17
-
18
- ### 1. Initial Setup & Mode Selection
19
-
20
- - **Acknowledge Task & Inputs:**
21
- - Confirm with the user that the "Correct Course Task" (Change Navigation & Integration) is being initiated.
22
- - Verify the change trigger and ensure you have the user's initial explanation of the issue and its perceived impact.
23
- - Confirm access to all relevant project artifacts (e.g., PRD, Epics/Stories, Architecture Documents, UI/UX Specifications) and, critically, the `.bmad-core/checklists/change-checklist`.
24
- - **Establish Interaction Mode:**
25
- - Ask the user their preferred interaction mode for this task:
26
- - **"Incrementally (Default & Recommended):** Shall we work through the change-checklist section by section, discussing findings and collaboratively drafting proposed changes for each relevant part before moving to the next? This allows for detailed, step-by-step refinement."
27
- - **"YOLO Mode (Batch Processing):** Or, would you prefer I conduct a more batched analysis based on the checklist and then present a consolidated set of findings and proposed changes for a broader review? This can be quicker for initial assessment but might require more extensive review of the combined proposals."
28
- - Once the user chooses, confirm the selected mode and then inform the user: "We will now use the change-checklist to analyze the change and draft proposed updates. I will guide you through the checklist items based on our chosen interaction mode."
29
-
30
- ### 2. Execute Checklist Analysis (Iteratively or Batched, per Interaction Mode)
31
-
32
- - Systematically work through Sections 1-4 of the change-checklist (typically covering Change Context, Epic/Story Impact Analysis, Artifact Conflict Resolution, and Path Evaluation/Recommendation).
33
- - For each checklist item or logical group of items (depending on interaction mode):
34
- - Present the relevant prompt(s) or considerations from the checklist to the user.
35
- - Request necessary information and actively analyze the relevant project artifacts (PRD, epics, architecture documents, story history, etc.) to assess the impact.
36
- - Discuss your findings for each item with the user.
37
- - Record the status of each checklist item (e.g., `[x] Addressed`, `[N/A]`, `[!] Further Action Needed`) and any pertinent notes or decisions.
38
- - Collaboratively agree on the "Recommended Path Forward" as prompted by Section 4 of the checklist.
39
-
40
- ### 3. Draft Proposed Changes (Iteratively or Batched)
41
-
42
- - Based on the completed checklist analysis (Sections 1-4) and the agreed "Recommended Path Forward" (excluding scenarios requiring fundamental replans that would necessitate immediate handoff to PM/Architect):
43
- - Identify the specific project artifacts that require updates (e.g., specific epics, user stories, PRD sections, architecture document components, diagrams).
44
- - **Draft the proposed changes directly and explicitly for each identified artifact.** Examples include:
45
- - Revising user story text, acceptance criteria, or priority.
46
- - Adding, removing, reordering, or splitting user stories within epics.
47
- - Proposing modified architecture diagram snippets (e.g., providing an updated Mermaid diagram block or a clear textual description of the change to an existing diagram).
48
- - Updating technology lists, configuration details, or specific sections within the PRD or architecture documents.
49
- - Drafting new, small supporting artifacts if necessary (e.g., a brief addendum for a specific decision).
50
- - If in "Incremental Mode," discuss and refine these proposed edits for each artifact or small group of related artifacts with the user as they are drafted.
51
- - If in "YOLO Mode," compile all drafted edits for presentation in the next step.
52
-
53
- ### 4. Generate "Sprint Change Proposal" with Edits
54
-
55
- - Synthesize the complete change-checklist analysis (covering findings from Sections 1-4) and all the agreed-upon proposed edits (from Instruction 3) into a single document titled "Sprint Change Proposal." This proposal should align with the structure suggested by Section 5 of the change-checklist.
56
- - The proposal must clearly present:
57
- - **Analysis Summary:** A concise overview of the original issue, its analyzed impact (on epics, artifacts, MVP scope), and the rationale for the chosen path forward.
58
- - **Specific Proposed Edits:** For each affected artifact, clearly show or describe the exact changes (e.g., "Change Story X.Y from: [old text] To: [new text]", "Add new Acceptance Criterion to Story A.B: [new AC]", "Update Section 3.2 of Architecture Document as follows: [new/modified text or diagram description]").
59
- - Present the complete draft of the "Sprint Change Proposal" to the user for final review and feedback. Incorporate any final adjustments requested by the user.
60
-
61
- ### 5. Finalize & Determine Next Steps
62
-
63
- - Obtain explicit user approval for the "Sprint Change Proposal," including all the specific edits documented within it.
64
- - Provide the finalized "Sprint Change Proposal" document to the user.
65
- - **Based on the nature of the approved changes:**
66
- - **If the approved edits sufficiently address the change and can be implemented directly or organized by a PO/SM:** State that the "Correct Course Task" is complete regarding analysis and change proposal, and the user can now proceed with implementing or logging these changes (e.g., updating actual project documents, backlog items). Suggest handoff to a PO/SM agent for backlog organization if appropriate.
67
- - **If the analysis and proposed path (as per checklist Section 4 and potentially Section 6) indicate that the change requires a more fundamental replan (e.g., significant scope change, major architectural rework):** Clearly state this conclusion. Advise the user that the next step involves engaging the primary PM or Architect agents, using the "Sprint Change Proposal" as critical input and context for that deeper replanning effort.
68
-
69
- ## Output Deliverables
70
-
71
- - **Primary:** A "Sprint Change Proposal" document (in markdown format). This document will contain:
72
- - A summary of the change-checklist analysis (issue, impact, rationale for the chosen path).
73
- - Specific, clearly drafted proposed edits for all affected project artifacts.
74
- - **Implicit:** An annotated change-checklist (or the record of its completion) reflecting the discussions, findings, and decisions made during the process.