Сходимость конвенций между средами

Семнадцать сред, семнадцать мнений о том, где живёт конфигурация и какую форму она принимает. Задача Apothem — сделать так, чтобы рабочий процесс оператора ощущался одинаково во всех них: вы описываете конвенции один раз, и они ведут себя одинаково, обращаетесь ли вы к Claude Code, Cursor или Gemini CLI. Эта публикация охватывает две расхождения, которые примиряет Apothem: формат конфигурации и поверхность применения.

Расхождение форматов

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

Среда с плоскими .md принимает правила дословно. Среде .mdc нужен заголовок метаданных Cursor, обёрнутый вокруг каждого правила. Среде с одним файлом нужно, чтобы весь набор правил был уплощён в один документ со стабильным порядком разделов, чтобы оператор читал одни и те же конвенции в одной и той же последовательности независимо от цели. Нейтральный профиль — единственный источник истины; расхождение целиком живёт в шаге отрисовки каждого адаптера.

Порядок разделов — якорь сходимости

Уплощение множества правил в один документ рискует перетасовать их между средами, так что одни и те же конвенции окажутся в AGENTS.md в ином порядке, чем в GEMINI.md. Apothem фиксирует порядок на уровне профиля: набор правил имеет объявленную последовательность, и каждый однофайловый адаптер обходит её в этом порядке. Оператор, запомнивший в одной среде, что «конвенции именования идут перед конвенциями коммитов», находит ту же последовательность в любой другой. Сходимость — не случайность отрисовки, а свойство, которое закрепляет профиль.

Расхождение применения

Формат конфигурации — видимая половина. Более трудная половина — применение: как с конвенции спрашивают в тот момент, когда оператор (или агент) действует.

Нативные хуки PreToolUse

claude-code, codex и qwen-code открывают нативные поверхности хуков. Хук PreToolUse срабатывает прежде, чем выполнится вызов инструмента, проверяет его и блокирует или переписывает. Это применение в реальном времени: правило против записи артефактов планирования в глобальное расположение становится хуком, который отклоняет запись прежде, чем она коснётся диска. Apothem материализует эти хуки прямо в конфигурацию хуков среды, так что конвенция применяется средой выполнения.

Дисциплина на основе обёртки в остальных средах

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

Что сходимость означает на практике

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

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

Прочитайте о поверхности применения по средам в Средах и о механике адаптеров в глубоком разборе устройства адаптеров.