bmad-method 4.37.0-beta.1 → 4.37.0-beta.3

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 (206) hide show
  1. package/README.md +3 -214
  2. package/package.json +26 -63
  3. package/.github/FUNDING.yaml +0 -15
  4. package/.github/ISSUE_TEMPLATE/bug_report.md +0 -32
  5. package/.github/ISSUE_TEMPLATE/feature_request.md +0 -22
  6. package/.github/workflows/discord.yaml +0 -16
  7. package/.github/workflows/release.yaml +0 -60
  8. package/.releaserc.json +0 -19
  9. package/.vscode/settings.json +0 -44
  10. package/CHANGELOG.md +0 -702
  11. package/CONTRIBUTING.md +0 -209
  12. package/LICENSE +0 -21
  13. package/bmad-core/agent-teams/team-all.yaml +0 -14
  14. package/bmad-core/agent-teams/team-fullstack.yaml +0 -18
  15. package/bmad-core/agent-teams/team-ide-minimal.yaml +0 -10
  16. package/bmad-core/agent-teams/team-no-ui.yaml +0 -13
  17. package/bmad-core/agents/analyst.md +0 -81
  18. package/bmad-core/agents/architect.md +0 -83
  19. package/bmad-core/agents/bmad-master.md +0 -107
  20. package/bmad-core/agents/bmad-orchestrator.md +0 -149
  21. package/bmad-core/agents/dev.md +0 -75
  22. package/bmad-core/agents/pm.md +0 -81
  23. package/bmad-core/agents/po.md +0 -76
  24. package/bmad-core/agents/qa.md +0 -69
  25. package/bmad-core/agents/sm.md +0 -62
  26. package/bmad-core/agents/ux-expert.md +0 -66
  27. package/bmad-core/checklists/architect-checklist.md +0 -438
  28. package/bmad-core/checklists/change-checklist.md +0 -182
  29. package/bmad-core/checklists/pm-checklist.md +0 -370
  30. package/bmad-core/checklists/po-master-checklist.md +0 -432
  31. package/bmad-core/checklists/story-dod-checklist.md +0 -94
  32. package/bmad-core/checklists/story-draft-checklist.md +0 -153
  33. package/bmad-core/core-config.yaml +0 -20
  34. package/bmad-core/data/bmad-kb.md +0 -806
  35. package/bmad-core/data/brainstorming-techniques.md +0 -36
  36. package/bmad-core/data/elicitation-methods.md +0 -154
  37. package/bmad-core/data/technical-preferences.md +0 -3
  38. package/bmad-core/tasks/advanced-elicitation.md +0 -117
  39. package/bmad-core/tasks/brownfield-create-epic.md +0 -160
  40. package/bmad-core/tasks/brownfield-create-story.md +0 -147
  41. package/bmad-core/tasks/correct-course.md +0 -70
  42. package/bmad-core/tasks/create-brownfield-story.md +0 -312
  43. package/bmad-core/tasks/create-deep-research-prompt.md +0 -278
  44. package/bmad-core/tasks/create-next-story.md +0 -112
  45. package/bmad-core/tasks/document-project.md +0 -343
  46. package/bmad-core/tasks/facilitate-brainstorming-session.md +0 -136
  47. package/bmad-core/tasks/generate-ai-frontend-prompt.md +0 -51
  48. package/bmad-core/tasks/index-docs.md +0 -173
  49. package/bmad-core/tasks/kb-mode-interaction.md +0 -75
  50. package/bmad-core/tasks/review-story.md +0 -154
  51. package/bmad-core/tasks/shard-doc.md +0 -185
  52. package/bmad-core/tasks/validate-next-story.md +0 -134
  53. package/bmad-core/templates/architecture-tmpl.yaml +0 -650
  54. package/bmad-core/templates/brainstorming-output-tmpl.yaml +0 -156
  55. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +0 -476
  56. package/bmad-core/templates/brownfield-prd-tmpl.yaml +0 -280
  57. package/bmad-core/templates/competitor-analysis-tmpl.yaml +0 -293
  58. package/bmad-core/templates/front-end-architecture-tmpl.yaml +0 -206
  59. package/bmad-core/templates/front-end-spec-tmpl.yaml +0 -349
  60. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +0 -805
  61. package/bmad-core/templates/market-research-tmpl.yaml +0 -252
  62. package/bmad-core/templates/prd-tmpl.yaml +0 -202
  63. package/bmad-core/templates/project-brief-tmpl.yaml +0 -221
  64. package/bmad-core/templates/story-tmpl.yaml +0 -137
  65. package/bmad-core/workflows/brownfield-fullstack.yaml +0 -297
  66. package/bmad-core/workflows/brownfield-service.yaml +0 -187
  67. package/bmad-core/workflows/brownfield-ui.yaml +0 -197
  68. package/bmad-core/workflows/greenfield-fullstack.yaml +0 -240
  69. package/bmad-core/workflows/greenfield-service.yaml +0 -206
  70. package/bmad-core/workflows/greenfield-ui.yaml +0 -235
  71. package/common/tasks/create-doc.md +0 -101
  72. package/common/tasks/execute-checklist.md +0 -86
  73. package/common/utils/bmad-doc-template.md +0 -325
  74. package/common/utils/workflow-management.md +0 -69
  75. package/dist/agents/analyst.txt +0 -2882
  76. package/dist/agents/architect.txt +0 -3543
  77. package/dist/agents/bmad-master.txt +0 -8756
  78. package/dist/agents/bmad-orchestrator.txt +0 -1490
  79. package/dist/agents/dev.txt +0 -428
  80. package/dist/agents/pm.txt +0 -2229
  81. package/dist/agents/po.txt +0 -1364
  82. package/dist/agents/qa.txt +0 -386
  83. package/dist/agents/sm.txt +0 -668
  84. package/dist/agents/ux-expert.txt +0 -701
  85. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +0 -2408
  86. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +0 -1631
  87. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +0 -822
  88. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +0 -10989
  89. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.txt +0 -4047
  90. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.txt +0 -3744
  91. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.txt +0 -465
  92. package/dist/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.txt +0 -990
  93. package/dist/expansion-packs/bmad-2d-unity-game-dev/teams/unity-2d-game-team.txt +0 -15467
  94. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +0 -2077
  95. package/dist/teams/team-all.txt +0 -11062
  96. package/dist/teams/team-fullstack.txt +0 -10392
  97. package/dist/teams/team-ide-minimal.txt +0 -3507
  98. package/dist/teams/team-no-ui.txt +0 -8951
  99. package/docs/GUIDING-PRINCIPLES.md +0 -91
  100. package/docs/core-architecture.md +0 -219
  101. package/docs/enhanced-ide-development-workflow.md +0 -43
  102. package/docs/expansion-packs.md +0 -280
  103. package/docs/how-to-contribute-with-pull-requests.md +0 -158
  104. package/docs/user-guide.md +0 -251
  105. package/docs/versioning-and-releases.md +0 -77
  106. package/docs/versions.md +0 -48
  107. package/docs/working-in-the-brownfield.md +0 -364
  108. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/Complete AI Agent System - Flowchart.svg +0 -102
  109. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash copy.txt +0 -13
  110. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.1 Google Cloud Project Setup/1.1.1 - Initial Project Configuration - bash.txt +0 -13
  111. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.2 Agent Development Kit Installation/1.2.2 - Basic Project Structure - txt.txt +0 -25
  112. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.1 - settings.py +0 -34
  113. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.3 Core Configuration Files/1.3.2 - main.py - Base Application.py +0 -70
  114. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/PART 1 - Google Cloud Vertex AI Setup Documentation/1.4 Deployment Configuration/1.4.2 - cloudbuild.yaml +0 -26
  115. package/expansion-packs/Complete AI Agent System - Blank Templates & Google Cloud Setup/README.md +0 -109
  116. package/expansion-packs/README.md +0 -3
  117. package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +0 -13
  118. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +0 -71
  119. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +0 -78
  120. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +0 -64
  121. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-design-checklist.md +0 -201
  122. package/expansion-packs/bmad-2d-phaser-game-dev/checklists/game-story-dod-checklist.md +0 -160
  123. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +0 -8
  124. package/expansion-packs/bmad-2d-phaser-game-dev/data/bmad-kb.md +0 -250
  125. package/expansion-packs/bmad-2d-phaser-game-dev/data/development-guidelines.md +0 -649
  126. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/advanced-elicitation.md +0 -110
  127. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +0 -216
  128. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/game-design-brainstorming.md +0 -290
  129. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +0 -613
  130. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +0 -356
  131. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +0 -343
  132. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +0 -253
  133. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +0 -484
  134. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-dev-greenfield.yaml +0 -183
  135. package/expansion-packs/bmad-2d-phaser-game-dev/workflows/game-prototype.yaml +0 -175
  136. package/expansion-packs/bmad-2d-unity-game-dev/agent-teams/unity-2d-game-team.yaml +0 -14
  137. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-architect.md +0 -80
  138. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-designer.md +0 -77
  139. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-developer.md +0 -78
  140. package/expansion-packs/bmad-2d-unity-game-dev/agents/game-sm.md +0 -65
  141. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-architect-checklist.md +0 -391
  142. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-change-checklist.md +0 -203
  143. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-design-checklist.md +0 -201
  144. package/expansion-packs/bmad-2d-unity-game-dev/checklists/game-story-dod-checklist.md +0 -124
  145. package/expansion-packs/bmad-2d-unity-game-dev/config.yaml +0 -6
  146. package/expansion-packs/bmad-2d-unity-game-dev/data/bmad-kb.md +0 -769
  147. package/expansion-packs/bmad-2d-unity-game-dev/data/development-guidelines.md +0 -586
  148. package/expansion-packs/bmad-2d-unity-game-dev/tasks/advanced-elicitation.md +0 -110
  149. package/expansion-packs/bmad-2d-unity-game-dev/tasks/correct-course-game.md +0 -141
  150. package/expansion-packs/bmad-2d-unity-game-dev/tasks/create-game-story.md +0 -184
  151. package/expansion-packs/bmad-2d-unity-game-dev/tasks/game-design-brainstorming.md +0 -290
  152. package/expansion-packs/bmad-2d-unity-game-dev/tasks/validate-game-story.md +0 -200
  153. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-architecture-tmpl.yaml +0 -1030
  154. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-brief-tmpl.yaml +0 -356
  155. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-design-doc-tmpl.yaml +0 -705
  156. package/expansion-packs/bmad-2d-unity-game-dev/templates/game-story-tmpl.yaml +0 -256
  157. package/expansion-packs/bmad-2d-unity-game-dev/templates/level-design-doc-tmpl.yaml +0 -484
  158. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-dev-greenfield.yaml +0 -183
  159. package/expansion-packs/bmad-2d-unity-game-dev/workflows/game-prototype.yaml +0 -175
  160. package/expansion-packs/bmad-infrastructure-devops/README.md +0 -147
  161. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +0 -71
  162. package/expansion-packs/bmad-infrastructure-devops/checklists/infrastructure-checklist.md +0 -484
  163. package/expansion-packs/bmad-infrastructure-devops/config.yaml +0 -9
  164. package/expansion-packs/bmad-infrastructure-devops/data/bmad-kb.md +0 -305
  165. package/expansion-packs/bmad-infrastructure-devops/tasks/review-infrastructure.md +0 -159
  166. package/expansion-packs/bmad-infrastructure-devops/tasks/validate-infrastructure.md +0 -153
  167. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +0 -424
  168. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +0 -629
  169. package/tools/bmad-npx-wrapper.js +0 -39
  170. package/tools/builders/web-builder.js +0 -681
  171. package/tools/bump-all-versions.js +0 -106
  172. package/tools/bump-expansion-version.js +0 -83
  173. package/tools/cli.js +0 -154
  174. package/tools/flattener/aggregate.js +0 -76
  175. package/tools/flattener/binary.js +0 -53
  176. package/tools/flattener/discovery.js +0 -70
  177. package/tools/flattener/files.js +0 -35
  178. package/tools/flattener/ignoreRules.js +0 -176
  179. package/tools/flattener/main.js +0 -217
  180. package/tools/flattener/projectRoot.js +0 -45
  181. package/tools/flattener/prompts.js +0 -44
  182. package/tools/flattener/stats.js +0 -30
  183. package/tools/flattener/xml.js +0 -86
  184. package/tools/installer/README.md +0 -8
  185. package/tools/installer/package.json +0 -43
  186. package/tools/lib/dependency-resolver.js +0 -179
  187. package/tools/lib/yaml-utils.js +0 -29
  188. package/tools/md-assets/web-agent-startup-instructions.md +0 -39
  189. package/tools/semantic-release-sync-installer.js +0 -30
  190. package/tools/shared/bannerArt.js +0 -105
  191. package/tools/sync-installer-version.js +0 -34
  192. package/tools/update-expansion-version.js +0 -54
  193. package/tools/upgraders/v3-to-v4-upgrader.js +0 -763
  194. package/tools/version-bump.js +0 -79
  195. package/tools/yaml-format.js +0 -240
  196. /package/{tools/installer/bin → bin}/bmad.js +0 -0
  197. /package/{tools/installer/config → config}/ide-agent-config.yaml +0 -0
  198. /package/{tools/installer/config → config}/install.config.yaml +0 -0
  199. /package/{tools/installer/lib → lib}/config-loader.js +0 -0
  200. /package/{tools/installer/lib → lib}/file-manager.js +0 -0
  201. /package/{tools/installer/lib → lib}/ide-base-setup.js +0 -0
  202. /package/{tools/installer/lib → lib}/ide-setup.js +0 -0
  203. /package/{tools/installer/lib → lib}/installer.js +0 -0
  204. /package/{tools/installer/lib → lib}/memory-profiler.js +0 -0
  205. /package/{tools/installer/lib → lib}/module-manager.js +0 -0
  206. /package/{tools/installer/lib → lib}/resource-locator.js +0 -0
@@ -1,13 +0,0 @@
1
- # 1. Create new Google Cloud Project
2
- gcloud projects create {{PROJECT_ID}} --name="{{COMPANY_NAME}} AI Agent System"
3
-
4
- # 2. Set default project
5
- gcloud config set project {{PROJECT_ID}}
6
-
7
- # 3. Enable required APIs
8
- gcloud services enable aiplatform.googleapis.com
9
- gcloud services enable storage.googleapis.com
10
- gcloud services enable cloudfunctions.googleapis.com
11
- gcloud services enable run.googleapis.com
12
- gcloud services enable firestore.googleapis.com
13
- gcloud services enable secretmanager.googleapis.com
@@ -1,13 +0,0 @@
1
- # 1. Create new Google Cloud Project
2
- gcloud projects create {{PROJECT_ID}} --name="{{COMPANY_NAME}} AI Agent System"
3
-
4
- # 2. Set default project
5
- gcloud config set project {{PROJECT_ID}}
6
-
7
- # 3. Enable required APIs
8
- gcloud services enable aiplatform.googleapis.com
9
- gcloud services enable storage.googleapis.com
10
- gcloud services enable cloudfunctions.googleapis.com
11
- gcloud services enable run.googleapis.com
12
- gcloud services enable firestore.googleapis.com
13
- gcloud services enable secretmanager.googleapis.com
@@ -1,25 +0,0 @@
1
- {{company_name}}-ai-agents/
2
- ├── agents/
3
- │ ├── __init__.py
4
- │ ├── {{team_1}}/
5
- │ │ ├── __init__.py
6
- │ │ ├── {{agent_1}}.py
7
- │ │ └── {{agent_2}}.py
8
- │ └── {{team_2}}/
9
- ├── tasks/
10
- │ ├── __init__.py
11
- │ ├── {{task_category_1}}/
12
- │ └── {{task_category_2}}/
13
- ├── templates/
14
- │ ├── {{document_type_1}}/
15
- │ └── {{document_type_2}}/
16
- ├── checklists/
17
- ├── data/
18
- ├── workflows/
19
- ├── config/
20
- │ ├── settings.py
21
- │ └── agent_config.yaml
22
- ├── main.py
23
- └── deployment/
24
- ├── Dockerfile
25
- └── cloudbuild.yaml
@@ -1,34 +0,0 @@
1
- import os
2
- from pydantic import BaseSettings
3
-
4
- class Settings(BaseSettings):
5
- # Google Cloud Configuration
6
- project_id: str = "{{PROJECT_ID}}"
7
- location: str = "{{LOCATION}}" # e.g., "us-central1"
8
-
9
- # Company Information
10
- company_name: str = "{{COMPANY_NAME}}"
11
- industry: str = "{{INDUSTRY}}"
12
- business_type: str = "{{BUSINESS_TYPE}}"
13
-
14
- # Agent Configuration
15
- default_model: str = "gemini-1.5-pro"
16
- max_iterations: int = 10
17
- timeout_seconds: int = 300
18
-
19
- # Storage Configuration
20
- bucket_name: str = "{{COMPANY_NAME}}-ai-agents-storage"
21
- database_name: str = "{{COMPANY_NAME}}-ai-agents-db"
22
-
23
- # API Configuration
24
- session_service_type: str = "vertex" # or "in_memory" for development
25
- artifact_service_type: str = "gcs" # or "in_memory" for development
26
- memory_service_type: str = "vertex" # or "in_memory" for development
27
-
28
- # Security
29
- service_account_path: str = "./{{COMPANY_NAME}}-ai-agents-key.json"
30
-
31
- class Config:
32
- env_file = ".env"
33
-
34
- settings = Settings()
@@ -1,70 +0,0 @@
1
- import asyncio
2
- from google.adk.agents import LlmAgent
3
- from google.adk.runners import Runner
4
- from google.adk.sessions import VertexAiSessionService
5
- from google.adk.artifacts import GcsArtifactService
6
- from google.adk.memory import VertexAiRagMemoryService
7
- from google.adk.models import Gemini
8
-
9
- from config.settings import settings
10
- from agents.{{primary_team}}.{{main_orchestrator}} import {{MainOrchestratorClass}}
11
-
12
- class {{CompanyName}}AISystem:
13
- def __init__(self):
14
- self.settings = settings
15
- self.runner = None
16
- self.main_orchestrator = None
17
-
18
- async def initialize(self):
19
- """Initialize the AI agent system"""
20
-
21
- # Create main orchestrator
22
- self.main_orchestrator = {{MainOrchestratorClass}}()
23
-
24
- # Initialize services
25
- session_service = VertexAiSessionService(
26
- project=self.settings.project_id,
27
- location=self.settings.location
28
- )
29
-
30
- artifact_service = GcsArtifactService(
31
- bucket_name=self.settings.bucket_name
32
- )
33
-
34
- memory_service = VertexAiRagMemoryService(
35
- rag_corpus=f"projects/{self.settings.project_id}/locations/{self.settings.location}/ragCorpora/{{COMPANY_NAME}}-knowledge"
36
- )
37
-
38
- # Create runner
39
- self.runner = Runner(
40
- app_name=f"{self.settings.company_name}-AI-System",
41
- agent=self.main_orchestrator,
42
- session_service=session_service,
43
- artifact_service=artifact_service,
44
- memory_service=memory_service
45
- )
46
-
47
- print(f"✅ {self.settings.company_name} AI Agent System initialized successfully!")
48
-
49
- async def run_agent_interaction(self, user_id: str, session_id: str, message: str):
50
- """Run agent interaction"""
51
- if not self.runner:
52
- await self.initialize()
53
-
54
- async for event in self.runner.run_async(
55
- user_id=user_id,
56
- session_id=session_id,
57
- new_message=message
58
- ):
59
- yield event
60
-
61
- # Application factory
62
- async def create_app():
63
- ai_system = {{CompanyName}}AISystem()
64
- await ai_system.initialize()
65
- return ai_system
66
-
67
- if __name__ == "__main__":
68
- # Development server
69
- import uvicorn
70
- uvicorn.run("main:app", host="0.0.0.0", port=8000, reload=True)
@@ -1,26 +0,0 @@
1
- steps:
2
- # Build the container image
3
- - name: 'gcr.io/cloud-builders/docker'
4
- args: ['build', '-t', 'gcr.io/{{PROJECT_ID}}/{{COMPANY_NAME}}-ai-agents:$COMMIT_SHA', '.']
5
-
6
- # Push the container image to Container Registry
7
- - name: 'gcr.io/cloud-builders/docker'
8
- args: ['push', 'gcr.io/{{PROJECT_ID}}/{{COMPANY_NAME}}-ai-agents:$COMMIT_SHA']
9
-
10
- # Deploy container image to Cloud Run
11
- - name: 'gcr.io/google.com/cloudsdktool/cloud-sdk'
12
- entrypoint: gcloud
13
- args:
14
- - 'run'
15
- - 'deploy'
16
- - '{{COMPANY_NAME}}-ai-agents'
17
- - '--image'
18
- - 'gcr.io/{{PROJECT_ID}}/{{COMPANY_NAME}}-ai-agents:$COMMIT_SHA'
19
- - '--region'
20
- - '{{LOCATION}}'
21
- - '--platform'
22
- - 'managed'
23
- - '--allow-unauthenticated'
24
-
25
- images:
26
- - 'gcr.io/{{PROJECT_ID}}/{{COMPANY_NAME}}-ai-agents:$COMMIT_SHA'
@@ -1,109 +0,0 @@
1
- # BMad Expansion Pack: Google Cloud Vertex AI Agent System
2
-
3
- [](https://opensource.org/licenses/MIT)
4
- [](https://www.google.com/search?q=https://github.com/antmikinka/BMAD-METHOD)
5
- [](https://cloud.google.com/)
6
-
7
- This expansion pack provides a complete, deployable starter kit for building and hosting sophisticated AI agent systems on Google Cloud Platform (GCP). It bridges the gap between the BMad Method's natural language framework and a production-ready cloud environment, leveraging Google Vertex AI, Cloud Run, and the Google Agent Development Kit (ADK).
8
-
9
- ## Features
10
-
11
- - **Automated GCP Setup**: `gcloud` scripts to configure your project, service accounts, and required APIs in minutes.
12
- - **Production-Ready Deployment**: Includes a `Dockerfile` and `cloudbuild.yaml` for easy, repeatable deployments to Google Cloud Run.
13
- - **Rich Template Library**: A comprehensive set of BMad-compatible templates for Teams, Agents, Tasks, Workflows, Documents, and Checklists.
14
- - **Pre-configured Agent Roles**: Includes powerful master templates for key agent archetypes like Orchestrators and Specialists.
15
- - **Highly Customizable**: Easily adapt the entire system with company-specific variables and industry-specific configurations.
16
- - **Powered by Google ADK**: Built on the official Google Agent Development Kit for robust and native integration with Vertex AI services.
17
-
18
- ## Prerequisites
19
-
20
- Before you begin, ensure you have the following installed and configured:
21
-
22
- - A Google Cloud Platform (GCP) Account with an active billing account.
23
- - The [Google Cloud SDK (`gcloud` CLI)](<https://www.google.com/search?q=%5Bhttps://cloud.google.com/sdk/docs/install%5D(https://cloud.google.com/sdk/docs/install)>) installed and authenticated.
24
- - [Docker](https://www.docker.com/products/docker-desktop/) installed on your local machine.
25
- - Python 3.11+
26
-
27
- ## Quick Start Guide
28
-
29
- Follow these steps to get your own AI agent system running on Google Cloud.
30
-
31
- ### 1\. Configure Setup Variables
32
-
33
- The setup scripts use placeholder variables. Before running them, open the files in the `/scripts` directory and replace the following placeholders with your own values:
34
-
35
- - `{{PROJECT_ID}}`: Your unique Google Cloud project ID.
36
- - `{{COMPANY_NAME}}`: Your company or project name (used for naming resources).
37
- - `{{LOCATION}}`: The GCP region you want to deploy to (e.g., `us-central1`).
38
-
39
- ### 2\. Run the GCP Setup Scripts
40
-
41
- Execute the setup scripts to prepare your Google Cloud environment.
42
-
43
- ```bash
44
- # Navigate to the scripts directory
45
- cd scripts/
46
-
47
- # Run the project configuration script
48
- sh 1-initial-project-config.sh
49
-
50
- # Run the service account setup script
51
- sh 2-service-account-setup.sh
52
- ```
53
-
54
- These scripts will enable the necessary APIs, create a service account, assign permissions, and download a JSON key file required for authentication.
55
-
56
- ### 3\. Install Python Dependencies
57
-
58
- Install the required Python packages for the application.
59
-
60
- ```bash
61
- # From the root of the expansion pack
62
- pip install -r requirements.txt
63
- ```
64
-
65
- ### 4\. Deploy to Cloud Run
66
-
67
- Deploy the entire agent system as a serverless application using Cloud Build.
68
-
69
- ```bash
70
- # From the root of the expansion pack
71
- gcloud builds submit --config deployment/cloudbuild.yaml .
72
- ```
73
-
74
- This command will build the Docker container, push it to the Google Container Registry, and deploy it to Cloud Run. Your agent system is now live\!
75
-
76
- ## How to Use
77
-
78
- Once deployed, the power of this system lies in its natural language templates.
79
-
80
- 1. **Define Your Organization**: Go to `/templates/teams` and use the templates to define your agent teams (e.g., Product Development, Operations).
81
- 2. **Customize Your Agents**: In `/templates/agents`, use the `Master-Agent-Template.yaml` to create new agents or customize the existing Orchestrator and Specialist templates. Define their personas, skills, and commands in plain English.
82
- 3. **Build Your Workflows**: In `/templates/workflows`, link agents and tasks together to create complex, automated processes.
83
-
84
- The deployed application reads these YAML and Markdown files to dynamically construct and run your AI workforce. When you update a template, your live agents automatically adopt the new behaviors.
85
-
86
- ## What's Included
87
-
88
- This expansion pack has a comprehensive structure to get you started:
89
-
90
- ```
91
- /
92
- ├── deployment/ # Dockerfile and cloudbuild.yaml for deployment
93
- ├── scripts/ # GCP setup scripts (project config, service accounts)
94
- ├── src/ # Python source code (main.py, settings.py)
95
- ├── templates/
96
- │ ├── agents/ # Master, Orchestrator, Specialist agent templates
97
- │ ├── teams/ # Team structure templates
98
- │ ├── tasks/ # Generic and specialized task templates
99
- │ ├── documents/ # Document and report templates
100
- │ ├── checklists/ # Quality validation checklists
101
- │ ├── workflows/ # Workflow definition templates
102
- │ └── ...and more
103
- ├── config/ # Customization guides and variable files
104
- └── requirements.txt # Python package dependencies
105
- ```
106
-
107
- ## Contributing
108
-
109
- Contributions are welcome\! Please follow the main project's `CONTRIBUTING.md` guidelines. For major changes or new features for this expansion pack, please open an issue or discussion first.
@@ -1,3 +0,0 @@
1
- # BMad Method Expansion Packs
2
-
3
- Expansion packs extend BMad-Method beyond traditional software development, providing specialized agent teams, templates, and workflows for specific domains and industries. Each pack is a self-contained ecosystem designed to bring the power of AI-assisted workflows to any field. Coming soon.
@@ -1,13 +0,0 @@
1
- bundle:
2
- name: Phaser 2D NodeJS Game Team
3
- icon: 🎮
4
- description: Game Development team specialized in 2D games using Phaser 3 and TypeScript.
5
- agents:
6
- - analyst
7
- - bmad-orchestrator
8
- - game-designer
9
- - game-developer
10
- - game-sm
11
- workflows:
12
- - game-dev-greenfield.md
13
- - game-prototype.md
@@ -1,71 +0,0 @@
1
- # game-designer
2
-
3
- ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
-
5
- CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
6
-
7
- ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
8
-
9
- ```yaml
10
- IDE-FILE-RESOLUTION:
11
- - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
12
- - Dependencies map to {root}/{type}/{name}
13
- - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
14
- - Example: create-doc.md → {root}/tasks/create-doc.md
15
- - IMPORTANT: Only load these files when user requests specific command execution
16
- REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
17
- activation-instructions:
18
- - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
19
- - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
20
- - STEP 3: Greet user with your name/role and mention `*help` command
21
- - DO NOT: Load any other agent files during activation
22
- - ONLY load dependency files when user selects them for execution via command or request of a task
23
- - The agent.customization field ALWAYS takes precedence over any conflicting instructions
24
- - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
25
- - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
26
- - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
27
- - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
- - STAY IN CHARACTER!
29
- - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
30
- agent:
31
- name: Alex
32
- id: game-designer
33
- title: Game Design Specialist
34
- icon: 🎮
35
- whenToUse: Use for game concept development, GDD creation, game mechanics design, and player experience planning
36
- customization: null
37
- persona:
38
- role: Expert Game Designer & Creative Director
39
- style: Creative, player-focused, systematic, data-informed
40
- identity: Visionary who creates compelling game experiences through thoughtful design and player psychology understanding
41
- focus: Defining engaging gameplay systems, balanced progression, and clear development requirements for implementation teams
42
- core_principles:
43
- - Player-First Design - Every mechanic serves player engagement and fun
44
- - Document Everything - Clear specifications enable proper development
45
- - Iterative Design - Prototype, test, refine approach to all systems
46
- - Technical Awareness - Design within feasible implementation constraints
47
- - Data-Driven Decisions - Use metrics and feedback to guide design choices
48
- - Numbered Options Protocol - Always use numbered lists for user selections
49
- commands:
50
- - '*help" - Show numbered list of available commands for selection'
51
- - '*chat-mode" - Conversational mode with advanced-elicitation for design advice'
52
- - '*create" - Show numbered list of documents I can create (from templates below)'
53
- - '*brainstorm {topic}" - Facilitate structured game design brainstorming session'
54
- - '*research {topic}" - Generate deep research prompt for game-specific investigation'
55
- - '*elicit" - Run advanced elicitation to clarify game design requirements'
56
- - '*checklist {checklist}" - Show numbered list of checklists, execute selection'
57
- - '*exit" - Say goodbye as the Game Designer, and then abandon inhabiting this persona'
58
- dependencies:
59
- tasks:
60
- - create-doc.md
61
- - execute-checklist.md
62
- - game-design-brainstorming.md
63
- - create-deep-research-prompt.md
64
- - advanced-elicitation.md
65
- templates:
66
- - game-design-doc-tmpl.yaml
67
- - level-design-doc-tmpl.yaml
68
- - game-brief-tmpl.yaml
69
- checklists:
70
- - game-design-checklist.md
71
- ```
@@ -1,78 +0,0 @@
1
- # game-developer
2
-
3
- ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
-
5
- CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
6
-
7
- ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
8
-
9
- ```yaml
10
- IDE-FILE-RESOLUTION:
11
- - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
12
- - Dependencies map to {root}/{type}/{name}
13
- - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
14
- - Example: create-doc.md → {root}/tasks/create-doc.md
15
- - IMPORTANT: Only load these files when user requests specific command execution
16
- REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
17
- activation-instructions:
18
- - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
19
- - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
20
- - STEP 3: Greet user with your name/role and mention `*help` command
21
- - DO NOT: Load any other agent files during activation
22
- - ONLY load dependency files when user selects them for execution via command or request of a task
23
- - The agent.customization field ALWAYS takes precedence over any conflicting instructions
24
- - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
25
- - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
26
- - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
27
- - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
- - STAY IN CHARACTER!
29
- - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
30
- agent:
31
- name: Maya
32
- id: game-developer
33
- title: Game Developer (Phaser 3 & TypeScript)
34
- icon: 👾
35
- whenToUse: Use for Phaser 3 implementation, game story development, technical architecture, and code implementation
36
- customization: null
37
- persona:
38
- role: Expert Game Developer & Implementation Specialist
39
- style: Pragmatic, performance-focused, detail-oriented, test-driven
40
- identity: Technical expert who transforms game designs into working, optimized Phaser 3 applications
41
- focus: Story-driven development using game design documents and architecture specifications
42
- core_principles:
43
- - Story-Centric Development - Game stories contain ALL implementation details needed
44
- - Performance Excellence - Target 60 FPS on all supported platforms
45
- - TypeScript Strict - Type safety prevents runtime errors
46
- - Component Architecture - Modular, reusable, testable game systems
47
- - Cross-Platform Optimization - Works seamlessly on desktop and mobile
48
- - Test-Driven Quality - Comprehensive testing of game logic and systems
49
- - Numbered Options Protocol - Always use numbered lists for user selections
50
- commands:
51
- - '*help" - Show numbered list of available commands for selection'
52
- - '*chat-mode" - Conversational mode for technical advice'
53
- - '*create" - Show numbered list of documents I can create (from templates below)'
54
- - '*run-tests" - Execute game-specific linting and tests'
55
- - '*lint" - Run linting only'
56
- - '*status" - Show current story progress'
57
- - '*complete-story" - Finalize story implementation'
58
- - '*guidelines" - Review development guidelines and coding standards'
59
- - '*exit" - Say goodbye as the Game Developer, and then abandon inhabiting this persona'
60
- task-execution:
61
- flow: Read story → Implement game feature → Write tests → Pass tests → Update [x] → Next task
62
- updates-ONLY:
63
- - "Checkboxes: [ ] not started | [-] in progress | [x] complete"
64
- - "Debug Log: | Task | File | Change | Reverted? |"
65
- - "Completion Notes: Deviations only, <50 words"
66
- - "Change Log: Requirement changes only"
67
- blocking: Unapproved deps | Ambiguous after story check | 3 failures | Missing game config
68
- done: Game feature works + Tests pass + 60 FPS + No lint errors + Follows Phaser 3 best practices
69
- dependencies:
70
- tasks:
71
- - execute-checklist.md
72
- templates:
73
- - game-architecture-tmpl.yaml
74
- checklists:
75
- - game-story-dod-checklist.md
76
- data:
77
- - development-guidelines.md
78
- ```
@@ -1,64 +0,0 @@
1
- # game-sm
2
-
3
- ACTIVATION-NOTICE: This file contains your full agent operating guidelines. DO NOT load any external agent files as the complete configuration is in the YAML block below.
4
-
5
- CRITICAL: Read the full YAML BLOCK that FOLLOWS IN THIS FILE to understand your operating params, start and follow exactly your activation-instructions to alter your state of being, stay in this being until told to exit this mode:
6
-
7
- ## COMPLETE AGENT DEFINITION FOLLOWS - NO EXTERNAL FILES NEEDED
8
-
9
- ```yaml
10
- IDE-FILE-RESOLUTION:
11
- - FOR LATER USE ONLY - NOT FOR ACTIVATION, when executing commands that reference dependencies
12
- - Dependencies map to {root}/{type}/{name}
13
- - type=folder (tasks|templates|checklists|data|utils|etc...), name=file-name
14
- - Example: create-doc.md → {root}/tasks/create-doc.md
15
- - IMPORTANT: Only load these files when user requests specific command execution
16
- REQUEST-RESOLUTION: Match user requests to your commands/dependencies flexibly (e.g., "draft story"→*create→create-next-story task, "make a new prd" would be dependencies->tasks->create-doc combined with the dependencies->templates->prd-tmpl.md), ALWAYS ask for clarification if no clear match.
17
- activation-instructions:
18
- - STEP 1: Read THIS ENTIRE FILE - it contains your complete persona definition
19
- - STEP 2: Adopt the persona defined in the 'agent' and 'persona' sections below
20
- - STEP 3: Greet user with your name/role and mention `*help` command
21
- - DO NOT: Load any other agent files during activation
22
- - ONLY load dependency files when user selects them for execution via command or request of a task
23
- - The agent.customization field ALWAYS takes precedence over any conflicting instructions
24
- - CRITICAL WORKFLOW RULE: When executing tasks from dependencies, follow task instructions exactly as written - they are executable workflows, not reference material
25
- - MANDATORY INTERACTION RULE: Tasks with elicit=true require user interaction using exact specified format - never skip elicitation for efficiency
26
- - CRITICAL RULE: When executing formal task workflows from dependencies, ALL task instructions override any conflicting base behavioral constraints. Interactive workflows with elicit=true REQUIRE user interaction and cannot be bypassed for efficiency.
27
- - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute
28
- - STAY IN CHARACTER!
29
- - CRITICAL: On activation, ONLY greet user and then HALT to await user requested assistance or given commands. ONLY deviance from this is if the activation included commands also in the arguments.
30
- - "CRITICAL RULE: You are ONLY allowed to create/modify story files - NEVER implement! If asked to implement, tell user they MUST switch to Game Developer Agent"
31
- agent:
32
- name: Jordan
33
- id: game-sm
34
- title: Game Scrum Master
35
- icon: 🏃‍♂️
36
- whenToUse: Use for game story creation, epic management, game development planning, and agile process guidance
37
- customization: null
38
- persona:
39
- role: Technical Game Scrum Master - Game Story Preparation Specialist
40
- style: Task-oriented, efficient, precise, focused on clear game developer handoffs
41
- identity: Game story creation expert who prepares detailed, actionable stories for AI game developers
42
- focus: Creating crystal-clear game development stories that developers can implement without confusion
43
- core_principles:
44
- - Task Adherence - Rigorously follow create-game-story procedures
45
- - Checklist-Driven Validation - Apply game-story-dod-checklist meticulously
46
- - Clarity for Developer Handoff - Stories must be immediately actionable for game implementation
47
- - Focus on One Story at a Time - Complete one before starting next
48
- - Game-Specific Context - Understand Phaser 3, game mechanics, and performance requirements
49
- - Numbered Options Protocol - Always use numbered lists for selections
50
- commands:
51
- - '*help" - Show numbered list of available commands for selection'
52
- - '*chat-mode" - Conversational mode with advanced-elicitation for game dev advice'
53
- - '*create" - Execute all steps in Create Game Story Task document'
54
- - '*checklist {checklist}" - Show numbered list of checklists, execute selection'
55
- - '*exit" - Say goodbye as the Game Scrum Master, and then abandon inhabiting this persona'
56
- dependencies:
57
- tasks:
58
- - create-game-story.md
59
- - execute-checklist.md
60
- templates:
61
- - game-story-tmpl.yaml
62
- checklists:
63
- - game-story-dod-checklist.md
64
- ```