Как ставить задачи, чтобы вышло хорошо?

Коротко: описывайте один результат, который можно проверить. Размер (S, M, L, XL) appagent определяет сам; для L и XL он сначала показывает план и ждёт вашего «да».

Размеры задач

РазмерПримерный объёмКак работает appagent
S1–3 файла, одна областьодин мини-план, быстрые проверки
M3–15 файловмини-план лида, до трёх задач, одно ревью всего результата в конце
Lбольше 15 файлов, несколько областейплан по волнам с критикой, ваше «да», затем исполнение и ревью
XLдесятки файлов, несколько пакетовто же, но по вехам: у каждой свой план и своё «да»

Если признаки разных размеров — берётся больший. Вопросы и правку одной строки без риска appagent делает сам, без прогона: оркестровка там только дороже.

Когда нужно ваше «да»

  • план для L и XL, а также для задач с риском — всегда стоп до вашего подтверждения;
  • push, слияние, деплой, миграции и удаление данных на боевой базе — отдельное «да» на каждое действие;
  • рискованные области — платежи, вход и права, персональные данные, секреты, удаление данных, миграция схемы реальной базы, выкладка на прод: план утверждаете вы, проверки ни в чём не ослабляются.

Подробнее о защите — Безопасность.

Хорошие и плохие формулировки

Плохо:

/orch:run Улучши сайт
/orch:run Почини, не работает

Хорошо:

/orch:run Добавить экспорт заказов в CSV в админке: кнопка, эндпоинт, тесты
/orch:debug Корзина показывает старую цену после смены промокода; воспроизводится при двух промокодах подряд
/orch:plan Перенести авторизацию на новые сессии; сначала только план

Что делает формулировку хорошей:

  • результат, который видно: «кнопка, эндпоинт, тесты», а не «улучши»;
  • границы: что не трогать («без изменения API»);
  • для багов — симптом и как воспроизвести;
  • если хотите только посмотреть варианты, скажите «концепция» или «варианты на выбор»: appagent сделает дешёвый показ без полной доводки, доводка начнётся после вашего «да».

Задача неясна — лид задаст 1–3 вопроса и остановится. Какую команду выбрать — Команды.