BMAD-METHOD/expansion-packs/bmad-infrastructure-devops/README.md

Infrastructure & DevOps Expansion Pack

Overview

This expansion pack extends BMAD Method with comprehensive infrastructure and DevOps capabilities. It's designed for teams that need to define, implement, and manage cloud infrastructure alongside their application development.

Purpose

While the core BMAD flow focuses on getting from business requirements to development (Analyst → PM → Architect → SM → Dev), many projects require sophisticated infrastructure planning and implementation. This expansion pack adds:

• Infrastructure architecture design capabilities
• Platform engineering implementation workflows
• DevOps automation and CI/CD pipeline design
• Cloud resource management and optimization
• Security and compliance validation

When to Use This Pack

Install this expansion pack when your project requires:

• Cloud infrastructure design and implementation
• Kubernetes/container platform setup
• Service mesh and GitOps workflows
• Infrastructure as Code (IaC) development
• Platform engineering and DevOps practices

What's Included

Agents

• devops.yml - DevOps and Platform Engineering agent configuration

Personas

• devops.md - DevOps Engineer persona (Alex)

IDE Agents

• devops.ide.md - IDE-specific DevOps agent configuration

Templates

• infrastructure-architecture-tmpl.md - Infrastructure architecture design template
• infrastructure-platform-from-arch-tmpl.md - Platform implementation from architecture template

Tasks

• infra/validate-infrastructure.md - Infrastructure validation workflow
• infra/review-infrastructure.md - Infrastructure review process

Checklists

• infrastructure-checklist.md - Comprehensive 16-section infrastructure validation checklist

Integration with Core BMAD

This expansion pack integrates with the core BMAD flow at these points:

1. After Architecture Phase: The Architect can trigger infrastructure architecture design
2. Parallel to Development: Infrastructure implementation can proceed alongside application development
3. Before Deployment: Infrastructure must be validated before application deployment

Installation

To install this expansion pack, run:

npm run install:expansion infrastructure
```text

Or manually:

```bash
node tools/install-expansion-pack.js infrastructure
```text

This will:

1. Copy all files to their appropriate locations in `.bmad-core/`
2. Update any necessary configurations
3. Make the DevOps agent available in teams

## Usage Examples

### 1. Infrastructure Architecture Design

After the main architecture is complete:

```bash
# Using the Architect agent
*create-infrastructure

# Or directly with DevOps agent
npm run agent devops
```text

### 2. Platform Implementation

With an approved infrastructure architecture:

```bash
# DevOps agent implements the platform
*implement-platform

3. Infrastructure Validation

Before deployment:

# Validate infrastructure against checklist
*validate-infra

Team Integration

The DevOps agent can be added to team configurations:

• team-technical.yml - For technical implementation teams
• team-full-org.yml - For complete organizational teams

Dependencies

This expansion pack works best when used with:

• Core BMAD agents (especially Architect)
• Technical preferences documentation
• Approved PRD and system architecture

Customization

You can customize this expansion pack by:

1. Modifying the infrastructure templates for your cloud provider
2. Adjusting the checklist items for your compliance needs
3. Adding custom tasks for your specific workflows

Notes

• Infrastructure work requires real-world cloud credentials and configurations
• The templates use placeholders ({{variable}}) that need actual values
• Always validate infrastructure changes before production deployment

---

Version: 1.0 Compatible with: BMAD Method v4