Зачем агенту порядок в папках

У агента в IDE нет памяти между сессиями. Есть файлы, которые он может открыть, и правила, которые ему сказали прочитать. Всё остальное для него не существует.

Вы час обсуждали с агентом структуру коммерческого предложения: какие блоки, в каком порядке, как считать цену. Получили отличный документ. Через неделю просите «сделай КП для новой компании» - и получаете другой документ. Другие блоки, другой тон, другая логика цены. Агент ничего не забыл, ему просто неоткуда было вспомнить: методология осталась в чате.

То же самое, если методология всё-таки записана, но лежит в случайной папке. Downloads/новая папка 3/кп_финал_2.md агент не найдёт. Он посмотрит в корень проекта, не увидит ничего похожего и придумает заново. Каждый раз по-разному.

Агент ищет по файлам, а не по памяти. Чего нет в папке, на которую он смотрит, того для него нет вообще.

Вторая проблема: утечки между клиентами

Первая проблема стоит времени. Вторая стоит репутации.

Допустим, в одной папке лежат: шаблон КП, готовое КП для компании А (с их реквизитами, суммами и цитатами из созвона), и заметки по компании Б. Вы просите агента сделать КП для Б. Он ищет «пример хорошего КП», находит документ для А и берёт его за основу. В результате у Б в тексте оказываются суммы А, а то и фраза «как вы говорили на встрече» с чужой цитатой.

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

Порядок в папках - это память и безопасность

Обе проблемы решаются одним и тем же: раскладкой воркспейса (общей папки, где живут все ваши проекты и материалы) по понятным местам, плюс файлом правил, который говорит агенту, куда смотреть.

• Память. Методология лежит в известном месте, файл правил на неё ссылается. Агент открывает её каждый раз, а не изобретает.
• Безопасность. Данные каждого клиента в своей папке, шаблоны отдельно. Правило «чужое не брать» записано, а не подразумевается.
• Скорость. Вы сами находите нужное за десять секунд, а не за десять минут поиска по «финал_2».

Файл правил в курсе будем называть AGENTS.md / CLAUDE.md. Это одна сущность: текстовый файл в корне папки, который агент читает первым. В Claude Code тот же файл называется CLAUDE.md, в других инструментах - AGENTS.md. Подробно про него - в курсе AGENTS.md и CLAUDE.md.

Три уровня

Весь курс держится на одной идее: любой файл в воркспейсе принадлежит одному из трёх уровней.

Если вы посмотрели на файл и не можете сразу сказать, к какому уровню он относится, это сигнал: либо файл лежит не там, либо в нём смешаны два уровня (например, шаблон с вписанными реквизитами клиента).

Что дальше

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