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

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

* docs(pr-172): add handoff, ADR-072, update project-map

---------

Co-authored-by: opencode-agent <agent@opencode.local>

2026-07-31 19:58:12 +03:00

2.2 KiB

Raw Permalink Blame History

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 файла или простых правок.

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

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

2.2 KiB Raw Permalink Blame History Unescape Escape