Справочник · learn-se

Чек-лист: постановка задачи агенту

Пять блоков хорошей спеки. Не каждой задаче нужны все пять — но пропуск должен быть осознанным.

#	Блок	Вопрос, на который отвечает
1	Контекст	Где в продукте это живёт и зачем пользователю? Одно-два предложения.
2	Поведение (Given/When/Then)	Что наблюдаемо меняется? Сначала happy path, затем edge cases.
3	Границы (scope)	Что явно НЕ входит? Что не трогать?
4	Acceptance criteria	По какому списку наблюдаемых фактов агент проверит себя сам?
5	Свобода реализации	Что агент решает сам? (По умолчанию — всё, что не в пунктах 2–4.)

Шаблон

Контекст: [где и зачем]

Поведение:
- Given [состояние], when [действие], then [наблюдаемый результат]
- Given [edge case], when [действие], then [что должно произойти]

Не входит: [out of scope, что не трогать]

Критерии приёмки:
- [ ] [проверяемый факт 1]
- [ ] [проверяемый факт 2]

Реализацию (файлы, подход) выбери сам. Если видишь
противоречие или пробел в сценариях — спроси до начала.

Быстрая самопроверка спеки

Симптом	Диагноз
В спеке есть имена файлов, хуков, библиотек	Ты пишешь implementation, а не spec. Убери — или осознай, зачем ограничиваешь.
Результат нельзя проверить, не читая код	Критерий не наблюдаемый. Переформулируй через поведение.
Один сценарий, нет edge cases	Спека описывает только happy path — жди итераций. Спроси себя: пусто? ноль? повторное нажатие? нет сети?
Нет «не входит»	Агент может унести задачу в попутный рефакторинг.
Спека длиннее будущего диффа	Overkill: для микро-правок хватит одного предложения с наблюдаемым результатом.