bmad-spec
Condenses an idea, brief, PRD or transcript into a short spec: one kernel file plus supporting files that later skills build from.
- Kind
- Skill
- Works with
- Claude Code
- Source
- bmad-code-org/BMAD-METHOD @ ec9a46ee2aef
- Path
- skills/bmad-spec/SKILL.md
- License
- MIT
- Jobs
- Planning, Documentation
InstallCopy it from the source repository, or sign in and let the assistant adapt it for your project.
# BMad Spec
## Overview
Canonical transformer for the BMad spec-kernel ecosystem. Takes any intent input — vague idea, brain dump, PRD, GDD, RFC, brief, Slack thread, customer email, meeting transcript, mockups, mixed multi-source — and produces **spec-{slug}.md** carrying the five-field kernel (Why, Capabilities, Constraints, Non-goals, Success signal) plus companion files for load-bearing content that does not fit or would bloat the kernel with expansive line-item detail. Together they are the machine contract every downstream BMad skill consumes.
Multiple skills may call to update the same spec over time.
## Conventions
- Bare paths (e.g. `assets/spec-template.md`) resolve from the skill root.
- `{skill-root}` is this skill's install dir; `{project-root}` is the nearest folder containing `_bmad/`, starting at the working dir and moving up through its parents.
- `{workflow.<name>}` resolves to fields in `customize.toml`.
## On Activation
1. Resolve customization: `uv run {project-root}/_bmad/scripts/resolve_customization.py --skill {skill-root} --project-root {project-root} --key workflow`.
…