bmad-code-org/bmad-method
Breakthrough Method for Agile Ai Driven Development
How bmad-method is put together
bmad-method (v6.11.0) is an npm-distributed CLI toolkit that installs the 'BMad Method' — a set of AI-driven agile development skills, agents, and workflows — into users' projects and IDEs. The primary language is JavaScript (Node.js >= 20.12) for the installer CLI, with Python 3.10+ scripts (run via uv) used for skill tooling such as sprint planning and retrospectives. Architecture is content-plus-installer: markdown/TOML/YAML skill definitions under src/ are copied into target projects by tools/installer, which also generates per-IDE command pointer files driven by platform-codes.yaml. A secondary Astro/Starlight documentation site lives under website/ with build/validation scripts in tools/. There are no datastores or server components; the repo is a static-content distribution and file-manipulation pipeline.
Languages
Frameworks
Infrastructure
Major components
Installer CLI
tools/installer/bmad-cli.js and commands/ implement the bmad/bmad-method binaries providing install, uninstall, and status subcommands.
Installer core engine
tools/installer/core/ holds Config, installer orchestration, install paths, manifest generation, shim policy, and environment checks (uv, WSL node).
IDE integration layer
tools/installer/ide/ resolves platform codes from platform-codes.yaml and uses ConfigDrivenIdeSetup to write skill files and command pointers into many IDEs (Copilot, OpenCode, etc.).
Module management
tools/installer/modules/ handles official modules, external/custom modules, channels, plugins, version resolution, and git environment detection.
Core skills library
src/core-skills/ contains base BMad skills (brainstorming, elicitation, review, help, party-mode) each defined as SKILL.md plus customize.toml.
BMM method skills
src/bmm-skills/ holds persona agents (analyst, PM, architect, dev, UX) and plan/ship workflow skills (PRD, architecture, sprint planning, build-auto, code review, retrospective).
Web bundles
web-bundles/ packages selected workflows as standalone SKILL.md/INSTRUCTIONS.md bundles for Gemini Gems and ChatGPT GPTs.
Docs site & validation tooling
website/ (Astro/Starlight) plus tools/build-docs.mjs, validate-doc-links.js, validate-sidebar-order.js, fix-doc-links.js build and lint the documentation.
No digest this week
1 weeksWeek of
Dependencies and code review
Dependency advisories
Security Watch
No known advisories across 0 scanned dependencies.
No known advisories in the scanned dependencies.
Code review
No concrete code-level issues confirmed.
Get this report every week for your repos.
GitZoid learns each repo, reports what changed, and flags what needs attention. One flat price for the whole team.
$19 a month, flat · First 10 outputs free · No card required