# sdd-spec-writer

Пишет исполняемые спецификации по описанию задачи: входы, выходы, побочные эффекты и тест-кейсы. Пригодится перед реализацией фичи, когда нужен однозначный контракт.

- субагент · `type=agent` · Claude Code · 252 установки
- Автор: davila7
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/development-team/sdd-spec-writer.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/sdd-spec-writer

## Что делает

Субагент работает по методологии Spec-Driven Development. На входе — описание задачи, на выходе файл с расширением `.spec.md`, например `create-order.spec.md`. Внутри: метаданные (кто исполнитель — агент или человек, сложность, языки), цель, контекст, контракт реализации, список файлов, обязательные тесты, критерии приёмки и команды проверки.

Расширение `.spec.md` не косметика: хуки контроля качества `plan-gate` и `scope-guard` находят активные спеки именно по этому шаблону имени. Назовёте файл иначе — проверки его не увидят.

Отдельный блок инструкций решает, кому отдавать задачу. Агент берёт прикладной и инфраструктурный слой, повторяемые паттерны вроде CRUD и валидации, если сложность не выше 8 часов. Код-ревью всегда за человеком, туда же субъективный UI/UX и решения по архитектуре, которых ещё нет в документации. Языки в поддержке: C#/.NET, TypeScript, Python, Go, Rust, Java, PHP, Ruby, Kotlin, Swift.

## Установка

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

1. **Через claude-code-templates**
```bash
npx claude-code-templates@latest --agent development-team/sdd-spec-writer
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/sdd-spec-writer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/sdd-spec-writer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/sdd-spec-writer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davila7/claude-code-templates/tree/HEAD/cli-tool/components/agents/development-team/sdd-spec-writer.md

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

## Примеры запросов агенту
- Напиши спеку для задачи «создание заказа» в `create-order.spec.md`
- Оформи контракт на эндпоинт отмены заказа: входы, выходы, побочные эффекты
- Разложи задачу миграции на спеку с тест-кейсами и командами проверки

## Похожие
- [sdd-mcp](https://affpapa.org/nevibecode/mcp/sdd-mcp.md) — MCP-сервер · ★ 21
- [indexion-sdd](https://affpapa.org/nevibecode/skills/indexion-sdd.md) — скилл · 5000 установок
- [spec-driven-development](https://affpapa.org/nevibecode/mcp/spec-driven-development.md) — MCP-сервер · ★ 439
- [test-writer](https://affpapa.org/nevibecode/skills/test-writer.md) — скилл · 353 установки
- [tlc-spec-driven](https://affpapa.org/nevibecode/skills/tlc-spec-driven.md) — скилл · 1200 установок
- [spec-miner](https://affpapa.org/nevibecode/skills/spec-miner.md) — скилл · 4400 установок

Из того же набора: [davila7/claude-code-templates](https://affpapa.org/nevibecode/by/davila7/claude-code-templates.md) — 361 карточка

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