bmad-spec

Distills intent inputs into a validated five-field SPEC.md contract with companion files.

6|Updated Aug 29, 2026
One-click install
npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-spec-hordricjr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bmad-spec
Source: https://github.com/HordRicJr/Akomagni/tree/main/bmad-core/.agents/skills/bmad-spec
Command: npx skills add https://github.com/HordRicJr/Akomagni --skill bmad-spec-hordricjr

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? Turning vague ideas, brain dumps, PRDs, transcripts, or mixed multi-source material into a single canonical specification is error-prone: decisions get lost, capability IDs drift, and downstream teams work from divergent documents. This Skill produces a preservation-validated SPEC.md kernel plus companion files that every downstream workflow consumes as the machine contract. ## Core Features & Use Cases - Spec distillation: Converts any intent input into the five-field kernel (Why, Capabilities, Constraints, Non-goals, Success signal) with stable CAP-N identifiers. - Append-only memory log: Records every decision, constraint, and assumption in .memlog.md and re-derives SPEC.md from it, so updates never cause merge drift. - Two-pass self-validation: Enforces eight Spec Law rules covering coherence and preservation of every load-bearing source claim. - Story breakdown: Optionally generates stories.yaml with checkpoints and dispatch notes for independently shippable slices. - Use Case: Paste a customer email thread and a meeting transcript, and receive a spec folder containing SPEC.md, a glossary companion, and a memlog with open questions flagged for human decision. ## Quick Start Ask the assistant to distill the attached product brief into a spec and validate it against the spec rules.

Frequently Asked Questions about bmad-spec

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I turn a PRD or brain dump into a formal specification?

Provide the PRD, brief, transcript, or idea as input and the skill distills it into a SPEC.md kernel with Why, Capabilities, Constraints, Non-goals, and Success signal fields. Load-bearing overflow content is routed into named companion files cited in the frontmatter.

How do I break a specification into implementation stories?

Run Story Breakdown interactively once SPEC.md exists. The skill walks capabilities with you and writes stories.yaml with id, title, description, spec_checkpoint, done_checkpoint, and invoke_dev_with fields per story.

Can I update an existing spec without losing capability IDs?

Yes. Re-invoking with the same slug targets the existing spec folder and updates it in place. The append-only .memlog.md is the authority, so existing CAP-N identifiers are preserved and new capabilities get the next unused number.

What happens when the input is too vague to distill?

Sparse input triggers either an express mode that logs gaps as open_questions entries or a guided walkthrough of the five fields. If the input is genuinely too thin, the skill stops and suggests running a PRD skill first.

Does the skill support headless or programmatic invocation?

Yes. Headless mode activates when there is no TTY or a programmatic caller supplies all inputs. It returns a small JSON object with status and the list of files written, or a blocked status with an error_code such as insufficient_intent or missing_slug.