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

bmad-init — скилл для Claude Code: что делает и как установить

Скилл bmad-init для Claude Code разворачивает рабочую область планирования BMAD. Запускается при старте нового проекта, чтобы выбрать масштаб и создать стартовые документы.

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

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

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

Разворачивает директорию bmad-output/ со стартовыми файлами: config.yaml, decision-log.md, project-context.md и пустой папкой stories/. Скилл отвечает только за структуру планирования и не пишет прикладной код, не собирает проект и не запускает тесты.

В процессе помощник опрашивает о масштабе, числе задач и требованиях к инфраструктуре через bash-скрипт select-track.sh. Он предлагает один из трёх треков: Quick Flow для 1–15 задач со спецификацией, BMad Method для 10–50+ задач с PRD и архитектурой или Enterprise от 30 задач с планами безопасности и DevOps. Скрипт init-project.sh работает идемпотентно, поэтому существующие записи в журнале решений и контексте проекта не затираются при повторном запуске. Для работы требуется окружение с поддержкой Bash.

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

  • развернуть структуру файлов для планирования по методологии BMAD
  • подобрать трек проектирования под размер и требования системы
  • составить первичный контекст проекта и зафиксировать ограничения
  • проверить корректность существующей рабочей области bmad-output

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

  • Инициализируй BMAD для нового сервиса
  • Какой трек BMAD выбрать для проекта на 20 задач?
  • Проверь рабочую область bmad-output

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

1Через Skills CLI (Vercel)

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

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

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

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

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

Вопросы о bmad-init

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

Выполните команду npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-init -a claude-code. Также можно вручную сохранить файл в ~/.claude/skills/bmad-init/SKILL.md.

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

Создаёт папку bmad-output/, генерирует config.yaml, лог решений decision-log.md и базовый документ контекста project-context.md. Он помогает выбрать трек планирования перед началом проработки PRD и архитектуры.

Что нужно для работы bmad-init?

Скиллу требуется окружение с Bash и доступные инструменты Read, Write, Edit, Glob, Grep и TodoWrite.

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

SKILL.md · MIT
---
name: bmad-init
description: |
  Initialize a BMAD planning workspace: pick a scale-adaptive TRACK (Quick Flow /
  BMad Method / Enterprise) interactively, then scaffold the output folder, a config
  file, an empty decision-log.md, and a project-context.md "constitution". Use when
  the user says "initialize BMAD", "set up BMAD", "start a new BMAD project",
  "scaffold the planning workspace", "bmad init", "create the bmad config", or is
  beginning planning and has no bmad-output/ folder yet. Also use when the user asks
  "which track should I use?" or "what scale is my project?". This is the FIRST skill
  to run before any other planning workflow (brief, PRD, architecture, stories).
allowed-tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
---

# BMAD Init — Workspace Scaffolder

Set up the planning workspace and choose the TRACK that scales the rest of the BMAD
planning workflows. This is a **planning** skill: it creates folders and seed
documents only. It never writes application code, runs tests, or builds anything.

## What it produces

Under the configured output folder (default `bmad-output/`):

```
bmad-output/
├── config.yaml          # project name, track, output paths, languages
├── decision-log.md      # empty threaded decision log (grows across workflows)
├── project-context.md   # the project "constitution" loaded by every later skill
└── stories/             # empty; future story files land here
```

`config.yaml` is the single source of truth other skills read to find the output
folder and the chosen track.

## The three TRACKS (never numbered Levels)

| Track | Story count | Planning artifacts |
|-------|-------------|--------------------|
| **Quick Flow** | 1–15 stories | tech-spec only |
| **BMad Method** | 10–50+ stories | PRD + Architecture (+ optional UX) |
| **Enterprise** | 30+ stories | PRD + Architecture + Security + DevOps planning |

The track is a **planning-need** decision, not a points/velocity decision. Story
count is a rough signal only; let scope, cross-team coordination, and risk drive the
call. A heuristic may suggest a default — **the user always confirms**.

## Workflow

1. **Check for an existing workspace.** Glob for `bmad-output/config.yaml` (or a
   custom output folder if the user names one). If it exists, read it and ask whether
   to keep, re-run idempotently (safe — existing files are preserved), or change the
   track. Do not clobber a populated decision-log.md or project-context.md.

2. **Gather rough scope signals** in conversation (don't interrogate):
   - One-line project description.
   - Roughly how many distinct pieces of work / stories? (ranges are fine)
   - Multiple teams or just one builder?
   - Hard compliance / security / infra requirements?

3. **Suggest a track.** Run the helper to print the three tracks and a suggested
   default, then state your recommendation and **ask the user to confirm or override**:

   ```bash
   bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/select-track.sh" --stories <N> --teams <one|many> --compliance <yes|no>
   ```

   Heuristic the helper applies (you may reason past it):
   - compliance/infra = yes, or 30+ stories → **Enterprise**
   - 10+ stories, or PRD/architecture clearly needed → **BMad Method**
   - otherwise → **Quick Flow**

4. **Scaffold.** Once the user confirms name + track, run:

   ```bash
   bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/init-project.sh" \
     --name "<project name>" \
     --track <quick-flow|bmad-method|enterprise> \
     --output "bmad-output"
   ```

   The script is **idempotent**: it creates missing folders and seeds any missing
   template files, but never overwrites `decision-log.md` or `project-context.md`
   if they already contain content. It always (re)writes `config.yaml`.

5. **Open the constitution.** Walk the user through filling the first sections of
   `project-context.md` (project goal, primary users, constraints, non-goals). This
   is the document every downstream skill loads, so a few good sentences here pay off.
   Record the track choice and rationale as the first entry in `decision-log.md`.

6. **Hand off.** Recommend the next planning step based on track:
   - Quick Flow → tech-spec, then sprint-planning / story creation.
   - BMad Method → product brief → PRD → architecture.
   - Enterprise → product brief → PRD → architecture (+ security & DevOps planning).

## Three intents

- **Create** — fresh workspace (the common case).
- **Update** — change the track or rename the project: edit `config.yaml` and append
  the change to `decision-log.md` with a date and reason. Do not wipe other files.
- **Validate** — confirm the workspace is well-formed:
  ```bash
  bash "${CLAUDE_PLUGIN_ROOT}/skills/bmad-init/scripts/init-project.sh" --validate --output "bmad-output"
  ```

## Guardrails

- No numbered Levels anywhere — only the three named tracks.
- No story points, velocity, burndown. Delivery is **count-based** (stories
  remaining / completion rate). Story sizing target: small enough for one agent
  session (~2–8h); split anything larger.
- This skill stops at scaffolding. It hands off to other planning skills; it never
  implements, tests, lints, or builds.

See `REFERENCE.md` for the full config schema, track decision detail, and the
project-context section guide.

> ---
> 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-init`. All methodology credit belongs to the BMAD Code Organization.

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

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

Все скиллы по теме «Настройка агента: память, контекст, субагенты» →
bmad-toolsmith bmad-code-org Скилл bmad-toolsmith для Claude Code собирает BMad-скиллы, агентов и модули из сессии. Запускайте его для создания с нуля, рефакторинга или упаковки сессии в переиспользуемый инструмент. CX Codex +1 9 100установок bmad-agent-pm bmad-code-org Скилл bmad-agent-pm для Claude Code и Cursor выступает в роли менеджера продуктов Джона для написания, обновления и проверки планов проектов. CX Codex +1 17 800установок bmad-idea akillness Скилл bmad-idea превращает сырую идею в один концепт-артефакт и подсказывает, к какому скиллу идти дальше. Нужен до PRD и спринт-планов. CX Codex +1 368установок bmad-auto bmad-labs Скилл bmad-auto оркеструет реализацию задач по методологии BMAD: ведёт конвейер историй Phase 4 либо переключается на Quick Flow для точечных правок. CX Codex +1 145установок bmad-marketing-growth-module reason-machines Скилл bmad-marketing-growth-module для Claude Code объединяет 14 агентов и 6 воркфлоу BMAD Framework для маркетинга SaaS: от стратегии до постов для отдельных площадок. CX Codex +1 910установок init-project davila7 Команда init-project для Claude Code разворачивает структуру нового проекта: каталоги, git, линтеры, тесты и CI. Создаёт настроенный репозиторий с первым коммитом. CX Codex +1 1 382установок

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

Весь набор →
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-spec Скилл bmad-spec для Claude Code превращает заметки, PRD или расшифровку в короткий файл SPEC.md с пятью разделами. Он включается, когда нужно сформулировать задачу и границы проекта. CX Codex +1 108установок 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установок bmad-builder Скилл bmad-builder для Claude Code создаёт и проверяет новые скиллы планирования в плагине BMAD. Генерирует структуру каталогов и следит, чтобы логика не выходила за рамки оркестрации. CX Codex +1 102установок

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

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