Позиция независимости от хоста

Apothem спроектирован вокруг единого принципа: ваша конфигурация управления должна пережить любую отдельную среду выполнения ассистента по написанию кода. Общий профиль Apothem — это файл YAML, прошедший проверку по схеме, по адресу ~/.config/apothem/profile.yaml или --profile PATH; упакованные группы Apothem предоставляют команды, правила, навыки, хуки, шаблоны, строки состояния, output-стили и определения делегирования. Адаптеры для конкретных окружений в каталоге src/apothem/harnesses/<harness>/ преобразуют эти входные данные в формат, требуемый каждым поддерживаемым окружением:

Claude Code, Cursor, Gemini CLI, GitHub Copilot, Codex, Windsurf,
OpenCode, Antigravity, Open-Claw, Hermes, Qwen Code,
CodeBuddy, Kiro, Trae, Zed, GLM (Z.ai), Kimi Code

Основная идеяCopy Anchor Link

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

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

ПроблемаCopy Anchor Link

У каждого окружения для написания кода свой формат конфигурации:

Claude Code:    CLAUDE.md + settings.json
Cursor:         .cursor/rules/*.mdc
GitHub Copilot: .github/copilot-instructions.md
Windsurf:       .devin/rules/
Codex:          AGENTS.md

Без Apothem вы поддерживаете N отдельных файлов конфигурации, которые со временем расходятся друг с другом.

Решение ApothemCopy Anchor Link

One shared Apothem profile (YAML) + packaged cohorts
    identity.name
    preferences.style
    rules[]
         |
         v
    Adapter layer (HarnessAdapter protocol — src/apothem/harnesses/<harness>/)
         |
         +---> Claude Code adapter   -> ~/.claude/
         +---> Cursor adapter        -> .cursor/rules/*.mdc
         +---> Copilot adapter       -> .github/copilot-instructions.md
         +---> Windsurf adapter      -> .devin/rules/
         +---> ...

Вы редактируете общий профиль один раз, затем запускаете apothem update --harness <name> или apothem update --harness all --project <path>, чтобы распространить изменение. apothem harnesses list выводит зарегистрированный набор.

Почему «apothem»Copy Anchor Link

Имя кодирует архитектуру. В геометрии апофема — это перпендикуляр от центра правильного многоугольника до середины одной из его сторон — единственное расстояние от ядра до каждого ребра, одинаковое по каждому направлению. Таков замысел: один общий профиль в центре, семнадцать равноудалённых окружений по периметру, каждая материализация на одинаковом расстоянии от источника истины. Ядро не меняется, когда меняется ребро; рёбра разделяют единое отношение к ядру. Поскольку каждое окружение выводится из одного профиля, расхождение обнаруживаемо (apothem status сообщает о нём) и исправимо (apothem update заново материализует конфигурацию).

Гарантии переносимостиCopy Anchor Link

Команды и помощники, помеченные portability: universal, переводятся в каждое окружение, чья запись в реестре поддерживает поверхность команд (преобразованную или поддерево поддержки); окружения без неё команд не получают. Движок не анализирует маркер. Команды и помощники, помеченные portability: project-specific, могут требовать документирования переопределений для каждого окружения в теле файла.