Перейти к содержимому
Источник

Про свалку отчётов от агента

Маленький лайфах по работе с агентом, к которому я уже очень привык. Добавить в gitignore какую-нибудь папку типа ai/ и в AGENTS.md оставить какие-то такие правила:

- `ai/` - директория для временных файлов агента.
    - Создавай здесь Markdown файлы для больших ответов (временная документация, анализ, отчеты).
    - Файлы называй с текущей датой и временем в начале: `YYYYMMDD_HHMM_file_name.md`
    - Перепроверяй дату с помощью `date` перед созданием файла

Теперь каждый раз, когда просишь его какой-нибудь отчёт сгенерить, он это делает в папку ai/ с упорядоченными названиями, чтобы не запутаться. Не в аутпут выплёвывает, и не с рандомными именами в корень проекта, откуда этот "мусор" потом нужно вычищать перед коммитами.

Типа такого получается:

- ai/
 - 20251104_1820_illustrations_migration.md
 - 20251106_1132_sdk_integration_analysis.md
 - 20251107_1605_identification_dependencies.md
 - 20251108_2245_webview_hooks_implementation.md
 - 20251110_1027_game_module_analysis.md

К примеру, последний был сделан по промпту "проанализируй как сейчас в проекте используется модуль game, какие у него зависимости, кажется его можно удалить".

Эти отчёты и сами по себе хороши, чтобы разобраться в каком-то вопросе по проекту. И ещё великолепно работают как промпт для следующего чистого чата с агентом. Типа, вот тебе подробные отчёты A, B и C – делай. Они не настолько важны, чтобы их в репу пушить, конечно, но при этом локально в истории остаются, чтобы ты мог память освежить. Это приятно.

Я почти уверен, что это не самый правильный подход с точки зрения процессов. Наверняка правильно завести тикет в джире, потом под это сделать отдельную ветку и там уже создавать всё что нужно только в рамках этого тикета. Но я часто совершенно не так работаю. Я параллельно генерю кучу идей и мне важно убрать все препятствия для этого. Агент может в нескольких вкладках терминала параллельно анализировать разные вопросы. И по каждому такому вопросу у меня в итоге есть артефакты, которые как минимум не мешают, а скорее помогают.

Но, кстати, хот тейк: конвеерные процессы через джиру убивают инициативность и выключают техническую фантазию. Т.е. часто чтобы кто-то сформулировал тебе полезный технический тикет в джире – нужно самому или в рамках брейншторма с командой что-то поанализировать. Вместо этого разрабы учатся действовать только в рамках тикета. А нужно оставлять в конвеере место на подумать.