BMD - BMAD Development Module
Version: 1.0.0-alpha.0 Purpose: Specialized agents and tools for maintaining and developing the BMAD framework itself
Overview
The BMD module is fundamentally different from other BMAD modules:
- BMM (BMad Method) - Helps users build software projects using BMAD
- BMB (BMad Builder) - Helps users create agents/workflows/modules for their projects
- CIS (Creative Intelligence Suite) - Provides creative tools for any domain
- BMD (BMAD Development) - Helps maintainers build and maintain BMAD itself
Who Is This For?
- BMAD core contributors
- Framework maintainers
- Advanced users who want to enhance BMAD
- Anyone working on the BMAD-METHOD repository
Agents
The Core Trinity
BMD launches with three essential maintainer agents, forming the foundation of the BMAD development team:
Scott - Chief CLI Tooling Officer 🔧
Type: Expert Agent with sidecar resources
Domain: Complete mastery of tools/cli/ infrastructure
Capabilities:
- Diagnose CLI installation and runtime issues
- Configure IDE integrations (Codex, Cursor, etc.)
- Build and update module installers
- Configure installation question flows
- Enhance CLI functionality
- Maintain CLI documentation
- Share installer and bundler patterns
- Track known issues and solutions
Personality: Star Trek Chief Engineer - systematic, urgent, and capable
Usage:
/bmad:bmd:agents:cli-chief
Commander - Chief Release Officer 🚀
Type: Expert Agent with sidecar resources
Domain: Release management, versioning, changelogs, deployments
Capabilities:
- Prepare releases with complete checklists
- Generate changelogs from git history
- Manage semantic versioning
- Create and push git release tags
- Validate release readiness
- Publish to NPM registry
- Create GitHub releases
- Coordinate hotfix releases
- Manage rollbacks if needed
- Track release history and patterns
Personality: Space Mission Control - calm, precise, checklist-driven
Usage:
/bmad:bmd:agents:release-chief
Atlas - Chief Documentation Keeper 📚
Type: Expert Agent with sidecar resources
Domain: All documentation files, guides, examples, README accuracy
Capabilities:
- Audit documentation for accuracy
- Validate links and cross-references
- Verify and update code examples
- Synchronize docs with code changes
- Update README files across project
- Generate API documentation
- Check documentation style and consistency
- Identify documentation gaps
- Track documentation health metrics
- Maintain CHANGELOG accuracy
Personality: Nature Documentarian - observational, precise, finding wonder in organization
Usage:
/bmad:bmd:agents:doc-keeper
Future Agents
The BMD module will continue to expand with:
- Bundler Expert - Web bundle compilation and validation specialist
- Architecture Guardian - Code pattern enforcement and structural integrity
- Testing Coordinator - Test coverage, CI/CD management, quality gates
- Workflow Auditor - Audits BMAD's own internal workflows
- Issue Triager - GitHub issue classification and management
- Migration Assistant - Version upgrade assistance and breaking change handling
- Code Quality Enforcer - ESLint/Prettier enforcement and technical debt tracking
- Dependency Manager - NPM package management and security scanning
Installation
Since BMD is part of the BMAD-METHOD source, install it like any other module:
npm run install:bmad -- --target . --modules bmd --ides codex --non-interactive
Or for contributors working directly in BMAD-METHOD:
npm run install:bmad -- --target /path/to/BMAD-METHOD --modules bmd --ides codex
Module Structure
src/modules/bmd/
├── agents/
│ ├── cli-chief.agent.yaml # Scott - CLI expert
│ ├── cli-chief-sidecar/ # Scott's workspace
│ │ ├── memories.md
│ │ ├── instructions.md
│ │ └── knowledge/
│ ├── release-chief.agent.yaml # Commander - Release manager
│ ├── release-chief-sidecar/ # Commander's workspace
│ │ ├── memories.md
│ │ ├── instructions.md
│ │ └── knowledge/
│ ├── doc-keeper.agent.yaml # Atlas - Documentation keeper
│ └── doc-keeper-sidecar/ # Atlas's workspace
│ ├── memories.md
│ ├── instructions.md
│ └── knowledge/
├── workflows/ # Future: release prep, validation
├── config.yaml # Module configuration
└── README.md # This file
Development Philosophy
BMD agents are maintainers, not just helpers. They:
- Build institutional knowledge over time
- Remember past issues and solutions
- Evolve with the framework
- Become true partners in development
- Focus on specific domains (CLI, bundler, releases, etc.)
Contributing
When adding new BMD agents:
- Consider if it's truly for BMAD development (not user project development)
- Use Expert agent type for domain-specific maintainers
- Include comprehensive sidecar resources
- Document the domain boundaries clearly
- Build knowledge accumulation into the agent
Vision
BMD agents will become the "senior engineering team" for BMAD itself - each with deep expertise in their domain, able to guide contributors, maintain quality, and evolve the framework intelligently.
License
Same as BMAD-METHOD repository