# spec-driven

Плагин spec-driven ведёт фичу через три фазы: требования в нотации EARS, дизайн и список задач. Дальше реализацию выполняет агент.

- плагин · `type=plugin` · Claude Code, Codex · ★ 1596 у репозитория
- Автор: habib0x
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/hashgraph-online/awesome-codex-plugins/tree/HEAD/plugins/Habib0x0/spec-driven-plugin
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст и 1 файл скриптов) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/plugins/spec-driven

## Что делает

Плагин превращает идею фичи в формальную спеку до первой строки кода. Команда `/spec <name>` создаёт каталог `.claude/specs/<name>/` с тремя файлами: `requirements.md` (истории с критериями приёмки в нотации EARS), `design.md` (архитектура и план работ) и `tasks.md` (задачи со статусом, проверкой и зависимостями). Требования собираются за пару раундов вопросов.

Реализация идёт из скриптов в каталоге `scripts/`. `bash scripts/spec-exec.sh --spec-name <name>` делает одну итерацию, `spec-loop.sh` крутит цикл до исчерпания `--max-iterations`. Перед каждой итерацией loop ставит checkpoint-коммит: если агент упал с ненулевым кодом, ветка откатывается к последнему чекпоинту. Спеки ссылаются друг на друга через раздел `## Depends On` в `requirements.md`, и скрипт не начнёт работу, пока у зависимостей не проверены все задачи.

В Codex те же команды вызываются с `$` вместо `/`, а корень спек задаётся переменной `SPEC_ROOT`; каталог `.codex/specs/` читается как запасной вариант при переезде. После реализации есть необязательный хвост: `spec-accept.sh` для приёмки, `spec-docs.sh`, `spec-release.sh` и `spec-verify.sh` с `--url` для смоук-тестов. Последний отдаёт `0` при успехе и `1` при провале, поэтому его ставят в CI обычным шагом.

## Установка

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

**Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add hashgraph-online/awesome-codex-plugins
```
В чате агента (не в терминале):
```text
/plugin install spec-driven@awesome-codex-plugins
```

## Когда брать
- Разложить идею фичи на требования, дизайн и задачи до начала кодинга
- Записать критерии приёмки в нотации EARS, чтобы каждый можно было проверить
- Прогнать автономный цикл реализации с откатом к чекпоинту при падении агента
- Связать спеки зависимостями и не запускать работу раньше времени
- Встроить смоук-тесты после деплоя в CI по коду выхода

## Примеры запросов агенту
- Запусти `/spec user-authentication` и проведи меня по трём фазам
- Крути `/spec-loop`, пока все задачи в `tasks.md` не закроются
- Покажи `/spec-status`: что готово и какие зависимости мешают

## Похожие
- [tlc-spec-driven](https://affpapa.org/nevibecode/skills/tlc-spec-driven.md) — скилл · 1300 установок
- [ns-spec-driven](https://affpapa.org/nevibecode/skills/ns-spec-driven.md) — скилл · 208 установок
- [spec-driven-workflow-v1](https://affpapa.org/nevibecode/rules/spec-driven-workflow-v1.md) — правило · ★ 41430 у репозитория
- [spec-driven-workflow](https://affpapa.org/nevibecode/skills/spec-driven-workflow.md) — скилл · 600 установок
- [mcp-server-spec-driven-development](https://affpapa.org/nevibecode/skills/mcp-server-spec-driven-development.md) — скилл · 175 установок
- [spec-driven-development](https://affpapa.org/nevibecode/mcp/spec-driven-development.md) — MCP-сервер · ★ 441 у репозитория

Из того же набора: [hashgraph-online/awesome-codex-plugins](https://affpapa.org/nevibecode/by/hashgraph-online/awesome-codex-plugins.md) — 391 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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