Кейсы

Каждый кейс — целиком: с чем вы приходите, что пишете, что агент делает в проекте и что получается. И где кейс не подходит.

1. От замысла до дерева задач

Ситуация. Есть идея фичи в двух абзацах, хочется получить план, по которому можно начинать, а не раскладывать его вручную.

Что вы пишете:

/plan-feature Экспорт отчётов в CSV и XLSX. Пользователь выбирает период и колонки,
файл собирается в фоне, по готовности приходит уведомление. Ограничение — 100 000 строк.

Что делает агент:

1. Ищет по смыслу похожее в проекте — нет ли уже фичи про экспорт, какие компоненты затронуты, какие решения принимались раньше.
2. Если чего-то не хватает, спрашивает карточкой: «Уведомление — в приложении или по почте?» с вариантами ответа.
3. Показывает план в чате: фича, 2–3 плана, задачи с критериями приёмки, зависимости.
4. После вашего «создавай» заводит в дереве фичу, планы и задачи, пишет спеку фичи, привязывает всё к компонентам, ставит зависимости.
5. В блоке «Что сделано» — ссылки на всё созданное.

Что получится. Фича AF-FEAT-31 с деревом задач, у каждой задачи описание и критерии приёмки, порядок задан зависимостями. Дальше задачи можно отдать внешнему агенту: /execute-task AF-PLAN-40.

Где не подходит. Агент не видит ваш код, поэтому оценка «какие файлы трогать» в задачах будет общей. Если важна точная привязка к коду, пусть внешний агент уточнит задачи по репозиторию перед выполнением.

2. Вопрос о проекте

Ситуация. Вы вернулись из отпуска или пришли в проект новым человеком.

Что вы пишете:

Что сейчас в работе по биллингу и что заблокировано? Почему мы отказались от Stripe?

Что делает агент: ищет по смыслу в нодах, комментариях [decision] и документах, читает найденные задачи и их зависимости.

Что получится. Ответ из двух частей: список задач в работе и заблокированных — с чипами-слагами и тем, кто чем блокирован; и объяснение решения со ссылкой на комментарий или документ, где оно записано. Агент не выдумывает: если решение нигде не записано, он так и скажет.

Где не подходит. Агент знает только то, что записано в проекте. Устные договорённости и то, что живёт лишь в коде, ему неизвестны.

3. Изменение через спеку

Ситуация. Проект в строгом spec-режиме, нужно поменять поведение: лимит экспорта вырос со 100 000 до 1 000 000 строк.

Что вы пишете:

/spec-first-change Лимит экспорта отчётов теперь 1 000 000 строк вместо 100 000.

Что делает агент:

1. Находит документ-спеку экспорта и требование о лимите.
2. Готовит дельту к спеке: что меняется и почему. Проверяет её формат.
3. Отправляет дельту на одобрение и останавливается: одобрить её может только человек.
4. Пишет вам: «Дельта … ждёт одобрения. После одобрения скажите — заведу задачу».
5. После вашего одобрения в интерфейсе и «продолжай» заводит задачу, связанную с дельтой. Применение дельты к спеке агент тоже сделает только после «Разрешить» в карточке подтверждения.

Что получится. Спека и задача, которые не разошлись: задачу нельзя закрыть, пока дельта не применена. Подробнее о режиме — Строгий режим.

4. ТЗ из файла — в задачи

Ситуация. Заказчик прислал ТЗ в Markdown на 15 страниц.

Что вы делаете:

1. Загружаете tz-v3.md в Артефакторий — он получает слаг AF-ARTF-14.
2. Пишете агенту:

Прочитай AF-ARTF-14 и разложи раздел «Личный кабинет» на фичи и задачи. Остальное пока не трогай.

Что делает агент: читает файл целиком (текстовые файлы до 1 МБ), выделяет раздел, сверяет с тем, что уже есть в дереве, показывает план, а после подтверждения создаёт фичи и задачи. В описании каждой фичи — ссылка на AF-ARTF-14, поэтому у файла в Артефактории в «Где используется» появятся эти фичи.

Где не подходит. ТЗ в PDF или DOCX агент прочитать не может — это двоичные файлы. Сохраните текст в .md или .txt и загрузите его.

5. Уборка трекера

Ситуация. За полгода в дереве накопились дубли, задачи без компонентов и заброшенные черновики.

Что вы пишете:

Найди в эпике AF-EPIC-5 задачи без компонентов и дубли. Покажи список, ничего не меняй.

Что делает агент: читает поддерево, ищет похожие задачи по смыслу, показывает таблицу: «дубль чего», «предлагаемый компонент», «почему».

Дальше вы решаете по пунктам: «Привяжи компоненты как предложил, дубли 3 и 5 свяжи связью duplicates и переведи в отменённые». Агент делает это; если вы попросите удалить, каждое удаление придёт карточкой «Нужно подтверждение».

Что получится. Чистое поддерево и комментарии агента у изменённых задач — видно, кто, что и почему поменял. В журнале действий изменения подписаны «Flownix Agent».

6. Проверка выполненной задачи

Ситуация. Внешний агент закончил AF-TASK-77 и перевёл её в «тестирование».

Что вы пишете:

/review-work AF-TASK-77

Что делает агент: читает задачу, критерии приёмки и комментарии исполнителя ([progress], [decision], [done]), сверяет одно с другим по пунктам, смотрит, применена ли дельта к спеке.

Что получится. Вердикт по каждому критерию приёмки в комментарии к задаче и новый статус: «выполнено», если всё сходится, или «регрессия» с перечнем того, что не так.

Где не подходит. Встроенный агент не видит код и не запускает тесты, поэтому проверяет только то, что записано в задаче: полноту отчёта исполнителя и соответствие критериям. Ревью кода — работа внешнего агента: Ревью.

7. Отчёт в Артефакторий

Ситуация. Нужна сводка по релизу для команды.

Что вы пишете:

Собери сводку по задачам, закрытым в релизе 0.31: что сделано, что перенесено и почему.
Сохрани в Артефакторий в reports/releases/.

Что делает агент: собирает данные, пишет Markdown-отчёт и сохраняет его с описанием — файл получает слаг, например AF-ARTF-52, и находится поиском по смыслу. Если файл с таким именем уже есть, агент спросит, создать ли новую версию.

Что получится. Отчёт, на который можно сослаться слагом из любой задачи или документа.

8. Собрать совет агентов

Ситуация. Предстоит архитектурное решение, по которому хочется услышать несколько независимых мнений.

Что вы пишете:

/harness-blueprint Нужен совет для выбора хранилища событий: архитектор, специалист по
надёжности и скептик, итог — судья.

Что делает агент: проводит короткое интервью (роли, бюджет, когда нужен человек), собирает харнесс и показывает его.

Что получится. Готовый харнесс в проекте. Запускаете его вы — с экрана Harness или через внешнего агента со скиллом /run-harness. Встроенный агент сам совет не запускает и в нём не участвует. Подробнее — Harness.

Как формулировать просьбы

• Называйте объект слагом. AF-FEAT-12 надёжнее, чем «та фича».
• Разделяйте «покажи» и «сделай». «Покажи план, ничего не создавай» — агент только ответит. «Создавай» — агент поменяет трекер.
• Задавайте границы. «Только раздел 3», «только в эпике AF-EPIC-5» — меньше лишних действий и кредитов.
• Отвечайте на вопросы агента. Карточка с вариантами — не формальность: агент спрашивает там, где мог бы ошибиться.