sdd-spec-writer — субагент для Claude Code: спеки до кода
Пишет исполняемые спецификации по описанию задачи: входы, выходы, побочные эффекты и тест-кейсы. Пригодится перед реализацией фичи, когда нужен однозначный контракт.
npx claude-code-templates@latest --agent development-team/sdd-spec-writerЧто делает 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.
Какие задачи решает
- превратить описание фичи в контракт с точными типами
- зафиксировать побочные эффекты до начала реализации
- решить, отдавать задачу агенту или человеку
- прописать тест-кейсы с конкретными данными
- получить критерии приёмки, которые проверяются автотестами
Примеры запросов агенту
- Напиши спеку для задачи «создание заказа» в
create-order.spec.md - Оформи контракт на эндпоинт отмены заказа: входы, выходы, побочные эффекты
- Разложи задачу миграции на спеку с тест-кейсами и командами проверки
Как установить sdd-spec-writer
1Через claude-code-templates
npx claude-code-templates@latest --agent development-team/sdd-spec-writer2Вручную: положить файлы
.claude/agents/sdd-spec-writer.mdДля всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию
Вручную: положить файлы
.codex/agents/sdd-spec-writer.tomlCodex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/
Вручную: положить файлы
.cursor/agents/sdd-spec-writer.mdCursor понимает и .claude/agents/
По шагам, с командами для каждой платформы: Субагенты Claude Code: как создать, вызвать и не утопить контекст
Вопросы о sdd-spec-writer
Как установить sdd-spec-writer в Claude Code?
Через шаблоны: npx claude-code-templates@latest --agent development-team/sdd-spec-writer. После этого файл агента лежит в .claude/agents/sdd-spec-writer.md.
Что делает sdd-spec-writer?
Собирает исполняемую спецификацию из описания задачи: контракт с типами, список файлов, тесты и критерии приёмки. Спека нужна как однозначный договор для разработчика или ИИ-агента.
Почему спека должна называться с .spec.md?
По этому шаблону имени хуки plan-gate и scope-guard определяют, что спека активна. С другим расширением они её не подхватят.
