Руками в папке проекта ничего не трогаем: гигиена рабочего места агента

Коротко

Что ломается, когда ты переименовываешь файл руками?

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

Объясняю дословно так, как объясняю на занятиях: если ты вручную здесь что-то наделаешь, то в следующий раз, когда он пойдёт, он эти связи потеряет. Поэтому лучше вообще в этой папке вручную ничего не делать.

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

Хуже всего, что ошибка тихая. Агент не скажет «ты переименовал папку». Он просто начнёт создавать файлы в новых местах и путаться в ссылках.

Почему агент не замечает файл, который ты положил сам?

Это второе место, где ломается интуиция. Человек думает: раз файл в папке проекта, агент его видит. Не видит.

Правильный порядок - две реплики вместо одной:

1. «Изучи файл с брифом, который я положил в папку с материалами, и пропиши его там, где это нужно».
2. «Проверь, пожалуйста: ты всё учитываешь?»

Вторая реплика - не паранойя. На занятиях участники задают её почти дословно, и в половине случаев выясняется, что учтено не всё: файл прочитан, но в служебное описание проекта не попал, а значит в следующей сессии его снова не будет.

Механика тут та же, что у второго мозга проекта: агент опирается на описание, а не на содержимое диска. Что именно писать в этом описании, я разбирал в материале про файл-память агента.

Граница: руками или через агента

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

Отдельно про облачные папки. Если проект лежит в синхронизируемой папке, добавляется третий участник, который тоже переименовывает и переносит файлы без спроса. Для проектов это плохо: лучше держать рабочую папку локально, а в облако выкладывать результаты.

Как правильно добавить свои материалы в проект?

1. Положи файл в подпапку с материалами

   Не в корень проекта. Одна папка под входящие документы, и в ней порядок понятен тебе, а не только агенту.

2. Назови файл понятно и латиницей

   Пробелы и длинные русские названия иногда доставляют проблемы при обращении к файлу. Короткое имя без пробелов надёжнее.

3. Скажи агенту, что появилось и зачем

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

4. Попроси внести в описание проекта и проверь

   «Пропиши это в файле правил проекта». Потом: «перечисли, что ты сейчас видишь». Файл должен быть в списке.

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

Один проект - одна папка, а не десять чатов

Один участник обучения сформулировал своё открытие так: я просто заводил тут чаты, а тут нужно наоборот - создавать каждый раз папку, а потом уже в этой папке заводить чат. Это ровно та развилка, которую стоит пройти пораньше.

Разница в трёх вещах:

• Память. В папке живут правила проекта и история решений. В чате - только текущий разговор.
• Материалы. В папке лежат исходники: брифы, выгрузки, документы. В чат их приходится загружать заново каждый раз.
• Результат. В папке результат накапливается файлами. В чате он рассыпается по сообщениям, и через неделю ты его не найдёшь.

Это часть более общего подхода, который я называю сборкой контекста для агента. Подробно разбирал его в материале про контекст-инжиниринг.

Что делать, если уже наломал?

Порядок восстановления:

1. Скажи честно, что менял. «Я переименовал папку с документами и перенёс два файла, вот новые имена».
2. Попроси сверку. «Пройди по служебным файлам, найди ссылки на старые пути и приведи их в порядок».
3. Попроси карту. «Опиши текущую структуру проекта коротко, чтобы я видел, что ты видишь».
4. Проверь на маленькой задаче. Не на важной: убедись, что агент попадает в нужные файлы.

И последнее наблюдение. Желание «навести порядок руками» обычно возникает от тревоги: человеку кажется, что в папке хаос, потому что он в ней не разбирается. Правильная реакция - попросить агента объяснить структуру, а не переделывать её под свою привычку.

Тревога эта, кстати, предсказуемая: она приходит сразу после того, как первые задачи начали получаться. Человек перестаёт бояться, что сломает, и начинает бояться, что организовал всё неправильно. На обучениях это звучит как «правильно ли я всё настроил». Ответ обычно один: структура нормальная, просто ты её не читал.

Здесь же лежит и вторая причина беспорядка - привычка держать рабочие файлы там, где привык их искать: на рабочем столе, в загрузках, в переписке. Проект от этого не ломается сразу, но через месяц ты не сможешь сказать, какая версия документа настоящая, а агент будет читать ту, которую ему один раз показали. Проще с самого начала считать папку проекта единственным местом, где живут материалы, и не держать вторых копий. Как понять, что контекст пора чистить и переносить в новый чат, разбирал в материале про гигиену контекстного окна.

Частые вопросы

Главный вывод

Вся статья сводится к одной картинке. Ты нанял исполнителя, который держит карту офиса в голове. Переставил мебель ночью - утром он ищет стол на прежнем месте.

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

Начни с простого: попроси агента перечислить материалы проекта. Если в списке не хватает половины того, что лежит в папке, ты нашёл причину его странных ответов.