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.
Files changed (85) hide show
  1. package/.github/workflows/promote-to-stable.yml +144 -0
  2. package/CHANGELOG.md +27 -2
  3. package/bmad-core/agents/analyst.md +1 -1
  4. package/bmad-core/agents/architect.md +2 -3
  5. package/bmad-core/agents/bmad-master.md +0 -1
  6. package/bmad-core/agents/bmad-orchestrator.md +9 -10
  7. package/bmad-core/agents/dev.md +9 -10
  8. package/bmad-core/agents/po.md +1 -1
  9. package/bmad-core/agents/qa.md +38 -19
  10. package/bmad-core/agents/sm.md +1 -1
  11. package/bmad-core/agents/ux-expert.md +1 -1
  12. package/bmad-core/checklists/architect-checklist.md +0 -5
  13. package/bmad-core/checklists/pm-checklist.md +0 -5
  14. package/bmad-core/checklists/po-master-checklist.md +0 -9
  15. package/bmad-core/checklists/story-dod-checklist.md +0 -7
  16. package/bmad-core/checklists/story-draft-checklist.md +0 -3
  17. package/bmad-core/data/bmad-kb.md +5 -2
  18. package/bmad-core/data/elicitation-methods.md +20 -0
  19. package/bmad-core/data/test-levels-framework.md +146 -0
  20. package/bmad-core/data/test-priorities-matrix.md +172 -0
  21. package/bmad-core/tasks/create-brownfield-story.md +11 -3
  22. package/bmad-core/tasks/create-deep-research-prompt.md +0 -11
  23. package/bmad-core/tasks/document-project.md +15 -13
  24. package/bmad-core/tasks/facilitate-brainstorming-session.md +1 -1
  25. package/bmad-core/tasks/index-docs.md +0 -6
  26. package/bmad-core/tasks/kb-mode-interaction.md +3 -3
  27. package/bmad-core/tasks/nfr-assess.md +343 -0
  28. package/bmad-core/tasks/qa-gate.md +159 -0
  29. package/bmad-core/tasks/review-story.md +243 -74
  30. package/bmad-core/tasks/risk-profile.md +353 -0
  31. package/bmad-core/tasks/shard-doc.md +0 -2
  32. package/bmad-core/tasks/test-design.md +174 -0
  33. package/bmad-core/tasks/trace-requirements.md +264 -0
  34. package/bmad-core/templates/qa-gate-tmpl.yaml +102 -0
  35. package/common/tasks/execute-checklist.md +0 -7
  36. package/dist/agents/analyst.txt +20 -26
  37. package/dist/agents/architect.txt +14 -35
  38. package/dist/agents/bmad-master.txt +40 -70
  39. package/dist/agents/bmad-orchestrator.txt +28 -5
  40. package/dist/agents/dev.txt +0 -14
  41. package/dist/agents/pm.txt +0 -25
  42. package/dist/agents/po.txt +0 -18
  43. package/dist/agents/qa.txt +2079 -135
  44. package/dist/agents/sm.txt +0 -10
  45. package/dist/agents/ux-expert.txt +0 -7
  46. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -37
  47. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +3 -12
  48. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -7
  49. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +44 -90
  50. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +14 -49
  51. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -46
  52. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -15
  53. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -17
  54. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +38 -142
  55. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -2
  56. package/dist/teams/team-all.txt +2181 -261
  57. package/dist/teams/team-fullstack.txt +43 -57
  58. package/dist/teams/team-ide-minimal.txt +2064 -125
  59. package/dist/teams/team-no-ui.txt +43 -57
  60. package/docs/enhanced-ide-development-workflow.md +220 -15
  61. package/docs/user-guide.md +271 -18
  62. package/docs/working-in-the-brownfield.md +265 -32
  63. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +14 -14
  64. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +0 -4
  65. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +3 -5
  66. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +0 -1
  67. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +0 -18
  68. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +0 -5
  69. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +0 -8
  70. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +0 -7
  71. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +0 -4
  72. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +0 -1
  73. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +0 -10
  74. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +0 -18
  75. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +0 -3
  76. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +0 -1
  77. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +0 -1
  78. package/package.json +1 -1
  79. package/tools/installer/bin/bmad.js +33 -32
  80. package/tools/installer/config/install.config.yaml +11 -1
  81. package/tools/installer/lib/file-manager.js +1 -1
  82. package/tools/installer/lib/ide-base-setup.js +1 -1
  83. package/tools/installer/lib/ide-setup.js +197 -83
  84. package/tools/installer/lib/installer.js +3 -3
  85. package/tools/installer/package.json +1 -1
@@ -674,7 +674,7 @@ Provide a user-friendly interface to the BMad knowledge base without overwhelmin
674
674
 
675
675
  ## Instructions
676
676
 
677
- When entering KB mode (*kb-mode), follow these steps:
677
+ When entering KB mode (\*kb-mode), follow these steps:
678
678
 
679
679
  ### 1. Welcome and Guide
680
680
 
@@ -716,12 +716,12 @@ Or ask me about anything else related to BMad-Method!
716
716
  When user is done or wants to exit KB mode:
717
717
 
718
718
  - Summarize key points discussed if helpful
719
- - Remind them they can return to KB mode anytime with *kb-mode
719
+ - Remind them they can return to KB mode anytime with \*kb-mode
720
720
  - Suggest next steps based on what was discussed
721
721
 
722
722
  ## Example Interaction
723
723
 
724
- **User**: *kb-mode
724
+ **User**: \*kb-mode
725
725
 
726
726
  **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.
727
727
 
@@ -1288,7 +1288,7 @@ Each status change requires user verification and approval before proceeding.
1288
1288
  #### Greenfield Development
1289
1289
 
1290
1290
  - Business analysis and market research
1291
- - Product requirements and feature definition
1291
+ - Product requirements and feature definition
1292
1292
  - System architecture and design
1293
1293
  - Development execution
1294
1294
  - Testing and deployment
@@ -1397,8 +1397,11 @@ Templates with Level 2 headings (`##`) can be automatically sharded:
1397
1397
 
1398
1398
  ```markdown
1399
1399
  ## Goals and Background Context
1400
- ## Requirements
1400
+
1401
+ ## Requirements
1402
+
1401
1403
  ## User Interface Design Goals
1404
+
1402
1405
  ## Success Metrics
1403
1406
  ```
1404
1407
 
@@ -1555,16 +1558,19 @@ Use the **expansion-creator** pack to build your own:
1555
1558
  ## Core Reflective Methods
1556
1559
 
1557
1560
  **Expand or Contract for Audience**
1561
+
1558
1562
  - Ask whether to 'expand' (add detail, elaborate) or 'contract' (simplify, clarify)
1559
1563
  - Identify specific target audience if relevant
1560
1564
  - Tailor content complexity and depth accordingly
1561
1565
 
1562
1566
  **Explain Reasoning (CoT Step-by-Step)**
1567
+
1563
1568
  - Walk through the step-by-step thinking process
1564
1569
  - Reveal underlying assumptions and decision points
1565
1570
  - Show how conclusions were reached from current role's perspective
1566
1571
 
1567
1572
  **Critique and Refine**
1573
+
1568
1574
  - Review output for flaws, inconsistencies, or improvement areas
1569
1575
  - Identify specific weaknesses from role's expertise
1570
1576
  - Suggest refined version reflecting domain knowledge
@@ -1572,12 +1578,14 @@ Use the **expansion-creator** pack to build your own:
1572
1578
  ## Structural Analysis Methods
1573
1579
 
1574
1580
  **Analyze Logical Flow and Dependencies**
1581
+
1575
1582
  - Examine content structure for logical progression
1576
1583
  - Check internal consistency and coherence
1577
1584
  - Identify and validate dependencies between elements
1578
1585
  - Confirm effective ordering and sequencing
1579
1586
 
1580
1587
  **Assess Alignment with Overall Goals**
1588
+
1581
1589
  - Evaluate content contribution to stated objectives
1582
1590
  - Identify any misalignments or gaps
1583
1591
  - Interpret alignment from specific role's perspective
@@ -1586,12 +1594,14 @@ Use the **expansion-creator** pack to build your own:
1586
1594
  ## Risk and Challenge Methods
1587
1595
 
1588
1596
  **Identify Potential Risks and Unforeseen Issues**
1597
+
1589
1598
  - Brainstorm potential risks from role's expertise
1590
1599
  - Identify overlooked edge cases or scenarios
1591
1600
  - Anticipate unintended consequences
1592
1601
  - Highlight implementation challenges
1593
1602
 
1594
1603
  **Challenge from Critical Perspective**
1604
+
1595
1605
  - Adopt critical stance on current content
1596
1606
  - Play devil's advocate from specified viewpoint
1597
1607
  - Argue against proposal highlighting weaknesses
@@ -1600,12 +1610,14 @@ Use the **expansion-creator** pack to build your own:
1600
1610
  ## Creative Exploration Methods
1601
1611
 
1602
1612
  **Tree of Thoughts Deep Dive**
1613
+
1603
1614
  - Break problem into discrete "thoughts" or intermediate steps
1604
1615
  - Explore multiple reasoning paths simultaneously
1605
1616
  - Use self-evaluation to classify each path as "sure", "likely", or "impossible"
1606
1617
  - Apply search algorithms (BFS/DFS) to find optimal solution paths
1607
1618
 
1608
1619
  **Hindsight is 20/20: The 'If Only...' Reflection**
1620
+
1609
1621
  - Imagine retrospective scenario based on current content
1610
1622
  - Identify the one "if only we had known/done X..." insight
1611
1623
  - Describe imagined consequences humorously or dramatically
@@ -1614,6 +1626,7 @@ Use the **expansion-creator** pack to build your own:
1614
1626
  ## Multi-Persona Collaboration Methods
1615
1627
 
1616
1628
  **Agile Team Perspective Shift**
1629
+
1617
1630
  - Rotate through different Scrum team member viewpoints
1618
1631
  - Product Owner: Focus on user value and business impact
1619
1632
  - Scrum Master: Examine process flow and team dynamics
@@ -1621,12 +1634,14 @@ Use the **expansion-creator** pack to build your own:
1621
1634
  - QA: Identify testing scenarios and quality concerns
1622
1635
 
1623
1636
  **Stakeholder Round Table**
1637
+
1624
1638
  - Convene virtual meeting with multiple personas
1625
1639
  - Each persona contributes unique perspective on content
1626
1640
  - Identify conflicts and synergies between viewpoints
1627
1641
  - Synthesize insights into actionable recommendations
1628
1642
 
1629
1643
  **Meta-Prompting Analysis**
1644
+
1630
1645
  - Step back to analyze the structure and logic of current approach
1631
1646
  - Question the format and methodology being used
1632
1647
  - Suggest alternative frameworks or mental models
@@ -1635,24 +1650,28 @@ Use the **expansion-creator** pack to build your own:
1635
1650
  ## Advanced 2025 Techniques
1636
1651
 
1637
1652
  **Self-Consistency Validation**
1653
+
1638
1654
  - Generate multiple reasoning paths for same problem
1639
1655
  - Compare consistency across different approaches
1640
1656
  - Identify most reliable and robust solution
1641
1657
  - Highlight areas where approaches diverge and why
1642
1658
 
1643
1659
  **ReWOO (Reasoning Without Observation)**
1660
+
1644
1661
  - Separate parametric reasoning from tool-based actions
1645
1662
  - Create reasoning plan without external dependencies
1646
1663
  - Identify what can be solved through pure reasoning
1647
1664
  - Optimize for efficiency and reduced token usage
1648
1665
 
1649
1666
  **Persona-Pattern Hybrid**
1667
+
1650
1668
  - Combine specific role expertise with elicitation pattern
1651
1669
  - Architect + Risk Analysis: Deep technical risk assessment
1652
1670
  - UX Expert + User Journey: End-to-end experience critique
1653
1671
  - PM + Stakeholder Analysis: Multi-perspective impact review
1654
1672
 
1655
1673
  **Emergent Collaboration Discovery**
1674
+
1656
1675
  - Allow multiple perspectives to naturally emerge
1657
1676
  - Identify unexpected insights from persona interactions
1658
1677
  - Explore novel combinations of viewpoints
@@ -1661,18 +1680,21 @@ Use the **expansion-creator** pack to build your own:
1661
1680
  ## Game-Based Elicitation Methods
1662
1681
 
1663
1682
  **Red Team vs Blue Team**
1683
+
1664
1684
  - Red Team: Attack the proposal, find vulnerabilities
1665
1685
  - Blue Team: Defend and strengthen the approach
1666
1686
  - Competitive analysis reveals blind spots
1667
1687
  - Results in more robust, battle-tested solutions
1668
1688
 
1669
1689
  **Innovation Tournament**
1690
+
1670
1691
  - Pit multiple alternative approaches against each other
1671
1692
  - Score each approach across different criteria
1672
1693
  - Crowd-source evaluation from different personas
1673
1694
  - Identify winning combination of features
1674
1695
 
1675
1696
  **Escape Room Challenge**
1697
+
1676
1698
  - Present content as constraints to work within
1677
1699
  - Find creative solutions within tight limitations
1678
1700
  - Identify minimum viable approach
@@ -1681,6 +1703,7 @@ Use the **expansion-creator** pack to build your own:
1681
1703
  ## Process Control
1682
1704
 
1683
1705
  **Proceed / No Further Actions**
1706
+
1684
1707
  - Acknowledge choice to finalize current work
1685
1708
  - Accept output as-is or move to next step
1686
1709
  - Prepare to continue without additional elicitation
@@ -1804,7 +1827,7 @@ If user selects Option 1, present numbered list of techniques from the brainstor
1804
1827
  1. Apply selected technique according to data file description
1805
1828
  2. Keep engaging with technique until user indicates they want to:
1806
1829
  - Choose a different technique
1807
- - Apply current ideas to a new technique
1830
+ - Apply current ideas to a new technique
1808
1831
  - Move to convergent phase
1809
1832
  - End session
1810
1833
 
@@ -1921,63 +1944,54 @@ CRITICAL: First, help the user select the most appropriate research focus based
1921
1944
  Present these numbered options to the user:
1922
1945
 
1923
1946
  1. **Product Validation Research**
1924
-
1925
1947
  - Validate product hypotheses and market fit
1926
1948
  - Test assumptions about user needs and solutions
1927
1949
  - Assess technical and business feasibility
1928
1950
  - Identify risks and mitigation strategies
1929
1951
 
1930
1952
  2. **Market Opportunity Research**
1931
-
1932
1953
  - Analyze market size and growth potential
1933
1954
  - Identify market segments and dynamics
1934
1955
  - Assess market entry strategies
1935
1956
  - Evaluate timing and market readiness
1936
1957
 
1937
1958
  3. **User & Customer Research**
1938
-
1939
1959
  - Deep dive into user personas and behaviors
1940
1960
  - Understand jobs-to-be-done and pain points
1941
1961
  - Map customer journeys and touchpoints
1942
1962
  - Analyze willingness to pay and value perception
1943
1963
 
1944
1964
  4. **Competitive Intelligence Research**
1945
-
1946
1965
  - Detailed competitor analysis and positioning
1947
1966
  - Feature and capability comparisons
1948
1967
  - Business model and strategy analysis
1949
1968
  - Identify competitive advantages and gaps
1950
1969
 
1951
1970
  5. **Technology & Innovation Research**
1952
-
1953
1971
  - Assess technology trends and possibilities
1954
1972
  - Evaluate technical approaches and architectures
1955
1973
  - Identify emerging technologies and disruptions
1956
1974
  - Analyze build vs. buy vs. partner options
1957
1975
 
1958
1976
  6. **Industry & Ecosystem Research**
1959
-
1960
1977
  - Map industry value chains and dynamics
1961
1978
  - Identify key players and relationships
1962
1979
  - Analyze regulatory and compliance factors
1963
1980
  - Understand partnership opportunities
1964
1981
 
1965
1982
  7. **Strategic Options Research**
1966
-
1967
1983
  - Evaluate different strategic directions
1968
1984
  - Assess business model alternatives
1969
1985
  - Analyze go-to-market strategies
1970
1986
  - Consider expansion and scaling paths
1971
1987
 
1972
1988
  8. **Risk & Feasibility Research**
1973
-
1974
1989
  - Identify and assess various risk factors
1975
1990
  - Evaluate implementation challenges
1976
1991
  - Analyze resource requirements
1977
1992
  - Consider regulatory and legal implications
1978
1993
 
1979
1994
  9. **Custom Research Focus**
1980
-
1981
1995
  - User-defined research objectives
1982
1996
  - Specialized domain investigation
1983
1997
  - Cross-functional research needs
@@ -2146,13 +2160,11 @@ CRITICAL: collaborate with the user to develop specific, actionable research que
2146
2160
  ### 5. Review and Refinement
2147
2161
 
2148
2162
  1. **Present Complete Prompt**
2149
-
2150
2163
  - Show the full research prompt
2151
2164
  - Explain key elements and rationale
2152
2165
  - Highlight any assumptions made
2153
2166
 
2154
2167
  2. **Gather Feedback**
2155
-
2156
2168
  - Are the objectives clear and correct?
2157
2169
  - Do the questions address all concerns?
2158
2170
  - Is the scope appropriate?
@@ -2303,9 +2315,9 @@ This document captures the CURRENT STATE of the [Project Name] codebase, includi
2303
2315
 
2304
2316
  ### Change Log
2305
2317
 
2306
- | Date | Version | Description | Author |
2307
- |------|---------|-------------|--------|
2308
- | [Date] | 1.0 | Initial brownfield analysis | [Analyst] |
2318
+ | Date | Version | Description | Author |
2319
+ | ------ | ------- | --------------------------- | --------- |
2320
+ | [Date] | 1.0 | Initial brownfield analysis | [Analyst] |
2309
2321
 
2310
2322
  ## Quick Reference - Key Files and Entry Points
2311
2323
 
@@ -2328,11 +2340,11 @@ This document captures the CURRENT STATE of the [Project Name] codebase, includi
2328
2340
 
2329
2341
  ### Actual Tech Stack (from package.json/requirements.txt)
2330
2342
 
2331
- | Category | Technology | Version | Notes |
2332
- |----------|------------|---------|--------|
2333
- | Runtime | Node.js | 16.x | [Any constraints] |
2334
- | Framework | Express | 4.18.2 | [Custom middleware?] |
2335
- | Database | PostgreSQL | 13 | [Connection pooling setup] |
2343
+ | Category | Technology | Version | Notes |
2344
+ | --------- | ---------- | ------- | -------------------------- |
2345
+ | Runtime | Node.js | 16.x | [Any constraints] |
2346
+ | Framework | Express | 4.18.2 | [Custom middleware?] |
2347
+ | Database | PostgreSQL | 13 | [Connection pooling setup] |
2336
2348
 
2337
2349
  etc...
2338
2350
 
@@ -2371,6 +2383,7 @@ project-root/
2371
2383
  ### Data Models
2372
2384
 
2373
2385
  Instead of duplicating, reference actual model files:
2386
+
2374
2387
  - **User Model**: See `src/models/User.js`
2375
2388
  - **Order Model**: See `src/models/Order.js`
2376
2389
  - **Related Types**: TypeScript definitions in `src/types/`
@@ -2400,10 +2413,10 @@ Instead of duplicating, reference actual model files:
2400
2413
 
2401
2414
  ### External Services
2402
2415
 
2403
- | Service | Purpose | Integration Type | Key Files |
2404
- |---------|---------|------------------|-----------|
2405
- | Stripe | Payments | REST API | `src/integrations/stripe/` |
2406
- | SendGrid | Emails | SDK | `src/services/emailService.js` |
2416
+ | Service | Purpose | Integration Type | Key Files |
2417
+ | -------- | -------- | ---------------- | ------------------------------ |
2418
+ | Stripe | Payments | REST API | `src/integrations/stripe/` |
2419
+ | SendGrid | Emails | SDK | `src/services/emailService.js` |
2407
2420
 
2408
2421
  etc...
2409
2422
 
@@ -2448,6 +2461,7 @@ npm run test:integration # Runs integration tests (requires local DB)
2448
2461
  ### Files That Will Need Modification
2449
2462
 
2450
2463
  Based on the enhancement requirements, these files will be affected:
2464
+
2451
2465
  - `src/services/userService.js` - Add new user fields
2452
2466
  - `src/models/User.js` - Update schema
2453
2467
  - `src/routes/userRoutes.js` - New endpoints
@@ -3904,7 +3918,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
3904
3918
  ## Instructions
3905
3919
 
3906
3920
  1. **Initial Assessment**
3907
-
3908
3921
  - If user or the task being run provides a checklist name:
3909
3922
  - Try fuzzy matching (e.g. "architecture checklist" -> "architect-checklist")
3910
3923
  - If multiple matches found, ask user to clarify
@@ -3917,14 +3930,12 @@ If the user asks or does not specify a specific checklist, list the checklists a
3917
3930
  - All at once (YOLO mode - recommended for checklists, there will be a summary of sections at the end to discuss)
3918
3931
 
3919
3932
  2. **Document and Artifact Gathering**
3920
-
3921
3933
  - Each checklist will specify its required documents/artifacts at the beginning
3922
3934
  - 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.
3923
3935
 
3924
3936
  3. **Checklist Processing**
3925
3937
 
3926
3938
  If in interactive mode:
3927
-
3928
3939
  - Work through each section of the checklist one at a time
3929
3940
  - For each section:
3930
3941
  - Review all items in the section following instructions for that section embedded in the checklist
@@ -3933,7 +3944,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
3933
3944
  - Get user confirmation before proceeding to next section or if any thing major do we need to halt and take corrective action
3934
3945
 
3935
3946
  If in YOLO mode:
3936
-
3937
3947
  - Process all sections at once
3938
3948
  - Create a comprehensive report of all findings
3939
3949
  - Present the complete analysis to the user
@@ -3941,7 +3951,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
3941
3951
  4. **Validation Approach**
3942
3952
 
3943
3953
  For each checklist item:
3944
-
3945
3954
  - Read and understand the requirement
3946
3955
  - Look for evidence in the documentation that satisfies the requirement
3947
3956
  - Consider both explicit mentions and implicit coverage
@@ -3955,7 +3964,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
3955
3964
  5. **Section Analysis**
3956
3965
 
3957
3966
  For each section:
3958
-
3959
3967
  - think step by step to calculate pass rate
3960
3968
  - Identify common themes in failed items
3961
3969
  - Provide specific recommendations for improvement
@@ -3965,7 +3973,6 @@ If the user asks or does not specify a specific checklist, list the checklists a
3965
3973
  6. **Final Report**
3966
3974
 
3967
3975
  Prepare a summary that includes:
3968
-
3969
3976
  - Overall checklist completion status
3970
3977
  - Pass rates by section
3971
3978
  - List of failed items with context
@@ -4082,13 +4089,11 @@ CRITICAL: Use proper parsing that understands markdown context. A ## inside a co
4082
4089
  For each extracted section:
4083
4090
 
4084
4091
  1. **Generate filename**: Convert the section heading to lowercase-dash-case
4085
-
4086
4092
  - Remove special characters
4087
4093
  - Replace spaces with dashes
4088
4094
  - Example: "## Tech Stack" → `tech-stack.md`
4089
4095
 
4090
4096
  2. **Adjust heading levels**:
4091
-
4092
4097
  - The level 2 heading becomes level 1 (# instead of ##) in the sharded new document
4093
4098
  - All subsection levels decrease by 1:
4094
4099
 
@@ -4973,7 +4978,6 @@ Ask the user if they want to work through the checklist:
4973
4978
  Create a comprehensive validation report that includes:
4974
4979
 
4975
4980
  1. Executive Summary
4976
-
4977
4981
  - Overall PRD completeness (percentage)
4978
4982
  - MVP scope appropriateness (Too Large/Just Right/Too Small)
4979
4983
  - Readiness for architecture phase (Ready/Nearly Ready/Not Ready)
@@ -4981,26 +4985,22 @@ Create a comprehensive validation report that includes:
4981
4985
 
4982
4986
  2. Category Analysis Table
4983
4987
  Fill in the actual table with:
4984
-
4985
4988
  - Status: PASS (90%+ complete), PARTIAL (60-89%), FAIL (<60%)
4986
4989
  - Critical Issues: Specific problems that block progress
4987
4990
 
4988
4991
  3. Top Issues by Priority
4989
-
4990
4992
  - BLOCKERS: Must fix before architect can proceed
4991
4993
  - HIGH: Should fix for quality
4992
4994
  - MEDIUM: Would improve clarity
4993
4995
  - LOW: Nice to have
4994
4996
 
4995
4997
  4. MVP Scope Assessment
4996
-
4997
4998
  - Features that might be cut for true MVP
4998
4999
  - Missing features that are essential
4999
5000
  - Complexity concerns
5000
5001
  - Timeline realism
5001
5002
 
5002
5003
  5. Technical Readiness
5003
-
5004
5004
  - Clarity of technical constraints
5005
5005
  - Identified technical risks
5006
5006
  - Areas needing architect investigation
@@ -7790,33 +7790,28 @@ Ask the user if they want to work through the checklist:
7790
7790
  Now that you've completed the checklist, generate a comprehensive validation report that includes:
7791
7791
 
7792
7792
  1. Executive Summary
7793
-
7794
7793
  - Overall architecture readiness (High/Medium/Low)
7795
7794
  - Critical risks identified
7796
7795
  - Key strengths of the architecture
7797
7796
  - Project type (Full-stack/Frontend/Backend) and sections evaluated
7798
7797
 
7799
7798
  2. Section Analysis
7800
-
7801
7799
  - Pass rate for each major section (percentage of items passed)
7802
7800
  - Most concerning failures or gaps
7803
7801
  - Sections requiring immediate attention
7804
7802
  - Note any sections skipped due to project type
7805
7803
 
7806
7804
  3. Risk Assessment
7807
-
7808
7805
  - Top 5 risks by severity
7809
7806
  - Mitigation recommendations for each
7810
7807
  - Timeline impact of addressing issues
7811
7808
 
7812
7809
  4. Recommendations
7813
-
7814
7810
  - Must-fix items before development
7815
7811
  - Should-fix items for better quality
7816
7812
  - Nice-to-have improvements
7817
7813
 
7818
7814
  5. AI Implementation Readiness
7819
-
7820
7815
  - Specific concerns for AI agent implementation
7821
7816
  - Areas needing additional clarification
7822
7817
  - Complexity hotspots to address
@@ -8118,12 +8113,10 @@ PROJECT TYPE DETECTION:
8118
8113
  First, determine the project type by checking:
8119
8114
 
8120
8115
  1. Is this a GREENFIELD project (new from scratch)?
8121
-
8122
8116
  - Look for: New project initialization, no existing codebase references
8123
8117
  - Check for: prd.md, architecture.md, new project setup stories
8124
8118
 
8125
8119
  2. Is this a BROWNFIELD project (enhancing existing system)?
8126
-
8127
8120
  - Look for: References to existing codebase, enhancement/modification language
8128
8121
  - Check for: brownfield-prd.md, brownfield-architecture.md, existing system analysis
8129
8122
 
@@ -8457,7 +8450,6 @@ Ask the user if they want to work through the checklist:
8457
8450
  Generate a comprehensive validation report that adapts to project type:
8458
8451
 
8459
8452
  1. Executive Summary
8460
-
8461
8453
  - Project type: [Greenfield/Brownfield] with [UI/No UI]
8462
8454
  - Overall readiness (percentage)
8463
8455
  - Go/No-Go recommendation
@@ -8467,42 +8459,36 @@ Generate a comprehensive validation report that adapts to project type:
8467
8459
  2. Project-Specific Analysis
8468
8460
 
8469
8461
  FOR GREENFIELD:
8470
-
8471
8462
  - Setup completeness
8472
8463
  - Dependency sequencing
8473
8464
  - MVP scope appropriateness
8474
8465
  - Development timeline feasibility
8475
8466
 
8476
8467
  FOR BROWNFIELD:
8477
-
8478
8468
  - Integration risk level (High/Medium/Low)
8479
8469
  - Existing system impact assessment
8480
8470
  - Rollback readiness
8481
8471
  - User disruption potential
8482
8472
 
8483
8473
  3. Risk Assessment
8484
-
8485
8474
  - Top 5 risks by severity
8486
8475
  - Mitigation recommendations
8487
8476
  - Timeline impact of addressing issues
8488
8477
  - [BROWNFIELD] Specific integration risks
8489
8478
 
8490
8479
  4. MVP Completeness
8491
-
8492
8480
  - Core features coverage
8493
8481
  - Missing essential functionality
8494
8482
  - Scope creep identified
8495
8483
  - True MVP vs over-engineering
8496
8484
 
8497
8485
  5. Implementation Readiness
8498
-
8499
8486
  - Developer clarity score (1-10)
8500
8487
  - Ambiguous requirements count
8501
8488
  - Missing technical details
8502
8489
  - [BROWNFIELD] Integration point clarity
8503
8490
 
8504
8491
  6. Recommendations
8505
-
8506
8492
  - Must-fix before development
8507
8493
  - Should-fix for quality
8508
8494
  - Consider for improvement