Работа с ИИ-агентом быстро усложняется, когда вместо одного проекта появляется небольшая экосистема: продукт, маркетинговый сайт, контент, аналитика, инструкции для команды и технические утилиты. Все эти части связаны, но отвечают за разные вещи. Агенту нужен широкий контекст, чтобы понимать продукт целиком, и одновременно строгие границы, чтобы не менять лишние файлы.
Надёжная архитектура строится вокруг одной верхней папки, единого источника общего контекста, карты проектов и явных правил чтения и редактирования. Такой подход подходит для Codex и переносится на другие агентные инструменты: меняются названия файлов инструкций, но не сам принцип.
Почему отдельного репозитория часто недостаточно
Типичная проблема возникает, когда агент открывается только внутри одного репозитория. Например, задача звучит как «обновить страницу тарифа», но актуальное описание тарифа находится в продуктовой документации, правила tone of voice — в контентном проекте, а дополнительные договорённости — в соседнем документе. Агент видит только небольшой фрагмент реальности и вынужден угадывать недостающие детали.
Первая попытка исправить ситуацию часто приводит к копированию одних и тех же файлов между проектами. Брендбук появляется в папке сайта, описание продукта — в контенте, тарифы — ещё в нескольких местах. Сначала это кажется удобным: нужные сведения лежат рядом с рабочими файлами. Через некоторое время копии расходятся. В одном проекте остаётся старая цена, в другом уже записана новая, а в третьем инструкция переписана и противоречит остальным версиям.