Шаблон Epic → Tasks: декомпозиция, критерии приёмки, Definition of Done

Принцип: модель предлагает план, принимает его человек, исполняет детерминированный код. Шаблон — то, что должно быть заполнено до того, как задача уйдёт агенту. Поля помечены: [человек] — заполняет человек, [модель] — может предложить модель, человек правит, [код] — считает система.

Epic

epic:
  title: "Промокоды в корзине"                   # [человек] одно предложение, глагол + результат
  goal: |                                        # [человек] зачем: 2–4 предложения для планировщика
    Покупатель вводит промокод в корзине, видит скидку до оплаты.
    Коды с истёкшим сроком отклоняются с понятным текстом.
  repository: "shop/web"                         # [человек] один Epic — один репозиторий
  constraints:                                   # [человек] что нельзя трогать
    - "контракт /api/checkout не меняется"
    - "миграции только аддитивные"
  budget:                                        # [человек] лимиты, после которых — эскалация
    tokens: 2_000_000
    attempts_per_task: 3
    review_rounds_per_task: 3
  human_review_paths: ["migrations/**", ".rivet/**", "payments/**"]   # [человек] merge только кнопкой

Задача (повторить для каждой)

task:
  id: T3                                         # [код]
  title: "Эндпоинт POST /api/cart/promo"         # [модель] глагол + объект, ≤ 60 знаков
  depends_on: [T1, T2]                           # [модель] только задачи этого Epic; цикл — план отклоняется
  capabilities: [coding]                         # [модель] coding | review | deploy
  description: |                                 # [модель] что сделать, без «как»
    Принять код, проверить срок и минимальную сумму, вернуть пересчитанную корзину.
  context:                                       # [человек] что агент должен прочитать до кода
    - "docs/architecture/cart.md"
    - "src/cart/pricing.ts — правила округления"
  acceptance:                                    # [модель → человек] проверяемые утверждения, не пожелания
    - "промокод с истёкшим сроком → 422 и текст «срок действия истёк»"
    - "пустой промокод = без промокода, 200"
    - "сумма товаров ниже минимума → 422, код не применён"
    - "тесты на три случая выше — красные до кода, зелёные после"
  out_of_scope:                                  # [человек] чтобы агент не «улучшал» лишнее
    - "UI корзины"
    - "отчёт по промокодам"
  stop_and_ask_if:                               # [человек] когда печатать BLOCKED и останавливаться
    - "критерий можно понять двумя способами"
    - "нужна новая зависимость"
    - "тесты красные после двух попыток"

Definition of Done (для каждой задачи)

• [ ] Все критерии приёмки покрыты тестами, тесты запущены в этой сессии, вывод приложен
• [ ] Изменены только файлы в рамках задачи; out_of_scope не тронут
• [ ] Контракты и миграции — в рамках constraints Epic
• [ ] Ревью сделано другим агентом или человеком, замечания закрыты или вынесены в отдельную задачу
• [ ] PR описан по шаблону: что, зачем, как проверено, что не сделано
• [ ] Merge — кнопкой человека, если путь в human_review_paths; иначе — по политике проекта

Проверка плана перед запуском (человек, 5 минут)

1. Граф без циклов; у каждой задачи ≤ 3 зависимостей, иначе задача слишком крупная.
2. Критерии приёмки — проверяемые: в каждом есть вход и ожидаемый результат.
3. Контекст указан файлами, а не «посмотри в коде».
4. Есть хотя бы один пункт stop_and_ask_if — агент должен знать, когда остановиться.
5. Бюджет и лимиты попыток заданы; что происходит при их исчерпании — записано.

Автор: Владимир Павлунин — pavlunin.com · Telegram «Технический фэншуй»: t.me/techfengshui