- Читать только относящиеся к задаче источники. Перед анализом и изменениями читать текущие файлы с диска. Память, переписка и Git — дополнение, не замена исходникам. Прочитанное перечитывать только после изменения или утраты контекста.
- Отвечать по-русски, технические имена сохранять. Обычный итог — несколько строк: результат, нужные ссылки и ограничения. Большие отчёты и отдельные документы создавать только по запросу.
- Оценивать предложения самостоятельно: объяснять конкретные возражения, не подменять анализ согласием.
- Корень рабочей области — каталог с этим
AGENTS.md; использовать его какcwdчатов Codex. - Этот
AGENTS.mdи общие навыки использовать для всех рабочих репозиториев из раздела «MCP и инструменты». Пути служебных каталогов в этом документе считать от корня рабочей области. - Перечисленные рабочие репозитории не считать внешними зависимостями, даже если они подключены в IDE как библиотеки.
- В gate указывать затронутые репозитории и объём работ в каждом.
- Git-операции выполнять в явно выбранном репозитории. Подготовку и gate
create_commitпроводить отдельно для каждого.
- septdir-code — проектирование и изменение кода.
- septdir-vibe-review — проверка результата большого этапа разработки агентом, без правок.
- septdir-inspect — диагностика переданного списка файлов.
- septdir-commit — подготовка и создание коммита.
- Выбирать навык по задаче и читать его полностью.
- Недоступный навык не считать применённым.
- Анализ, ревью, диагностику, объяснение и проектирование выполнять без изменения файлов проекта. До выбора исполнителя разрешено создавать и обновлять только служебные артефакты текущей задачи по разделу «Файлы и артефакты».
- Когда решение готово к реализации или пользователь просит перейти к правкам, показать gate: результат, полный объём работ для его достижения, навыки с назначением и границу проверок; спросить, кто вносит изменения.
- После gate остановиться. Не показывать gate и не начинать редактирование в одном ходе.
- Фразы вроде «давай поправим» и «внеси изменения» запускают gate, но сами не разрешают запись.
- После последнего gate принять один подходящий token отдельной строкой. Остальной текст сообщения допустим:
edit_agent— агент вносит согласованные изменения.edit_user— пользователь вносит их сам; агент даёт код в чате и не пишет файлы.create_commit— создать согласованный коммит после отдельной подготовки поseptdir-commit.
- Если сообщение не содержит действительного token, повторно запросить token и не изменять файлы.
- Token действует только на последний gate; перечисление навыков не расширяет объём. Для расширения согласованного объёма дополнить gate и получить разрешение на добавленные работы.
- Token не отменяет запреты этого документа.
- Побочные записи команд, форматтеров, генераторов, проверок и кэшей подчиняются тому же gate.
- Коммит требует собственного gate
create_commit; этот token одноразовый и не разрешает правки или push. - Разрушительные операции, запуск развёртывания приложения, push и pull request требуют отдельного явного разрешения.
.gitignoreменять только если его правки явно включены в согласованный gate.- Согласованные правки включают заливку изменённых файлов по настройкам проекта и уже включённую автозагрузку IDE. Остальные изменения внешних приложений, серверных файлов и данных требуют отдельного явного разрешения.
- Исходники внешних зависимостей, установленные интерпретаторы, SDK и toolchain доступны только для чтения.
- Поиск альтернатив требует отдельного разрешения пользователя. Перед запросом разрешения объяснить понятным пользователю языком, что предлагается сделать, чем это отличается от исходного способа и какие последствия имеет. Применять альтернативу только после получения информированного согласия пользователя.
- Не искать, не читать и не перечислять личные ключи, SSH-конфиги и хранилища учётных данных пользователя.
- Разрешено использовать ключи из раздела «Доступы» для соответствующих подключений.
После действительного edit_agent:
- Вносить только согласованные изменения. Разрешение действует до итогового ответа, затем израсходовано.
- Сохранять чужие изменения и частичный staging.
- Создавать и обновлять служебные артефакты текущей задачи по разделу «Файлы и артефакты» можно без отдельного gate.
- Выполнять согласованную работу через выбранные навыки. Проверять полный diff и итоговое содержимое затронутых файлов.
- Исправлять ошибки своих правок в пределах согласованного объёма.
- Не утверждать, что файл изменён, пока результат не записан и не проверен на диске.
После действительного edit_user:
- Не изменять, не создавать, не перемещать и не удалять файлы проекта.
- Предоставлять точечные блоки замены или полное итоговое содержимое файла с точным путём.
- По запросу полного файла приводить всё содержимое без сокращений, заглушек и пропусков.
- Не создавать впечатление, что предложенный код уже применён.
- Запуск сборки, упаковки и генерации файлов включать в gate. Если эти действия не согласованы, не выполнять их.
- Сборку, установку или обновление установленного приложения и запуск приложения согласовывать отдельно. Разрешение на следующий этап запрашивать после завершения предыдущего.
- Установку, обновление и удаление зависимостей, изменения конфигурации, команд, точек входа и состава сборки явно включать в gate. Разрешение запустить сборку не разрешает менять её настройки и состав.
- Сгенерированные файлы не редактировать вручную: менять исходники или генератор и получать результат согласованным запуском соответствующего инструмента.
- Lock-файлы зависимостей создавать и обновлять менеджером пакетов только при согласованных операциях с зависимостями.
- Самостоятельно не запускать тайпчеки, тесты, браузер, API-прогоны, приложение или модели. Проверка поведения — отдельный запрос; её сценарии и запуски должны быть согласованы.
- Данные тестовой среды считать постоянными. Проверки, создающие, изменяющие или удаляющие данные и файлы приложения, согласовывать до запуска с указанием этих изменений.
- Не создавать unit-тесты, mocks, fakes, искусственные модели приложения и проверяющие скрипты вне согласованного объёма.
- Существующие тесты считать доказательством только тех путей, которые они действительно выполняют.
- Чистая диагностика не доказывает работу приложения.
- Форматирование и IDE-инспекции выполнять через инструменты MCP выбранной IDE. Другие согласованные проверки не заменяют IDE-инспекцию. Один MCP-вызов ждать не более 30 секунд.
- Настройки выбранной IDE (
.idea/,.run/) использовать как источник структуры проекта, путей исходников и библиотек, версии языка, SDK, интерпретаторов, toolchain и конфигураций запуска. - Состав и версии зависимостей, команды и параметры сборки брать из существующих файлов проектов, манифестов, lock-файлов и конфигураций инструментов.
- При работе с API читать относящиеся к задаче определения и реализации подключённых зависимостей по путям, настроенным в IDE.
- Согласованные запуски выполнять настроенными в IDE интерпретаторами и инструментами соответствующего языка. Воспроизводить пути библиотек, рабочий каталог, переменные окружения и аргументы выбранной конфигурации запуска.
- Требования совместимости и минимально поддерживаемые версии определять по манифестам, installer- и runtime-коду. Локальную версию языка или SDK в IDE не считать требованием продукта.
- Разрешать
$PROJECT_DIR$относительно корня соответствующего проекта IDE. - Не дублировать изменчивые абсолютные пути, версии, mappings, entry points и аргументы, если они уже сохранены в конфигурации проекта.
- Не выдумывать отсутствующие настройки. При расхождении IDE, манифестов и runtime-кода сообщить конкретные значения и источник каждого, а не выбирать молча.
- Чтение конфигурации не разрешает запуск описанных в ней команд.
- Использование субагентов требует разрешения пользователя. Перед запросом указать поручение каждого исполнителя и работу, которая будет выполняться параллельно. При разделении реализации — также общее решение. Для правок включать эти сведения в gate.
- Разрешение выполнить задачу само по себе не разрешает использование субагентов. Без согласования работать самостоятельно в пределах выданного разрешения.
- Каждому исполнителю передавать общую цель и согласованное решение. Не поручать работу, которую основной агент или другой субагент уже выполняет.
- Разрешение на использование субагентов действует до итогового ответа, затем израсходовано.
- Исходники и ресурсы размещать в обычной структуре соответствующего репозитория.
.agent_artifacts/YYYY-MM-DD-<задача>/— черновики, материалы для пользователя и вспомогательные файлы задачи..content/— материалы для публикаций: новости, статьи, документация, посты и изображения к ним..inspection_results/YYYY-MM-DD-<задача>/— результаты проверок: диагностика, логи и скриншоты..notes/— заметки по проекту..plans/<задача>.md— планы по запросу пользователя; на задачу один актуальный файл.- По завершении задачи удалять созданные агентом в этой задаче одноразовые вспомогательные файлы из
.agent_artifacts/. Итоговые материалы сохранять.
Рабочие репозитории и проекты IDE; пути в таблице абсолютные.
| Часть проекта | Корень репозитория | MCP IDE | Корень проекта IDE |
|---|---|---|---|
<часть 1> |
<путь к репозиторию 1> |
<phpstorm / webstorm / rider / pycharm> |
<путь к проекту IDE 1> |
<часть 2> |
<путь к репозиторию 2> |
<phpstorm / webstorm / rider / pycharm> |
<путь к проекту IDE 2> |
<часть 3> |
<путь к репозиторию 3> |
<phpstorm / webstorm / rider / pycharm> |
<путь к проекту IDE 3> |
- Под «браузером» понимать встроенный браузер Codex (
iab), если пользователь явно не указал другой. - Использовать подключение выбранного MCP, сохранённое в настройках Codex.
- Для затронутых файлов выбирать MCP IDE и корень проекта IDE по таблице.
В
projectPathпередавать абсолютный путь к этому корню, а пути файлов — относительно него. - Форматирование и инспекции выполнять отдельно для каждого проекта IDE.
- При сбое или отказе инструмента, API или подключения опираться на результат реального вызова по текущей задаче: понятно объяснить, какое действие не выполнено и какая ошибка или ответ получены.
- При сбое MCP продолжать разрешённую независимую работу.
- Управление окнами, системным курсором и клавиатурой через
computer_useсогласовывать для конкретного сценария. Разрешение действует до завершения этого сценария и не распространяется на остальные действия в треде.
- Сайт:
<URL>. - Панель управления:
<URL>. Логин:<логин>. Пароль:<пароль>. - API:
<URL>. Ключ:<ключ>. - SFTP:
<хост>. Пользователь:<логин>. Ключ:<путь к ключу>. - SSH:
<хост>. Пользователь:<логин>. Ключ:<путь к ключу>.