bmad-method 4.5.0 → 4.6.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (34) hide show
  1. package/CHANGELOG.md +19 -0
  2. package/bmad-core/agents/bmad-orchestrator.md +55 -66
  3. package/bmad-core/agents/pm.md +0 -1
  4. package/bmad-core/tasks/doc-migration-task.md +9 -9
  5. package/bmad-core/tasks/index-docs.md +3 -7
  6. package/bmad-core/templates/front-end-spec-tmpl.md +1 -1
  7. package/bmad-core/templates/fullstack-architecture-tmpl.md +60 -60
  8. package/bmad-core/templates/prd-tmpl.md +2 -2
  9. package/bmad-core/workflows/brownfield-fullstack.yml +19 -58
  10. package/bmad-core/workflows/brownfield-service.yml +19 -58
  11. package/bmad-core/workflows/brownfield-ui.yml +20 -59
  12. package/bmad-core/workflows/greenfield-fullstack.yml +31 -77
  13. package/bmad-core/workflows/greenfield-service.yml +22 -68
  14. package/bmad-core/workflows/greenfield-ui.yml +30 -76
  15. package/dist/agents/architect.txt +60 -60
  16. package/dist/agents/bmad-master.txt +66 -70
  17. package/dist/agents/bmad-orchestrator.txt +55 -66
  18. package/dist/agents/pm.txt +2 -467
  19. package/dist/agents/ux-expert.txt +1 -1
  20. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +55 -66
  21. package/dist/expansion-packs/expansion-creator/agents/bmad-the-creator.txt +39 -32
  22. package/dist/teams/team-all.txt +368 -1099
  23. package/dist/teams/team-fullstack.txt +286 -1017
  24. package/dist/teams/team-ide-minimal.txt +55 -66
  25. package/dist/teams/team-no-ui.txt +224 -785
  26. package/docs/claude-code-guide.md +6 -4
  27. package/docs/cursor-guide.md +8 -4
  28. package/docs/roo-code-guide.md +6 -4
  29. package/docs/versioning-and-releases.md +6 -6
  30. package/docs/windsurf-guide.md +6 -4
  31. package/expansion-packs/expansion-creator/tasks/generate-expansion-pack.md +17 -13
  32. package/package.json +1 -1
  33. package/tools/installer/package.json +1 -1
  34. package/bmad-core/templates/simple-project-prd-tmpl.md +0 -461
@@ -89,7 +89,6 @@ dependencies:
89
89
  templates:
90
90
  - prd-tmpl
91
91
  - brownfield-prd-tmpl
92
- - simple-project-prd-tmpl
93
92
  checklists:
94
93
  - pm-checklist
95
94
  - change-checklist
@@ -1265,7 +1264,7 @@ Document sharded successfully:
1265
1264
  CRITICAL: Epics MUST be logically sequential following agile best practices:
1266
1265
 
1267
1266
  - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
1268
- - Epic 1 must establish foundational project infrastructure (app setup, Git, CI/CD, core services) unless we are adding new functionality to an existing app, while also delivering an initial piece of functionality, even as simple as a health-check route or display of a simple canary page
1267
+ - Epic 1 must establish foundational project infrastructure (app setup, Git, CI/CD, core services) unless we are adding new functionality to an existing app, while also delivering an initial piece of functionality, even as simple as a health-check route or display of a simple canary page - remember this when we produce the stories for the first epic!
1269
1268
  - Each subsequent epic builds upon previous epics' functionality delivering major blocks of functionality that provide tangible value to users or business when deployed
1270
1269
  - Not every project needs multiple epics, an epic needs to deliver value. For example, an API completed can deliver value even if a UI is not complete and planned for a separate epic.
1271
1270
  - Err on the side of less epics, but let the user know your rationale and offer options for splitting them if it seems some are too large or focused on disparate things.
@@ -1297,7 +1296,7 @@ CRITICAL: Epics MUST be logically sequential following agile best practices:
1297
1296
  [[LLM: CRITICAL STORY SEQUENCING REQUIREMENTS:
1298
1297
 
1299
1298
  - Stories within each epic MUST be logically sequential
1300
- - Each story should be a "vertical slice" delivering complete functionality
1299
+ - Each story should be a "vertical slice" delivering complete functionality aside from early enabler stories for project foundation
1301
1300
  - No story should depend on work from a later story or epic
1302
1301
  - Identify and note any direct prerequisite stories
1303
1302
  - Focus on "what" and "why" not "how" (leave technical implementation to Architect) yet be precise enough to support a logical sequential order of operations from story to story.
@@ -1592,470 +1591,6 @@ so that {{benefit}}.
1592
1591
  <</REPEAT>>
1593
1592
  ==================== END: templates#brownfield-prd-tmpl ====================
1594
1593
 
1595
- ==================== START: templates#simple-project-prd-tmpl ====================
1596
- # {{Project Name}} Product Requirements Document (PRD)
1597
-
1598
- [[LLM: If available, review any provided document or ask if any are optionally available: Project Brief]]
1599
-
1600
- ## Goals and Background Context
1601
-
1602
- [[LLM: Populate the 2 child sections based on what we have received from user description or the provided brief. Allow user to review the 2 sections and offer changes before proceeding]]
1603
-
1604
- ### Goals
1605
-
1606
- [[LLM: Bullet list of 1 line desired outcomes the PRD will deliver if successful - user and project desires]]
1607
-
1608
- ### Background Context
1609
-
1610
- [[LLM: 1-2 short paragraphs summarizing the background context, such as what we learned in the brief without being redundant with the goals, what and why this solves a problem, what the current landscape or need is etc...]]
1611
-
1612
- ### Change Log
1613
-
1614
- [[LLM: Track document versions and changes]]
1615
-
1616
- | Date | Version | Description | Author |
1617
- | :--- | :------ | :---------- | :----- |
1618
-
1619
- ## Requirements
1620
-
1621
- [[LLM: Draft the list of functional and non functional requirements under the two child sections, and immediately execute tasks#advanced-elicitation display]]
1622
-
1623
- ### Functional
1624
-
1625
- [[LLM: Each Requirement will be a bullet markdown and an identifier sequence starting with FR`.]]
1626
- @{example: - FR6: The Todo List uses AI to detect and warn against adding potentially duplicate todo items that are worded differently.}
1627
-
1628
- ### Non Functional
1629
-
1630
- [[LLM: Each Requirement will be a bullet markdown and an identifier sequence starting with NFR`.]]
1631
- @{example: - NFR1: AWS service usage **must** aim to stay within free-tier limits where feasible.}
1632
-
1633
- ^^CONDITION: has_ui^^
1634
-
1635
- ## User Interface Design Goals
1636
-
1637
- [[LLM: Capture high-level UI/UX vision to inform story creation and also generate a prompt for Lovable or V0 if the user would like either. Steps:
1638
-
1639
- 1. Pre-fill all subsections with educated guesses based on project context
1640
- 2. Present the complete rendered section to user
1641
- 3. Clearly let the user know where assumptions were made
1642
- 4. Ask targeted questions for unclear/missing elements or areas needing more specification
1643
- 5. This is NOT detailed UI spec - focus on product vision and user goals
1644
- 6. After section completion, immediately apply `tasks#advanced-elicitation` protocol]]
1645
-
1646
- ### Overall UX Vision
1647
-
1648
- ### Key Interaction Paradigms
1649
-
1650
- ### Core Screens and Views
1651
-
1652
- [[LLM: From a product perspective, what are the most critical screens or views necessary to deliver the the PRD values and goals? This is meant to be Conceptual High Level to Drive Rough Epic or User Stories]]
1653
-
1654
- @{example}
1655
-
1656
- - Login Screen
1657
- - Main Dashboard
1658
- - Item Detail Page
1659
- - Settings Page
1660
- @{/example}
1661
-
1662
- ### Accessibility: { None, WCAG, etc }
1663
-
1664
- ### Branding
1665
-
1666
- [[LLM: Any known branding elements or style guides that must be incorporated?]]
1667
-
1668
- @{example}
1669
-
1670
- - Replicate the look and feel of early 1900s black and white cinema, including animated effects replicating film damage or projector glitches during page or state transitions.
1671
- - Attached is the full color pallet and tokens for our corporate branding.
1672
- @{/example}
1673
-
1674
- ### Target Device and Platforms
1675
-
1676
- @{example}
1677
- "Web Responsive, and all mobile platforms", "IPhone Only", "ASCII Windows Desktop"
1678
- @{/example}
1679
-
1680
- ^^/CONDITION: has_ui^^
1681
-
1682
- ## Technical Assumptions
1683
-
1684
- [[LLM: Gather technical decisions that will be used for this simple technical PRD that includes architecture decisions. Steps:
1685
-
1686
- 1. Check if `data#technical-preferences` or an attached `technical-preferences` file exists - use it to pre-populate choices
1687
- 2. Ask user about: languages, frameworks, starter templates, libraries, APIs, deployment targets
1688
- 3. For unknowns, offer guidance based on project goals and MVP scope
1689
- 4. Document ALL technical choices with rationale (why this choice fits the project)
1690
- 5. These become constraints for the Architect - be specific and complete
1691
- 6. After section completion, apply `tasks#advanced-elicitation` protocol.]]
1692
-
1693
- ### Repository Structure: { Monorepo, Polyrepo, etc...}
1694
-
1695
- ### Service Architecture
1696
-
1697
- [[LLM: CRITICAL DECISION - Document the high-level service architecture (e.g., Monolith, Microservices, Serverless functions within a Monorepo).]]
1698
-
1699
- ## Testing requirements
1700
-
1701
- [[LLM: CRITICAL DECISION - Document the testing requirements, unit only, integration, e2e, manual, need for manual testing convenience methods).]]
1702
-
1703
- ### Additional Technical Assumptions and Requests
1704
-
1705
- [[LLM: Throughout the entire process of drafting this document, if any other technical assumptions are raised or discovered appropriate for the architect, add them here as additional bulleted items]]
1706
-
1707
- ## Data Models
1708
-
1709
- [[LLM: Define the core data models/entities that will be used in the front end (if there is one), core application or back end, and if both, shared between frontend and backend:
1710
-
1711
- 1. Review PRD requirements and identify key business entities
1712
- 2. For each model, explain its purpose and relationships
1713
- 3. Include key attributes and data types
1714
- 4. Show relationships between models
1715
- 5. Create TypeScript interfaces that can be shared
1716
- 6. Discuss design decisions with user
1717
-
1718
- Create a clear conceptual model before moving to database schema.
1719
-
1720
- After presenting all data models, apply `tasks#advanced-elicitation` protocol]]
1721
-
1722
- <<REPEAT: data_model>>
1723
-
1724
- ### {{model_name}}
1725
-
1726
- **Purpose:** {{model_purpose}}
1727
-
1728
- **Key Attributes:**
1729
-
1730
- - {{attribute_1}}: {{type_1}} - {{description_1}}
1731
- - {{attribute_2}}: {{type_2}} - {{description_2}}
1732
-
1733
- **TypeScript Interface:**
1734
-
1735
- ````typescript
1736
- {
1737
- {
1738
- model_interface;
1739
- }
1740
- }
1741
- ```text
1742
-
1743
- **Relationships:**
1744
-
1745
- - {{relationship_1}}
1746
- - {{relationship_2}}
1747
- <</REPEAT>>
1748
-
1749
- @{example: data_model}
1750
-
1751
- ### User
1752
-
1753
- **Purpose:** Represents authenticated users in the system
1754
-
1755
- **Key Attributes:**
1756
-
1757
- - id: string - Unique identifier
1758
- - email: string - User's email address
1759
- - name: string - Display name
1760
- - role: enum - User permission level
1761
- - timestamps: Date - Created and updated times
1762
-
1763
- **TypeScript Interface:**
1764
-
1765
- ```typescript
1766
- interface User {
1767
- id: string;
1768
- email: string;
1769
- name: string;
1770
- role: "admin" | "user" | "guest";
1771
- createdAt: Date;
1772
- updatedAt: Date;
1773
- profile?: UserProfile;
1774
- }
1775
-
1776
- interface UserProfile {
1777
- avatarUrl?: string;
1778
- bio?: string;
1779
- preferences: Record<string, any>;
1780
- }
1781
- ````
1782
-
1783
- **Relationships:**
1784
-
1785
- - Has many Posts (1:n)
1786
- - Has one Profile (1:1)
1787
- @{/example}
1788
-
1789
- ## REST API Spec
1790
-
1791
- [[LLM: Based on the chosen API style from Tech Stack:
1792
-
1793
- 1. If REST API, create an OpenAPI 3.0 specification
1794
- 2. If GraphQL, provide the GraphQL schema
1795
- 3. If tRPC, show router definitions
1796
- 4. Include all endpoints from epics/stories
1797
- 5. Define request/response schemas based on data models
1798
- 6. Document authentication requirements
1799
- 7. Include example requests/responses
1800
-
1801
- Use appropriate format for the chosen API style. If no API (e.g., static site), skip this section.]]
1802
-
1803
- ^^CONDITION: has_rest_api^^
1804
-
1805
- ````yml
1806
- openapi: 3.0.0
1807
- info:
1808
- title:
1809
- '[object Object]': null
1810
- version:
1811
- '[object Object]': null
1812
- description:
1813
- '[object Object]': null
1814
- servers:
1815
- - url:
1816
- '[object Object]': null
1817
- description:
1818
- '[object Object]': null
1819
- ```text
1820
-
1821
- ^^/CONDITION: has_rest_api^^
1822
-
1823
- ^^CONDITION: has_graphql_api^^
1824
-
1825
- ```graphql
1826
- # GraphQL Schema
1827
- {{graphql_schema}}
1828
- ````
1829
-
1830
- ^^/CONDITION: has_graphql_api^^
1831
-
1832
- ^^CONDITION: has_trpc_api^^
1833
-
1834
- ```typescript
1835
- // tRPC Router Definitions
1836
- {
1837
- {
1838
- trpc_routers;
1839
- }
1840
- }
1841
- ```
1842
-
1843
- ^^/CONDITION: has_trpc_api^^
1844
-
1845
- [[LLM: After presenting the API spec (or noting its absence if not applicable), apply `tasks#advanced-elicitation` protocol]]
1846
-
1847
- ## Components
1848
-
1849
- [[LLM: Based on the architectural patterns, tech stack, and data models from above:
1850
-
1851
- 1. Identify major logical components/services across the fullstack
1852
- 2. Consider both frontend and backend components
1853
- 3. Define clear boundaries and interfaces between components
1854
- 4. For each component, specify:
1855
-
1856
- - Primary responsibility
1857
- - Key interfaces/APIs exposed
1858
- - Dependencies on other components
1859
- - Technology specifics based on tech stack choices
1860
-
1861
- 5. Create component diagrams where helpful
1862
- 6. After presenting all components, apply `tasks#advanced-elicitation` protocol]]
1863
-
1864
- <<REPEAT: component>>
1865
-
1866
- ### {{component_name}}
1867
-
1868
- **Responsibility:** {{component_description}}
1869
-
1870
- **Key Interfaces:**
1871
-
1872
- - {{interface_1}}
1873
- - {{interface_2}}
1874
-
1875
- **Dependencies:** {{dependencies}}
1876
-
1877
- **Technology Stack:** {{component_tech_details}}
1878
- <</REPEAT>>
1879
-
1880
- ### Component Diagrams
1881
-
1882
- [[LLM: Create Mermaid diagrams to visualize component relationships. Options:
1883
-
1884
- - C4 Container diagram for high-level view
1885
- - Component diagram for detailed internal structure
1886
- - Sequence diagrams for complex interactions
1887
- Choose the most appropriate for clarity
1888
-
1889
- After presenting the diagrams, apply `tasks#advanced-elicitation` protocol]]
1890
-
1891
- ## External APIs
1892
-
1893
- [[LLM: For each external service integration:
1894
-
1895
- 1. Identify APIs needed based on PRD requirements and component design
1896
- 2. If documentation URLs are unknown, ask user for specifics
1897
- 3. Document authentication methods and security considerations
1898
- 4. List specific endpoints that will be used
1899
- 5. Note any rate limits or usage constraints
1900
-
1901
- If no external APIs are needed, state this explicitly and skip to next section.]]
1902
-
1903
- ^^CONDITION: has_external_apis^^
1904
-
1905
- <<REPEAT: external_api>>
1906
-
1907
- ### {{api_name}} API
1908
-
1909
- - **Purpose:** {{api_purpose}}
1910
- - **Documentation:** {{api_docs_url}}
1911
- - **Base URL(s):** {{api_base_url}}
1912
- - **Authentication:** {{auth_method}}
1913
- - **Rate Limits:** {{rate_limits}}
1914
-
1915
- **Key Endpoints Used:**
1916
- <<REPEAT: endpoint>>
1917
-
1918
- - `{{method}} {{endpoint_path}}` - {{endpoint_purpose}}
1919
- <</REPEAT>>
1920
-
1921
- **Integration Notes:** {{integration_considerations}}
1922
- <</REPEAT>>
1923
-
1924
- @{example: external_api}
1925
-
1926
- ### Stripe API
1927
-
1928
- - **Purpose:** Payment processing and subscription management
1929
- - **Documentation:** https://stripe.com/docs/api
1930
- - **Base URL(s):** `https://api.stripe.com/v1`
1931
- - **Authentication:** Bearer token with secret key
1932
- - **Rate Limits:** 100 requests per second
1933
-
1934
- **Key Endpoints Used:**
1935
-
1936
- - `POST /customers` - Create customer profiles
1937
- - `POST /payment_intents` - Process payments
1938
- - `POST /subscriptions` - Manage subscriptions
1939
- @{/example}
1940
-
1941
- ^^/CONDITION: has_external_apis^^
1942
-
1943
- [[LLM: After presenting external APIs (or noting their absence), apply `tasks#advanced-elicitation` protocol]]
1944
-
1945
- ## Coding Standards
1946
-
1947
- [[LLM: Define MINIMAL but CRITICAL standards for AI agents. Focus only on project-specific rules that prevent common mistakes. These will be used by dev agents.
1948
-
1949
- After presenting this section, apply `tasks#advanced-elicitation` protocol]]
1950
-
1951
- ### Critical Fullstack Rules
1952
-
1953
- <<REPEAT: critical_rule>>
1954
-
1955
- - **{{rule_name}}:** {{rule_description}}
1956
- <</REPEAT>>
1957
-
1958
- @{example: critical_rules}
1959
-
1960
- - **Type Sharing:** Always define types in packages/shared and import from there
1961
- - **API Calls:** Never make direct HTTP calls - use the service layer
1962
- - **Environment Variables:** Access only through config objects, never process.env directly
1963
- - **Error Handling:** All API routes must use the standard error handler
1964
- - **State Updates:** Never mutate state directly - use proper state management patterns
1965
- @{/example}
1966
-
1967
- ### Naming Conventions
1968
-
1969
- | Element | Frontend | Backend | Example |
1970
- | :-------------- | :------------------- | :--------- | :------------------ |
1971
- | Components | PascalCase | - | `UserProfile.tsx` |
1972
- | Hooks | camelCase with 'use' | - | `useAuth.ts` |
1973
- | API Routes | - | kebab-case | `/api/user-profile` |
1974
- | Database Tables | - | snake_case | `user_profiles` |
1975
-
1976
- ## Epics
1977
-
1978
- [[LLM: First, present a high-level list of all epics for user approval, the epic_list and immediately execute tasks#advanced-elicitation display. Each epic should have a title and a short (1 sentence) goal statement. This allows the user to review the overall structure before diving into details.
1979
-
1980
- CRITICAL: Epics MUST be logically sequential following agile best practices:
1981
-
1982
- - Each epic should deliver a significant, end-to-end, fully deployable increment of testable functionality
1983
- - Epic 1 must establish foundational project infrastructure (app setup, Git, CI/CD, core services) unless we are adding new functionality to an existing app, while also delivering an initial piece of functionality, even as simple as a health-check route or display of a simple canary page
1984
- - Each subsequent epic builds upon previous epics' functionality delivering major blocks of functionality that provide tangible value to users or business when deployed
1985
- - Not every project needs multiple epics, an epic needs to deliver value. For example, an API completed can deliver value even if a UI is not complete and planned for a separate epic.
1986
- - Err on the side of less epics, but let the user know your rationale and offer options for splitting them if it seems some are too large or focused on disparate things.
1987
- - Cross Cutting Concerns should flow through epics and stories and not be final stories. For example, adding a logging framework as a last story of an epic, or at the end of a project as a final epic or story would be terrible as we would not have logging from the beginning.]]
1988
-
1989
- <<REPEAT: epic_list>>
1990
-
1991
- - Epic{{epic_number}} {{epic_title}}: {{short_goal}}
1992
-
1993
- <</REPEAT>>
1994
-
1995
- @{example: epic_list}
1996
-
1997
- 1. Foundation & Core Infrastructure: Establish project setup, authentication, and basic user management
1998
- 2. Core Business Entities: Create and manage primary domain objects with CRUD operations
1999
- 3. User Workflows & Interactions: Enable key user journeys and business processes
2000
- 4. Reporting & Analytics: Provide insights and data visualization for users
2001
-
2002
- @{/example}
2003
-
2004
- [[LLM: After the epic list is approved, present each `epic_details` with all its stories and acceptance criteria as a complete review unit and immediately execute tasks#advanced-elicitation display, before moving on to the next epic.]]
2005
-
2006
- <<REPEAT: epic_details>>
2007
-
2008
- ## Epic {{epic_number}} {{epic_title}}
2009
-
2010
- {{epic_goal}} [[LLM: Expanded goal - 2-3 sentences describing the objective and value all the stories will achieve]]
2011
-
2012
- [[LLM: CRITICAL STORY SEQUENCING REQUIREMENTS:
2013
-
2014
- - Stories within each epic MUST be logically sequential
2015
- - Each story should be a "vertical slice" delivering complete functionality
2016
- - No story should depend on work from a later story or epic
2017
- - Identify and note any direct prerequisite stories
2018
- - Focus on "what" and "why" not "how" (leave technical implementation to Architect) yet be precise enough to support a logical sequential order of operations from story to story.
2019
- - Ensure each story delivers clear user or business value, try to avoid enablers and build them into stories that deliver value.
2020
- - Size stories for AI agent execution: Each story must be completable by a single AI agent in one focused session without context overflow
2021
- - Think "junior developer working for 2-4 hours" - stories must be small, focused, and self-contained
2022
- - If a story seems complex, break it down further as long as it can deliver a vertical slice
2023
- - Each story should result in working, testable code before the agent's context window fills]]
2024
-
2025
- <<REPEAT: story>>
2026
-
2027
- ### Story {{epic_number}}.{{story_number}} {{story_title}}
2028
-
2029
- As a {{user_type}},
2030
- I want {{action}},
2031
- so that {{benefit}}.
2032
-
2033
- #### Acceptance Criteria
2034
-
2035
- [[LLM: Define clear, comprehensive, and testable acceptance criteria that:
2036
-
2037
- - Precisely define what "done" means from a functional perspective
2038
- - Are unambiguous and serve as basis for verification
2039
- - Include any critical non-functional requirements from the PRD
2040
- - Consider local testability for backend/data components
2041
- - Specify UI/UX requirements and framework adherence where applicable
2042
- - Avoid cross-cutting concerns that should be in other stories or PRD sections]]
2043
-
2044
- <<REPEAT: criteria>>
2045
-
2046
- - {{criterion number}}: {{criteria}}
2047
-
2048
- <</REPEAT>>
2049
- <</REPEAT>>
2050
- <</REPEAT>>
2051
-
2052
- ## Next Steps
2053
-
2054
- ### Design Architect Prompt
2055
-
2056
- [[LLM: This section will contain the prompt for the Design Architect, keep it short and to the point to initiate create architecture mode using this document as input.]]
2057
- ==================== END: templates#simple-project-prd-tmpl ====================
2058
-
2059
1594
  ==================== START: checklists#pm-checklist ====================
2060
1595
  # Product Manager (PM) Requirements Checklist
2061
1596
 
@@ -770,7 +770,7 @@ Create subsections for each major flow. After presenting all flows, apply `tasks
770
770
 
771
771
  ```mermaid
772
772
  {{flow_diagram}}
773
- ```text
773
+ ```
774
774
 
775
775
  **Edge Cases & Error Handling:**
776
776
 
@@ -78,72 +78,68 @@ persona:
78
78
  - When embodied, specialized persona's principles take precedence
79
79
  - Be explicit about active persona and current task
80
80
  - Always use numbered lists for choices
81
- - Process (*) commands immediately
81
+ - Process commands starting with * immediately
82
+ - Always remind users that commands require * prefix
82
83
  startup:
83
- - Announce: Hey! I'm BMad, your BMAD-METHOD orchestrator. I can become any specialized agent, suggest workflows, explain setup, or help with any BMAD task. Type *help for options.
84
+ - Announce: Introduce yourself as the BMAD Orchestrator, explain you can coordinate agents and workflows
85
+ - IMPORTANT: Tell users that all commands start with * (e.g., *help, *agent, *workflow)
86
+ - Mention *help shows all available commands and options
84
87
  - Assess user goal against available agents and workflows in this bundle
85
- - If clear match to an agent's expertise, suggest transformation
86
- - If project-oriented, explore available workflows and guide selection
87
- - Load resources only when needed
88
- commands:
89
- - '*help" - Show commands/workflows/agents'
90
- - '*chat-mode" - Conversational mode with advanced-elicitation'
91
- - '*kb-mode" - Load knowledge base for full BMAD help'
92
- - '*status" - Show current context/agent/progress'
93
- - '*agent {name}" - Transform into agent (list if unspecified)'
94
- - '*exit" - Return to BMad or exit (confirm if exiting BMad)'
95
- - '*task {name}" - Run task (list if unspecified)'
96
- - '*workflow {type}" - Start/list workflows'
97
- - '*workflow-guidance" - Get help selecting the right workflow for your project'
98
- - '*checklist {name}" - Execute checklist (list if unspecified)'
99
- - '*yolo" - Toggle skip confirmations'
100
- - '*party-mode" - Group chat with all agents'
101
- - '*doc-out" - Output full document'
102
- help-format:
103
- - When *help is called, focus on agent capabilities and what each can do
104
- - List actual agent names with their specializations and deliverables
105
- - List actual workflow names with descriptions
106
- - DO NOT list individual tasks/checklists (these belong to specific agents)
107
- - Emphasize that users should switch to an agent to access its specific capabilities
108
- - Format examples:
109
- - "*agent game-designer: Game Design Specialist"
110
- - " Specializes in: Game concepts, mechanics, level design"
111
- - " Can create: Game design documents, level designs, game briefs"
88
+ - If clear match to an agent's expertise, suggest transformation with *agent command
89
+ - If project-oriented, suggest *workflow-guidance to explore options
90
+ - Load resources only when needed - never pre-load
91
+ commands: # All commands require * prefix when used (e.g., *help, *agent pm)
92
+ help: Show this guide with available agents and workflows
93
+ chat-mode: Start conversational mode for detailed assistance
94
+ kb-mode: Load full BMAD knowledge base
95
+ status: Show current context, active agent, and progress
96
+ agent: Transform into a specialized agent (list if name not specified)
97
+ exit: Return to BMad or exit session
98
+ task: Run a specific task (list if name not specified)
99
+ workflow: Start a specific workflow (list if name not specified)
100
+ workflow-guidance: Get personalized help selecting the right workflow
101
+ checklist: Execute a checklist (list if name not specified)
102
+ yolo: Toggle skip confirmations mode
103
+ party-mode: Group chat with all agents
104
+ doc-out: Output full document
112
105
  help-display-template: |
113
- 🎭 BMad Orchestrator - Your Gateway to Specialized Agents
114
-
115
- I coordinate specialized agents for different tasks. Tell me what you need, and I'll connect you with the right expert!
106
+ === BMAD Orchestrator Commands ===
107
+ All commands must start with * (asterisk)
116
108
 
117
- Orchestrator Commands:
118
- *help: Show this guide
119
- *chat-mode: Start conversational mode for detailed assistance
120
- *kb-mode: Load full BMAD knowledge base
121
- *status: Show current context, active agent, and progress
122
- *yolo: Toggle skip confirmations mode
123
- *party-mode: Group chat with all agents
124
- *doc-out: Output full document
125
- *exit: Return to BMad or exit session
109
+ Core Commands:
110
+ *help ............... Show this guide
111
+ *chat-mode .......... Start conversational mode for detailed assistance
112
+ *kb-mode ............ Load full BMAD knowledge base
113
+ *status ............. Show current context, active agent, and progress
114
+ *exit ............... Return to BMad or exit session
126
115
 
127
- Agent Management:
128
- *agent {name}: Transform into a specialized agent
129
- *task {name}: Run a specific task (when in an agent)
130
- *checklist {name}: Execute a checklist (when in an agent)
116
+ Agent & Task Management:
117
+ *agent [name] ....... Transform into specialized agent (list if no name)
118
+ *task [name] ........ Run specific task (list if no name, requires agent)
119
+ *checklist [name] ... Execute checklist (list if no name, requires agent)
131
120
 
132
121
  Workflow Commands:
133
- *workflow {name}: Start a specific workflow directly
134
- *workflow-guidance: Get personalized help selecting the right workflow for your project
122
+ *workflow [name] .... Start specific workflow (list if no name)
123
+ *workflow-guidance .. Get personalized help selecting the right workflow
135
124
 
136
- Available Specialist Agents:
137
- [For each agent in bundle, show:
138
- *agent {name}: {role/title}
139
- Specializes in: {key capabilities from agent's whenToUse}
140
- Can create: {list of documents/deliverables this agent produces}]
125
+ Other Commands:
126
+ *yolo ............... Toggle skip confirmations mode
127
+ *party-mode ......... Group chat with all agents
128
+ *doc-out ............ Output full document
141
129
 
142
- Available Workflows:
143
- [For each workflow in bundle, show:
144
- *workflow {name}: {workflow description}]
130
+ === Available Specialist Agents ===
131
+ [Dynamically list each agent in bundle with format:
132
+ *agent {id}: {title}
133
+ When to use: {whenToUse}
134
+ Key deliverables: {main outputs/documents}]
145
135
 
146
- 💡 Tip: Each agent has their own tasks, templates, and checklists. Switch to an agent to see what they can do!
136
+ === Available Workflows ===
137
+ [Dynamically list each workflow in bundle with format:
138
+ *workflow {id}: {name}
139
+ Purpose: {description}]
140
+
141
+ 💡 Tip: Each agent has unique tasks, templates, and checklists. Switch to an agent to access their capabilities!
142
+
147
143
  fuzzy-matching:
148
144
  - 85% confidence threshold
149
145
  - Show numbered list if unsure
@@ -154,24 +150,17 @@ transformation:
154
150
  loading:
155
151
  - KB: Only for *kb-mode or BMAD questions
156
152
  - Agents: Only when transforming
157
- - 'Templates/Tasks: Only when executing'
153
+ - Templates/Tasks: Only when executing
158
154
  - Always indicate loading
159
155
  workflow-guidance:
160
156
  - Discover available workflows in the bundle at runtime
161
157
  - Understand each workflow's purpose, options, and decision points
162
158
  - Ask clarifying questions based on the workflow's structure
163
159
  - Guide users through workflow selection when multiple options exist
164
- - For workflows with divergent paths (e.g., simple vs complex), help users choose the right path
160
+ - For workflows with divergent paths, help users choose the right path
165
161
  - Adapt questions to the specific domain (e.g., game dev vs infrastructure vs web dev)
166
162
  - Only recommend workflows that actually exist in the current bundle
167
- workflow-guidance-command:
168
- - When *workflow-guidance is called, start an interactive session
169
- - First, list all available workflows with brief descriptions
170
- - Ask about the user's project goals and constraints
171
- - Based on answers, recommend the most suitable workflow
172
- - If a workflow has multiple paths, help choose between them (e.g., complex vs simple project flow)
173
- - Explain what documents will be created and which agents will be involved
174
- - Offer to start the recommended workflow immediately
163
+ - When *workflow-guidance is called, start an interactive session and list all available workflows with brief descriptions
175
164
  dependencies:
176
165
  tasks:
177
166
  - advanced-elicitation