BMad Infrastructure & DevOps Module

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

Quickstart

Copy the skills/bmad-agent-devops/ folder into your project's .claude/skills/ directory. On first activation, Alex will detect the module isn't registered and walk you through setup. You can also trigger setup manually:

Talk to Alex with setup

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
CH	Chat	Chat with Alex about infrastructure, DevOps, or platform engineering
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

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

As a BMad Community Module

Copy the skills/bmad-agent-devops/ folder into your project's .claude/skills/ directory. On first activation, Alex will detect the module isn't registered and walk you through setup.

Via npm

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

   npm install bmad-module-infrastructure-devops

2. Copy the skill into your project:

   cp -r node_modules/bmad-module-infrastructure-devops/skills/bmad-agent-devops .claude/skills/

3. Activate Alex — setup will trigger automatically on first run.

Configuration

During setup, you'll be asked to configure:

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

Selections are stored in _bmad/config.yaml (under the infra section) 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

skills/
  bmad-agent-devops/
    SKILL.md                         # Alex agent skill definition
    assets/
      module.yaml                    # Module manifest and config prompts
      module-help.csv                # Help entries for the BMad help system
      module-setup.md                # Self-registration flow
    scripts/
      merge-config.py                # Config merge script
      merge-help-csv.py              # Help CSV merge script
    references/
      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
  .claude-plugin/
    marketplace.json                 # Community module distribution manifest

Development

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

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.