bmad-method 4.6.0 → 4.6.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -2019,3 +2019,38 @@ This checklist serves as a comprehensive framework for validating infrastructure
2019
2019
  - [ ] Platform component integration validated
2020
2020
  - [ ] Cross-platform functionality tested and verified
2021
2021
  ==================== END: checklists#infrastructure-checklist ====================
2022
+
2023
+ ==================== START: data#technical-preferences ====================
2024
+ # User-Defined Preferred Patterns and Preferences
2025
+
2026
+ None Listed
2027
+ ==================== END: data#technical-preferences ====================
2028
+
2029
+ ==================== START: utils#template-format ====================
2030
+ # Template Format Conventions
2031
+
2032
+ Templates in the BMAD method use standardized markup for AI processing. These conventions ensure consistent document generation.
2033
+
2034
+ ## Template Markup Elements
2035
+
2036
+ - **{{placeholders}}**: Variables to be replaced with actual content
2037
+ - **[[LLM: instructions]]**: Internal processing instructions for AI agents (never shown to users)
2038
+ - **REPEAT** sections: Content blocks that may be repeated as needed
2039
+ - **^^CONDITION^^** blocks: Conditional content included only if criteria are met
2040
+ - **@{examples}**: Example content for guidance (never output to users)
2041
+
2042
+ ## Processing Rules
2043
+
2044
+ - Replace all {{placeholders}} with project-specific content
2045
+ - Execute all [[LLM: instructions]] internally without showing users
2046
+ - Process conditional and repeat blocks as specified
2047
+ - Use examples for guidance but never include them in final output
2048
+ - Present only clean, formatted content to users
2049
+
2050
+ ## Critical Guidelines
2051
+
2052
+ - **NEVER display template markup, LLM instructions, or examples to users**
2053
+ - Template elements are for AI processing only
2054
+ - Focus on faithful template execution and clean output
2055
+ - All template-specific instructions are embedded within templates
2056
+ ==================== END: utils#template-format ====================
@@ -1330,6 +1330,405 @@ Embedded knowledge (automatic):
1330
1330
  ```
1331
1331
  ==================== END: tasks#generate-expansion-pack ====================
1332
1332
 
1333
+ ==================== START: tasks#advanced-elicitation ====================
1334
+ # Advanced Elicitation Task
1335
+
1336
+ ## Purpose
1337
+
1338
+ - Provide optional reflective and brainstorming actions to enhance content quality
1339
+ - Enable deeper exploration of ideas through structured elicitation techniques
1340
+ - Support iterative refinement through multiple analytical perspectives
1341
+
1342
+ ## Task Instructions
1343
+
1344
+ ### 1. Section Context and Review
1345
+
1346
+ [[LLM: When invoked after outputting a section:
1347
+
1348
+ 1. First, provide a brief 1-2 sentence summary of what the user should look for in the section just presented (e.g., "Please review the technology choices for completeness and alignment with your project needs. Pay special attention to version numbers and any missing categories.")
1349
+
1350
+ 2. If the section contains Mermaid diagrams, explain each diagram briefly before offering elicitation options (e.g., "The component diagram shows the main system modules and their interactions. Notice how the API Gateway routes requests to different services.")
1351
+
1352
+ 3. If the section contains multiple distinct items (like multiple components, multiple patterns, etc.), inform the user they can apply elicitation actions to:
1353
+
1354
+ - The entire section as a whole
1355
+ - Individual items within the section (specify which item when selecting an action)
1356
+
1357
+ 4. Then present the action list as specified below.]]
1358
+
1359
+ ### 2. Ask for Review and Present Action List
1360
+
1361
+ [[LLM: Ask the user to review the drafted section. In the SAME message, inform them that they can suggest additions, removals, or modifications, OR they can select an action by number from the 'Advanced Reflective, Elicitation & Brainstorming Actions'. If there are multiple items in the section, mention they can specify which item(s) to apply the action to. Then, present ONLY the numbered list (0-9) of these actions. Conclude by stating that selecting 9 will proceed to the next section. Await user selection. If an elicitation action (0-8) is chosen, execute it and then re-offer this combined review/elicitation choice. If option 9 is chosen, or if the user provides direct feedback, proceed accordingly.]]
1362
+
1363
+ **Present the numbered list (0-9) with this exact format:**
1364
+
1365
+ ```text
1366
+ **Advanced Reflective, Elicitation & Brainstorming Actions**
1367
+ Choose an action (0-9 - 9 to bypass - HELP for explanation of these options):
1368
+
1369
+ 0. Expand or Contract for Audience
1370
+ 1. Explain Reasoning (CoT Step-by-Step)
1371
+ 2. Critique and Refine
1372
+ 3. Analyze Logical Flow and Dependencies
1373
+ 4. Assess Alignment with Overall Goals
1374
+ 5. Identify Potential Risks and Unforeseen Issues
1375
+ 6. Challenge from Critical Perspective (Self or Other Persona)
1376
+ 7. Explore Diverse Alternatives (ToT-Inspired)
1377
+ 8. Hindsight is 20/20: The 'If Only...' Reflection
1378
+ 9. Proceed / No Further Actions
1379
+ ```
1380
+
1381
+ ### 2. Processing Guidelines
1382
+
1383
+ **Do NOT show:**
1384
+
1385
+ - The full protocol text with `[[LLM: ...]]` instructions
1386
+ - Detailed explanations of each option unless executing or the user asks, when giving the definition you can modify to tie its relevance
1387
+ - Any internal template markup
1388
+
1389
+ **After user selection from the list:**
1390
+
1391
+ - Execute the chosen action according to the protocol instructions below
1392
+ - Ask if they want to select another action or proceed with option 9 once complete
1393
+ - Continue until user selects option 9 or indicates completion
1394
+
1395
+ ## Action Definitions
1396
+
1397
+ 0. Expand or Contract for Audience
1398
+ [[LLM: Ask the user whether they want to 'expand' on the content (add more detail, elaborate) or 'contract' it (simplify, clarify, make more concise). Also, ask if there's a specific target audience they have in mind. Once clarified, perform the expansion or contraction from your current role's perspective, tailored to the specified audience if provided.]]
1399
+
1400
+ 1. Explain Reasoning (CoT Step-by-Step)
1401
+ [[LLM: Explain the step-by-step thinking process, characteristic of your role, that you used to arrive at the current proposal for this content.]]
1402
+
1403
+ 2. Critique and Refine
1404
+ [[LLM: From your current role's perspective, review your last output or the current section for flaws, inconsistencies, or areas for improvement, and then suggest a refined version reflecting your expertise.]]
1405
+
1406
+ 3. Analyze Logical Flow and Dependencies
1407
+ [[LLM: From your role's standpoint, examine the content's structure for logical progression, internal consistency, and any relevant dependencies. Confirm if elements are presented in an effective order.]]
1408
+
1409
+ 4. Assess Alignment with Overall Goals
1410
+ [[LLM: Evaluate how well the current content contributes to the stated overall goals of the document, interpreting this from your specific role's perspective and identifying any misalignments you perceive.]]
1411
+
1412
+ 5. Identify Potential Risks and Unforeseen Issues
1413
+ [[LLM: Based on your role's expertise, brainstorm potential risks, overlooked edge cases, or unintended consequences related to the current content or proposal.]]
1414
+
1415
+ 6. Challenge from Critical Perspective (Self or Other Persona)
1416
+ [[LLM: Adopt a critical perspective on the current content. If the user specifies another role or persona (e.g., 'as a customer', 'as [Another Persona Name]'), critique the content or play devil's advocate from that specified viewpoint. If no other role is specified, play devil's advocate from your own current persona's viewpoint, arguing against the proposal or current content and highlighting weaknesses or counterarguments specific to your concerns. This can also randomly include YAGNI when appropriate, such as when trimming the scope of an MVP, the perspective might challenge the need for something to cut MVP scope.]]
1417
+
1418
+ 7. Explore Diverse Alternatives (ToT-Inspired)
1419
+ [[LLM: From your role's perspective, first broadly brainstorm a range of diverse approaches or solutions to the current topic. Then, from this wider exploration, select and present 2 distinct alternatives, detailing the pros, cons, and potential implications you foresee for each.]]
1420
+
1421
+ 8. Hindsight is 20/20: The 'If Only...' Reflection
1422
+ [[LLM: In your current persona, imagine it's a retrospective for a project based on the current content. What's the one 'if only we had known/done X...' that your role would humorously or dramatically highlight, along with the imagined consequences?]]
1423
+
1424
+ 9. Proceed / No Further Actions
1425
+ [[LLM: Acknowledge the user's choice to finalize the current work, accept the AI's last output as is, or move on to the next step without selecting another action from this list. Prepare to proceed accordingly.]]
1426
+ ==================== END: tasks#advanced-elicitation ====================
1427
+
1428
+ ==================== START: tasks#create-deep-research-prompt ====================
1429
+ # Create Deep Research Prompt Task
1430
+
1431
+ This task helps create comprehensive research prompts for various types of deep analysis. It can process inputs from brainstorming sessions, project briefs, market research, or specific research questions to generate targeted prompts for deeper investigation.
1432
+
1433
+ ## Purpose
1434
+
1435
+ Generate well-structured research prompts that:
1436
+
1437
+ - Define clear research objectives and scope
1438
+ - Specify appropriate research methodologies
1439
+ - Outline expected deliverables and formats
1440
+ - Guide systematic investigation of complex topics
1441
+ - Ensure actionable insights are captured
1442
+
1443
+ ## Research Type Selection
1444
+
1445
+ [[LLM: First, help the user select the most appropriate research focus based on their needs and any input documents they've provided.]]
1446
+
1447
+ ### 1. Research Focus Options
1448
+
1449
+ Present these numbered options to the user:
1450
+
1451
+ 1. **Product Validation Research**
1452
+
1453
+ - Validate product hypotheses and market fit
1454
+ - Test assumptions about user needs and solutions
1455
+ - Assess technical and business feasibility
1456
+ - Identify risks and mitigation strategies
1457
+
1458
+ 2. **Market Opportunity Research**
1459
+
1460
+ - Analyze market size and growth potential
1461
+ - Identify market segments and dynamics
1462
+ - Assess market entry strategies
1463
+ - Evaluate timing and market readiness
1464
+
1465
+ 3. **User & Customer Research**
1466
+
1467
+ - Deep dive into user personas and behaviors
1468
+ - Understand jobs-to-be-done and pain points
1469
+ - Map customer journeys and touchpoints
1470
+ - Analyze willingness to pay and value perception
1471
+
1472
+ 4. **Competitive Intelligence Research**
1473
+
1474
+ - Detailed competitor analysis and positioning
1475
+ - Feature and capability comparisons
1476
+ - Business model and strategy analysis
1477
+ - Identify competitive advantages and gaps
1478
+
1479
+ 5. **Technology & Innovation Research**
1480
+
1481
+ - Assess technology trends and possibilities
1482
+ - Evaluate technical approaches and architectures
1483
+ - Identify emerging technologies and disruptions
1484
+ - Analyze build vs. buy vs. partner options
1485
+
1486
+ 6. **Industry & Ecosystem Research**
1487
+
1488
+ - Map industry value chains and dynamics
1489
+ - Identify key players and relationships
1490
+ - Analyze regulatory and compliance factors
1491
+ - Understand partnership opportunities
1492
+
1493
+ 7. **Strategic Options Research**
1494
+
1495
+ - Evaluate different strategic directions
1496
+ - Assess business model alternatives
1497
+ - Analyze go-to-market strategies
1498
+ - Consider expansion and scaling paths
1499
+
1500
+ 8. **Risk & Feasibility Research**
1501
+
1502
+ - Identify and assess various risk factors
1503
+ - Evaluate implementation challenges
1504
+ - Analyze resource requirements
1505
+ - Consider regulatory and legal implications
1506
+
1507
+ 9. **Custom Research Focus**
1508
+ [[LLM: Allow user to define their own specific research focus.]]
1509
+ - User-defined research objectives
1510
+ - Specialized domain investigation
1511
+ - Cross-functional research needs
1512
+
1513
+ ### 2. Input Processing
1514
+
1515
+ [[LLM: Based on the selected research type and any provided inputs (project brief, brainstorming results, etc.), extract relevant context and constraints.]]
1516
+
1517
+ **If Project Brief provided:**
1518
+
1519
+ - Extract key product concepts and goals
1520
+ - Identify target users and use cases
1521
+ - Note technical constraints and preferences
1522
+ - Highlight uncertainties and assumptions
1523
+
1524
+ **If Brainstorming Results provided:**
1525
+
1526
+ - Synthesize main ideas and themes
1527
+ - Identify areas needing validation
1528
+ - Extract hypotheses to test
1529
+ - Note creative directions to explore
1530
+
1531
+ **If Market Research provided:**
1532
+
1533
+ - Build on identified opportunities
1534
+ - Deepen specific market insights
1535
+ - Validate initial findings
1536
+ - Explore adjacent possibilities
1537
+
1538
+ **If Starting Fresh:**
1539
+
1540
+ - Gather essential context through questions
1541
+ - Define the problem space
1542
+ - Clarify research objectives
1543
+ - Establish success criteria
1544
+
1545
+ ## Process
1546
+
1547
+ ### 3. Research Prompt Structure
1548
+
1549
+ [[LLM: Based on the selected research type and context, collaboratively develop a comprehensive research prompt with these components.]]
1550
+
1551
+ #### A. Research Objectives
1552
+
1553
+ [[LLM: Work with the user to articulate clear, specific objectives for the research.]]
1554
+
1555
+ - Primary research goal and purpose
1556
+ - Key decisions the research will inform
1557
+ - Success criteria for the research
1558
+ - Constraints and boundaries
1559
+
1560
+ #### B. Research Questions
1561
+
1562
+ [[LLM: Develop specific, actionable research questions organized by theme.]]
1563
+
1564
+ **Core Questions:**
1565
+
1566
+ - Central questions that must be answered
1567
+ - Priority ranking of questions
1568
+ - Dependencies between questions
1569
+
1570
+ **Supporting Questions:**
1571
+
1572
+ - Additional context-building questions
1573
+ - Nice-to-have insights
1574
+ - Future-looking considerations
1575
+
1576
+ #### C. Research Methodology
1577
+
1578
+ [[LLM: Specify appropriate research methods based on the type and objectives.]]
1579
+
1580
+ **Data Collection Methods:**
1581
+
1582
+ - Secondary research sources
1583
+ - Primary research approaches (if applicable)
1584
+ - Data quality requirements
1585
+ - Source credibility criteria
1586
+
1587
+ **Analysis Frameworks:**
1588
+
1589
+ - Specific frameworks to apply
1590
+ - Comparison criteria
1591
+ - Evaluation methodologies
1592
+ - Synthesis approaches
1593
+
1594
+ #### D. Output Requirements
1595
+
1596
+ [[LLM: Define how research findings should be structured and presented.]]
1597
+
1598
+ **Format Specifications:**
1599
+
1600
+ - Executive summary requirements
1601
+ - Detailed findings structure
1602
+ - Visual/tabular presentations
1603
+ - Supporting documentation
1604
+
1605
+ **Key Deliverables:**
1606
+
1607
+ - Must-have sections and insights
1608
+ - Decision-support elements
1609
+ - Action-oriented recommendations
1610
+ - Risk and uncertainty documentation
1611
+
1612
+ ### 4. Prompt Generation
1613
+
1614
+ [[LLM: Synthesize all elements into a comprehensive, ready-to-use research prompt.]]
1615
+
1616
+ **Research Prompt Template:**
1617
+
1618
+ ```markdown
1619
+ ## Research Objective
1620
+
1621
+ [Clear statement of what this research aims to achieve]
1622
+
1623
+ ## Background Context
1624
+
1625
+ [Relevant information from project brief, brainstorming, or other inputs]
1626
+
1627
+ ## Research Questions
1628
+
1629
+ ### Primary Questions (Must Answer)
1630
+
1631
+ 1. [Specific, actionable question]
1632
+ 2. [Specific, actionable question]
1633
+ ...
1634
+
1635
+ ### Secondary Questions (Nice to Have)
1636
+
1637
+ 1. [Supporting question]
1638
+ 2. [Supporting question]
1639
+ ...
1640
+
1641
+ ## Research Methodology
1642
+
1643
+ ### Information Sources
1644
+
1645
+ - [Specific source types and priorities]
1646
+
1647
+ ### Analysis Frameworks
1648
+
1649
+ - [Specific frameworks to apply]
1650
+
1651
+ ### Data Requirements
1652
+
1653
+ - [Quality, recency, credibility needs]
1654
+
1655
+ ## Expected Deliverables
1656
+
1657
+ ### Executive Summary
1658
+
1659
+ - Key findings and insights
1660
+ - Critical implications
1661
+ - Recommended actions
1662
+
1663
+ ### Detailed Analysis
1664
+
1665
+ [Specific sections needed based on research type]
1666
+
1667
+ ### Supporting Materials
1668
+
1669
+ - Data tables
1670
+ - Comparison matrices
1671
+ - Source documentation
1672
+
1673
+ ## Success Criteria
1674
+
1675
+ [How to evaluate if research achieved its objectives]
1676
+
1677
+ ## Timeline and Priority
1678
+
1679
+ [If applicable, any time constraints or phasing]
1680
+ ```
1681
+
1682
+ ### 5. Review and Refinement
1683
+
1684
+ [[LLM: Present the draft research prompt for user review and refinement.]]
1685
+
1686
+ 1. **Present Complete Prompt**
1687
+
1688
+ - Show the full research prompt
1689
+ - Explain key elements and rationale
1690
+ - Highlight any assumptions made
1691
+
1692
+ 2. **Gather Feedback**
1693
+
1694
+ - Are the objectives clear and correct?
1695
+ - Do the questions address all concerns?
1696
+ - Is the scope appropriate?
1697
+ - Are output requirements sufficient?
1698
+
1699
+ 3. **Refine as Needed**
1700
+ - Incorporate user feedback
1701
+ - Adjust scope or focus
1702
+ - Add missing elements
1703
+ - Clarify ambiguities
1704
+
1705
+ ### 6. Next Steps Guidance
1706
+
1707
+ [[LLM: Provide clear guidance on how to use the research prompt.]]
1708
+
1709
+ **Execution Options:**
1710
+
1711
+ 1. **Use with AI Research Assistant**: Provide this prompt to an AI model with research capabilities
1712
+ 2. **Guide Human Research**: Use as a framework for manual research efforts
1713
+ 3. **Hybrid Approach**: Combine AI and human research using this structure
1714
+
1715
+ **Integration Points:**
1716
+
1717
+ - How findings will feed into next phases
1718
+ - Which team members should review results
1719
+ - How to validate findings
1720
+ - When to revisit or expand research
1721
+
1722
+ ## Important Notes
1723
+
1724
+ - The quality of the research prompt directly impacts the quality of insights gathered
1725
+ - Be specific rather than general in research questions
1726
+ - Consider both current state and future implications
1727
+ - Balance comprehensiveness with focus
1728
+ - Document assumptions and limitations clearly
1729
+ - Plan for iterative refinement based on initial findings
1730
+ ==================== END: tasks#create-deep-research-prompt ====================
1731
+
1333
1732
  ==================== START: templates#agent-tmpl ====================
1334
1733
  # [AGENT_ID]
1335
1734
 
@@ -3,6 +3,7 @@ bundle:
3
3
  icon: 🎮
4
4
  description: Game Development team specialized in 2D games using Phaser 3 and TypeScript.
5
5
  agents:
6
+ - analyst
6
7
  - bmad-orchestrator
7
8
  - game-designer
8
9
  - game-developer
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "bmad-method",
3
- "version": "4.6.0",
3
+ "version": "4.6.2",
4
4
  "description": "Breakthrough Method of Agile AI-driven Development",
5
5
  "main": "tools/cli.js",
6
6
  "bin": {