# ADR-072: Feature-spec skill — SDD-style Q&A for feature planning

## Статус

Accepted (PR #172)

## Контекст

При реализации фич через прямой чат агент часто не получает результат с первого промпта. Причины: нет зафиксированных контрактов, граничных случаев, out-of-scope. Агент угадывает решения вместо того, чтобы спросить.

Существующий `/spec` скилл (9 фаз, 7 файлов) — для новых проектов, слишком тяжёл для feature-level работы. После PR #169 `create-issue` tool валидирует 7 SDD-секций. Нужен лёгкий скилл, который через Q&A вырабатывает план фичи по SDD-шаблону.

## Решение

Создан `feature-spec` скилл — лёгкая SDD-дисциплина для feature-level работы:
- Slash-команда `/feature-spec` загружает скилл
- Скилл направляет Q&A: агент задает вопросы по 7 SDD-секциям, не гадает
- План остаётся в чате (без файлов спеки)
- После Q&A юзер говорит "создай issue" → issue через `issue` скилл + `create-issue` tool (7 секций)
- Затем `/run-pipeline` реализует

Decision criteria: feature-spec нужен когда 2+ компонента, бизнес-правила, diff >400 строк. Не нужен для 1 файла или простых правок.

## Альтернативы

1. **Обогатить `issue` скилл SDD-секциями** — но issue скилл фокусируется на создании issues, а не на Q&A-планировании
2. **Добавить "feature mode" в `/spec`** — усложнило бы существующий 9-фазный скилл
3. **Два режима в create-issue (sdd flag)** — отвергнуто в пользу единого 7-секционного стандарта (PR #169)