Архитектура исполнителей

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

Apothem читает один общий профиль (~/.config/apothem/profile.yaml) и материализует конфигурацию, нативную для окружения, для семнадцати зарегистрированных адаптеров. Окружения не разделяют общую модель возможностей делегированных исполнителей: одни предоставляют хуки перед вызовом инструмента, другие исполняют правила из плоских файлов .md, третьи встраивают каждое правило в единый файл инструкций, а некоторые рендерят конфигурацию на основе профиля во время установки. Эта страница описывает это расхождение и дисциплину, которую Apothem применяет поверх него.

Матрица возможностей делегированных исполнителей по окружениямCopy Anchor Link

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

Примечания к матрице:

• claude-code — адаптер с самой широкой нативной поверхностью. Он несёт нативные хуки PreToolUse, PostToolUse, Stop и SessionStart и поставляет шаблоны настроек вендора. Он записывает один управляемый блок, ограниченный служебными маркерами, в CLAUDE.md и оставляет прозу оператора за пределами маркеров без изменений.
• codex устанавливает нативные хуки жизненного цикла через hooks.json, преобразует исполнителей в TOML, оборачивает командные промпты как навыки Codex и оставляет config.toml во владении оператора.
• antigravity сохраняет ~/.gemini/GEMINI.md как глобальный якорь контекста и устанавливает плагин Apothem в ~/.gemini/antigravity-cli/plugins/apothem/. Файлы хуков сохраняются как вспомогательный материал, пока адаптер не начнёт сам вести преобразование схемы хуков Antigravity.
• cursor активирует правила через один файл .mdc, который несёт фронтматтер MDC вендора (description, globs, alwaysApply); адаптер не записывает единый файл .cursorrules.
• windsurf использует .devin/rules/; адаптер не записывает единый файл .windsurfrules.
• hermes и open-claw рендерят нативные файлы конфигурации и подключают каталоги навыков Apothem через настройку каталога навыков, задокументированную в каждом окружении. Неподдерживаемые общие группы остаются в поддеревьях поддержки, принадлежащих Apothem.
• qwen-code рендерит задокументированные ключи settings.json для контекста и диспетчеризации хуков, затем использует нативные для Qwen каталоги команд, навыков и исполнителей.

Дисциплина межсредовой оркестрацииCopy Anchor Link

Apothem применяет конвергенцию по соглашениям соседних элементов: один и тот же вызываемый оператором рабочий процесс проецируется в нативную идиому каждого окружения, а не принудительно приводится к одному общему формату. Правило, которое активируется как плоский файл .md под claude-code, становится правилом рабочей области .mdc под cursor, встроенным разделом GEMINI.md под gemini-cli и конкатенированной ссылкой в QWEN.md под qwen-code плюс нативными каталогами обнаружения — то же намерение, диалект каждого окружения.

Каноническая эталонная группа находится по адресу:

src/apothem/{rules,commands,skills,agents,output-styles,hooks,conformity,statuslines}/

Каждый адаптер распространяет подмножество этой группы. Подмножество для каждого окружения объявлено в src/apothem/lib/propagation-manifest.yaml; манифест является единым источником истины о том, какие артефакты достигают какого окружения и в какой форме. Адаптер никогда не изобретает артефакты вне манифеста, а манифест никогда не назначает артефакт окружению, у которого нет поверхности для его размещения.

Объяснение классов адаптеровCopy Anchor Link

Apothem сортирует адаптеры на три класса по тому, как они транслируют общий профиль в нативный для окружения вывод.

• Класс I — прямое распространение. Адаптер копирует канонические эталонные артефакты (подмножество, объявленное в манифесте) напрямую в место конфигурации окружения без шага рендеринга. Материализатора нет. antigravity, codebuddy, codex, cursor, gemini-cli, github-copilot, glm, kimi-code, kiro, trae, windsurf и zed относятся к Классу I.
• Класс II-A — прямое распространение + шаблоны настроек, привязанные к вендору. Адаптер выполняет прямое распространение артефактов и дополнительно управляет специфичными для вендора шаблонами настроек, привязанными к схеме вендора. claude-code относится к Классу II-A.
• Класс II-B — материализатор единой поверхности, рендеримой из профиля. Адаптер рендерит общий профиль в единую нативную поверхность конфигурации через материализатор. hermes, open-claw, opencode и qwen-code относятся к Классу II-B.

Поведение во время материализацииCopy Anchor Link

Различие классов проявляется во время материализации — когда оператор запускает CLI против окружения:

• apothem install --harness <H> распространяет подмножество манифеста для <H> и для адаптеров Класса II-A / II-B рендерит нативную для окружения конфигурацию.
• apothem verify --harness <H> проверяет, что управляемые файлы существуют и разбираются. С --profile PATH он также сверяет их с тем, что произвёл бы этот профиль, и завершается ошибкой при расхождении.
• apothem status сообщает, установлено ли каждое окружение и разошлось ли оно с текущим общим профилем.
• apothem doctor сообщает состояние по окружениям для каждого зарегистрированного адаптера: ok, not_installed, needs_project, verify_failed, hook_failed или error.

См. справочник по CLI для полных поверхностей команд.

Таксономия расхожденийCopy Anchor Link

Семнадцать окружений расходятся по трём осям. Каждое различие между окружениями в матрице сводится к одной из них.

Задача Apothem — удерживать одно согласованное намерение оператора постоянным, пока эти три оси варьируются от окружения к окружению. Манифест распространения и контракт класса адаптера — два механизма, которые сохраняют это намерение стабильным поверх расхождения.