bmad-method 4.37.0-beta.6 → 5.0.0-beta.1
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/.github/workflows/promote-to-stable.yml +144 -0
- package/CHANGELOG.md +27 -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 +38 -19
- 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/data/test-levels-framework.md +146 -0
- package/bmad-core/data/test-priorities-matrix.md +172 -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/nfr-assess.md +343 -0
- package/bmad-core/tasks/qa-gate.md +159 -0
- package/bmad-core/tasks/review-story.md +243 -74
- package/bmad-core/tasks/risk-profile.md +353 -0
- package/bmad-core/tasks/shard-doc.md +0 -2
- package/bmad-core/tasks/test-design.md +174 -0
- package/bmad-core/tasks/trace-requirements.md +264 -0
- package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
- package/common/tasks/execute-checklist.md +0 -7
- package/dist/agents/analyst.txt +20 -26
- package/dist/agents/architect.txt +14 -35
- package/dist/agents/bmad-master.txt +40 -70
- package/dist/agents/bmad-orchestrator.txt +28 -5
- package/dist/agents/dev.txt +0 -14
- package/dist/agents/pm.txt +0 -25
- package/dist/agents/po.txt +0 -18
- package/dist/agents/qa.txt +2079 -135
- package/dist/agents/sm.txt +0 -10
- package/dist/agents/ux-expert.txt +0 -7
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -37
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +3 -12
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -7
- package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +44 -90
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +14 -49
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -46
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -15
- package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -17
- package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +38 -142
- package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -2
- package/dist/teams/team-all.txt +2181 -261
- package/dist/teams/team-fullstack.txt +43 -57
- package/dist/teams/team-ide-minimal.txt +2064 -125
- package/dist/teams/team-no-ui.txt +43 -57
- package/docs/enhanced-ide-development-workflow.md +220 -15
- package/docs/user-guide.md +271 -18
- package/docs/working-in-the-brownfield.md +265 -32
- 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/bin/bmad.js +33 -32
- package/tools/installer/config/install.config.yaml +11 -1
- package/tools/installer/lib/file-manager.js +1 -1
- package/tools/installer/lib/ide-base-setup.js +1 -1
- package/tools/installer/lib/ide-setup.js +197 -83
- package/tools/installer/lib/installer.js +3 -3
- package/tools/installer/package.json +1 -1
|
@@ -728,7 +728,7 @@ Provide a user-friendly interface to the BMad knowledge base without overwhelmin
|
|
|
728
728
|
|
|
729
729
|
## Instructions
|
|
730
730
|
|
|
731
|
-
When entering KB mode (
|
|
731
|
+
When entering KB mode (\*kb-mode), follow these steps:
|
|
732
732
|
|
|
733
733
|
### 1. Welcome and Guide
|
|
734
734
|
|
|
@@ -770,12 +770,12 @@ Or ask me about anything else related to BMad-Method!
|
|
|
770
770
|
When user is done or wants to exit KB mode:
|
|
771
771
|
|
|
772
772
|
- Summarize key points discussed if helpful
|
|
773
|
-
- Remind them they can return to KB mode anytime with
|
|
773
|
+
- Remind them they can return to KB mode anytime with \*kb-mode
|
|
774
774
|
- Suggest next steps based on what was discussed
|
|
775
775
|
|
|
776
776
|
## Example Interaction
|
|
777
777
|
|
|
778
|
-
**User**:
|
|
778
|
+
**User**: \*kb-mode
|
|
779
779
|
|
|
780
780
|
**Assistant**: I've entered KB mode and have access to the full BMad knowledge base. I can help you with detailed information about any aspect of BMad-Method.
|
|
781
781
|
|
|
@@ -1342,7 +1342,7 @@ Each status change requires user verification and approval before proceeding.
|
|
|
1342
1342
|
#### Greenfield Development
|
|
1343
1343
|
|
|
1344
1344
|
- Business analysis and market research
|
|
1345
|
-
- Product requirements and feature definition
|
|
1345
|
+
- Product requirements and feature definition
|
|
1346
1346
|
- System architecture and design
|
|
1347
1347
|
- Development execution
|
|
1348
1348
|
- Testing and deployment
|
|
@@ -1451,8 +1451,11 @@ Templates with Level 2 headings (`##`) can be automatically sharded:
|
|
|
1451
1451
|
|
|
1452
1452
|
```markdown
|
|
1453
1453
|
## Goals and Background Context
|
|
1454
|
-
|
|
1454
|
+
|
|
1455
|
+
## Requirements
|
|
1456
|
+
|
|
1455
1457
|
## User Interface Design Goals
|
|
1458
|
+
|
|
1456
1459
|
## Success Metrics
|
|
1457
1460
|
```
|
|
1458
1461
|
|
|
@@ -1609,16 +1612,19 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1609
1612
|
## Core Reflective Methods
|
|
1610
1613
|
|
|
1611
1614
|
**Expand or Contract for Audience**
|
|
1615
|
+
|
|
1612
1616
|
- Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
|
|
1613
1617
|
- Identify specific target audience if relevant
|
|
1614
1618
|
- Tailor content complexity and depth accordingly
|
|
1615
1619
|
|
|
1616
1620
|
**Explain Reasoning (CoT Step-by-Step)**
|
|
1621
|
+
|
|
1617
1622
|
- Walk through the step-by-step thinking process
|
|
1618
1623
|
- Reveal underlying assumptions and decision points
|
|
1619
1624
|
- Show how conclusions were reached from current role's perspective
|
|
1620
1625
|
|
|
1621
1626
|
**Critique and Refine**
|
|
1627
|
+
|
|
1622
1628
|
- Review output for flaws, inconsistencies, or improvement areas
|
|
1623
1629
|
- Identify specific weaknesses from role's expertise
|
|
1624
1630
|
- Suggest refined version reflecting domain knowledge
|
|
@@ -1626,12 +1632,14 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1626
1632
|
## Structural Analysis Methods
|
|
1627
1633
|
|
|
1628
1634
|
**Analyze Logical Flow and Dependencies**
|
|
1635
|
+
|
|
1629
1636
|
- Examine content structure for logical progression
|
|
1630
1637
|
- Check internal consistency and coherence
|
|
1631
1638
|
- Identify and validate dependencies between elements
|
|
1632
1639
|
- Confirm effective ordering and sequencing
|
|
1633
1640
|
|
|
1634
1641
|
**Assess Alignment with Overall Goals**
|
|
1642
|
+
|
|
1635
1643
|
- Evaluate content contribution to stated objectives
|
|
1636
1644
|
- Identify any misalignments or gaps
|
|
1637
1645
|
- Interpret alignment from specific role's perspective
|
|
@@ -1640,12 +1648,14 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1640
1648
|
## Risk and Challenge Methods
|
|
1641
1649
|
|
|
1642
1650
|
**Identify Potential Risks and Unforeseen Issues**
|
|
1651
|
+
|
|
1643
1652
|
- Brainstorm potential risks from role's expertise
|
|
1644
1653
|
- Identify overlooked edge cases or scenarios
|
|
1645
1654
|
- Anticipate unintended consequences
|
|
1646
1655
|
- Highlight implementation challenges
|
|
1647
1656
|
|
|
1648
1657
|
**Challenge from Critical Perspective**
|
|
1658
|
+
|
|
1649
1659
|
- Adopt critical stance on current content
|
|
1650
1660
|
- Play devil's advocate from specified viewpoint
|
|
1651
1661
|
- Argue against proposal highlighting weaknesses
|
|
@@ -1654,12 +1664,14 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1654
1664
|
## Creative Exploration Methods
|
|
1655
1665
|
|
|
1656
1666
|
**Tree of Thoughts Deep Dive**
|
|
1667
|
+
|
|
1657
1668
|
- Break problem into discrete "thoughts" or intermediate steps
|
|
1658
1669
|
- Explore multiple reasoning paths simultaneously
|
|
1659
1670
|
- Use self-evaluation to classify each path as "sure", "likely", or "impossible"
|
|
1660
1671
|
- Apply search algorithms (BFS/DFS) to find optimal solution paths
|
|
1661
1672
|
|
|
1662
1673
|
**Hindsight is 20/20: The 'If Only...' Reflection**
|
|
1674
|
+
|
|
1663
1675
|
- Imagine retrospective scenario based on current content
|
|
1664
1676
|
- Identify the one "if only we had known/done X..." insight
|
|
1665
1677
|
- Describe imagined consequences humorously or dramatically
|
|
@@ -1668,6 +1680,7 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1668
1680
|
## Multi-Persona Collaboration Methods
|
|
1669
1681
|
|
|
1670
1682
|
**Agile Team Perspective Shift**
|
|
1683
|
+
|
|
1671
1684
|
- Rotate through different Scrum team member viewpoints
|
|
1672
1685
|
- Product Owner: Focus on user value and business impact
|
|
1673
1686
|
- Scrum Master: Examine process flow and team dynamics
|
|
@@ -1675,12 +1688,14 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1675
1688
|
- QA: Identify testing scenarios and quality concerns
|
|
1676
1689
|
|
|
1677
1690
|
**Stakeholder Round Table**
|
|
1691
|
+
|
|
1678
1692
|
- Convene virtual meeting with multiple personas
|
|
1679
1693
|
- Each persona contributes unique perspective on content
|
|
1680
1694
|
- Identify conflicts and synergies between viewpoints
|
|
1681
1695
|
- Synthesize insights into actionable recommendations
|
|
1682
1696
|
|
|
1683
1697
|
**Meta-Prompting Analysis**
|
|
1698
|
+
|
|
1684
1699
|
- Step back to analyze the structure and logic of current approach
|
|
1685
1700
|
- Question the format and methodology being used
|
|
1686
1701
|
- Suggest alternative frameworks or mental models
|
|
@@ -1689,24 +1704,28 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1689
1704
|
## Advanced 2025 Techniques
|
|
1690
1705
|
|
|
1691
1706
|
**Self-Consistency Validation**
|
|
1707
|
+
|
|
1692
1708
|
- Generate multiple reasoning paths for same problem
|
|
1693
1709
|
- Compare consistency across different approaches
|
|
1694
1710
|
- Identify most reliable and robust solution
|
|
1695
1711
|
- Highlight areas where approaches diverge and why
|
|
1696
1712
|
|
|
1697
1713
|
**ReWOO (Reasoning Without Observation)**
|
|
1714
|
+
|
|
1698
1715
|
- Separate parametric reasoning from tool-based actions
|
|
1699
1716
|
- Create reasoning plan without external dependencies
|
|
1700
1717
|
- Identify what can be solved through pure reasoning
|
|
1701
1718
|
- Optimize for efficiency and reduced token usage
|
|
1702
1719
|
|
|
1703
1720
|
**Persona-Pattern Hybrid**
|
|
1721
|
+
|
|
1704
1722
|
- Combine specific role expertise with elicitation pattern
|
|
1705
1723
|
- Architect + Risk Analysis: Deep technical risk assessment
|
|
1706
1724
|
- UX Expert + User Journey: End-to-end experience critique
|
|
1707
1725
|
- PM + Stakeholder Analysis: Multi-perspective impact review
|
|
1708
1726
|
|
|
1709
1727
|
**Emergent Collaboration Discovery**
|
|
1728
|
+
|
|
1710
1729
|
- Allow multiple perspectives to naturally emerge
|
|
1711
1730
|
- Identify unexpected insights from persona interactions
|
|
1712
1731
|
- Explore novel combinations of viewpoints
|
|
@@ -1715,18 +1734,21 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1715
1734
|
## Game-Based Elicitation Methods
|
|
1716
1735
|
|
|
1717
1736
|
**Red Team vs Blue Team**
|
|
1737
|
+
|
|
1718
1738
|
- Red Team: Attack the proposal, find vulnerabilities
|
|
1719
1739
|
- Blue Team: Defend and strengthen the approach
|
|
1720
1740
|
- Competitive analysis reveals blind spots
|
|
1721
1741
|
- Results in more robust, battle-tested solutions
|
|
1722
1742
|
|
|
1723
1743
|
**Innovation Tournament**
|
|
1744
|
+
|
|
1724
1745
|
- Pit multiple alternative approaches against each other
|
|
1725
1746
|
- Score each approach across different criteria
|
|
1726
1747
|
- Crowd-source evaluation from different personas
|
|
1727
1748
|
- Identify winning combination of features
|
|
1728
1749
|
|
|
1729
1750
|
**Escape Room Challenge**
|
|
1751
|
+
|
|
1730
1752
|
- Present content as constraints to work within
|
|
1731
1753
|
- Find creative solutions within tight limitations
|
|
1732
1754
|
- Identify minimum viable approach
|
|
@@ -1735,6 +1757,7 @@ Use the **expansion-creator** pack to build your own:
|
|
|
1735
1757
|
## Process Control
|
|
1736
1758
|
|
|
1737
1759
|
**Proceed / No Further Actions**
|
|
1760
|
+
|
|
1738
1761
|
- Acknowledge choice to finalize current work
|
|
1739
1762
|
- Accept output as-is or move to next step
|
|
1740
1763
|
- Prepare to continue without additional elicitation
|
|
@@ -1858,7 +1881,7 @@ If user selects Option 1, present numbered list of techniques from the brainstor
|
|
|
1858
1881
|
1. Apply selected technique according to data file description
|
|
1859
1882
|
2. Keep engaging with technique until user indicates they want to:
|
|
1860
1883
|
- Choose a different technique
|
|
1861
|
-
- Apply current ideas to a new technique
|
|
1884
|
+
- Apply current ideas to a new technique
|
|
1862
1885
|
- Move to convergent phase
|
|
1863
1886
|
- End session
|
|
1864
1887
|
|
|
@@ -1975,63 +1998,54 @@ CRITICAL: First, help the user select the most appropriate research focus based
|
|
|
1975
1998
|
Present these numbered options to the user:
|
|
1976
1999
|
|
|
1977
2000
|
1. **Product Validation Research**
|
|
1978
|
-
|
|
1979
2001
|
- Validate product hypotheses and market fit
|
|
1980
2002
|
- Test assumptions about user needs and solutions
|
|
1981
2003
|
- Assess technical and business feasibility
|
|
1982
2004
|
- Identify risks and mitigation strategies
|
|
1983
2005
|
|
|
1984
2006
|
2. **Market Opportunity Research**
|
|
1985
|
-
|
|
1986
2007
|
- Analyze market size and growth potential
|
|
1987
2008
|
- Identify market segments and dynamics
|
|
1988
2009
|
- Assess market entry strategies
|
|
1989
2010
|
- Evaluate timing and market readiness
|
|
1990
2011
|
|
|
1991
2012
|
3. **User & Customer Research**
|
|
1992
|
-
|
|
1993
2013
|
- Deep dive into user personas and behaviors
|
|
1994
2014
|
- Understand jobs-to-be-done and pain points
|
|
1995
2015
|
- Map customer journeys and touchpoints
|
|
1996
2016
|
- Analyze willingness to pay and value perception
|
|
1997
2017
|
|
|
1998
2018
|
4. **Competitive Intelligence Research**
|
|
1999
|
-
|
|
2000
2019
|
- Detailed competitor analysis and positioning
|
|
2001
2020
|
- Feature and capability comparisons
|
|
2002
2021
|
- Business model and strategy analysis
|
|
2003
2022
|
- Identify competitive advantages and gaps
|
|
2004
2023
|
|
|
2005
2024
|
5. **Technology & Innovation Research**
|
|
2006
|
-
|
|
2007
2025
|
- Assess technology trends and possibilities
|
|
2008
2026
|
- Evaluate technical approaches and architectures
|
|
2009
2027
|
- Identify emerging technologies and disruptions
|
|
2010
2028
|
- Analyze build vs. buy vs. partner options
|
|
2011
2029
|
|
|
2012
2030
|
6. **Industry & Ecosystem Research**
|
|
2013
|
-
|
|
2014
2031
|
- Map industry value chains and dynamics
|
|
2015
2032
|
- Identify key players and relationships
|
|
2016
2033
|
- Analyze regulatory and compliance factors
|
|
2017
2034
|
- Understand partnership opportunities
|
|
2018
2035
|
|
|
2019
2036
|
7. **Strategic Options Research**
|
|
2020
|
-
|
|
2021
2037
|
- Evaluate different strategic directions
|
|
2022
2038
|
- Assess business model alternatives
|
|
2023
2039
|
- Analyze go-to-market strategies
|
|
2024
2040
|
- Consider expansion and scaling paths
|
|
2025
2041
|
|
|
2026
2042
|
8. **Risk & Feasibility Research**
|
|
2027
|
-
|
|
2028
2043
|
- Identify and assess various risk factors
|
|
2029
2044
|
- Evaluate implementation challenges
|
|
2030
2045
|
- Analyze resource requirements
|
|
2031
2046
|
- Consider regulatory and legal implications
|
|
2032
2047
|
|
|
2033
2048
|
9. **Custom Research Focus**
|
|
2034
|
-
|
|
2035
2049
|
- User-defined research objectives
|
|
2036
2050
|
- Specialized domain investigation
|
|
2037
2051
|
- Cross-functional research needs
|
|
@@ -2200,13 +2214,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
|
|
|
2200
2214
|
### 5. Review and Refinement
|
|
2201
2215
|
|
|
2202
2216
|
1. **Present Complete Prompt**
|
|
2203
|
-
|
|
2204
2217
|
- Show the full research prompt
|
|
2205
2218
|
- Explain key elements and rationale
|
|
2206
2219
|
- Highlight any assumptions made
|
|
2207
2220
|
|
|
2208
2221
|
2. **Gather Feedback**
|
|
2209
|
-
|
|
2210
2222
|
- Are the objectives clear and correct?
|
|
2211
2223
|
- Do the questions address all concerns?
|
|
2212
2224
|
- Is the scope appropriate?
|
|
@@ -2357,9 +2369,9 @@ This document captures the CURRENT STATE of the [Project Name] codebase, includi
|
|
|
2357
2369
|
|
|
2358
2370
|
### Change Log
|
|
2359
2371
|
|
|
2360
|
-
| Date
|
|
2361
|
-
|
|
2362
|
-
| [Date] | 1.0
|
|
2372
|
+
| Date | Version | Description | Author |
|
|
2373
|
+
| ------ | ------- | --------------------------- | --------- |
|
|
2374
|
+
| [Date] | 1.0 | Initial brownfield analysis | [Analyst] |
|
|
2363
2375
|
|
|
2364
2376
|
## Quick Reference - Key Files and Entry Points
|
|
2365
2377
|
|
|
@@ -2382,11 +2394,11 @@ This document captures the CURRENT STATE of the [Project Name] codebase, includi
|
|
|
2382
2394
|
|
|
2383
2395
|
### Actual Tech Stack (from package.json/requirements.txt)
|
|
2384
2396
|
|
|
2385
|
-
| Category
|
|
2386
|
-
|
|
2387
|
-
| Runtime
|
|
2388
|
-
| Framework | Express
|
|
2389
|
-
| Database
|
|
2397
|
+
| Category | Technology | Version | Notes |
|
|
2398
|
+
| --------- | ---------- | ------- | -------------------------- |
|
|
2399
|
+
| Runtime | Node.js | 16.x | [Any constraints] |
|
|
2400
|
+
| Framework | Express | 4.18.2 | [Custom middleware?] |
|
|
2401
|
+
| Database | PostgreSQL | 13 | [Connection pooling setup] |
|
|
2390
2402
|
|
|
2391
2403
|
etc...
|
|
2392
2404
|
|
|
@@ -2425,6 +2437,7 @@ project-root/
|
|
|
2425
2437
|
### Data Models
|
|
2426
2438
|
|
|
2427
2439
|
Instead of duplicating, reference actual model files:
|
|
2440
|
+
|
|
2428
2441
|
- **User Model**: See `src/models/User.js`
|
|
2429
2442
|
- **Order Model**: See `src/models/Order.js`
|
|
2430
2443
|
- **Related Types**: TypeScript definitions in `src/types/`
|
|
@@ -2454,10 +2467,10 @@ Instead of duplicating, reference actual model files:
|
|
|
2454
2467
|
|
|
2455
2468
|
### External Services
|
|
2456
2469
|
|
|
2457
|
-
| Service
|
|
2458
|
-
|
|
2459
|
-
| Stripe
|
|
2460
|
-
| SendGrid | Emails
|
|
2470
|
+
| Service | Purpose | Integration Type | Key Files |
|
|
2471
|
+
| -------- | -------- | ---------------- | ------------------------------ |
|
|
2472
|
+
| Stripe | Payments | REST API | `src/integrations/stripe/` |
|
|
2473
|
+
| SendGrid | Emails | SDK | `src/services/emailService.js` |
|
|
2461
2474
|
|
|
2462
2475
|
etc...
|
|
2463
2476
|
|
|
@@ -2502,6 +2515,7 @@ npm run test:integration # Runs integration tests (requires local DB)
|
|
|
2502
2515
|
### Files That Will Need Modification
|
|
2503
2516
|
|
|
2504
2517
|
Based on the enhancement requirements, these files will be affected:
|
|
2518
|
+
|
|
2505
2519
|
- `src/services/userService.js` - Add new user fields
|
|
2506
2520
|
- `src/models/User.js` - Update schema
|
|
2507
2521
|
- `src/routes/userRoutes.js` - New endpoints
|
|
@@ -3958,7 +3972,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
3958
3972
|
## Instructions
|
|
3959
3973
|
|
|
3960
3974
|
1. **Initial Assessment**
|
|
3961
|
-
|
|
3962
3975
|
- If user or the task being run provides a checklist name:
|
|
3963
3976
|
- Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
|
|
3964
3977
|
- If multiple matches found, ask user to clarify
|
|
@@ -3971,14 +3984,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
3971
3984
|
- All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
|
|
3972
3985
|
|
|
3973
3986
|
2. **Document and Artifact Gathering**
|
|
3974
|
-
|
|
3975
3987
|
- Each checklist will specify its required documents/artifacts at the beginning
|
|
3976
3988
|
- Follow the checklist's specific instructions for what to gather, generally a file can be resolved in the docs folder, if not or unsure, halt and ask or confirm with the user.
|
|
3977
3989
|
|
|
3978
3990
|
3. **Checklist Processing**
|
|
3979
3991
|
|
|
3980
3992
|
If in interactive mode:
|
|
3981
|
-
|
|
3982
3993
|
- Work through each section of the checklist one at a time
|
|
3983
3994
|
- For each section:
|
|
3984
3995
|
- Review all items in the section following instructions for that section embedded in the checklist
|
|
@@ -3987,7 +3998,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
3987
3998
|
- Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
|
|
3988
3999
|
|
|
3989
4000
|
If in YOLO mode:
|
|
3990
|
-
|
|
3991
4001
|
- Process all sections at once
|
|
3992
4002
|
- Create a comprehensive report of all findings
|
|
3993
4003
|
- Present the complete analysis to the user
|
|
@@ -3995,7 +4005,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
3995
4005
|
4. **Validation Approach**
|
|
3996
4006
|
|
|
3997
4007
|
For each checklist item:
|
|
3998
|
-
|
|
3999
4008
|
- Read and understand the requirement
|
|
4000
4009
|
- Look for evidence in the documentation that satisfies the requirement
|
|
4001
4010
|
- Consider both explicit mentions and implicit coverage
|
|
@@ -4009,7 +4018,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
4009
4018
|
5. **Section Analysis**
|
|
4010
4019
|
|
|
4011
4020
|
For each section:
|
|
4012
|
-
|
|
4013
4021
|
- think step by step to calculate pass rate
|
|
4014
4022
|
- Identify common themes in failed items
|
|
4015
4023
|
- Provide specific recommendations for improvement
|
|
@@ -4019,7 +4027,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
|
|
|
4019
4027
|
6. **Final Report**
|
|
4020
4028
|
|
|
4021
4029
|
Prepare a summary that includes:
|
|
4022
|
-
|
|
4023
4030
|
- Overall checklist completion status
|
|
4024
4031
|
- Pass rates by section
|
|
4025
4032
|
- List of failed items with context
|
|
@@ -4136,13 +4143,11 @@ CRITICAL: Use proper parsing that understands markdown context. A ## inside a co
|
|
|
4136
4143
|
For each extracted section:
|
|
4137
4144
|
|
|
4138
4145
|
1. **Generate filename**: Convert the section heading to lowercase-dash-case
|
|
4139
|
-
|
|
4140
4146
|
- Remove special characters
|
|
4141
4147
|
- Replace spaces with dashes
|
|
4142
4148
|
- Example: "## Tech Stack" → `tech-stack.md`
|
|
4143
4149
|
|
|
4144
4150
|
2. **Adjust heading levels**:
|
|
4145
|
-
|
|
4146
4151
|
- The level 2 heading becomes level 1 (# instead of ##) in the sharded new document
|
|
4147
4152
|
- All subsection levels decrease by 1:
|
|
4148
4153
|
|
|
@@ -5027,7 +5032,6 @@ Ask the user if they want to work through the checklist:
|
|
|
5027
5032
|
Create a comprehensive validation report that includes:
|
|
5028
5033
|
|
|
5029
5034
|
1. Executive Summary
|
|
5030
|
-
|
|
5031
5035
|
- Overall PRD completeness (percentage)
|
|
5032
5036
|
- MVP scope appropriateness (Too Large/Just Right/Too Small)
|
|
5033
5037
|
- Readiness for architecture phase (Ready/Nearly Ready/Not Ready)
|
|
@@ -5035,26 +5039,22 @@ Create a comprehensive validation report that includes:
|
|
|
5035
5039
|
|
|
5036
5040
|
2. Category Analysis Table
|
|
5037
5041
|
Fill in the actual table with:
|
|
5038
|
-
|
|
5039
5042
|
- Status: PASS (90%+ complete), PARTIAL (60-89%), FAIL (<60%)
|
|
5040
5043
|
- Critical Issues: Specific problems that block progress
|
|
5041
5044
|
|
|
5042
5045
|
3. Top Issues by Priority
|
|
5043
|
-
|
|
5044
5046
|
- BLOCKERS: Must fix before architect can proceed
|
|
5045
5047
|
- HIGH: Should fix for quality
|
|
5046
5048
|
- MEDIUM: Would improve clarity
|
|
5047
5049
|
- LOW: Nice to have
|
|
5048
5050
|
|
|
5049
5051
|
4. MVP Scope Assessment
|
|
5050
|
-
|
|
5051
5052
|
- Features that might be cut for true MVP
|
|
5052
5053
|
- Missing features that are essential
|
|
5053
5054
|
- Complexity concerns
|
|
5054
5055
|
- Timeline realism
|
|
5055
5056
|
|
|
5056
5057
|
5. Technical Readiness
|
|
5057
|
-
|
|
5058
5058
|
- Clarity of technical constraints
|
|
5059
5059
|
- Identified technical risks
|
|
5060
5060
|
- Areas needing architect investigation
|
|
@@ -8250,33 +8250,28 @@ Ask the user if they want to work through the checklist:
|
|
|
8250
8250
|
Now that you've completed the checklist, generate a comprehensive validation report that includes:
|
|
8251
8251
|
|
|
8252
8252
|
1. Executive Summary
|
|
8253
|
-
|
|
8254
8253
|
- Overall architecture readiness (High/Medium/Low)
|
|
8255
8254
|
- Critical risks identified
|
|
8256
8255
|
- Key strengths of the architecture
|
|
8257
8256
|
- Project type (Full-stack/Frontend/Backend) and sections evaluated
|
|
8258
8257
|
|
|
8259
8258
|
2. Section Analysis
|
|
8260
|
-
|
|
8261
8259
|
- Pass rate for each major section (percentage of items passed)
|
|
8262
8260
|
- Most concerning failures or gaps
|
|
8263
8261
|
- Sections requiring immediate attention
|
|
8264
8262
|
- Note any sections skipped due to project type
|
|
8265
8263
|
|
|
8266
8264
|
3. Risk Assessment
|
|
8267
|
-
|
|
8268
8265
|
- Top 5 risks by severity
|
|
8269
8266
|
- Mitigation recommendations for each
|
|
8270
8267
|
- Timeline impact of addressing issues
|
|
8271
8268
|
|
|
8272
8269
|
4. Recommendations
|
|
8273
|
-
|
|
8274
8270
|
- Must-fix items before development
|
|
8275
8271
|
- Should-fix items for better quality
|
|
8276
8272
|
- Nice-to-have improvements
|
|
8277
8273
|
|
|
8278
8274
|
5. AI Implementation Readiness
|
|
8279
|
-
|
|
8280
8275
|
- Specific concerns for AI agent implementation
|
|
8281
8276
|
- Areas needing additional clarification
|
|
8282
8277
|
- Complexity hotspots to address
|
|
@@ -8578,12 +8573,10 @@ PROJECT TYPE DETECTION:
|
|
|
8578
8573
|
First, determine the project type by checking:
|
|
8579
8574
|
|
|
8580
8575
|
1. Is this a GREENFIELD project (new from scratch)?
|
|
8581
|
-
|
|
8582
8576
|
- Look for: New project initialization, no existing codebase references
|
|
8583
8577
|
- Check for: prd.md, architecture.md, new project setup stories
|
|
8584
8578
|
|
|
8585
8579
|
2. Is this a BROWNFIELD project (enhancing existing system)?
|
|
8586
|
-
|
|
8587
8580
|
- Look for: References to existing codebase, enhancement/modification language
|
|
8588
8581
|
- Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
|
|
8589
8582
|
|
|
@@ -8917,7 +8910,6 @@ Ask the user if they want to work through the checklist:
|
|
|
8917
8910
|
Generate a comprehensive validation report that adapts to project type:
|
|
8918
8911
|
|
|
8919
8912
|
1. Executive Summary
|
|
8920
|
-
|
|
8921
8913
|
- Project type: [Greenfield/Brownfield] with [UI/No UI]
|
|
8922
8914
|
- Overall readiness (percentage)
|
|
8923
8915
|
- Go/No-Go recommendation
|
|
@@ -8927,42 +8919,36 @@ Generate a comprehensive validation report that adapts to project type:
|
|
|
8927
8919
|
2. Project-Specific Analysis
|
|
8928
8920
|
|
|
8929
8921
|
FOR GREENFIELD:
|
|
8930
|
-
|
|
8931
8922
|
- Setup completeness
|
|
8932
8923
|
- Dependency sequencing
|
|
8933
8924
|
- MVP scope appropriateness
|
|
8934
8925
|
- Development timeline feasibility
|
|
8935
8926
|
|
|
8936
8927
|
FOR BROWNFIELD:
|
|
8937
|
-
|
|
8938
8928
|
- Integration risk level (High/Medium/Low)
|
|
8939
8929
|
- Existing system impact assessment
|
|
8940
8930
|
- Rollback readiness
|
|
8941
8931
|
- User disruption potential
|
|
8942
8932
|
|
|
8943
8933
|
3. Risk Assessment
|
|
8944
|
-
|
|
8945
8934
|
- Top 5 risks by severity
|
|
8946
8935
|
- Mitigation recommendations
|
|
8947
8936
|
- Timeline impact of addressing issues
|
|
8948
8937
|
- [BROWNFIELD] Specific integration risks
|
|
8949
8938
|
|
|
8950
8939
|
4. MVP Completeness
|
|
8951
|
-
|
|
8952
8940
|
- Core features coverage
|
|
8953
8941
|
- Missing essential functionality
|
|
8954
8942
|
- Scope creep identified
|
|
8955
8943
|
- True MVP vs over-engineering
|
|
8956
8944
|
|
|
8957
8945
|
5. Implementation Readiness
|
|
8958
|
-
|
|
8959
8946
|
- Developer clarity score (1-10)
|
|
8960
8947
|
- Ambiguous requirements count
|
|
8961
8948
|
- Missing technical details
|
|
8962
8949
|
- [BROWNFIELD] Integration point clarity
|
|
8963
8950
|
|
|
8964
8951
|
6. Recommendations
|
|
8965
|
-
|
|
8966
8952
|
- Must-fix before development
|
|
8967
8953
|
- Should-fix for quality
|
|
8968
8954
|
- Consider for improvement
|