Files
BMAD-METHOD/bmad-agent/templates/infrastructure-architecture-tmpl.md
Sebastian Ickler cffbb59941 Plaform Engineer role for a robust infrastructure (#135)
* Add Platform Engineer role to support a robust and validated infrastructure

* Platform Engineer and Architect boundaries, confidence levels, domain expertise

* remove duplicate task, leftover artifact

* Consistency, workflow, feedback loops between architect and PE

* PE customization generalized, updated Architect, consistency check
2025-06-04 21:35:02 -05:00

3.6 KiB

{Project Name} Infrastructure Architecture

Infrastructure Overview

  • Cloud Provider(s)
  • Core Services & Resources
  • Regional Architecture
  • Multi-environment Strategy

Infrastructure as Code (IaC)

  • Tools & Frameworks
  • Repository Structure
  • State Management
  • Dependency Management

Environment Configuration

  • Environment Promotion Strategy
  • Configuration Management
  • Secret Management
  • Feature Flag Integration

Environment Transition Strategy

  • Development to Production Pipeline
  • Deployment Stages and Gates
  • Approval Workflows and Authorities
  • Rollback Procedures
  • Change Cadence and Release Windows
  • Environment-Specific Configuration Management

Network Architecture

  • VPC/VNET Design
  • Subnet Strategy
  • Security Groups & NACLs
  • Load Balancers & API Gateways
  • Service Mesh (if applicable)

Compute Resources

  • Container Strategy
  • Serverless Architecture
  • VM/Instance Configuration
  • Auto-scaling Approach

Data Resources

  • Database Deployment Strategy
  • Backup & Recovery
  • Replication & Failover
  • Data Migration Strategy

Security Architecture

  • IAM & Authentication
  • Network Security
  • Data Encryption
  • Compliance Controls
  • Security Scanning & Monitoring

Shared Responsibility Model

  • Cloud Provider Responsibilities
  • Platform Team Responsibilities
  • Development Team Responsibilities
  • Security Team Responsibilities
  • Operational Monitoring Ownership
  • Incident Response Accountability Matrix

Monitoring & Observability

  • Metrics Collection
  • Logging Strategy
  • Tracing Implementation
  • Alerting & Incident Response
  • Dashboards & Visualization

CI/CD Pipeline

  • Pipeline Architecture
  • Build Process
  • Deployment Strategy
  • Rollback Procedures
  • Approval Gates

Disaster Recovery

  • Backup Strategy
  • Recovery Procedures
  • RTO & RPO Targets
  • DR Testing Approach

Cost Optimization

  • Resource Sizing Strategy
  • Reserved Instances/Commitments
  • Cost Monitoring & Reporting
  • Optimization Recommendations

Infrastructure Verification

Validation Framework

This infrastructure architecture will be validated using the comprehensive infrastructure-checklist.md, with particular focus on Section 12: Architecture Documentation Validation. The checklist ensures:

  • Completeness of architecture documentation
  • Consistency with broader system architecture
  • Appropriate level of detail for different stakeholders
  • Clear implementation guidance
  • Future evolution considerations

Validation Process

The architecture documentation validation should be performed:

  • After initial architecture development
  • After significant architecture changes
  • Before major implementation phases
  • During periodic architecture reviews

The Platform Engineer should use the infrastructure checklist to systematically validate all aspects of this architecture document.

Infrastructure Evolution

  • Technical Debt Inventory
  • Planned Upgrades and Migrations
  • Deprecation Schedule
  • Technology Roadmap
  • Capacity Planning
  • Scalability Considerations

Integration with Application Architecture

  • Service-to-Infrastructure Mapping
  • Application Dependency Matrix
  • Performance Requirements Implementation
  • Security Requirements Implementation
  • Data Flow to Infrastructure Correlation
  • API Gateway and Service Mesh Integration

Cross-Team Collaboration

  • Platform Engineer and Developer Touchpoints
  • Frontend/Backend Integration Requirements
  • Product Requirements to Infrastructure Mapping
  • Architecture Decision Impact Analysis
  • Design Architect UI/UX Infrastructure Requirements
  • Analyst Research Integration

Infrastructure Change Management

  • Change Request Process
  • Risk Assessment
  • Testing Strategy
  • Validation Procedures