Как ставить задачи, чтобы вышло хорошо?
Коротко: описывайте один результат, который можно проверить. Размер (S, M, L, XL) appagent определяет сам; для L и XL он сначала показывает план и ждёт вашего «да».
Размеры задач
| Размер | Примерный объём | Как работает appagent |
|---|---|---|
| S | 1–3 файла, одна область | один мини-план, быстрые проверки |
| M | 3–15 файлов | мини-план лида, до трёх задач, одно ревью всего результата в конце |
| L | больше 15 файлов, несколько областей | план по волнам с критикой, ваше «да», затем исполнение и ревью |
| XL | десятки файлов, несколько пакетов | то же, но по вехам: у каждой свой план и своё «да» |
Если признаки разных размеров — берётся больший. Вопросы и правку одной строки без риска appagent делает сам, без прогона: оркестровка там только дороже.
Когда нужно ваше «да»
- план для L и XL, а также для задач с риском — всегда стоп до вашего подтверждения;
- push, слияние, деплой, миграции и удаление данных на боевой базе — отдельное «да» на каждое действие;
- рискованные области — платежи, вход и права, персональные данные, секреты, удаление данных, миграция схемы реальной базы, выкладка на прод: план утверждаете вы, проверки ни в чём не ослабляются.
Подробнее о защите — Безопасность.
Хорошие и плохие формулировки
Плохо:
/orch:run Улучши сайт
/orch:run Почини, не работает
Хорошо:
/orch:run Добавить экспорт заказов в CSV в админке: кнопка, эндпоинт, тесты
/orch:debug Корзина показывает старую цену после смены промокода; воспроизводится при двух промокодах подряд
/orch:plan Перенести авторизацию на новые сессии; сначала только план
Что делает формулировку хорошей:
- результат, который видно: «кнопка, эндпоинт, тесты», а не «улучши»;
- границы: что не трогать («без изменения API»);
- для багов — симптом и как воспроизвести;
- если хотите только посмотреть варианты, скажите «концепция» или «варианты на выбор»: appagent сделает дешёвый показ без полной доводки, доводка начнётся после вашего «да».
Задача неясна — лид задаст 1–3 вопроса и остановится. Какую команду выбрать — Команды.