Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (bmad-module-infrastructure-devops) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

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:

Security & Compliance
Infrastructure as Code
Resilience & Availability
Backup & Disaster Recovery
Monitoring & Observability
Performance & Optimization
Operations & Governance
CI/CD & Deployment
Networking & Connectivity
Compliance & Documentation
BMad Workflow Integration
Architecture Documentation Validation
Container Platform Validation
GitOps Workflows Validation
Service Mesh Validation
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

Install the module into your project's node_modules:
```
npm install bmad-module-infrastructure-devops
```
Run the BMad installer:
```
npx bmad-method install
```
Select this module when the installer reaches the custom module step. Point it at:
```
node_modules/bmad-module-infrastructure-devops/src
```
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:

After Architecture Phase - Architect triggers infrastructure design
Parallel to Development - Infrastructure implementation proceeds alongside application work
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.