Рабочее пространство агента

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

Дата составления: 2026-08-29
Статус: 💡 Актуально

Доступ к файлам и доступ к папке — разные вещи

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

Навигационный файл

Агенту нужна точка входа — файл, который он читает первым и из которого понимает, как устроена папка и как здесь принято работать. Без него агент каждый раз заново угадывает, что где лежит.

  • **AGENTS.md** — открытый межвендорский стандарт: один файл, который читают агенты разных производителей. В конце 2025 года передан под управление профильного фонда при Linux Foundation — в одной связке с MCP. Логика та же: вендорская практика становится отраслевым стандартом;

  • **CLAUDE.md** — конвенция Anthropic. Практическая деталь: Claude Code читает именно CLAUDE.md, поэтому если вы держите оба файла, их следует связать — первой строкой в CLAUDE.md ставится @AGENTS.md. Так не приходится вести два документа параллельно;

  • В других интерфейсах ту же роль играет инструкция проекта: в Claude Cowork — инструкции проекта, в веб-чатах — системный промпт или инструкция ассистента.

Как писать навигационный файл: базовые правила

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

2. Держите файл коротким. Каждая его строка попадает в каждую сессию и тратит контекстное окно и внимание модели на задачах, к которым не имеет отношения. Класть в него стоит то, что материально влияет на решения агента; остальное выносить.

3. Указатели вместо копий. Вместо того чтобы переносить в навигационный файл содержимое методик и регламентов, дайте короткие ссылки на отдельные документы с пометкой, когда их читать. Агент подтянет их по делу, а не в каждой сессии. Это ровно та же логика, что у скиллов: длинные инструкции «как что-то сделать» лучше дробить на отдельные файлы, чем держать одним полотном.

4. Не заменяйте файлом порядок в папке. Навигационный файл помогает там, где содержимое уже разложено осмысленно, и не спасает там, где нет. Имена файлов, иерархия папок и даты изменения сами по себе несут для агента сигнал: файл с понятным именем в понятной подпапке будет прочитан правильно и без инструкции.

Структура рабочей папки

Универсальной схемы нет, но есть разделение слоев, которое работает почти в любой задаче:

  • Сырое — материалы как получены, не редактируются. Сюда же складывается все входящее;

  • Обработанное — нормализованное: расшифровки, конвертированные в .md документы, выжимки. То, с чем агент реально работает;

  • Выходное — то, что агент произвел: черновики, расчеты, отчеты;

  • Контекст задачи или дела — вводные по конкретному спору, проекту, контрагенту;

  • Общие инструкции — требования к оформлению документов, не привязанные к конкретной задаче.

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

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

Доступ агента к хранилищу

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

  • Разделяйте хранилища: рабочее, доступное агенту, и личное, к которому он не подключается вовсе;

  • Держите хранилище под git. Каждое изменение обратимо: если агент испортил файл, состояние восстанавливается;

  • Начинайте в режиме только для чтения. Запись включайте после того, как убедились, что агент ходит туда, куда нужно.

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

Журнал работы

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

Зачем это нужно, лучше всего объяснил участник сообщества Нейросети | ilovedocs Олег Блинов, описавший свой сетап из навигационного файла, README.md и обязательного отчета после каждой задачи: «тогда и инструкциям следует, и новую сессию нестрашно начать».

Журнал закрывает главную проблему памяти агента: следующая сессия начинается не с нуля, а с чтения того, чем закончилась предыдущая.

Связанные статьи

Дополнительные материалы

Теги: #агентный-ии #рабочее-пространство #актуальное