Кейсы

1. Агент сохраняет замер и ссылается на него

Ситуация. Внешний агент выполняет AF-TASK-901 «Кеш для поиска» и меряет скорость до и после. Раньше замер оставался в его сессии и терялся.

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

artifact_upload(folder: "reports/bench/", name: "latency-2026-10-05.md",
                content: "...", description: "Замер p95 /api/search до и после кеша Redis")
  → AF-ARTF-12
add_comment(slug: "AF-TASK-901", body: "[done] p95 480 → 95 мс, замер AF-ARTF-12")

Что получится. В комментарии задачи — чип AF-ARTF-12, щелчок открывает отчёт с отрисованным Markdown. У файла в «Где используется» — AF-TASK-901. Тот, кто проверяет задачу, видит доказательство, а не слова «стало быстрее».

2. Макеты от дизайнера — к задачам

Ситуация. Дизайнер нарисовал онбординг: 12 экранов в PNG и PDF с описанием потоков.

Что делает дизайнер:

1. Создаёт каталог design/onboarding/ и перетаскивает в него папку с экранами целиком.
2. Добавляет описание к PDF: «Потоки онбординга v2: регистрация, приглашение в команду, первый проект».
3. В задачах AF-TASK-120…126 нажимает «Прикрепить из Артефактория» и выбирает нужные экраны.

Что получится. У каждой задачи — свои экраны, видимые прямо из неё. Когда дизайнер выпустит правку, он загрузит файл с тем же именем и выберет «Новая версия»: ссылки в задачах не изменятся, но откроют уже новый макет, а старый останется в истории версий.

3. Лог инцидента находится через месяц

Ситуация. В октябре упала миграция на проде. Дежурный сохранил лог и вывод EXPLAIN в incidents/2026-10/ с описанием «Миграция 0042 упала по таймауту блокировки на orders». В ноябре похожее падение на другой таблице.

Что делаете вы: в Артефактории переключаете поиск на «По смыслу» и пишете «миграция упала из-за блокировки». Или спрашиваете агента: «Было ли раньше, что миграция падала из-за блокировок?»

Что получится. Октябрьский лог в первых строках выдачи, хотя ни одно слово запроса не совпадает с именем файла migration-0042.log. В «Где используется» — задача, в которой тогда чинили, с решением в комментарии [decision].

Где не подходит. Поиск идёт по имени, каталогу, описанию и тегам, но не по содержимому файла. Лог без описания поиском по смыслу не найдётся.

4. Новая версия ТЗ

Ситуация. Заказчик прислал третью редакцию ТЗ. На вторую уже ссылаются пять фич.

Что делаете вы: загружаете tz.md в тот же каталог, где лежит прежняя редакция, и в вопросе «Файл «tz.md» уже есть в каталоге» выбираете «Новая версия».

Что получится. Слаг AF-ARTF-14 тот же, все пять фич ссылаются на актуальную редакцию. В «Истории версий» видны v1, v2, v3 — каждую можно скачать. Встроенного агента можно попросить: «Сравни v2 и v3 файла AF-ARTF-14 и скажи, какие фичи затронуты» — агент прочитает обе версии, если это текстовые файлы.

5. Файлы между шагами харнесса

Ситуация. Харнесс «Выбор хранилища событий»: аналитик → два критика → судья.

Что происходит:

1. Аналитик пишет сравнение вариантов, сохраняет его через artifact_upload с harness_run_id и сдаёт шаг с result_artifact_ids: ["AF-ARTF-60"].
2. Оба критика получают AF-ARTF-60 в input_artifact_ids своего шага автоматически, читают и сохраняют свои критики — AF-ARTF-61, AF-ARTF-62.
3. Судья получает на вход все три файла.

Что получится. Файлы прогона лежат в Артефактории с источником «Прогон харнесса», у каждого в «Где используется» — прогон с видом «результат». Через полгода видно не только решение, но и на каком анализе оно стояло.

6. Уборка квоты

Ситуация. Индикатор квоты пожелтел: «Хранилище заполнено больше чем на 80%».

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

1. Сортируете таблицу по колонке «Размер» в крупных каталогах — обычно место занимают дампы и видео.
2. Смотрите «Где используется»: файлы, на которые никто не ссылается, — первые кандидаты.
3. Удаляете ненужное, затем в «Корзине» нажимаете «Удалить навсегда» — место освобождается сразу, а не через 7 дней.

Или просите встроенного агента: «Покажи 10 самых больших файлов, на которые никто не ссылается». Удалять агент будет только после вашего «Разрешить» на каждый файл.

7. Скриншот к багу

Ситуация. Тестировщик нашёл баг в вёрстке.

Что делает тестировщик: перетаскивает скриншот в каталог bugs/, описывает «Кнопка «Сохранить» уезжает за край на 375 px» и в описании задачи-бага нажимает «Прикрепить из Артефактория».

Что получится. Исполнитель видит чип с именем файла прямо в задаче, щелчок открывает скриншот с превью. Внешний агент, которому отдали задачу, получит ссылку на скачивание через artifact_download_url.