К основному содержанию
скилл CX Codex

bmad-spec — скилл для Claude Code: спецификация и установка

Скилл bmad-spec для Claude Code превращает заметки, PRD или расшифровку в короткий файл SPEC.md с пятью разделами. Он включается, когда нужно сформулировать задачу и границы проекта.

MIT 108 установок ★ 493 обновлён 2026-06-20

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-spec -a claude-code
Открыть на GitHub

Что делает bmad-spec

bmad-spec собирает исходные материалы в SPEC.md с разделами Problem, Capabilities, Constraints, Non-Goals и Success Metrics. На вход можно дать текст, расшифровку, описание в чате или путь к файлу. Сначала скилл показывает черновик и спрашивает, нужно ли что-то изменить; файл записывает после подтверждения.

Для файла берётся шаблон spec.template.md, а папка вывода задаётся в bmad-output/config.yaml или по умолчанию называется bmad-output/. Скилл также добавляет запись в decision-log.md. Он предназначен для планирования: код не пишет и тесты не запускает.

Какие задачи решает

  • собрать требования из заметок в единую спецификацию
  • зафиксировать ограничения и то, что не входит в объём работ
  • сформулировать измеримые признаки готовности проекта
  • обновить существующий SPEC.md после изменения требований

Примеры запросов агенту

  • Собери из этих заметок спецификацию проекта в SPEC.md.
  • Преобразуй этот PRD в краткий документ с проблемой, возможностями и ограничениями.
  • Проверь SPEC.md по пяти разделам и покажи, что нужно исправить.

Как установить bmad-spec

1Через Skills CLI (Vercel)

npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-spec -a claude-code

2Вручную: положить файлы

~/.claude/skills/bmad-spec/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/bmad-spec/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о bmad-spec

Как установить bmad-spec в Claude Code?

Выполни npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-spec -a claude-code. Файл скилла устанавливается по пути ~/.claude/skills/bmad-spec/SKILL.md.

Что делает bmad-spec?

Он превращает неструктурированные материалы в SPEC.md с разделами Problem, Capabilities, Constraints, Non-Goals и Success Metrics. Перед записью показывает черновик и ждёт подтверждения.

Какие разделы входят в SPEC.md?

Пять разделов: проблема, возможности решения, ограничения, то, что исключено из объёма работ, и метрики успеха.

Исходный текст

SKILL.md · MIT
---
name: bmad-spec
description: |
  Distills ANY messy input — brain dump, transcript, long PRD, stakeholder notes,
  feature request, voice memo — into a tight five-field SPEC.md kernel that any
  downstream planning skill can consume. The five fields are: Problem, Capabilities,
  Constraints, Non-Goals, Success Metrics.

  Use when the user says "create a spec", "write a spec for", "distill this into a
  spec", "I have a brain dump", "turn this into something structured", "clean up these
  notes", "make a SPEC from", "I want to define the problem", "help me scope this",
  "summarize what we're building", "I have a PRD but need a kernel", "what are we
  actually solving?", or drops raw text/transcript and asks for structure. Also use
  when starting any new initiative and a clean shared definition is missing.
allowed-tools: Read, Write, Edit, Glob, Grep, TodoWrite
---

# BMAD Spec — Five-Field Kernel Distiller

**Function:** Accept messy, unstructured, or verbose input and produce a lean
`SPEC.md` kernel (five fields, no more) that anchors every downstream planning
workflow. This is a **planning** skill. It never writes application code, runs
tests, or builds anything.

## What it produces

A single file under the configured output folder (default `bmad-output/`):

```
bmad-output/
└── SPEC.md    # the five-field kernel
```

The kernel is intentionally small — a SPEC is not a PRD, not a brief, not an
architecture doc. It is the shared definition of what is being built and why.
Every downstream skill (PRD, tech-spec, architecture) loads it as the ground
truth for scope.

## The five fields

| Field | Purpose |
|---|---|
| **Problem** | The one thing that hurts right now and why it matters |
| **Capabilities** | What the solution must be able to do (outcome-framed) |
| **Constraints** | Hard limits that are not negotiable (budget, tech, time, compliance) |
| **Non-Goals** | Scope that is explicitly out — prevents creep and confusion |
| **Success Metrics** | Observable signals that confirm the problem is solved |

See `templates/spec.template.md` for the exact template with guidance and examples.

## Workflow

### 1. Ingest

Accept whatever the user hands over:
- Paste of raw text, notes, or a transcript
- A path to an existing file (`Read` it)
- Verbal description in the chat

If the input exceeds a few hundred words, briefly acknowledge what you received
before proceeding. Do not ask the user to reformat it — that is the skill's job.

### 2. Extract (silent analysis)

Read the input and locate signal for each field:
- **Problem:** What pain, gap, or failure state is described? Who experiences it?
- **Capabilities:** What outcomes or abilities are requested? Rephrase features
  as capabilities ("users can …", "the system supports …").
- **Constraints:** What is fixed? Look for budget figures, tech mandates, deadlines,
  regulatory mentions, team-size limits.
- **Non-Goals:** What is the input silent about that a reader might assume? What
  is explicitly ruled out? What is deferred?
- **Success Metrics:** What does "done" or "working" look like? Numbers,
  observable behaviors, thresholds.

### 3. Draft and present

Write a concise draft of all five fields and show it to the user in the chat
before writing to disk. Keep each field tight:
- Problem: 2–5 sentences max.
- Capabilities: 3–7 bullet points, outcome-framed.
- Constraints: 2–6 bullet points, hard limits only.
- Non-Goals: 2–6 bullet points, clear and unambiguous.
- Success Metrics: 2–5 bullet points, each with a measurable signal.

After presenting, ask one targeted question: "Does anything here need to change
before I write SPEC.md?"

### 4. Write

Once the user confirms (or revises), write `SPEC.md` using the template:

```
${CLAUDE_PLUGIN_ROOT}/skills/bmad-spec/templates/spec.template.md
```

Output path: `<outputFolder>/SPEC.md` (read `bmad-output/config.yaml` if it
exists to find the configured output folder; fall back to `bmad-output/`).

Append a new entry to `bmad-output/decision-log.md` (create it if absent):

```markdown
## SPEC created — <ISO date>
- Source: <one-line description of the input, e.g. "stakeholder brain dump">
- Key scope decision: <the single most important Non-Goal or Constraint>
```

### 5. Hand off

After writing, tell the user what the SPEC unlocks:
- **Quick Flow track** → hand off to `bmad-tech-spec` to turn the kernel into a
  deployable spec.
- **BMad Method / Enterprise track** → hand off to `bmad-product-brief` or the
  PM role (`bmad-prfaq`) for a full PRD.
- If no workspace exists yet, suggest running `/bmad-planning-orchestrator:bmad-init`
  first to pick a track.

## Three intents

- **Create** — distill fresh input into a new `SPEC.md` (the common case).
- **Update** — the user has new information or changed scope. Read the existing
  `SPEC.md`, apply the changes, present a diff-style summary, confirm, then
  overwrite. Record the change in `decision-log.md`.
- **Validate** — review `SPEC.md` against the five-field contract: are all fields
  present and non-empty? Is the Problem one coherent statement? Are Capabilities
  outcome-framed (not feature-list)? Are Non-Goals unambiguous? Flag any gaps and
  offer to fix them.

## Distillation heuristics

Follow these when mapping noisy input to the five fields:

| Input pattern | Maps to |
|---|---|
| "we need to fix / users complain / it's broken" | Problem |
| "it should / users can / the system supports" | Capabilities |
| "we can't / no budget / must use / by deadline" | Constraints |
| "not in scope / later / out of v1 / won't do" | Non-Goals |
| "if X% then / we'll know it works when / target" | Success Metrics |

When a constraint sounds aspirational (e.g., "we'd like to finish in Q3"), move
it to Non-Goals or flag it as a soft constraint and note the ambiguity.

When capabilities sound like features rather than outcomes, rephrase: "add a
search bar" → "users can find any record within 3 keystrokes".

When no success metrics appear in the input, use the Problem statement to derive
proxy metrics: if the problem is "users can't find X", a metric is "time-to-find
X reduced by Y%".

## Guardrails

- **Lean by design.** Resist adding a sixth field. If important information does
  not fit the five fields, note it as context in the file header and direct the
  user to expand it in the PRD or tech-spec stage.
- **No solutioning.** The Capabilities field names outcomes, not implementation
  choices. Architecture, tech stack, and approach live downstream.
- **No story points, velocity, or burndown** anywhere in the SPEC.
- **Scope law.** This skill's last artifact is `SPEC.md`. It does not create
  stories, write code, or produce acceptance criteria. Hand those to downstream
  skills.

See `REFERENCE.md` for extended distillation patterns and edge cases.

> ---
> Part of the **BMAD Planning & Orchestrator** plugin — a Claude Code harness for the **BMAD Method** by the **BMAD Code Organization** (https://github.com/bmad-code-org/BMAD-METHOD). Implements the spirit of `bmad-spec`. All methodology credit belongs to the BMAD Code Organization.

© aj-geddes · MIT · aj-geddes/claude-code-bmad-skills

Похожие скиллы

Все скиллы по теме «Тексты и документация» →
bmad-agent-pm bmad-code-org Скилл bmad-agent-pm для Claude Code и Cursor выступает в роли менеджера продуктов Джона для написания, обновления и проверки планов проектов. CX Codex +1 17 800установок spec Klerith Проектирует спецификации по методологии spec-driven development. Задаёт уточняющие вопросы блоками и формирует файл требований в папке specs/ перед написанием кода. CX Codex +1 5 000установок spec-writer dannwaneri Скилл spec-writer превращает туманное описание фичи в структурированный спек, технический план и список задач. Помечает каждое предположение прямо в тексте, чтобы вы могли исправить неточности до того, как агент начнёт кодить. CX Codex +1 ★ 29звёзд репо absolute-spec dhruvjainin Скилл absolute-spec для Claude Code превращает запрос на функцию в проектную спецификацию после изучения кодовой базы. Агент задаёт несколько уточняющих вопросов, записывает документ в docs/plans/ и передаёт его на отдельную оценку. CX Codex +1 176установок quick-spec qdhenry Команда quick-spec разбирает кодовую базу, задаёт до 10 вопросов и пишет готовую спецификацию в файл. Для простых фич и рефакторингов, где полный опрос избыточен. CX Codex +1 ★ 1 357звёзд репо bmad-architecture bmad-code-org Скилл bmad-architecture пишет короткий архитектурный документ: фиксирует только те решения, без которых независимо собранные части системы разойдутся. CX Codex +1 17 800установок

Из того же набора11

Весь набор →
bmad-epics-and-stories Скилл bmad-epics-and-stories превращает PRD и архитектуру в готовый к разработке бэклог: один файл epics.md и набор самодостаточных story-файлов с критериями приёма, заметками разработчика и картой зависимостей. CX Codex +1 138установок bmad-research Скилл bmad-research для Claude Code проводит структурированное исследование рынка, конкурентов, технологий и отрасли, собирая данные из живых источников и оформляя их в цитируемый отчёт. CX Codex +1 138установок bmad-brainstorm Скилл bmad-brainstorm запускает структурированные мозговые штурмы по методикам вроде SCAMPER, SWOT и «5 почему». Формирует отчёт с выводами для дальнейшего планирования. CX Codex +1 130установок bmad-tech-spec Скилл bmad-tech-spec для Claude Code создаёт компактный техспек для небольших фич вместо полного PRD и архитектуры. Он собирает один артефакт перед разработкой историй. CX Codex +1 114установок bmad-readiness-check Скилл bmad-readiness-check для Claude Code сверяет документы планирования перед началом разработки. Запускается по просьбе проверить готовность требований, архитектуры и эпиков к реализации. CX Codex +1 107установок bmad-document-project Скилл bmad-document-project для Claude Code сканирует готовый репозиторий в режиме чтения и сохраняет файл project-documentation.md. Документ фиксирует стек и архитектуру перед планированием дальнейших задач. CX Codex +1 104установок bmad-sprint-planning Скилл bmad-sprint-planning для Claude Code раскладывает истории по зависимостям и формирует план передачи в разработку. Запускается по просьбе упорядочить истории, составить волны или создать sprint-status.yaml. CX Codex +1 104установок bmad-investigate Скилл bmad-investigate для Claude Code расследует баги и оформляет факты в case file. Запускается по запросу найти причину ошибки, разобрать инцидент или обновить расследование. CX Codex +1 102установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой