43b60d6101
* 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>
28 lines
2.2 KiB
Markdown
28 lines
2.2 KiB
Markdown
# 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)
|