Рабочее пространство для ИИ-агента: гид для менеджера

8 мин чтения
Stanislav Belyaev
Stanislav Belyaev Engineering Leader в Microsoft
Рабочее пространство для ИИ-агента: гид для менеджера

AI-модели в этой статье

Каждая новая сессия с ИИ-агентом начинается с одного и того же. Вот контекст проекта, вот где лежат статусы, вот кто заказчик, вот что мы уже выяснили в прошлый раз. Минут двадцать-тридцать чистого времени – на то, чтобы привести ассистента в рабочее состояние. И так при каждом входе.

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

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

Почему агент каждый раз начинается с нуля

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

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

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

Один файл, который заменяет час объяснений

В корне пространства лежит INDEX.md – карта всего, что в нём есть: каждая папка, каждый значимый файл, одна строка на объект. А сверху – таблица быстрого поиска вида «ищу X -> смотрите в Y»: где статусы, где договорённости с подрядчиком, где прошлые расследования.

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

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

Для менеджера разница с инженерной версией невелика: вместо телеметрии – статусы, протоколы созвонов, договоры и выгрузки из трекера. Формат тот же. В примере ниже ассистент соберёт вам первый INDEX из списка ваших папок.

Папка на одно расследование

Второе решение – у каждого расследования или проекта своя папка, самодостаточная для понимания. Внутри повторяется узнаваемый рисунок: README с выводами, запросы или исходные данные, материалы по ходам работы, готовые документы с датой в имени.

Про README стоит сказать отдельно. Он начинается с вывода, и уже потом – что внутри. Не «в этой папке собраны материалы по теме X», а сразу: короткая версия, что выяснилось, и какова цена вопроса. Читателю (и агенту в следующей сессии) нужен результат в первые десять секунд, оглавление подождёт.

Даты в именах файлов делают то же самое для времени: routing-change-results-2026-07-16.md – это снимок на дату, а не вечно недописанный живой документ. Когда понимание ситуации меняется, вы не переписываете старое, а выпускаете новый датированный файл. История того, как менялась картина, сохраняется сама собой.

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

Говорите агенту, что должно получиться

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

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

Собственно, всё. Инструменты здесь самые обычные, вся разница – в привычках: карта в корне, папка на задачу, явно заданная форма результата. Через месяц они становятся фоном. Проверим на практике: промпт ниже превращает хаотичный список папок в черновик INDEX.md.

Попробуйте сами
Сборка INDEX.md из списка папок: карта быстрого поиска и пометки о проблемных местах – проверьте, что модель заметит в вашем хаосе
Вы
Вот содержимое рабочей папки руководителя проекта. Помоги превратить её в организованное пространство. Что лежит в папке: - release-2026-08/ – материалы релиза августа: план, тесты, переписка - release_final/ – «финальная» версия релиза, правки после ревью - release_final_v2/ – ещё одни правки - statusy/ – еженедельные статусы для руководства, 12 файлов - intervju-kandidaty/ – протоколы собеседований, 5 человек - pretenzii-podryadchik/ – переписка с подрядчиком по срыву сроков - metriki-vypuski.csv – выгрузка метрик релиза - finalnyi-otchet-po-relizu.docx – отчёт без даты в имени - zametki-vstrechi-0409.docx – заметки со встречи 4 сентября - draft.md – черновик чего-то неясного Сделай черновик INDEX.md: 1. Таблица быстрого поиска «ищу -> где лежит»: 6–8 типовых запросов («какой сейчас статус релиза», «что обещал подрядчик», «какие метрики у релиза» и подобные). 2. Одна строка на каждую папку и файл: что это, насколько актуально. 3. Отдельным списком – проблемы, которые ты видишь: дубликаты, файлы без даты, папки с неясным содержанием. Для каждой – конкретное предложение, что сделать (слить, переименовать, заархивировать). 4. В конце – правило для будущего: одно предложение, которое напомнит поддерживать INDEX в актуальном виде.
Сравниваем:
kimi-k3 · deepseek-v4-pro

Посмотрите в ответе на третий пункт. Дубли release_final/ и release_final_v2/, отчёт без даты в имени, загадочный draft.md – агент видит это ровно так, как видел бы новый коллега, и его растерянность полезна: всё, что он пометил как неясное, станет вашим списком мест, требующих разбора.

Черновик INDEX.md собирается за десять минут. Чуть дольше ставится чуть другое умение: видеть, где агент справляется с вашими данными, а где только выглядит убедительно. В открытом модуле курса это отрабатывается на реальных задачах – тех самых, из которых состоит ваша неделя.

Первый INDEX.md у вас появится через десять минут. Дальше – 9 реальных задач менеджера, где агент работает с вашими данными так же предметно. Бесплатно.

Доступ сразу после регистрации

Начать обучение

Чего структура не заменит

Теперь о границах.

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

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

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

Пространство – первый слой работы с агентом. Второй слой – умение проверять то, что он пишет. 9 практических задач менеджера покажут оба – бесплатно.

Доступ сразу после регистрации

Начать обучение
Открытый модуль

Работа с ИИ-агентом – навык построения среды

В открытом модуле курса – 9 бесплатных уроков на реальных задачах менеджера: агент в вашем рабочем контексте, а не в учебных примерах. Фундамент добавляет систематизацию: как строить среду, проверять выводы и делегировать циклы.

9 практических задач менеджера – бесплатно
Агент учится на вашем контексте
а не на абстракциях
Разбор типовых ловушек агентной работы
Практика постановки задач с заданной формой результата

Часто задаваемые вопросы

Зачем агенту специальная структура папок, если он и так читает файлы?
Агент не помнит ничего между сессиями. Без карты рабочего пространства каждую новую сессию вы начинаете с объяснений, где что лежит. Один файл-указатель снимает этот получасовой налог: агент открывает его первым и сразу понимает, где искать.
Что писать в INDEX.md, если проектов немного?
Достаточно таблицы из двух колонок: «ищу» и «где лежит». Слева – вопросы, которые возникают в работе («статус по релизу», «претензии подрядчика»), справа – папка или файл. Плюс одно правило для себя: новая папка – новая строка в таблице.
Нужен ли менеджеру контроль версий, как инженерам?
В полном виде – нет. Но принцип стоит забрать: у документа есть датированная версия, которая не переписывается молча. Для менеджера это значит: статус-отчёт от 27 августа остаётся отчётом от 27 августа, а правки выходят новой датой. Тогда всегда видно, что изменилось и когда.
Stanislav Belyaev

Stanislav Belyaev

Engineering Leader в Microsoft

18 лет в управлении инженерными командами. Основатель mysummit.school. 700+ выпускников в Яндекс Практикуме и Стратоплане.