# bmad-epics-and-stories

Скилл bmad-epics-and-stories превращает PRD и архитектуру в готовый к разработке бэклог: один файл epics.md и набор самодостаточных story-файлов с критериями приёма, заметками разработчика и картой зависимостей.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 138 установок · ★ 493 у репозитория
- Автор: aj-geddes
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/aj-geddes/claude-code-bmad-skills/tree/HEAD/bmad-planning-orchestrator/skills/bmad-epics-and-stories/SKILL.md
- Обновлён: 2026-06-20
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/bmad-epics-and-stories

## Что делает

Скилл разбивает требования на эпики, каждый — доставляемый срез ценности, а затем компилирует историю в самодостаточный контекстный объект на ~8K токенов. Каждая история содержит историю (as-a/I-want/so-that), нумерованные критерии приёма, подзадачи, привязанные к критериям, Dev Notes с цитатами на prd.md и architecture.md, стратегию тестирования (без запуска), карту блокировок между историями и явный список файлов и модулей, которые история может менять. Такой список — рычаг для параллельной безконфликтной работы.

У скилла три режима: создать новые эпики и истории, обновить существующую историю или проверить черновик по контракту. История должна быть размером в один день разработки (2–8 часов); если больше — история разбивается, баллов нет. Скилл никогда не пишет код приложения, не запускает тесты и не собирает. Последний файл, который скилл выпускает, — история со статусом `ready-for-dev`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-epics-and-stories -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/bmad-epics-and-stories/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/bmad-epics-and-stories/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-epics-and-stories -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/bmad-epics-and-stories/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-epics-and-stories -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/bmad-epics-and-stories/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install aj-geddes/claude-code-bmad-skills bmad-planning-orchestrator/skills/bmad-epics-and-stories
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/bmad-epics-and-stories/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-epics-and-stories -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/aj-geddes/claude-code-bmad-skills --path bmad-planning-orchestrator/skills/bmad-epics-and-stories
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/bmad-epics-and-stories/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add aj-geddes/claude-code-bmad-skills --skill bmad-epics-and-stories -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/aj-geddes/claude-code-bmad-skills/tree/HEAD/bmad-planning-orchestrator/skills/bmad-epics-and-stories/SKILL.md

## Когда брать
- превратить PRD в упорядоченный список эпик с зависимостями
- разбить эпик на истории размером в один день разработки
- составить историю с критериями приёма, привязанными к требованиям
- объявить явный список файлов, которые история может менять, для параллельной разработки
- проверить черновик истории на полноту и соответствие контракту

## Примеры запросов агенту
- Разбей PRD на эпики и создай истории для Claude Code
- Сверстай эпику на истории размером в один день
- Проверь историю на полноту: все ли критерии приёма и зависимости указаны

## Похожие
- [user-stories](https://affpapa.org/nevibecode/skills/user-stories.md) — скилл · 3500 установок
- [write-stories](https://affpapa.org/nevibecode/commands/write-stories.md) — команда · ★ 28211 у репозитория
- [team-backlog](https://affpapa.org/nevibecode/skills/team-backlog.md) — скилл · ★ 71 у репозитория
- [breakdown-epic-pm](https://affpapa.org/nevibecode/skills/breakdown-epic-pm.md) — скилл · 9100 установок
- [pm-spec-writing](https://affpapa.org/nevibecode/skills/pm-spec-writing.md) — скилл · 286 установок
- [deliver-user-stories](https://affpapa.org/nevibecode/skills/deliver-user-stories.md) — скилл · 1000 установок

Из того же набора: [aj-geddes/claude-code-bmad-skills](https://affpapa.org/nevibecode/by/aj-geddes/claude-code-bmad-skills.md) — 11 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
