BMad Infrastructure & DevOps Module

A custom BMad Method module that adds infrastructure and DevOps capabilities through Alex, a DevOps Infrastructure Specialist & Platform Engineer agent.

Quickstart

# 1. Install this module into your project
npm install bmad-module-infrastructure-devops

# 2. Run the BMad installer
npx bmad-method install

# 3. When prompted for custom modules, point the installer at:
#    node_modules/bmad-module-infrastructure-devops/src

The installer will copy the module's agents, workflows, templates, and data into your project's _bmad/infra/ directory and prompt you to configure your infrastructure preferences.

What's Included

Agent: Alex

A 15+ year DevSecOps and Platform Engineering specialist who guides you through infrastructure architecture design, validation, and implementation.

Menu Commands:

Code	Command	Description
RI	Review Infrastructure	Systematic review of existing infrastructure against best practices
VI	Validate Infrastructure	Comprehensive validation of changes before deployment
IA	Infrastructure Architecture	Create infrastructure architecture document from template
PI	Platform Implementation	Create platform implementation plan from approved architecture
CK	Checklist	Run the full 16-section infrastructure validation checklist
CH	Chat	Chat with Alex about infrastructure, DevOps, or platform engineering

Workflows

• Review Infrastructure - Thorough review with incremental or rapid assessment modes, architectural escalation assessment, and BMad integration checks
• Validate Infrastructure - Pre-deployment validation with architecture design review gate, 16-section compliance checking, and signoff recommendations

Templates

• Infrastructure Architecture - Comprehensive architecture document covering cloud providers, IaC, networking, compute, security, monitoring, CI/CD, and DR
• Platform Implementation - Detailed implementation plan for container platforms, GitOps, service mesh, and developer experience

Checklist

A 16-section infrastructure validation checklist covering:

1. Security & Compliance
2. Infrastructure as Code
3. Resilience & Availability
4. Backup & Disaster Recovery
5. Monitoring & Observability
6. Performance & Optimization
7. Operations & Governance
8. CI/CD & Deployment
9. Networking & Connectivity
10. Compliance & Documentation
11. BMad Workflow Integration
12. Architecture Documentation Validation
13. Container Platform Validation
14. GitOps Workflows Validation
15. Service Mesh Validation
16. Developer Experience Platform Validation

Installation

This is a custom module — it is not bundled with the BMad installer. You install the npm package first, then the BMad installer wires it into your project.

Prerequisites

• Node.js >= 22.0.0
• An existing project (or a new directory) where you want to set up BMad

Step-by-Step

1. Install the module into your project's node_modules:

   npm install bmad-module-infrastructure-devops

2. Run the BMad installer:

   npx bmad-method install

3. Select this module when the installer reaches the custom module step. Point it at:

   node_modules/bmad-module-infrastructure-devops/src
   

4. Answer the configuration prompts (see Configuration below).

The installer copies the module contents into _bmad/infra/ and registers it in your project's _bmad/_config/manifest.yaml.

Configuration

The installer's Configuration Gateway offers Express Setup (accept all defaults) or Customize (choose per-module). If you customize, you'll be prompted for:

Setting	Options	Default
Cloud provider	AWS, Azure, GCP, Bare Metal, Hybrid	AWS
Container platform	Kubernetes, Docker Compose, Nomad, None	Kubernetes
IaC tool	Terraform/OpenTofu, Pulumi, Ansible, CloudFormation, Other	Terraform
GitOps tool	ArgoCD, Flux, None	ArgoCD

With Express Setup, all defaults are applied automatically. Either way, selections are stored in _bmad/_config/module-configs.yaml and used by Alex to tailor recommendations to your stack.

Integration Points

This module integrates with the core BMad workflow at three stages:

1. After Architecture Phase - Architect triggers infrastructure design
2. Parallel to Development - Infrastructure implementation proceeds alongside application work
3. Before Deployment - Infrastructure validation occurs prior to application deployment

Alex collaborates with other BMad agents:

• Architect - Design review gates and architectural escalation
• Development agents - Environment provisioning and platform support
• Product Owner - PRD alignment and non-functional requirements

Module Structure

src/
  agents/
    devops.agent.yaml        # Alex agent definition
  workflows/
    review-infrastructure/   # Infrastructure review workflow (3 steps)
    validate-infrastructure/ # Pre-deployment validation workflow (4 steps)
  templates/
    infrastructure-architecture-tmpl.md
    platform-implementation-tmpl.md
  data/
    infrastructure-checklist.md
  module.yaml                # Module manifest and config prompts
  module-help.csv            # Help entries for the BMad help system

Development

npm install              # Install dependencies
npm test                 # Run all checks (schemas, lint, format)
npm run lint             # Run linting only
npm run lint:fix         # Auto-fix lint issues
npm run format:fix       # Auto-fix formatting

Schema Validation

Agent YAML files are validated against the BMad agent schema:

npm run test:schemas     # Run agent schema tests
npm run validate:schemas # Validate agent schema compliance

Publishing

npm run release          # Patch release (0.1.0 -> 0.1.1)
npm run release:minor    # Minor release (0.1.0 -> 0.2.0)
npm run release:major    # Major release (0.1.0 -> 1.0.0)

Contributing

See CONTRIBUTING.md for guidelines on submitting issues and pull requests.

License

MIT License - see LICENSE for details.

---

BMad Infrastructure & DevOps Module - Part of the BMad Method ecosystem.