---
pr: 172
title: feat(feature-spec): add SDD-style Q&A skill for feature planning
---

## Что сделано

- `.opencode/commands/feature-spec.md` — slash-команда `/feature-spec` (pattern как spec.md, run-pipeline.md)
- `.opencode/skills/feature-spec/SKILL.md` — скилл с:
  - SDD-шаблон (7 секций, совпадает с create-issue validation)
  - Инструкции Q&A: агент задает вопросы списком, не гадает
  - Decision criteria: когда feature-spec нужен (2+ компонента, бизнес-правила, diff >400 строк), когда нет (1 файл — прямой чат)
  - Handoff: план в чате → юзер говорит "создай issue" → issue скилл → /run-pipeline

## Почему

При реализации фич через прямой чат агент часто не получает результат с первого промпта — нет зафиксированных контрактов, граничных случаев, out-of-scope. Feature-spec — лёгкий скилл: Q&A по SDD-шаблону → план в чате → issue через `issue` скилл → `/run-pipeline`. Не требует oracle-скрипта, файлов спеки или создания issues.

## Pending

- Обновить AGENTS.md если нужно упомянуть feature-spec в pipeline или workflow
- Добавить feature-spec в README репозитория (если применимо)
- Мониторить использование: действительно ли Q&A улучшает результаты с первого промпта

## Watch out

- Feature-spec НЕ создаёт issues — только планирует. Юзер должен сказать "создай issue"
- Feature-spec НЕ запускает /run-pipeline — юзер делает это сам
- SDD-шаблон должен совпадать с 7 секциями create-issue validation (PR #169)
- Если фича простая (1 файл) — агент должен сказать что спека не нужна
- Нет oracle-скрипта — это Q&A, не детерминистичный процесс как /spec