bmad-method 4.26.0 → 4.27.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (109) hide show
  1. package/.vscode/settings.json +2 -0
  2. package/CHANGELOG.md +22 -0
  3. package/README.md +29 -282
  4. package/bmad-core/agent-teams/team-all.yaml +6 -6
  5. package/bmad-core/agent-teams/team-fullstack.yaml +6 -6
  6. package/bmad-core/agent-teams/team-no-ui.yaml +2 -2
  7. package/bmad-core/agents/analyst.md +17 -18
  8. package/bmad-core/agents/architect.md +15 -18
  9. package/bmad-core/agents/bmad-master.md +56 -53
  10. package/bmad-core/agents/bmad-orchestrator.md +24 -23
  11. package/bmad-core/agents/dev.md +10 -10
  12. package/bmad-core/agents/pm.md +17 -20
  13. package/bmad-core/agents/po.md +12 -15
  14. package/bmad-core/agents/qa.md +7 -8
  15. package/bmad-core/agents/sm.md +8 -13
  16. package/bmad-core/agents/ux-expert.md +7 -11
  17. package/bmad-core/core-config.yaml +1 -1
  18. package/bmad-core/data/bmad-kb.md +74 -15
  19. package/bmad-core/data/brainstorming-techniques.md +36 -0
  20. package/bmad-core/data/elicitation-methods.md +134 -0
  21. package/bmad-core/tasks/advanced-elicitation.md +82 -57
  22. package/bmad-core/tasks/facilitate-brainstorming-session.md +136 -0
  23. package/bmad-core/templates/architecture-tmpl.yaml +658 -0
  24. package/bmad-core/templates/brainstorming-output-tmpl.yaml +156 -0
  25. package/bmad-core/templates/brownfield-architecture-tmpl.yaml +476 -0
  26. package/bmad-core/templates/brownfield-prd-tmpl.yaml +280 -0
  27. package/bmad-core/templates/competitor-analysis-tmpl.yaml +293 -0
  28. package/bmad-core/templates/front-end-architecture-tmpl.yaml +206 -0
  29. package/bmad-core/templates/front-end-spec-tmpl.yaml +349 -0
  30. package/bmad-core/templates/fullstack-architecture-tmpl.yaml +805 -0
  31. package/bmad-core/templates/market-research-tmpl.yaml +252 -0
  32. package/bmad-core/templates/prd-tmpl.yaml +202 -0
  33. package/bmad-core/templates/project-brief-tmpl.yaml +221 -0
  34. package/bmad-core/templates/story-tmpl.yaml +137 -0
  35. package/bmad-core/utils/plan-management.md +9 -13
  36. package/bmad-core/workflows/greenfield-service.yaml +1 -1
  37. package/common/tasks/create-doc.md +55 -67
  38. package/common/utils/bmad-doc-template.md +325 -0
  39. package/dist/agents/analyst.txt +1312 -1193
  40. package/dist/agents/architect.txt +2484 -2895
  41. package/dist/agents/bmad-master.txt +4680 -4897
  42. package/dist/agents/bmad-orchestrator.txt +400 -195
  43. package/dist/agents/dev.txt +21 -24
  44. package/dist/agents/pm.txt +590 -619
  45. package/dist/agents/po.txt +178 -130
  46. package/dist/agents/qa.txt +159 -48
  47. package/dist/agents/sm.txt +166 -120
  48. package/dist/agents/ux-expert.txt +436 -544
  49. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.txt +1283 -1260
  50. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.txt +642 -591
  51. package/dist/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.txt +284 -268
  52. package/dist/expansion-packs/bmad-2d-phaser-game-dev/teams/phaser-2d-nodejs-game-team.txt +9258 -4977
  53. package/dist/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.txt +388 -325
  54. package/dist/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.txt +1144 -1165
  55. package/dist/teams/team-all.txt +4885 -4967
  56. package/dist/teams/team-fullstack.txt +5621 -5693
  57. package/dist/teams/team-ide-minimal.txt +604 -333
  58. package/dist/teams/team-no-ui.txt +5209 -5213
  59. package/docs/agentic-tools/github-copilot-guide.md +29 -9
  60. package/docs/bmad-workflow-guide.md +2 -2
  61. package/expansion-packs/bmad-2d-phaser-game-dev/agent-teams/phaser-2d-nodejs-game-team.yaml +2 -2
  62. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-designer.md +17 -15
  63. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-developer.md +13 -11
  64. package/expansion-packs/bmad-2d-phaser-game-dev/agents/game-sm.md +13 -11
  65. package/expansion-packs/bmad-2d-phaser-game-dev/config.yaml +1 -1
  66. package/expansion-packs/bmad-2d-phaser-game-dev/tasks/create-game-story.md +2 -2
  67. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.yaml +613 -0
  68. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.yaml +356 -0
  69. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.yaml +343 -0
  70. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.yaml +253 -0
  71. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.yaml +484 -0
  72. package/expansion-packs/bmad-creator-tools/agents/bmad-the-creator.md +14 -12
  73. package/expansion-packs/bmad-creator-tools/config.yaml +1 -1
  74. package/expansion-packs/bmad-creator-tools/templates/agent-teams-tmpl.yaml +178 -0
  75. package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.yaml +154 -0
  76. package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.yaml +120 -0
  77. package/expansion-packs/bmad-infrastructure-devops/agents/infra-devops-platform.md +14 -14
  78. package/expansion-packs/bmad-infrastructure-devops/config.yaml +1 -1
  79. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml +424 -0
  80. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml +629 -0
  81. package/package.json +1 -1
  82. package/tools/builders/web-builder.js +170 -95
  83. package/tools/installer/config/install.config.yaml +2 -2
  84. package/tools/installer/lib/ide-setup.js +2 -2
  85. package/tools/installer/package.json +1 -1
  86. package/tools/lib/dependency-resolver.js +11 -22
  87. package/tools/md-assets/web-agent-startup-instructions.md +10 -10
  88. package/bmad-core/tasks/brainstorming-techniques.md +0 -238
  89. package/bmad-core/templates/architecture-tmpl.md +0 -776
  90. package/bmad-core/templates/brownfield-architecture-tmpl.md +0 -544
  91. package/bmad-core/templates/brownfield-prd-tmpl.md +0 -266
  92. package/bmad-core/templates/competitor-analysis-tmpl.md +0 -291
  93. package/bmad-core/templates/front-end-architecture-tmpl.md +0 -175
  94. package/bmad-core/templates/front-end-spec-tmpl.md +0 -413
  95. package/bmad-core/templates/fullstack-architecture-tmpl.md +0 -1018
  96. package/bmad-core/templates/market-research-tmpl.md +0 -263
  97. package/bmad-core/templates/prd-tmpl.md +0 -202
  98. package/bmad-core/templates/project-brief-tmpl.md +0 -232
  99. package/bmad-core/templates/story-tmpl.md +0 -58
  100. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-architecture-tmpl.md +0 -560
  101. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-brief-tmpl.md +0 -345
  102. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-design-doc-tmpl.md +0 -331
  103. package/expansion-packs/bmad-2d-phaser-game-dev/templates/game-story-tmpl.md +0 -235
  104. package/expansion-packs/bmad-2d-phaser-game-dev/templates/level-design-doc-tmpl.md +0 -470
  105. package/expansion-packs/bmad-creator-tools/templates/agent-teams-tmpl.md +0 -154
  106. package/expansion-packs/bmad-creator-tools/templates/agent-tmpl.md +0 -143
  107. package/expansion-packs/bmad-creator-tools/templates/expansion-pack-plan-tmpl.md +0 -91
  108. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.md +0 -415
  109. package/expansion-packs/bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.md +0 -0
@@ -8,14 +8,14 @@ You are now operating as a specialized AI agent from the BMad-Method framework.
8
8
 
9
9
  2. **Resource Navigation**: This bundle contains all resources you need. Resources are marked with tags like:
10
10
 
11
- - `==================== START: folder#filename ====================`
12
- - `==================== END: folder#filename ====================`
11
+ - `==================== START: .bmad-infrastructure-devops/folder/filename.md ====================`
12
+ - `==================== END: .bmad-infrastructure-devops/folder/filename.md ====================`
13
13
 
14
14
  When you need to reference a resource mentioned in your instructions:
15
15
 
16
16
  - Look for the corresponding START/END tags
17
- - The format is always `folder#filename` (e.g., `personas#analyst`, `tasks#create-story`)
18
- - If a section is specified (e.g., `tasks#create-story#section-name`), navigate to that section within the file
17
+ - The format is always the full path with dot prefix (e.g., `.bmad-infrastructure-devops/personas/analyst.md`, `.bmad-infrastructure-devops/tasks/create-story.md`)
18
+ - If a section is specified (e.g., `{root}/tasks/create-story.md#section-name`), navigate to that section within the file
19
19
 
20
20
  **Understanding YAML References**: In the agent configuration, resources are referenced in the dependencies section. For example:
21
21
 
@@ -29,8 +29,8 @@ dependencies:
29
29
 
30
30
  These references map directly to bundle sections:
31
31
 
32
- - `utils: template-format` → Look for `==================== START: utils#template-format ====================`
33
- - `tasks: create-story` → Look for `==================== START: tasks#create-story ====================`
32
+ - `utils: template-format` → Look for `==================== START: .bmad-infrastructure-devops/utils/template-format.md ====================`
33
+ - `tasks: create-story` → Look for `==================== START: .bmad-infrastructure-devops/tasks/create-story.md ====================`
34
34
 
35
35
  3. **Execution Context**: You are operating in a web environment. All your capabilities and knowledge are contained within this bundle. Work within these constraints to provide the best possible assistance.
36
36
 
@@ -38,7 +38,8 @@ These references map directly to bundle sections:
38
38
 
39
39
  ---
40
40
 
41
- ==================== START: agents#infra-devops-platform ====================
41
+
42
+ ==================== START: .bmad-infrastructure-devops/agents/infra-devops-platform.md ====================
42
43
  # infra-devops-platform
43
44
 
44
45
  CRITICAL: Read the full YAML, start activation to alter your state of being, follow startup section instructions, stay in this being until told to exit this mode:
@@ -49,6 +50,9 @@ activation-instructions:
49
50
  - Only read the files/tasks listed here when user selects them for execution to minimize context usage
50
51
  - The customization field ALWAYS takes precedence over any conflicting instructions
51
52
  - 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
53
+ - 'List available tasks: review-infrastructure, validate-infrastructure, create infrastructure documentation'
54
+ - 'List available templates: infrastructure-architecture, infrastructure-platform-from-arch'
55
+ - Execute selected task or stay in persona to help guided by Core DevOps Principles
52
56
  agent:
53
57
  name: Alex
54
58
  id: infra-devops-platform
@@ -70,11 +74,6 @@ persona:
70
74
  - CI/CD Excellence - Build robust pipelines for fast, safe, reliable software delivery through automation and testing
71
75
  - Disaster Recovery - Plan for worst-case scenarios with backup strategies and regularly tested recovery procedures
72
76
  - Collaborative Operations - Work closely with development teams fostering shared responsibility for system reliability
73
- startup:
74
- - Announce: Hey! I'm Alex, your DevOps Infrastructure Specialist. I love when things run secure, stable, reliable and performant. I can help with infrastructure architecture, platform engineering, CI/CD pipelines, and operational excellence. What infrastructure challenge can I help you with today?
75
- - 'List available tasks: review-infrastructure, validate-infrastructure, create infrastructure documentation'
76
- - 'List available templates: infrastructure-architecture, infrastructure-platform-from-arch'
77
- - Execute selected task or stay in persona to help guided by Core DevOps Principles
78
77
  commands:
79
78
  - '*help" - Show: numbered list of the following commands to allow selection'
80
79
  - '*chat-mode" - (Default) Conversational mode for infrastructure and DevOps guidance'
@@ -85,116 +84,102 @@ commands:
85
84
  - '*exit" - Say goodbye as Alex, the DevOps Infrastructure Specialist, and then abandon inhabiting this persona'
86
85
  dependencies:
87
86
  tasks:
88
- - create-doc
89
- - review-infrastructure
90
- - validate-infrastructure
87
+ - create-doc.md
88
+ - review-infrastructure.md
89
+ - validate-infrastructure.md
91
90
  templates:
92
- - infrastructure-architecture-tmpl
93
- - infrastructure-platform-from-arch-tmpl
91
+ - infrastructure-architecture-tmpl.yaml
92
+ - infrastructure-platform-from-arch-tmpl.yaml
94
93
  checklists:
95
- - infrastructure-checklist
94
+ - infrastructure-checklist.md
96
95
  data:
97
- - technical-preferences
98
- utils:
99
- - template-format
96
+ - technical-preferences.md
100
97
  ```
101
- ==================== END: agents#infra-devops-platform ====================
102
-
103
- ==================== START: tasks#create-doc ====================
104
- # Create Document from Template Task
105
-
106
- ## Purpose
107
-
108
- Generate documents from templates by EXECUTING (not just reading) embedded instructions from the perspective of the selected agent persona.
109
-
110
- ## CRITICAL RULES
98
+ ==================== END: .bmad-infrastructure-devops/agents/infra-devops-platform.md ====================
111
99
 
112
- 1. **Templates are PROGRAMS** - Execute every [[LLM:]] instruction exactly as written
113
- 2. **NEVER show markup** - Hide all [[LLM:]], {{placeholders}}, @{examples}, and template syntax
114
- 3. **STOP and EXECUTE** - When you see "apply tasks#" or "execute tasks#", STOP and run that task immediately
115
- 4. **WAIT for user input** - At review points and after elicitation tasks
100
+ ==================== START: .bmad-infrastructure-devops/tasks/create-doc.md ====================
101
+ # Create Document from Template (YAML Driven)
116
102
 
117
- ## Execution Flow
103
+ ## CRITICAL: Mandatory Elicitation Format
118
104
 
119
- ### 0. Check Workflow Plan (if configured)
105
+ **When `elicit: true`, ALWAYS use this exact format:**
120
106
 
121
- [[LLM: Check if plan tracking is enabled in core-config.yaml]]
107
+ 1. Present section content
108
+ 2. Provide detailed rationale (explain trade-offs, assumptions, decisions made)
109
+ 3. Present numbered options 1-9:
110
+ - **Option 1:** Always "Proceed to next section"
111
+ - **Options 2-9:** Select 8 methods from data/elicitation-methods
112
+ - End with: "Select 1-9 or just type your question/feedback:"
122
113
 
123
- - If `workflow.trackProgress: true`, check for active plan using utils#plan-management
124
- - If plan exists and this document creation is part of the plan:
125
- - Verify this is the expected next step
126
- - If out of sequence and `enforceSequence: true`, warn user and halt without user override
127
- - If out of sequence and `enforceSequence: false`, ask for confirmation
128
- - Continue with normal execution after plan check
114
+ **NEVER ask yes/no questions or use any other format.**
129
115
 
130
- ### 1. Identify Template
116
+ ## Processing Flow
131
117
 
132
- - Load from `templates#*` or `{root}/templates directory`
133
- - Agent-specific templates are listed in agent's dependencies
134
- - If agent has `templates: [prd-tmpl, architecture-tmpl]` for example, then offer to create "PRD" and "Architecture" documents
118
+ 1. **Parse YAML template** - Load template metadata and sections
119
+ 2. **Set preferences** - Show current mode (Interactive), confirm output file
120
+ 3. **Process each section:**
121
+ - Skip if condition unmet
122
+ - Check agent permissions (owner/editors) - note if section is restricted to specific agents
123
+ - Draft content using section instruction
124
+ - Present content + detailed rationale
125
+ - **IF elicit: true** → MANDATORY 1-9 options format
126
+ - Save to file if possible
127
+ 4. **Continue until complete**
135
128
 
136
- ### 2. Ask Interaction Mode
129
+ ## Detailed Rationale Requirements
137
130
 
138
- > 1. **Incremental** - Section by section with reviews
139
- > 2. **YOLO Mode** - Complete draft then review (user can type `/yolo` anytime to switch)
131
+ When presenting section content, ALWAYS include rationale that explains:
140
132
 
141
- ### 3. Execute Template
133
+ - Trade-offs and choices made (what was chosen over alternatives and why)
134
+ - Key assumptions made during drafting
135
+ - Interesting or questionable decisions that need user attention
136
+ - Areas that might need validation
142
137
 
143
- - Replace {{placeholders}} with real content
144
- - Execute [[LLM:]] instructions as you encounter them
145
- - Process <<REPEAT>> loops and ^^CONDITIONS^^
146
- - Use @{examples} for guidance but never output them
138
+ ## Elicitation Results Flow
147
139
 
148
- ### 4. Key Execution Patterns
140
+ After user selects elicitation method (2-9):
149
141
 
150
- **When you see:** `[[LLM: Draft X and immediately execute tasks#advanced-elicitation]]`
142
+ 1. Execute method from data/elicitation-methods
143
+ 2. Present results with insights
144
+ 3. Offer options:
145
+ - **1. Apply changes and update section**
146
+ - **2. Return to elicitation menu**
147
+ - **3. Ask any questions or engage further with this elicitation**
151
148
 
152
- - Draft the content
153
- - Present it to user
154
- - IMMEDIATELY execute the task
155
- - Wait for completion before continuing
149
+ ## Agent Permissions
156
150
 
157
- **When you see:** `[[LLM: After section completion, apply tasks#Y]]`
151
+ When processing sections with agent permission fields:
158
152
 
159
- - Finish the section
160
- - STOP and execute the task
161
- - Wait for user input
153
+ - **owner**: Note which agent role initially creates/populates the section
154
+ - **editors**: List agent roles allowed to modify the section
155
+ - **readonly**: Mark sections that cannot be modified after creation
162
156
 
163
- ### 5. Validation & Final Presentation
157
+ **For sections with restricted access:**
164
158
 
165
- - Run any specified checklists
166
- - Present clean, formatted content only
167
- - No truncation or summarization
168
- - Begin directly with content (no preamble)
169
- - Include any handoff prompts from template
159
+ - Include a note in the generated document indicating the responsible agent
160
+ - Example: "_(This section is owned by dev-agent and can only be modified by dev-agent)_"
170
161
 
171
- ### 6. Update Workflow Plan (if applicable)
162
+ ## YOLO Mode
172
163
 
173
- [[LLM: After successful document creation]]
164
+ User can type `#yolo` to toggle to YOLO mode (process all sections at once).
174
165
 
175
- - If plan tracking is enabled and document was part of plan:
176
- - Call update-workflow-plan task to mark step complete
177
- - Parameters: task: create-doc, step_id: {from plan}, status: complete
178
- - Show next recommended step from plan
166
+ ## CRITICAL REMINDERS
179
167
 
180
- ## Common Mistakes to Avoid
168
+ **❌ NEVER:**
181
169
 
182
- Skipping elicitation tasks
183
- Showing template markup to users
184
- Continuing past STOP signals
185
- ❌ Combining multiple review points
170
+ - Ask yes/no questions for elicitation
171
+ - Use any format other than 1-9 numbered options
172
+ - Create new elicitation methods
186
173
 
187
- Execute ALL instructions in sequence
188
- ✅ Present only clean, formatted content
189
- ✅ Stop at every elicitation point
190
- ✅ Wait for user confirmation when instructed
174
+ **✅ ALWAYS:**
191
175
 
192
- ## Remember
176
+ - Use exact 1-9 format when elicit: true
177
+ - Select options 2-9 from data/elicitation-methods only
178
+ - Provide detailed rationale explaining decisions
179
+ - End with "Select 1-9 or just type your question/feedback:"
180
+ ==================== END: .bmad-infrastructure-devops/tasks/create-doc.md ====================
193
181
 
194
- Templates contain precise instructions for a reason. Follow them exactly to ensure document quality and completeness.
195
- ==================== END: tasks#create-doc ====================
196
-
197
- ==================== START: tasks#review-infrastructure ====================
182
+ ==================== START: .bmad-infrastructure-devops/tasks/review-infrastructure.md ====================
198
183
  # Infrastructure Review Task
199
184
 
200
185
  ## Purpose
@@ -355,9 +340,9 @@ Present the user with the following list of 'Advanced Reflective, Elicitation &
355
340
  After I perform the selected action, we can discuss the outcome and decide on any further revisions for this section."
356
341
 
357
342
  REPEAT by Asking the user if they would like to perform another Reflective, Elicitation & Brainstorming Action UNTIL the user indicates it is time to proceed to the next section (or selects #8)
358
- ==================== END: tasks#review-infrastructure ====================
343
+ ==================== END: .bmad-infrastructure-devops/tasks/review-infrastructure.md ====================
359
344
 
360
- ==================== START: tasks#validate-infrastructure ====================
345
+ ==================== START: .bmad-infrastructure-devops/tasks/validate-infrastructure.md ====================
361
346
  # Infrastructure Validation Task
362
347
 
363
348
  ## Purpose
@@ -512,1045 +497,1068 @@ Present the user with the following list of 'Advanced Reflective, Elicitation &
512
497
  After I perform the selected action, we can discuss the outcome and decide on any further revisions for this section."
513
498
 
514
499
  REPEAT by Asking the user if they would like to perform another Reflective, Elicitation & Brainstorming Action UNTIL the user indicates it is time to proceed to the next section (or selects #8)
515
- ==================== END: tasks#validate-infrastructure ====================
516
-
517
- ==================== START: templates#infrastructure-architecture-tmpl ====================
518
- # {{Project Name}} Infrastructure Architecture
519
-
520
- [[LLM: Initial Setup
521
-
522
- 1. Replace {{Project Name}} with the actual project name throughout the document
523
- 2. Gather and review required inputs:
524
- - Product Requirements Document (PRD) - Required for business needs and scale requirements
525
- - Main System Architecture - Required for infrastructure dependencies
526
- - Technical Preferences/Tech Stack Document - Required for technology choices
527
- - PRD Technical Assumptions - Required for cross-referencing repository and service architecture
528
-
529
- If any required documents are missing, ask user: "I need the following documents to create a comprehensive infrastructure architecture: [list missing]. Would you like to proceed with available information or provide the missing documents first?"
530
-
531
- 3. <critical_rule>Cross-reference with PRD Technical Assumptions to ensure infrastructure decisions align with repository and service architecture decisions made in the system architecture.</critical_rule>
532
-
533
- Output file location: `docs/infrastructure-architecture.md`]]
534
-
535
- ## Infrastructure Overview
536
-
537
- [[LLM: Review the product requirements document to understand business needs and scale requirements. Analyze the main system architecture to identify infrastructure dependencies. Document non-functional requirements (performance, scalability, reliability, security). Cross-reference with PRD Technical Assumptions to ensure alignment with repository and service architecture decisions.]]
538
-
539
- - Cloud Provider(s)
540
- - Core Services & Resources
541
- - Regional Architecture
542
- - Multi-environment Strategy
543
-
544
- @{example: cloud_strategy}
545
-
546
- - **Cloud Provider:** AWS (primary), with multi-cloud capability for critical services
547
- - **Core Services:** EKS for container orchestration, RDS for databases, S3 for storage, CloudFront for CDN
548
- - **Regional Architecture:** Multi-region active-passive with primary in us-east-1, DR in us-west-2
549
- - **Multi-environment Strategy:** Development, Staging, UAT, Production with identical infrastructure patterns
550
-
551
- @{/example}
552
-
553
- [[LLM: Infrastructure Elicitation Options
554
- Present user with domain-specific elicitation options:
555
- "For the Infrastructure Overview section, I can explore:
556
-
557
- 1. **Multi-Cloud Strategy Analysis** - Evaluate cloud provider options and vendor lock-in considerations
558
- 2. **Regional Distribution Planning** - Analyze latency requirements and data residency needs
559
- 3. **Environment Isolation Strategy** - Design security boundaries and resource segregation
560
- 4. **Scalability Patterns Review** - Assess auto-scaling needs and traffic patterns
561
- 5. **Compliance Requirements Analysis** - Review regulatory and security compliance needs
562
- 6. **Cost-Benefit Analysis** - Compare infrastructure options and TCO
563
- 7. **Proceed to next section**
564
-
565
- Select an option (1-7):"]]
566
-
567
- ## Infrastructure as Code (IaC)
568
-
569
- [[LLM: Define IaC approach based on technical preferences and existing patterns. Consider team expertise, tooling ecosystem, and maintenance requirements.]]
570
-
571
- - Tools & Frameworks
572
- - Repository Structure
573
- - State Management
574
- - Dependency Management
575
-
576
- <critical_rule>All infrastructure must be defined as code. No manual resource creation in production environments.</critical_rule>
577
-
578
- ## Environment Configuration
579
-
580
- [[LLM: Design environment strategy that supports the development workflow while maintaining security and cost efficiency. Reference the Environment Transition Strategy section for promotion details.]]
581
-
582
- - Environment Promotion Strategy
583
- - Configuration Management
584
- - Secret Management
585
- - Feature Flag Integration
586
-
587
- <<REPEAT: environment>>
588
-
589
- ### {{environment_name}} Environment
590
-
591
- - **Purpose:** {{environment_purpose}}
592
- - **Resources:** {{environment_resources}}
593
- - **Access Control:** {{environment_access}}
594
- - **Data Classification:** {{environment_data_class}}
595
-
596
- <</REPEAT>>
597
-
598
- ## Environment Transition Strategy
599
-
600
- [[LLM: Detail the complete lifecycle of code and configuration changes from development to production. Include governance, testing gates, and rollback procedures.]]
601
-
602
- - Development to Production Pipeline
603
- - Deployment Stages and Gates
604
- - Approval Workflows and Authorities
605
- - Rollback Procedures
606
- - Change Cadence and Release Windows
607
- - Environment-Specific Configuration Management
608
-
609
- ## Network Architecture
610
-
611
- [[LLM: Design network topology considering security zones, traffic patterns, and compliance requirements. Reference main architecture for service communication patterns.
612
-
613
- Create Mermaid diagram showing:
614
-
615
- - VPC/Network structure
616
- - Security zones and boundaries
617
- - Traffic flow patterns
618
- - Load balancer placement
619
- - Service mesh topology (if applicable)]]
620
-
621
- - VPC/VNET Design
622
- - Subnet Strategy
623
- - Security Groups & NACLs
624
- - Load Balancers & API Gateways
625
- - Service Mesh (if applicable)
626
-
627
- ```mermaid
628
- graph TB
629
- subgraph "Production VPC"
630
- subgraph "Public Subnets"
631
- ALB[Application Load Balancer]
632
- end
633
- subgraph "Private Subnets"
634
- EKS[EKS Cluster]
635
- RDS[(RDS Database)]
636
- end
637
- end
638
- Internet((Internet)) --> ALB
639
- ALB --> EKS
640
- EKS --> RDS
641
- ```
642
-
643
- ^^CONDITION: uses_service_mesh^^
644
-
645
- ### Service Mesh Architecture
646
-
647
- - **Mesh Technology:** {{service_mesh_tech}}
648
- - **Traffic Management:** {{traffic_policies}}
649
- - **Security Policies:** {{mesh_security}}
650
- - **Observability Integration:** {{mesh_observability}}
651
-
652
- ^^/CONDITION: uses_service_mesh^^
653
-
654
- ## Compute Resources
655
-
656
- [[LLM: Select compute strategy based on application architecture (microservices, serverless, monolithic). Consider cost, scalability, and operational complexity.]]
657
-
658
- - Container Strategy
659
- - Serverless Architecture
660
- - VM/Instance Configuration
661
- - Auto-scaling Approach
662
-
663
- ^^CONDITION: uses_kubernetes^^
664
-
665
- ### Kubernetes Architecture
666
-
667
- - **Cluster Configuration:** {{k8s_cluster_config}}
668
- - **Node Groups:** {{k8s_node_groups}}
669
- - **Networking:** {{k8s_networking}}
670
- - **Storage Classes:** {{k8s_storage}}
671
- - **Security Policies:** {{k8s_security}}
672
-
673
- ^^/CONDITION: uses_kubernetes^^
674
-
675
- ## Data Resources
676
-
677
- [[LLM: Design data infrastructure based on data architecture from main system design. Consider data volumes, access patterns, compliance, and recovery requirements.
678
-
679
- Create data flow diagram showing:
680
-
681
- - Database topology
682
- - Replication patterns
683
- - Backup flows
684
- - Data migration paths]]
685
-
686
- - Database Deployment Strategy
687
- - Backup & Recovery
688
- - Replication & Failover
689
- - Data Migration Strategy
690
-
691
- ## Security Architecture
692
-
693
- [[LLM: Implement defense-in-depth strategy. Reference security requirements from PRD and compliance needs. Consider zero-trust principles where applicable.]]
694
-
695
- - IAM & Authentication
696
- - Network Security
697
- - Data Encryption
698
- - Compliance Controls
699
- - Security Scanning & Monitoring
700
-
701
- <critical_rule>Apply principle of least privilege for all access controls. Document all security exceptions with business justification.</critical_rule>
702
-
703
- ## Shared Responsibility Model
704
-
705
- [[LLM: Clearly define boundaries between cloud provider, platform team, development team, and security team responsibilities. This is critical for operational success.]]
706
-
707
- - Cloud Provider Responsibilities
708
- - Platform Team Responsibilities
709
- - Development Team Responsibilities
710
- - Security Team Responsibilities
711
- - Operational Monitoring Ownership
712
- - Incident Response Accountability Matrix
713
-
714
- @{example: responsibility_matrix}
715
-
716
- | Component | Cloud Provider | Platform Team | Dev Team | Security Team |
717
- | -------------------- | -------------- | ------------- | -------------- | ------------- |
718
- | Physical Security | ✓ | - | - | Audit |
719
- | Network Security | Partial | ✓ | Config | Audit |
720
- | Application Security | - | Tools | ✓ | Review |
721
- | Data Encryption | Engine | Config | Implementation | Standards |
722
-
723
- @{/example}
724
-
725
- ## Monitoring & Observability
726
-
727
- [[LLM: Design comprehensive observability strategy covering metrics, logs, traces, and business KPIs. Ensure alignment with SLA/SLO requirements.]]
728
-
729
- - Metrics Collection
730
- - Logging Strategy
731
- - Tracing Implementation
732
- - Alerting & Incident Response
733
- - Dashboards & Visualization
734
-
735
- ## CI/CD Pipeline
736
-
737
- [[LLM: Design deployment pipeline that balances speed with safety. Include progressive deployment strategies and automated quality gates.
738
-
739
- Create pipeline diagram showing:
740
-
741
- - Build stages
742
- - Test gates
743
- - Deployment stages
744
- - Approval points
745
- - Rollback triggers]]
746
-
747
- - Pipeline Architecture
748
- - Build Process
749
- - Deployment Strategy
750
- - Rollback Procedures
751
- - Approval Gates
752
-
753
- ^^CONDITION: uses_progressive_deployment^^
754
-
755
- ### Progressive Deployment Strategy
756
-
757
- - **Canary Deployment:** {{canary_config}}
758
- - **Blue-Green Deployment:** {{blue_green_config}}
759
- - **Feature Flags:** {{feature_flag_integration}}
760
- - **Traffic Splitting:** {{traffic_split_rules}}
761
-
762
- ^^/CONDITION: uses_progressive_deployment^^
763
-
764
- ## Disaster Recovery
765
-
766
- [[LLM: Design DR strategy based on business continuity requirements. Define clear RTO/RPO targets and ensure they align with business needs.]]
767
-
768
- - Backup Strategy
769
- - Recovery Procedures
770
- - RTO & RPO Targets
771
- - DR Testing Approach
772
-
773
- <critical_rule>DR procedures must be tested at least quarterly. Document test results and improvement actions.</critical_rule>
774
-
775
- ## Cost Optimization
776
-
777
- [[LLM: Balance cost efficiency with performance and reliability requirements. Include both immediate optimizations and long-term strategies.]]
778
-
779
- - Resource Sizing Strategy
780
- - Reserved Instances/Commitments
781
- - Cost Monitoring & Reporting
782
- - Optimization Recommendations
783
-
784
- ## BMad Integration Architecture
785
-
786
- [[LLM: Design infrastructure to specifically support other BMad agents and their workflows. This ensures the infrastructure enables the entire BMad methodology.]]
787
-
788
- ### Development Agent Support
789
-
790
- - Container platform for development environments
791
- - GitOps workflows for application deployment
792
- - Service mesh integration for development testing
793
- - Developer self-service platform capabilities
794
-
795
- ### Product & Architecture Alignment
796
-
797
- - Infrastructure implementing PRD scalability requirements
798
- - Deployment automation supporting product iteration speed
799
- - Service reliability meeting product SLAs
800
- - Architecture patterns properly implemented in infrastructure
801
-
802
- ### Cross-Agent Integration Points
803
-
804
- - CI/CD pipelines supporting Frontend, Backend, and Full Stack development workflows
805
- - Monitoring and observability data accessible to QA and DevOps agents
806
- - Infrastructure enabling Design Architect's UI/UX performance requirements
807
- - Platform supporting Analyst's data collection and analysis needs
808
-
809
- ## DevOps/Platform Feasibility Review
810
-
811
- [[LLM: CRITICAL STEP - Present architectural blueprint summary to DevOps/Platform Engineering Agent for feasibility review. Request specific feedback on:
812
-
813
- - **Operational Complexity:** Are the proposed patterns implementable with current tooling and expertise?
814
- - **Resource Constraints:** Do infrastructure requirements align with available resources and budgets?
815
- - **Security Implementation:** Are security patterns achievable with current security toolchain?
816
- - **Operational Overhead:** Will the proposed architecture create excessive operational burden?
817
- - **Technology Constraints:** Are selected technologies compatible with existing infrastructure?
818
-
819
- Document all feasibility feedback and concerns raised. Iterate on architectural decisions based on operational constraints and feedback.
820
-
821
- <critical_rule>Address all critical feasibility concerns before proceeding to final architecture documentation. If critical blockers identified, revise architecture before continuing.</critical_rule>]]
822
-
823
- ### Feasibility Assessment Results
824
-
825
- - **Green Light Items:** {{feasible_items}}
826
- - **Yellow Light Items:** {{items_needing_adjustment}}
827
- - **Red Light Items:** {{items_requiring_redesign}}
828
- - **Mitigation Strategies:** {{mitigation_plans}}
829
-
830
- ## Infrastructure Verification
831
-
832
- ### Validation Framework
833
-
834
- This infrastructure architecture will be validated using the comprehensive `infrastructure-checklist.md`, with particular focus on Section 12: Architecture Documentation Validation. The checklist ensures:
835
-
836
- - Completeness of architecture documentation
837
- - Consistency with broader system architecture
838
- - Appropriate level of detail for different stakeholders
839
- - Clear implementation guidance
840
- - Future evolution considerations
841
-
842
- ### Validation Process
843
-
844
- The architecture documentation validation should be performed:
845
-
846
- - After initial architecture development
847
- - After significant architecture changes
848
- - Before major implementation phases
849
- - During periodic architecture reviews
850
-
851
- The Platform Engineer should use the infrastructure checklist to systematically validate all aspects of this architecture document.
852
-
853
- ## Implementation Handoff
854
-
855
- [[LLM: Create structured handoff documentation for implementation team. This ensures architecture decisions are properly communicated and implemented.]]
856
-
857
- ### Architecture Decision Records (ADRs)
858
-
859
- Create ADRs for key infrastructure decisions:
860
-
861
- - Cloud provider selection rationale
862
- - Container orchestration platform choice
863
- - Networking architecture decisions
864
- - Security implementation choices
865
- - Cost optimization trade-offs
866
-
867
- ### Implementation Validation Criteria
868
-
869
- Define specific criteria for validating correct implementation:
870
-
871
- - Infrastructure as Code quality gates
872
- - Security compliance checkpoints
873
- - Performance benchmarks
874
- - Cost targets
875
- - Operational readiness criteria
876
-
877
- ### Knowledge Transfer Requirements
878
-
879
- - Technical documentation for operations team
880
- - Runbook creation requirements
881
- - Training needs for platform team
882
- - Handoff meeting agenda items
883
-
884
- ## Infrastructure Evolution
885
-
886
- [[LLM: Document the long-term vision and evolution path for the infrastructure. Consider technology trends, anticipated growth, and technical debt management.]]
887
-
888
- - Technical Debt Inventory
889
- - Planned Upgrades and Migrations
890
- - Deprecation Schedule
891
- - Technology Roadmap
892
- - Capacity Planning
893
- - Scalability Considerations
894
-
895
- ## Integration with Application Architecture
896
-
897
- [[LLM: Map infrastructure components to application services. Ensure infrastructure design supports application requirements and patterns defined in main architecture.]]
898
-
899
- - Service-to-Infrastructure Mapping
900
- - Application Dependency Matrix
901
- - Performance Requirements Implementation
902
- - Security Requirements Implementation
903
- - Data Flow to Infrastructure Correlation
904
- - API Gateway and Service Mesh Integration
905
-
906
- ## Cross-Team Collaboration
907
-
908
- [[LLM: Define clear interfaces and communication patterns between teams. This section is critical for operational success and should include specific touchpoints and escalation paths.]]
909
-
910
- - Platform Engineer and Developer Touchpoints
911
- - Frontend/Backend Integration Requirements
912
- - Product Requirements to Infrastructure Mapping
913
- - Architecture Decision Impact Analysis
914
- - Design Architect UI/UX Infrastructure Requirements
915
- - Analyst Research Integration
916
-
917
- ## Infrastructure Change Management
918
-
919
- [[LLM: Define structured process for infrastructure changes. Include risk assessment, testing requirements, and rollback procedures.]]
920
-
921
- - Change Request Process
922
- - Risk Assessment
923
- - Testing Strategy
924
- - Validation Procedures
925
-
926
- [[LLM: Final Review - Ensure all sections are complete and consistent. Verify feasibility review was conducted and all concerns addressed. Apply final validation against infrastructure checklist.]]
927
-
928
- ---
929
-
930
- _Document Version: 1.0_
931
- _Last Updated: {{current_date}}_
932
- _Next Review: {{review_date}}_
933
- ==================== END: templates#infrastructure-architecture-tmpl ====================
934
-
935
- ==================== START: templates#infrastructure-platform-from-arch-tmpl ====================
936
- # {{Project Name}} Platform Infrastructure Implementation
937
-
938
- [[LLM: Initial Setup
939
-
940
- 1. Replace {{Project Name}} with the actual project name throughout the document
941
- 2. Gather and review required inputs:
942
-
943
- - **Infrastructure Architecture Document** (Primary input - REQUIRED)
944
- - Infrastructure Change Request (if applicable)
945
- - Infrastructure Guidelines
946
- - Technology Stack Document
947
- - Infrastructure Checklist
948
- - NOTE: If Infrastructure Architecture Document is missing, HALT and request: "I need the Infrastructure Architecture Document to proceed with platform implementation. This document defines the infrastructure design that we'll be implementing."
949
-
950
- 3. Validate that the infrastructure architecture has been reviewed and approved
951
- 4. <critical_rule>All platform implementation must align with the approved infrastructure architecture. Any deviations require architect approval.</critical_rule>
952
-
953
- Output file location: `docs/platform-infrastructure/platform-implementation.md`]]
954
-
955
- ## Executive Summary
956
-
957
- [[LLM: Provide a high-level overview of the platform infrastructure being implemented, referencing the infrastructure architecture document's key decisions and requirements.]]
958
-
959
- - Platform implementation scope and objectives
960
- - Key architectural decisions being implemented
961
- - Expected outcomes and benefits
962
- - Timeline and milestones
963
-
964
- ## Joint Planning Session with Architect
965
-
966
- [[LLM: Document the collaborative planning session between DevOps/Platform Engineer and Architect. This ensures alignment before implementation begins.]]
967
-
968
- ### Architecture Alignment Review
969
-
970
- - Review of infrastructure architecture document
971
- - Confirmation of design decisions
972
- - Identification of any ambiguities or gaps
973
- - Agreement on implementation approach
974
-
975
- ### Implementation Strategy Collaboration
976
-
977
- - Platform layer sequencing
978
- - Technology stack validation
979
- - Integration approach between layers
980
- - Testing and validation strategy
981
-
982
- ### Risk & Constraint Discussion
983
-
984
- - Technical risks and mitigation strategies
985
- - Resource constraints and workarounds
986
- - Timeline considerations
987
- - Compliance and security requirements
988
-
989
- ### Implementation Validation Planning
990
-
991
- - Success criteria for each platform layer
992
- - Testing approach and acceptance criteria
993
- - Rollback strategies
994
- - Communication plan
995
-
996
- ### Documentation & Knowledge Transfer Planning
997
-
998
- - Documentation requirements
999
- - Knowledge transfer approach
1000
- - Training needs identification
1001
- - Handoff procedures
1002
-
1003
- ## Foundation Infrastructure Layer
1004
-
1005
- [[LLM: Implement the base infrastructure layer based on the infrastructure architecture. This forms the foundation for all platform services.]]
1006
-
1007
- ### Cloud Provider Setup
1008
-
1009
- - Account/Subscription configuration
1010
- - Region selection and setup
1011
- - Resource group/organizational structure
1012
- - Cost management setup
1013
-
1014
- ### Network Foundation
1015
-
1016
- ```hcl
1017
- # Example Terraform for VPC setup
1018
- module "vpc" {
1019
- source = "./modules/vpc"
1020
-
1021
- cidr_block = "{{vpc_cidr}}"
1022
- availability_zones = {{availability_zones}}
1023
- public_subnets = {{public_subnets}}
1024
- private_subnets = {{private_subnets}}
1025
- }
1026
- ```
1027
-
1028
- ### Security Foundation
1029
-
1030
- - IAM roles and policies
1031
- - Security groups and NACLs
1032
- - Encryption keys (KMS/Key Vault)
1033
- - Compliance controls
1034
-
1035
- ### Core Services
1036
-
1037
- - DNS configuration
1038
- - Certificate management
1039
- - Logging infrastructure
1040
- - Monitoring foundation
1041
-
1042
- [[LLM: Platform Layer Elicitation
1043
- After implementing foundation infrastructure, present:
1044
- "For the Foundation Infrastructure layer, I can explore:
1045
-
1046
- 1. **Platform Layer Security Hardening** - Additional security controls and compliance validation
1047
- 2. **Performance Optimization** - Network and resource optimization
1048
- 3. **Operational Excellence Enhancement** - Automation and monitoring improvements
1049
- 4. **Platform Integration Validation** - Verify foundation supports upper layers
1050
- 5. **Developer Experience Analysis** - Foundation impact on developer workflows
1051
- 6. **Disaster Recovery Testing** - Foundation resilience validation
1052
- 7. **BMAD Workflow Integration** - Cross-agent support verification
1053
- 8. **Finalize and Proceed to Container Platform**
1054
-
1055
- Select an option (1-8):"]]
1056
-
1057
- ## Container Platform Implementation
1058
-
1059
- [[LLM: Build the container orchestration platform on top of the foundation infrastructure, following the architecture's container strategy.]]
1060
-
1061
- ### Kubernetes Cluster Setup
1062
-
1063
- ^^CONDITION: uses_eks^^
1064
-
1065
- ```bash
1066
- # EKS Cluster Configuration
1067
- eksctl create cluster \
1068
- --name {{cluster_name}} \
1069
- --region {{aws_region}} \
1070
- --nodegroup-name {{nodegroup_name}} \
1071
- --node-type {{instance_type}} \
1072
- --nodes {{node_count}}
1073
- ```
1074
-
1075
- ^^/CONDITION: uses_eks^^
1076
-
1077
- ^^CONDITION: uses_aks^^
1078
-
1079
- ```bash
1080
- # AKS Cluster Configuration
1081
- az aks create \
1082
- --resource-group {{resource_group}} \
1083
- --name {{cluster_name}} \
1084
- --node-count {{node_count}} \
1085
- --node-vm-size {{vm_size}} \
1086
- --network-plugin azure
1087
- ```
1088
-
1089
- ^^/CONDITION: uses_aks^^
1090
-
1091
- ### Node Configuration
1092
-
1093
- - Node groups/pools setup
1094
- - Autoscaling configuration
1095
- - Node security hardening
1096
- - Resource quotas and limits
1097
-
1098
- ### Cluster Services
1099
-
1100
- - CoreDNS configuration
1101
- - Ingress controller setup
1102
- - Certificate management
1103
- - Storage classes
1104
-
1105
- ### Security & RBAC
1106
-
1107
- - RBAC policies
1108
- - Pod security policies/standards
1109
- - Network policies
1110
- - Secrets management
1111
-
1112
- [[LLM: Present container platform elicitation options similar to foundation layer]]
1113
-
1114
- ## GitOps Workflow Implementation
1115
-
1116
- [[LLM: Implement GitOps patterns for declarative infrastructure and application management as defined in the architecture.]]
1117
-
1118
- ### GitOps Tooling Setup
1119
-
1120
- ^^CONDITION: uses_argocd^^
1121
-
1122
- ```yaml
1123
- apiVersion: argoproj.io/v1alpha1
1124
- kind: Application
1125
- metadata:
1126
- name: argocd
1127
- namespace: argocd
1128
- spec:
1129
- source:
1130
- repoURL:
1131
- "[object Object]": null
1132
- targetRevision:
1133
- "[object Object]": null
1134
- path:
1135
- "[object Object]": null
1136
- ```
1137
-
1138
- ^^/CONDITION: uses_argocd^^
1139
-
1140
- ^^CONDITION: uses_flux^^
1141
-
1142
- ```yaml
1143
- apiVersion: source.toolkit.fluxcd.io/v1beta2
1144
- kind: GitRepository
1145
- metadata:
1146
- name: flux-system
1147
- namespace: flux-system
1148
- spec:
1149
- interval: 1m
1150
- ref:
1151
- branch:
1152
- "[object Object]": null
1153
- url:
1154
- "[object Object]": null
1155
- ```
1156
-
1157
- ^^/CONDITION: uses_flux^^
1158
-
1159
- ### Repository Structure
1160
-
1161
- ```text
1162
- platform-gitops/
1163
-  clusters/
1164
-   production/
1165
-   staging/
1166
-   development/
1167
-  infrastructure/
1168
-   base/
1169
-   overlays/
1170
-  applications/
1171
-  base/
1172
-  overlays/
1173
- ```
1174
-
1175
- ### Deployment Workflows
1176
-
1177
- - Application deployment patterns
1178
- - Progressive delivery setup
1179
- - Rollback procedures
1180
- - Multi-environment promotion
1181
-
1182
- ### Access Control
1183
-
1184
- - Git repository permissions
1185
- - GitOps tool RBAC
1186
- - Secret management integration
1187
- - Audit logging
1188
-
1189
- ## Service Mesh Implementation
1190
-
1191
- [[LLM: Deploy service mesh for advanced traffic management, security, and observability as specified in the architecture.]]
1192
-
1193
- ^^CONDITION: uses_istio^^
1194
-
1195
- ### Istio Service Mesh
1196
-
1197
- ```bash
1198
- # Istio Installation
1199
- istioctl install --set profile={{istio_profile}} \
1200
- --set values.gateways.istio-ingressgateway.type={{ingress_type}}
1201
- ```
1202
-
1203
- - Control plane configuration
1204
- - Data plane injection
1205
- - Gateway configuration
1206
- - Observability integration
1207
- ^^/CONDITION: uses_istio^^
1208
-
1209
- ^^CONDITION: uses_linkerd^^
1210
-
1211
- ### Linkerd Service Mesh
1212
-
1213
- ```bash
1214
- # Linkerd Installation
1215
- linkerd install --cluster-name={{cluster_name}} | kubectl apply -f -
1216
- linkerd viz install | kubectl apply -f -
1217
- ```
1218
-
1219
- - Control plane setup
1220
- - Proxy injection
1221
- - Traffic policies
1222
- - Metrics collection
1223
- ^^/CONDITION: uses_linkerd^^
1224
-
1225
- ### Traffic Management
1226
-
1227
- - Load balancing policies
1228
- - Circuit breakers
1229
- - Retry policies
1230
- - Canary deployments
1231
-
1232
- ### Security Policies
1233
-
1234
- - mTLS configuration
1235
- - Authorization policies
1236
- - Rate limiting
1237
- - Network segmentation
1238
-
1239
- ## Developer Experience Platform
1240
-
1241
- [[LLM: Build the developer self-service platform to enable efficient development workflows as outlined in the architecture.]]
1242
-
1243
- ### Developer Portal
1244
-
1245
- - Service catalog setup
1246
- - API documentation
1247
- - Self-service workflows
1248
- - Resource provisioning
1249
-
1250
- ### CI/CD Integration
1251
-
1252
- ```yaml
1253
- apiVersion: tekton.dev/v1beta1
1254
- kind: Pipeline
1255
- metadata:
1256
- name: platform-pipeline
1257
- spec:
1258
- tasks:
1259
- - name: build
1260
- taskRef:
1261
- name: build-task
1262
- - name: test
1263
- taskRef:
1264
- name: test-task
1265
- - name: deploy
1266
- taskRef:
1267
- name: gitops-deploy
1268
- ```
1269
-
1270
- ### Development Tools
1271
-
1272
- - Local development setup
1273
- - Remote development environments
1274
- - Testing frameworks
1275
- - Debugging tools
1276
-
1277
- ### Self-Service Capabilities
1278
-
1279
- - Environment provisioning
1280
- - Database creation
1281
- - Feature flag management
1282
- - Configuration management
1283
-
1284
- ## Platform Integration & Security Hardening
1285
-
1286
- [[LLM: Implement comprehensive platform-wide integration and security controls across all layers.]]
1287
-
1288
- ### End-to-End Security
1289
-
1290
- - Platform-wide security policies
1291
- - Cross-layer authentication
1292
- - Encryption in transit and at rest
1293
- - Compliance validation
1294
-
1295
- ### Integrated Monitoring
1296
-
1297
- ```yaml
1298
- apiVersion: v1
1299
- kind: ConfigMap
1300
- metadata:
1301
- name: prometheus-config
1302
- data:
1303
- prometheus.yaml: |
1304
- global:
1305
- scrape_interval: {{scrape_interval}}
1306
- scrape_configs:
1307
- - job_name: 'kubernetes-pods'
1308
- kubernetes_sd_configs:
1309
- - role: pod
1310
- ```
1311
-
1312
- ### Platform Observability
1313
-
1314
- - Metrics aggregation
1315
- - Log collection and analysis
1316
- - Distributed tracing
1317
- - Dashboard creation
1318
-
1319
- ### Backup & Disaster Recovery
1320
-
1321
- - Platform backup strategy
1322
- - Disaster recovery procedures
1323
- - RTO/RPO validation
1324
- - Recovery testing
1325
-
1326
- ## Platform Operations & Automation
1327
-
1328
- [[LLM: Establish operational procedures and automation for platform management.]]
1329
-
1330
- ### Monitoring & Alerting
1331
-
1332
- - SLA/SLO monitoring
1333
- - Alert routing
1334
- - Incident response
1335
- - Performance baselines
1336
-
1337
- ### Automation Framework
1338
-
1339
- ```yaml
1340
- apiVersion: operators.coreos.com/v1alpha1
1341
- kind: ClusterServiceVersion
1342
- metadata:
1343
- name: platform-operator
1344
- spec:
1345
- customresourcedefinitions:
1346
- owned:
1347
- - name: platformconfigs.platform.io
1348
- version: v1alpha1
1349
- ```
1350
-
1351
- ### Maintenance Procedures
1352
-
1353
- - Upgrade procedures
1354
- - Patch management
1355
- - Certificate rotation
1356
- - Capacity management
1357
-
1358
- ### Operational Runbooks
1359
-
1360
- - Common operational tasks
1361
- - Troubleshooting guides
1362
- - Emergency procedures
1363
- - Recovery playbooks
1364
-
1365
- ## BMAD Workflow Integration
1366
-
1367
- [[LLM: Validate that the platform supports all BMAD agent workflows and cross-functional requirements.]]
1368
-
1369
- ### Development Agent Support
1370
-
1371
- - Frontend development workflows
1372
- - Backend development workflows
1373
- - Full-stack integration
1374
- - Local development experience
1375
-
1376
- ### Infrastructure-as-Code Development
1377
-
1378
- - IaC development workflows
1379
- - Testing frameworks
1380
- - Deployment automation
1381
- - Version control integration
1382
-
1383
- ### Cross-Agent Collaboration
1384
-
1385
- - Shared services access
1386
- - Communication patterns
1387
- - Data sharing mechanisms
1388
- - Security boundaries
1389
-
1390
- ### CI/CD Integration
1391
-
1392
- ```yaml
1393
- stages:
1394
- - analyze
1395
- - plan
1396
- - architect
1397
- - develop
1398
- - test
1399
- - deploy
1400
- ```
1401
-
1402
- ## Platform Validation & Testing
1403
-
1404
- [[LLM: Execute comprehensive validation to ensure the platform meets all requirements.]]
1405
-
1406
- ### Functional Testing
1407
-
1408
- - Component testing
1409
- - Integration testing
1410
- - End-to-end testing
1411
- - Performance testing
1412
-
1413
- ### Security Validation
1414
-
1415
- - Penetration testing
1416
- - Compliance scanning
1417
- - Vulnerability assessment
1418
- - Access control validation
1419
-
1420
- ### Disaster Recovery Testing
1421
-
1422
- - Backup restoration
1423
- - Failover procedures
1424
- - Recovery time validation
1425
- - Data integrity checks
1426
-
1427
- ### Load Testing
1428
-
1429
- ```typescript
1430
- // K6 Load Test Example
1431
- import http from 'k6/http';
1432
- import { check } from 'k6';
1433
-
1434
- export let options = {
1435
- stages: [
1436
- { duration: '5m', target: {{target_users}} },
1437
- { duration: '10m', target: {{target_users}} },
1438
- { duration: '5m', target: 0 },
1439
- ],
1440
- };
1441
- ```
1442
-
1443
- ## Knowledge Transfer & Documentation
1444
-
1445
- [[LLM: Prepare comprehensive documentation and knowledge transfer materials.]]
1446
-
1447
- ### Platform Documentation
1448
-
1449
- - Architecture documentation
1450
- - Operational procedures
1451
- - Configuration reference
1452
- - API documentation
1453
-
1454
- ### Training Materials
1455
-
1456
- - Developer guides
1457
- - Operations training
1458
- - Security best practices
1459
- - Troubleshooting guides
1460
-
1461
- ### Handoff Procedures
1462
-
1463
- - Team responsibilities
1464
- - Escalation procedures
1465
- - Support model
1466
- - Knowledge base
1467
-
1468
- ## Implementation Review with Architect
1469
-
1470
- [[LLM: Document the post-implementation review session with the Architect to validate alignment and capture learnings.]]
1471
-
1472
- ### Implementation Validation
1473
-
1474
- - Architecture alignment verification
1475
- - Deviation documentation
1476
- - Performance validation
1477
- - Security review
1478
-
1479
- ### Lessons Learned
1480
-
1481
- - What went well
1482
- - Challenges encountered
1483
- - Process improvements
1484
- - Technical insights
1485
-
1486
- ### Future Evolution
1487
-
1488
- - Enhancement opportunities
1489
- - Technical debt items
1490
- - Upgrade planning
1491
- - Capacity planning
1492
-
1493
- ### Sign-off & Acceptance
1494
-
1495
- - Architect approval
1496
- - Stakeholder acceptance
1497
- - Go-live authorization
1498
- - Support transition
1499
-
1500
- ## Platform Metrics & KPIs
1501
-
1502
- [[LLM: Define and implement key performance indicators for platform success measurement.]]
1503
-
1504
- ### Technical Metrics
1505
-
1506
- - Platform availability: {{availability_target}}
1507
- - Response time: {{response_time_target}}
1508
- - Resource utilization: {{utilization_target}}
1509
- - Error rates: {{error_rate_target}}
1510
-
1511
- ### Business Metrics
1512
-
1513
- - Developer productivity
1514
- - Deployment frequency
1515
- - Lead time for changes
1516
- - Mean time to recovery
1517
-
1518
- ### Operational Metrics
1519
-
1520
- - Incident response time
1521
- - Patch compliance
1522
- - Cost per workload
1523
- - Resource efficiency
1524
-
1525
- ## Appendices
1526
-
1527
- ### A. Configuration Reference
1528
-
1529
- [[LLM: Document all configuration parameters and their values used in the platform implementation.]]
1530
-
1531
- ### B. Troubleshooting Guide
1532
-
1533
- [[LLM: Provide common issues and their resolutions for platform operations.]]
1534
-
1535
- ### C. Security Controls Matrix
1536
-
1537
- [[LLM: Map implemented security controls to compliance requirements.]]
1538
-
1539
- ### D. Integration Points
1540
-
1541
- [[LLM: Document all integration points with external systems and services.]]
1542
-
1543
- [[LLM: Final Review - Ensure all platform layers are properly implemented, integrated, and documented. Verify that the implementation fully supports the BMAD methodology and all agent workflows. Confirm successful validation against the infrastructure checklist.]]
1544
-
1545
- ---
1546
-
1547
- _Platform Version: 1.0_
1548
- _Implementation Date: {{implementation_date}}_
1549
- _Next Review: {{review_date}}_
1550
- _Approved by: {{architect_name}} (Architect), {{devops_name}} (DevOps/Platform Engineer)_
1551
- ==================== END: templates#infrastructure-platform-from-arch-tmpl ====================
1552
-
1553
- ==================== START: checklists#infrastructure-checklist ====================
500
+ ==================== END: .bmad-infrastructure-devops/tasks/validate-infrastructure.md ====================
501
+
502
+ ==================== START: .bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml ====================
503
+ template:
504
+ id: infrastructure-architecture-template-v2
505
+ name: Infrastructure Architecture
506
+ version: 2.0
507
+ output:
508
+ format: markdown
509
+ filename: docs/infrastructure-architecture.md
510
+ title: "{{project_name}} Infrastructure Architecture"
511
+
512
+ workflow:
513
+ mode: interactive
514
+ elicitation: advanced-elicitation
515
+ custom_elicitation:
516
+ title: "Infrastructure Architecture Elicitation Actions"
517
+ sections:
518
+ - id: infrastructure-overview
519
+ options:
520
+ - "Multi-Cloud Strategy Analysis - Evaluate cloud provider options and vendor lock-in considerations"
521
+ - "Regional Distribution Planning - Analyze latency requirements and data residency needs"
522
+ - "Environment Isolation Strategy - Design security boundaries and resource segregation"
523
+ - "Scalability Patterns Review - Assess auto-scaling needs and traffic patterns"
524
+ - "Compliance Requirements Analysis - Review regulatory and security compliance needs"
525
+ - "Cost-Benefit Analysis - Compare infrastructure options and TCO"
526
+ - "Proceed to next section"
527
+
528
+ sections:
529
+ - id: initial-setup
530
+ instruction: |
531
+ Initial Setup
532
+
533
+ 1. Replace {{project_name}} with the actual project name throughout the document
534
+ 2. Gather and review required inputs:
535
+ - Product Requirements Document (PRD) - Required for business needs and scale requirements
536
+ - Main System Architecture - Required for infrastructure dependencies
537
+ - Technical Preferences/Tech Stack Document - Required for technology choices
538
+ - PRD Technical Assumptions - Required for cross-referencing repository and service architecture
539
+
540
+ If any required documents are missing, ask user: "I need the following documents to create a comprehensive infrastructure architecture: [list missing]. Would you like to proceed with available information or provide the missing documents first?"
541
+
542
+ 3. <critical_rule>Cross-reference with PRD Technical Assumptions to ensure infrastructure decisions align with repository and service architecture decisions made in the system architecture.</critical_rule>
543
+
544
+ Output file location: `docs/infrastructure-architecture.md`
545
+
546
+ - id: infrastructure-overview
547
+ title: Infrastructure Overview
548
+ instruction: |
549
+ Review the product requirements document to understand business needs and scale requirements. Analyze the main system architecture to identify infrastructure dependencies. Document non-functional requirements (performance, scalability, reliability, security). Cross-reference with PRD Technical Assumptions to ensure alignment with repository and service architecture decisions.
550
+ elicit: true
551
+ custom_elicitation: infrastructure-overview
552
+ template: |
553
+ - Cloud Provider(s)
554
+ - Core Services & Resources
555
+ - Regional Architecture
556
+ - Multi-environment Strategy
557
+ examples:
558
+ - |
559
+ - **Cloud Provider:** AWS (primary), with multi-cloud capability for critical services
560
+ - **Core Services:** EKS for container orchestration, RDS for databases, S3 for storage, CloudFront for CDN
561
+ - **Regional Architecture:** Multi-region active-passive with primary in us-east-1, DR in us-west-2
562
+ - **Multi-environment Strategy:** Development, Staging, UAT, Production with identical infrastructure patterns
563
+
564
+ - id: iac
565
+ title: Infrastructure as Code (IaC)
566
+ instruction: Define IaC approach based on technical preferences and existing patterns. Consider team expertise, tooling ecosystem, and maintenance requirements.
567
+ template: |
568
+ - Tools & Frameworks
569
+ - Repository Structure
570
+ - State Management
571
+ - Dependency Management
572
+
573
+ <critical_rule>All infrastructure must be defined as code. No manual resource creation in production environments.</critical_rule>
574
+
575
+ - id: environment-configuration
576
+ title: Environment Configuration
577
+ instruction: Design environment strategy that supports the development workflow while maintaining security and cost efficiency. Reference the Environment Transition Strategy section for promotion details.
578
+ template: |
579
+ - Environment Promotion Strategy
580
+ - Configuration Management
581
+ - Secret Management
582
+ - Feature Flag Integration
583
+ sections:
584
+ - id: environments
585
+ repeatable: true
586
+ title: "{{environment_name}} Environment"
587
+ template: |
588
+ - **Purpose:** {{environment_purpose}}
589
+ - **Resources:** {{environment_resources}}
590
+ - **Access Control:** {{environment_access}}
591
+ - **Data Classification:** {{environment_data_class}}
592
+
593
+ - id: environment-transition
594
+ title: Environment Transition Strategy
595
+ instruction: Detail the complete lifecycle of code and configuration changes from development to production. Include governance, testing gates, and rollback procedures.
596
+ template: |
597
+ - Development to Production Pipeline
598
+ - Deployment Stages and Gates
599
+ - Approval Workflows and Authorities
600
+ - Rollback Procedures
601
+ - Change Cadence and Release Windows
602
+ - Environment-Specific Configuration Management
603
+
604
+ - id: network-architecture
605
+ title: Network Architecture
606
+ instruction: |
607
+ Design network topology considering security zones, traffic patterns, and compliance requirements. Reference main architecture for service communication patterns.
608
+
609
+ Create Mermaid diagram showing:
610
+ - VPC/Network structure
611
+ - Security zones and boundaries
612
+ - Traffic flow patterns
613
+ - Load balancer placement
614
+ - Service mesh topology (if applicable)
615
+ template: |
616
+ - VPC/VNET Design
617
+ - Subnet Strategy
618
+ - Security Groups & NACLs
619
+ - Load Balancers & API Gateways
620
+ - Service Mesh (if applicable)
621
+ sections:
622
+ - id: network-diagram
623
+ type: mermaid
624
+ mermaid_type: graph
625
+ template: |
626
+ graph TB
627
+ subgraph "Production VPC"
628
+ subgraph "Public Subnets"
629
+ ALB[Application Load Balancer]
630
+ end
631
+ subgraph "Private Subnets"
632
+ EKS[EKS Cluster]
633
+ RDS[(RDS Database)]
634
+ end
635
+ end
636
+ Internet((Internet)) --> ALB
637
+ ALB --> EKS
638
+ EKS --> RDS
639
+ - id: service-mesh
640
+ title: Service Mesh Architecture
641
+ condition: Uses service mesh
642
+ template: |
643
+ - **Mesh Technology:** {{service_mesh_tech}}
644
+ - **Traffic Management:** {{traffic_policies}}
645
+ - **Security Policies:** {{mesh_security}}
646
+ - **Observability Integration:** {{mesh_observability}}
647
+
648
+ - id: compute-resources
649
+ title: Compute Resources
650
+ instruction: Select compute strategy based on application architecture (microservices, serverless, monolithic). Consider cost, scalability, and operational complexity.
651
+ template: |
652
+ - Container Strategy
653
+ - Serverless Architecture
654
+ - VM/Instance Configuration
655
+ - Auto-scaling Approach
656
+ sections:
657
+ - id: kubernetes
658
+ title: Kubernetes Architecture
659
+ condition: Uses Kubernetes
660
+ template: |
661
+ - **Cluster Configuration:** {{k8s_cluster_config}}
662
+ - **Node Groups:** {{k8s_node_groups}}
663
+ - **Networking:** {{k8s_networking}}
664
+ - **Storage Classes:** {{k8s_storage}}
665
+ - **Security Policies:** {{k8s_security}}
666
+
667
+ - id: data-resources
668
+ title: Data Resources
669
+ instruction: |
670
+ Design data infrastructure based on data architecture from main system design. Consider data volumes, access patterns, compliance, and recovery requirements.
671
+
672
+ Create data flow diagram showing:
673
+ - Database topology
674
+ - Replication patterns
675
+ - Backup flows
676
+ - Data migration paths
677
+ template: |
678
+ - Database Deployment Strategy
679
+ - Backup & Recovery
680
+ - Replication & Failover
681
+ - Data Migration Strategy
682
+
683
+ - id: security-architecture
684
+ title: Security Architecture
685
+ instruction: Implement defense-in-depth strategy. Reference security requirements from PRD and compliance needs. Consider zero-trust principles where applicable.
686
+ template: |
687
+ - IAM & Authentication
688
+ - Network Security
689
+ - Data Encryption
690
+ - Compliance Controls
691
+ - Security Scanning & Monitoring
692
+
693
+ <critical_rule>Apply principle of least privilege for all access controls. Document all security exceptions with business justification.</critical_rule>
694
+
695
+ - id: shared-responsibility
696
+ title: Shared Responsibility Model
697
+ instruction: Clearly define boundaries between cloud provider, platform team, development team, and security team responsibilities. This is critical for operational success.
698
+ template: |
699
+ - Cloud Provider Responsibilities
700
+ - Platform Team Responsibilities
701
+ - Development Team Responsibilities
702
+ - Security Team Responsibilities
703
+ - Operational Monitoring Ownership
704
+ - Incident Response Accountability Matrix
705
+ examples:
706
+ - |
707
+ | Component | Cloud Provider | Platform Team | Dev Team | Security Team |
708
+ | -------------------- | -------------- | ------------- | -------------- | ------------- |
709
+ | Physical Security | ✓ | - | - | Audit |
710
+ | Network Security | Partial | ✓ | Config | Audit |
711
+ | Application Security | - | Tools | ✓ | Review |
712
+ | Data Encryption | Engine | Config | Implementation | Standards |
713
+
714
+ - id: monitoring-observability
715
+ title: Monitoring & Observability
716
+ instruction: Design comprehensive observability strategy covering metrics, logs, traces, and business KPIs. Ensure alignment with SLA/SLO requirements.
717
+ template: |
718
+ - Metrics Collection
719
+ - Logging Strategy
720
+ - Tracing Implementation
721
+ - Alerting & Incident Response
722
+ - Dashboards & Visualization
723
+
724
+ - id: cicd-pipeline
725
+ title: CI/CD Pipeline
726
+ instruction: |
727
+ Design deployment pipeline that balances speed with safety. Include progressive deployment strategies and automated quality gates.
728
+
729
+ Create pipeline diagram showing:
730
+ - Build stages
731
+ - Test gates
732
+ - Deployment stages
733
+ - Approval points
734
+ - Rollback triggers
735
+ template: |
736
+ - Pipeline Architecture
737
+ - Build Process
738
+ - Deployment Strategy
739
+ - Rollback Procedures
740
+ - Approval Gates
741
+ sections:
742
+ - id: progressive-deployment
743
+ title: Progressive Deployment Strategy
744
+ condition: Uses progressive deployment
745
+ template: |
746
+ - **Canary Deployment:** {{canary_config}}
747
+ - **Blue-Green Deployment:** {{blue_green_config}}
748
+ - **Feature Flags:** {{feature_flag_integration}}
749
+ - **Traffic Splitting:** {{traffic_split_rules}}
750
+
751
+ - id: disaster-recovery
752
+ title: Disaster Recovery
753
+ instruction: Design DR strategy based on business continuity requirements. Define clear RTO/RPO targets and ensure they align with business needs.
754
+ template: |
755
+ - Backup Strategy
756
+ - Recovery Procedures
757
+ - RTO & RPO Targets
758
+ - DR Testing Approach
759
+
760
+ <critical_rule>DR procedures must be tested at least quarterly. Document test results and improvement actions.</critical_rule>
761
+
762
+ - id: cost-optimization
763
+ title: Cost Optimization
764
+ instruction: Balance cost efficiency with performance and reliability requirements. Include both immediate optimizations and long-term strategies.
765
+ template: |
766
+ - Resource Sizing Strategy
767
+ - Reserved Instances/Commitments
768
+ - Cost Monitoring & Reporting
769
+ - Optimization Recommendations
770
+
771
+ - id: bmad-integration
772
+ title: BMad Integration Architecture
773
+ instruction: Design infrastructure to specifically support other BMad agents and their workflows. This ensures the infrastructure enables the entire BMad methodology.
774
+ sections:
775
+ - id: dev-agent-support
776
+ title: Development Agent Support
777
+ template: |
778
+ - Container platform for development environments
779
+ - GitOps workflows for application deployment
780
+ - Service mesh integration for development testing
781
+ - Developer self-service platform capabilities
782
+ - id: product-architecture-alignment
783
+ title: Product & Architecture Alignment
784
+ template: |
785
+ - Infrastructure implementing PRD scalability requirements
786
+ - Deployment automation supporting product iteration speed
787
+ - Service reliability meeting product SLAs
788
+ - Architecture patterns properly implemented in infrastructure
789
+ - id: cross-agent-integration
790
+ title: Cross-Agent Integration Points
791
+ template: |
792
+ - CI/CD pipelines supporting Frontend, Backend, and Full Stack development workflows
793
+ - Monitoring and observability data accessible to QA and DevOps agents
794
+ - Infrastructure enabling Design Architect's UI/UX performance requirements
795
+ - Platform supporting Analyst's data collection and analysis needs
796
+
797
+ - id: feasibility-review
798
+ title: DevOps/Platform Feasibility Review
799
+ instruction: |
800
+ CRITICAL STEP - Present architectural blueprint summary to DevOps/Platform Engineering Agent for feasibility review. Request specific feedback on:
801
+
802
+ - **Operational Complexity:** Are the proposed patterns implementable with current tooling and expertise?
803
+ - **Resource Constraints:** Do infrastructure requirements align with available resources and budgets?
804
+ - **Security Implementation:** Are security patterns achievable with current security toolchain?
805
+ - **Operational Overhead:** Will the proposed architecture create excessive operational burden?
806
+ - **Technology Constraints:** Are selected technologies compatible with existing infrastructure?
807
+
808
+ Document all feasibility feedback and concerns raised. Iterate on architectural decisions based on operational constraints and feedback.
809
+
810
+ <critical_rule>Address all critical feasibility concerns before proceeding to final architecture documentation. If critical blockers identified, revise architecture before continuing.</critical_rule>
811
+ sections:
812
+ - id: feasibility-results
813
+ title: Feasibility Assessment Results
814
+ template: |
815
+ - **Green Light Items:** {{feasible_items}}
816
+ - **Yellow Light Items:** {{items_needing_adjustment}}
817
+ - **Red Light Items:** {{items_requiring_redesign}}
818
+ - **Mitigation Strategies:** {{mitigation_plans}}
819
+
820
+ - id: infrastructure-verification
821
+ title: Infrastructure Verification
822
+ sections:
823
+ - id: validation-framework
824
+ title: Validation Framework
825
+ content: |
826
+ This infrastructure architecture will be validated using the comprehensive `infrastructure-checklist.md`, with particular focus on Section 12: Architecture Documentation Validation. The checklist ensures:
827
+
828
+ - Completeness of architecture documentation
829
+ - Consistency with broader system architecture
830
+ - Appropriate level of detail for different stakeholders
831
+ - Clear implementation guidance
832
+ - Future evolution considerations
833
+ - id: validation-process
834
+ title: Validation Process
835
+ content: |
836
+ The architecture documentation validation should be performed:
837
+
838
+ - After initial architecture development
839
+ - After significant architecture changes
840
+ - Before major implementation phases
841
+ - During periodic architecture reviews
842
+
843
+ The Platform Engineer should use the infrastructure checklist to systematically validate all aspects of this architecture document.
844
+
845
+ - id: implementation-handoff
846
+ title: Implementation Handoff
847
+ instruction: Create structured handoff documentation for implementation team. This ensures architecture decisions are properly communicated and implemented.
848
+ sections:
849
+ - id: adrs
850
+ title: Architecture Decision Records (ADRs)
851
+ content: |
852
+ Create ADRs for key infrastructure decisions:
853
+
854
+ - Cloud provider selection rationale
855
+ - Container orchestration platform choice
856
+ - Networking architecture decisions
857
+ - Security implementation choices
858
+ - Cost optimization trade-offs
859
+ - id: implementation-validation
860
+ title: Implementation Validation Criteria
861
+ content: |
862
+ Define specific criteria for validating correct implementation:
863
+
864
+ - Infrastructure as Code quality gates
865
+ - Security compliance checkpoints
866
+ - Performance benchmarks
867
+ - Cost targets
868
+ - Operational readiness criteria
869
+ - id: knowledge-transfer
870
+ title: Knowledge Transfer Requirements
871
+ template: |
872
+ - Technical documentation for operations team
873
+ - Runbook creation requirements
874
+ - Training needs for platform team
875
+ - Handoff meeting agenda items
876
+
877
+ - id: infrastructure-evolution
878
+ title: Infrastructure Evolution
879
+ instruction: Document the long-term vision and evolution path for the infrastructure. Consider technology trends, anticipated growth, and technical debt management.
880
+ template: |
881
+ - Technical Debt Inventory
882
+ - Planned Upgrades and Migrations
883
+ - Deprecation Schedule
884
+ - Technology Roadmap
885
+ - Capacity Planning
886
+ - Scalability Considerations
887
+
888
+ - id: app-integration
889
+ title: Integration with Application Architecture
890
+ instruction: Map infrastructure components to application services. Ensure infrastructure design supports application requirements and patterns defined in main architecture.
891
+ template: |
892
+ - Service-to-Infrastructure Mapping
893
+ - Application Dependency Matrix
894
+ - Performance Requirements Implementation
895
+ - Security Requirements Implementation
896
+ - Data Flow to Infrastructure Correlation
897
+ - API Gateway and Service Mesh Integration
898
+
899
+ - id: cross-team-collaboration
900
+ title: Cross-Team Collaboration
901
+ instruction: Define clear interfaces and communication patterns between teams. This section is critical for operational success and should include specific touchpoints and escalation paths.
902
+ template: |
903
+ - Platform Engineer and Developer Touchpoints
904
+ - Frontend/Backend Integration Requirements
905
+ - Product Requirements to Infrastructure Mapping
906
+ - Architecture Decision Impact Analysis
907
+ - Design Architect UI/UX Infrastructure Requirements
908
+ - Analyst Research Integration
909
+
910
+ - id: change-management
911
+ title: Infrastructure Change Management
912
+ instruction: Define structured process for infrastructure changes. Include risk assessment, testing requirements, and rollback procedures.
913
+ template: |
914
+ - Change Request Process
915
+ - Risk Assessment
916
+ - Testing Strategy
917
+ - Validation Procedures
918
+
919
+ - id: final-review
920
+ instruction: Final Review - Ensure all sections are complete and consistent. Verify feasibility review was conducted and all concerns addressed. Apply final validation against infrastructure checklist.
921
+ content: |
922
+ ---
923
+
924
+ _Document Version: 1.0_
925
+ _Last Updated: {{current_date}}_
926
+ _Next Review: {{review_date}}_
927
+ ==================== END: .bmad-infrastructure-devops/templates/infrastructure-architecture-tmpl.yaml ====================
928
+
929
+ ==================== START: .bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml ====================
930
+ template:
931
+ id: infrastructure-platform-template-v2
932
+ name: Platform Infrastructure Implementation
933
+ version: 2.0
934
+ output:
935
+ format: markdown
936
+ filename: docs/platform-infrastructure/platform-implementation.md
937
+ title: "{{project_name}} Platform Infrastructure Implementation"
938
+
939
+ workflow:
940
+ mode: interactive
941
+ elicitation: advanced-elicitation
942
+ custom_elicitation:
943
+ title: "Platform Implementation Elicitation Actions"
944
+ sections:
945
+ - id: foundation-infrastructure
946
+ options:
947
+ - "Platform Layer Security Hardening - Additional security controls and compliance validation"
948
+ - "Performance Optimization - Network and resource optimization"
949
+ - "Operational Excellence Enhancement - Automation and monitoring improvements"
950
+ - "Platform Integration Validation - Verify foundation supports upper layers"
951
+ - "Developer Experience Analysis - Foundation impact on developer workflows"
952
+ - "Disaster Recovery Testing - Foundation resilience validation"
953
+ - "BMAD Workflow Integration - Cross-agent support verification"
954
+ - "Finalize and Proceed to Container Platform"
955
+
956
+ sections:
957
+ - id: initial-setup
958
+ instruction: |
959
+ Initial Setup
960
+
961
+ 1. Replace {{project_name}} with the actual project name throughout the document
962
+ 2. Gather and review required inputs:
963
+ - **Infrastructure Architecture Document** (Primary input - REQUIRED)
964
+ - Infrastructure Change Request (if applicable)
965
+ - Infrastructure Guidelines
966
+ - Technology Stack Document
967
+ - Infrastructure Checklist
968
+ - NOTE: If Infrastructure Architecture Document is missing, HALT and request: "I need the Infrastructure Architecture Document to proceed with platform implementation. This document defines the infrastructure design that we'll be implementing."
969
+
970
+ 3. Validate that the infrastructure architecture has been reviewed and approved
971
+ 4. <critical_rule>All platform implementation must align with the approved infrastructure architecture. Any deviations require architect approval.</critical_rule>
972
+
973
+ Output file location: `docs/platform-infrastructure/platform-implementation.md`
974
+
975
+ - id: executive-summary
976
+ title: Executive Summary
977
+ instruction: Provide a high-level overview of the platform infrastructure being implemented, referencing the infrastructure architecture document's key decisions and requirements.
978
+ template: |
979
+ - Platform implementation scope and objectives
980
+ - Key architectural decisions being implemented
981
+ - Expected outcomes and benefits
982
+ - Timeline and milestones
983
+
984
+ - id: joint-planning
985
+ title: Joint Planning Session with Architect
986
+ instruction: Document the collaborative planning session between DevOps/Platform Engineer and Architect. This ensures alignment before implementation begins.
987
+ sections:
988
+ - id: architecture-alignment
989
+ title: Architecture Alignment Review
990
+ template: |
991
+ - Review of infrastructure architecture document
992
+ - Confirmation of design decisions
993
+ - Identification of any ambiguities or gaps
994
+ - Agreement on implementation approach
995
+ - id: implementation-strategy
996
+ title: Implementation Strategy Collaboration
997
+ template: |
998
+ - Platform layer sequencing
999
+ - Technology stack validation
1000
+ - Integration approach between layers
1001
+ - Testing and validation strategy
1002
+ - id: risk-constraint
1003
+ title: Risk & Constraint Discussion
1004
+ template: |
1005
+ - Technical risks and mitigation strategies
1006
+ - Resource constraints and workarounds
1007
+ - Timeline considerations
1008
+ - Compliance and security requirements
1009
+ - id: validation-planning
1010
+ title: Implementation Validation Planning
1011
+ template: |
1012
+ - Success criteria for each platform layer
1013
+ - Testing approach and acceptance criteria
1014
+ - Rollback strategies
1015
+ - Communication plan
1016
+ - id: documentation-planning
1017
+ title: Documentation & Knowledge Transfer Planning
1018
+ template: |
1019
+ - Documentation requirements
1020
+ - Knowledge transfer approach
1021
+ - Training needs identification
1022
+ - Handoff procedures
1023
+
1024
+ - id: foundation-infrastructure
1025
+ title: Foundation Infrastructure Layer
1026
+ instruction: Implement the base infrastructure layer based on the infrastructure architecture. This forms the foundation for all platform services.
1027
+ elicit: true
1028
+ custom_elicitation: foundation-infrastructure
1029
+ sections:
1030
+ - id: cloud-provider-setup
1031
+ title: Cloud Provider Setup
1032
+ template: |
1033
+ - Account/Subscription configuration
1034
+ - Region selection and setup
1035
+ - Resource group/organizational structure
1036
+ - Cost management setup
1037
+ - id: network-foundation
1038
+ title: Network Foundation
1039
+ type: code
1040
+ language: hcl
1041
+ template: |
1042
+ # Example Terraform for VPC setup
1043
+ module "vpc" {
1044
+ source = "./modules/vpc"
1045
+
1046
+ cidr_block = "{{vpc_cidr}}"
1047
+ availability_zones = {{availability_zones}}
1048
+ public_subnets = {{public_subnets}}
1049
+ private_subnets = {{private_subnets}}
1050
+ }
1051
+ - id: security-foundation
1052
+ title: Security Foundation
1053
+ template: |
1054
+ - IAM roles and policies
1055
+ - Security groups and NACLs
1056
+ - Encryption keys (KMS/Key Vault)
1057
+ - Compliance controls
1058
+ - id: core-services
1059
+ title: Core Services
1060
+ template: |
1061
+ - DNS configuration
1062
+ - Certificate management
1063
+ - Logging infrastructure
1064
+ - Monitoring foundation
1065
+
1066
+ - id: container-platform
1067
+ title: Container Platform Implementation
1068
+ instruction: Build the container orchestration platform on top of the foundation infrastructure, following the architecture's container strategy.
1069
+ sections:
1070
+ - id: kubernetes-setup
1071
+ title: Kubernetes Cluster Setup
1072
+ sections:
1073
+ - id: eks-setup
1074
+ condition: Uses EKS
1075
+ type: code
1076
+ language: bash
1077
+ template: |
1078
+ # EKS Cluster Configuration
1079
+ eksctl create cluster \
1080
+ --name {{cluster_name}} \
1081
+ --region {{aws_region}} \
1082
+ --nodegroup-name {{nodegroup_name}} \
1083
+ --node-type {{instance_type}} \
1084
+ --nodes {{node_count}}
1085
+ - id: aks-setup
1086
+ condition: Uses AKS
1087
+ type: code
1088
+ language: bash
1089
+ template: |
1090
+ # AKS Cluster Configuration
1091
+ az aks create \
1092
+ --resource-group {{resource_group}} \
1093
+ --name {{cluster_name}} \
1094
+ --node-count {{node_count}} \
1095
+ --node-vm-size {{vm_size}} \
1096
+ --network-plugin azure
1097
+ - id: node-configuration
1098
+ title: Node Configuration
1099
+ template: |
1100
+ - Node groups/pools setup
1101
+ - Autoscaling configuration
1102
+ - Node security hardening
1103
+ - Resource quotas and limits
1104
+ - id: cluster-services
1105
+ title: Cluster Services
1106
+ template: |
1107
+ - CoreDNS configuration
1108
+ - Ingress controller setup
1109
+ - Certificate management
1110
+ - Storage classes
1111
+ - id: security-rbac
1112
+ title: Security & RBAC
1113
+ template: |
1114
+ - RBAC policies
1115
+ - Pod security policies/standards
1116
+ - Network policies
1117
+ - Secrets management
1118
+
1119
+ - id: gitops-workflow
1120
+ title: GitOps Workflow Implementation
1121
+ instruction: Implement GitOps patterns for declarative infrastructure and application management as defined in the architecture.
1122
+ sections:
1123
+ - id: gitops-tooling
1124
+ title: GitOps Tooling Setup
1125
+ sections:
1126
+ - id: argocd-setup
1127
+ condition: Uses ArgoCD
1128
+ type: code
1129
+ language: yaml
1130
+ template: |
1131
+ apiVersion: argoproj.io/v1alpha1
1132
+ kind: Application
1133
+ metadata:
1134
+ name: argocd
1135
+ namespace: argocd
1136
+ spec:
1137
+ source:
1138
+ repoURL: {{repo_url}}
1139
+ targetRevision: {{target_revision}}
1140
+ path: {{path}}
1141
+ - id: flux-setup
1142
+ condition: Uses Flux
1143
+ type: code
1144
+ language: yaml
1145
+ template: |
1146
+ apiVersion: source.toolkit.fluxcd.io/v1beta2
1147
+ kind: GitRepository
1148
+ metadata:
1149
+ name: flux-system
1150
+ namespace: flux-system
1151
+ spec:
1152
+ interval: 1m
1153
+ ref:
1154
+ branch: {{branch}}
1155
+ url: {{git_url}}
1156
+ - id: repository-structure
1157
+ title: Repository Structure
1158
+ type: code
1159
+ language: text
1160
+ template: |
1161
+ platform-gitops/
1162
+ clusters/
1163
+ production/
1164
+ staging/
1165
+ development/
1166
+ infrastructure/
1167
+ base/
1168
+ overlays/
1169
+ applications/
1170
+ base/
1171
+ overlays/
1172
+ - id: deployment-workflows
1173
+ title: Deployment Workflows
1174
+ template: |
1175
+ - Application deployment patterns
1176
+ - Progressive delivery setup
1177
+ - Rollback procedures
1178
+ - Multi-environment promotion
1179
+ - id: access-control
1180
+ title: Access Control
1181
+ template: |
1182
+ - Git repository permissions
1183
+ - GitOps tool RBAC
1184
+ - Secret management integration
1185
+ - Audit logging
1186
+
1187
+ - id: service-mesh
1188
+ title: Service Mesh Implementation
1189
+ instruction: Deploy service mesh for advanced traffic management, security, and observability as specified in the architecture.
1190
+ sections:
1191
+ - id: istio-mesh
1192
+ title: Istio Service Mesh
1193
+ condition: Uses Istio
1194
+ sections:
1195
+ - id: istio-install
1196
+ type: code
1197
+ language: bash
1198
+ template: |
1199
+ # Istio Installation
1200
+ istioctl install --set profile={{istio_profile}} \
1201
+ --set values.gateways.istio-ingressgateway.type={{ingress_type}}
1202
+ - id: istio-config
1203
+ template: |
1204
+ - Control plane configuration
1205
+ - Data plane injection
1206
+ - Gateway configuration
1207
+ - Observability integration
1208
+ - id: linkerd-mesh
1209
+ title: Linkerd Service Mesh
1210
+ condition: Uses Linkerd
1211
+ sections:
1212
+ - id: linkerd-install
1213
+ type: code
1214
+ language: bash
1215
+ template: |
1216
+ # Linkerd Installation
1217
+ linkerd install --cluster-name={{cluster_name}} | kubectl apply -f -
1218
+ linkerd viz install | kubectl apply -f -
1219
+ - id: linkerd-config
1220
+ template: |
1221
+ - Control plane setup
1222
+ - Proxy injection
1223
+ - Traffic policies
1224
+ - Metrics collection
1225
+ - id: traffic-management
1226
+ title: Traffic Management
1227
+ template: |
1228
+ - Load balancing policies
1229
+ - Circuit breakers
1230
+ - Retry policies
1231
+ - Canary deployments
1232
+ - id: security-policies
1233
+ title: Security Policies
1234
+ template: |
1235
+ - mTLS configuration
1236
+ - Authorization policies
1237
+ - Rate limiting
1238
+ - Network segmentation
1239
+
1240
+ - id: developer-experience
1241
+ title: Developer Experience Platform
1242
+ instruction: Build the developer self-service platform to enable efficient development workflows as outlined in the architecture.
1243
+ sections:
1244
+ - id: developer-portal
1245
+ title: Developer Portal
1246
+ template: |
1247
+ - Service catalog setup
1248
+ - API documentation
1249
+ - Self-service workflows
1250
+ - Resource provisioning
1251
+ - id: cicd-integration
1252
+ title: CI/CD Integration
1253
+ type: code
1254
+ language: yaml
1255
+ template: |
1256
+ apiVersion: tekton.dev/v1beta1
1257
+ kind: Pipeline
1258
+ metadata:
1259
+ name: platform-pipeline
1260
+ spec:
1261
+ tasks:
1262
+ - name: build
1263
+ taskRef:
1264
+ name: build-task
1265
+ - name: test
1266
+ taskRef:
1267
+ name: test-task
1268
+ - name: deploy
1269
+ taskRef:
1270
+ name: gitops-deploy
1271
+ - id: development-tools
1272
+ title: Development Tools
1273
+ template: |
1274
+ - Local development setup
1275
+ - Remote development environments
1276
+ - Testing frameworks
1277
+ - Debugging tools
1278
+ - id: self-service
1279
+ title: Self-Service Capabilities
1280
+ template: |
1281
+ - Environment provisioning
1282
+ - Database creation
1283
+ - Feature flag management
1284
+ - Configuration management
1285
+
1286
+ - id: platform-integration
1287
+ title: Platform Integration & Security Hardening
1288
+ instruction: Implement comprehensive platform-wide integration and security controls across all layers.
1289
+ sections:
1290
+ - id: end-to-end-security
1291
+ title: End-to-End Security
1292
+ template: |
1293
+ - Platform-wide security policies
1294
+ - Cross-layer authentication
1295
+ - Encryption in transit and at rest
1296
+ - Compliance validation
1297
+ - id: integrated-monitoring
1298
+ title: Integrated Monitoring
1299
+ type: code
1300
+ language: yaml
1301
+ template: |
1302
+ apiVersion: v1
1303
+ kind: ConfigMap
1304
+ metadata:
1305
+ name: prometheus-config
1306
+ data:
1307
+ prometheus.yaml: |
1308
+ global:
1309
+ scrape_interval: {{scrape_interval}}
1310
+ scrape_configs:
1311
+ - job_name: 'kubernetes-pods'
1312
+ kubernetes_sd_configs:
1313
+ - role: pod
1314
+ - id: platform-observability
1315
+ title: Platform Observability
1316
+ template: |
1317
+ - Metrics aggregation
1318
+ - Log collection and analysis
1319
+ - Distributed tracing
1320
+ - Dashboard creation
1321
+ - id: backup-dr
1322
+ title: Backup & Disaster Recovery
1323
+ template: |
1324
+ - Platform backup strategy
1325
+ - Disaster recovery procedures
1326
+ - RTO/RPO validation
1327
+ - Recovery testing
1328
+
1329
+ - id: platform-operations
1330
+ title: Platform Operations & Automation
1331
+ instruction: Establish operational procedures and automation for platform management.
1332
+ sections:
1333
+ - id: monitoring-alerting
1334
+ title: Monitoring & Alerting
1335
+ template: |
1336
+ - SLA/SLO monitoring
1337
+ - Alert routing
1338
+ - Incident response
1339
+ - Performance baselines
1340
+ - id: automation-framework
1341
+ title: Automation Framework
1342
+ type: code
1343
+ language: yaml
1344
+ template: |
1345
+ apiVersion: operators.coreos.com/v1alpha1
1346
+ kind: ClusterServiceVersion
1347
+ metadata:
1348
+ name: platform-operator
1349
+ spec:
1350
+ customresourcedefinitions:
1351
+ owned:
1352
+ - name: platformconfigs.platform.io
1353
+ version: v1alpha1
1354
+ - id: maintenance-procedures
1355
+ title: Maintenance Procedures
1356
+ template: |
1357
+ - Upgrade procedures
1358
+ - Patch management
1359
+ - Certificate rotation
1360
+ - Capacity management
1361
+ - id: operational-runbooks
1362
+ title: Operational Runbooks
1363
+ template: |
1364
+ - Common operational tasks
1365
+ - Troubleshooting guides
1366
+ - Emergency procedures
1367
+ - Recovery playbooks
1368
+
1369
+ - id: bmad-workflow-integration
1370
+ title: BMAD Workflow Integration
1371
+ instruction: Validate that the platform supports all BMAD agent workflows and cross-functional requirements.
1372
+ sections:
1373
+ - id: development-agent-support
1374
+ title: Development Agent Support
1375
+ template: |
1376
+ - Frontend development workflows
1377
+ - Backend development workflows
1378
+ - Full-stack integration
1379
+ - Local development experience
1380
+ - id: iac-development
1381
+ title: Infrastructure-as-Code Development
1382
+ template: |
1383
+ - IaC development workflows
1384
+ - Testing frameworks
1385
+ - Deployment automation
1386
+ - Version control integration
1387
+ - id: cross-agent-collaboration
1388
+ title: Cross-Agent Collaboration
1389
+ template: |
1390
+ - Shared services access
1391
+ - Communication patterns
1392
+ - Data sharing mechanisms
1393
+ - Security boundaries
1394
+ - id: cicd-integration-workflow
1395
+ title: CI/CD Integration
1396
+ type: code
1397
+ language: yaml
1398
+ template: |
1399
+ stages:
1400
+ - analyze
1401
+ - plan
1402
+ - architect
1403
+ - develop
1404
+ - test
1405
+ - deploy
1406
+
1407
+ - id: platform-validation
1408
+ title: Platform Validation & Testing
1409
+ instruction: Execute comprehensive validation to ensure the platform meets all requirements.
1410
+ sections:
1411
+ - id: functional-testing
1412
+ title: Functional Testing
1413
+ template: |
1414
+ - Component testing
1415
+ - Integration testing
1416
+ - End-to-end testing
1417
+ - Performance testing
1418
+ - id: security-validation
1419
+ title: Security Validation
1420
+ template: |
1421
+ - Penetration testing
1422
+ - Compliance scanning
1423
+ - Vulnerability assessment
1424
+ - Access control validation
1425
+ - id: dr-testing
1426
+ title: Disaster Recovery Testing
1427
+ template: |
1428
+ - Backup restoration
1429
+ - Failover procedures
1430
+ - Recovery time validation
1431
+ - Data integrity checks
1432
+ - id: load-testing
1433
+ title: Load Testing
1434
+ type: code
1435
+ language: typescript
1436
+ template: |
1437
+ // K6 Load Test Example
1438
+ import http from 'k6/http';
1439
+ import { check } from 'k6';
1440
+
1441
+ export let options = {
1442
+ stages: [
1443
+ { duration: '5m', target: {{target_users}} },
1444
+ { duration: '10m', target: {{target_users}} },
1445
+ { duration: '5m', target: 0 },
1446
+ ],
1447
+ };
1448
+
1449
+ - id: knowledge-transfer
1450
+ title: Knowledge Transfer & Documentation
1451
+ instruction: Prepare comprehensive documentation and knowledge transfer materials.
1452
+ sections:
1453
+ - id: platform-documentation
1454
+ title: Platform Documentation
1455
+ template: |
1456
+ - Architecture documentation
1457
+ - Operational procedures
1458
+ - Configuration reference
1459
+ - API documentation
1460
+ - id: training-materials
1461
+ title: Training Materials
1462
+ template: |
1463
+ - Developer guides
1464
+ - Operations training
1465
+ - Security best practices
1466
+ - Troubleshooting guides
1467
+ - id: handoff-procedures
1468
+ title: Handoff Procedures
1469
+ template: |
1470
+ - Team responsibilities
1471
+ - Escalation procedures
1472
+ - Support model
1473
+ - Knowledge base
1474
+
1475
+ - id: implementation-review
1476
+ title: Implementation Review with Architect
1477
+ instruction: Document the post-implementation review session with the Architect to validate alignment and capture learnings.
1478
+ sections:
1479
+ - id: implementation-validation
1480
+ title: Implementation Validation
1481
+ template: |
1482
+ - Architecture alignment verification
1483
+ - Deviation documentation
1484
+ - Performance validation
1485
+ - Security review
1486
+ - id: lessons-learned
1487
+ title: Lessons Learned
1488
+ template: |
1489
+ - What went well
1490
+ - Challenges encountered
1491
+ - Process improvements
1492
+ - Technical insights
1493
+ - id: future-evolution
1494
+ title: Future Evolution
1495
+ template: |
1496
+ - Enhancement opportunities
1497
+ - Technical debt items
1498
+ - Upgrade planning
1499
+ - Capacity planning
1500
+ - id: sign-off
1501
+ title: Sign-off & Acceptance
1502
+ template: |
1503
+ - Architect approval
1504
+ - Stakeholder acceptance
1505
+ - Go-live authorization
1506
+ - Support transition
1507
+
1508
+ - id: platform-metrics
1509
+ title: Platform Metrics & KPIs
1510
+ instruction: Define and implement key performance indicators for platform success measurement.
1511
+ sections:
1512
+ - id: technical-metrics
1513
+ title: Technical Metrics
1514
+ template: |
1515
+ - Platform availability: {{availability_target}}
1516
+ - Response time: {{response_time_target}}
1517
+ - Resource utilization: {{utilization_target}}
1518
+ - Error rates: {{error_rate_target}}
1519
+ - id: business-metrics
1520
+ title: Business Metrics
1521
+ template: |
1522
+ - Developer productivity
1523
+ - Deployment frequency
1524
+ - Lead time for changes
1525
+ - Mean time to recovery
1526
+ - id: operational-metrics
1527
+ title: Operational Metrics
1528
+ template: |
1529
+ - Incident response time
1530
+ - Patch compliance
1531
+ - Cost per workload
1532
+ - Resource efficiency
1533
+
1534
+ - id: appendices
1535
+ title: Appendices
1536
+ sections:
1537
+ - id: config-reference
1538
+ title: A. Configuration Reference
1539
+ instruction: Document all configuration parameters and their values used in the platform implementation.
1540
+ - id: troubleshooting
1541
+ title: B. Troubleshooting Guide
1542
+ instruction: Provide common issues and their resolutions for platform operations.
1543
+ - id: security-controls
1544
+ title: C. Security Controls Matrix
1545
+ instruction: Map implemented security controls to compliance requirements.
1546
+ - id: integration-points
1547
+ title: D. Integration Points
1548
+ instruction: Document all integration points with external systems and services.
1549
+
1550
+ - id: final-review
1551
+ instruction: Final Review - Ensure all platform layers are properly implemented, integrated, and documented. Verify that the implementation fully supports the BMAD methodology and all agent workflows. Confirm successful validation against the infrastructure checklist.
1552
+ content: |
1553
+ ---
1554
+
1555
+ _Platform Version: 1.0_
1556
+ _Implementation Date: {{implementation_date}}_
1557
+ _Next Review: {{review_date}}_
1558
+ _Approved by: {{architect_name}} (Architect), {{devops_name}} (DevOps/Platform Engineer)_
1559
+ ==================== END: .bmad-infrastructure-devops/templates/infrastructure-platform-from-arch-tmpl.yaml ====================
1560
+
1561
+ ==================== START: .bmad-infrastructure-devops/checklists/infrastructure-checklist.md ====================
1554
1562
  # Infrastructure Change Validation Checklist
1555
1563
 
1556
1564
  This checklist serves as a comprehensive framework for validating infrastructure changes before deployment to production. The DevOps/Platform Engineer should systematically work through each item, ensuring the infrastructure is secure, compliant, resilient, and properly implemented according to organizational standards.
@@ -2035,39 +2043,10 @@ This checklist serves as a comprehensive framework for validating infrastructure
2035
2043
  - [ ] Local development environment compatibility verified
2036
2044
  - [ ] Platform component integration validated
2037
2045
  - [ ] Cross-platform functionality tested and verified
2038
- ==================== END: checklists#infrastructure-checklist ====================
2046
+ ==================== END: .bmad-infrastructure-devops/checklists/infrastructure-checklist.md ====================
2039
2047
 
2040
- ==================== START: data#technical-preferences ====================
2048
+ ==================== START: .bmad-infrastructure-devops/data/technical-preferences.md ====================
2041
2049
  # User-Defined Preferred Patterns and Preferences
2042
2050
 
2043
2051
  None Listed
2044
- ==================== END: data#technical-preferences ====================
2045
-
2046
- ==================== START: utils#template-format ====================
2047
- # Template Format Conventions
2048
-
2049
- Templates in the BMad method use standardized markup for AI processing. These conventions ensure consistent document generation.
2050
-
2051
- ## Template Markup Elements
2052
-
2053
- - **{{placeholders}}**: Variables to be replaced with actual content
2054
- - **[[LLM: instructions]]**: Internal processing instructions for AI agents (never shown to users)
2055
- - **REPEAT** sections: Content blocks that may be repeated as needed
2056
- - **^^CONDITION^^** blocks: Conditional content included only if criteria are met
2057
- - **@{examples}**: Example content for guidance (never output to users)
2058
-
2059
- ## Processing Rules
2060
-
2061
- - Replace all {{placeholders}} with project-specific content
2062
- - Execute all [[LLM: instructions]] internally without showing users
2063
- - Process conditional and repeat blocks as specified
2064
- - Use examples for guidance but never include them in final output
2065
- - Present only clean, formatted content to users
2066
-
2067
- ## Critical Guidelines
2068
-
2069
- - **NEVER display template markup, LLM instructions, or examples to users**
2070
- - Template elements are for AI processing only
2071
- - Focus on faithful template execution and clean output
2072
- - All template-specific instructions are embedded within templates
2073
- ==================== END: utils#template-format ====================
2052
+ ==================== END: .bmad-infrastructure-devops/data/technical-preferences.md ====================