Концепции
Глоссарий, определяющий общие профили, адаптеры окружений, правила, хуки, шлюзы соответствия, навыки и делегированных исполнителей в Apothem.
Краткий справочник по терминам, которые встретятся вам по всей документации Apothem.
Общий профиль
Файл YAML, прошедший проверку по схеме, по адресу ~/.config/apothem/profile.yaml
(переопределяется через --profile PATH). Это единственный источник истины для вашей
идентичности, предпочтений и конфигурации; каждый адаптер окружения читает его при
установке и выводит из него нативную конфигурацию этого окружения.
Адаптер окружения
Адаптер для конкретной платформы, который преобразует общий профиль в нативный формат конфигурации для конкретного окружения. Поддерживаемые среды выполнения перечислены в:
Claude Code, Cursor, Gemini CLI, etc.Установка Apothem всегда означает: установить общий профиль, а затем материализовать один или несколько адаптеров.
Поведенческое правило
Файл Markdown в каталоге src/apothem/rules/, который загружается при каждом взаимодействии (всегда активный) или
только при редактировании файлов по определённому пути (с фильтрацией по пути). Правила формализуют то, как должно
вести себя окружение. Четыре правила всегда активны: agnostic-posture, authority-inquiry,
session-closure и context-management. Индекс правил, apothem-rule-index, загружается вместе с
ними и называет каждое другое правило и когда его читать. Окружение, которое не ограничивает правила
по пути, не загружает ни одно из остальных, поэтому индекс — это способ, которым сессия их находит.
Хук
Скрипт на Python, зарегистрированный в конфигурации хуков окружения (settings.json для Claude Code), который срабатывает на событиях жизненного цикла, таких как PreToolUse, PostToolUse, SessionStart и Stop; некоторые адаптеры также регистрируют PreCompact и PostCompact. Хуки обеспечивают соблюдение требований соответствия в реальном времени, до того как вывод попадёт на диск. Адаптеры для окружений без механизма хуков его опускают.
Шлюз соответствия
Механическая часть пятнадцатипунктного шлюза предэмиссии (M1-M15) — машинно-проверяемые валидаторы,
которые запускаются перед выпуском артефакта; по умолчанию они носят рекомендательный характер, а с флагом
--strict блокируют выпуск. Шлюз предэмиссии — это нижний порог качества;
шлюз соответствия запускает свои машинно-проверяемые пункты, а хуки обеспечивают соблюдение отдельных пунктов в реальном времени.
Набор планов
Структурированный каталог по адресу <project-root>/.apothem/plans/<suite-name>/, содержащий спецификацию, мастер-план, по-фазовые файлы PHASE.md и выходные артефакты. Конвейером /plan управляются наборы планов.
Навык
Переиспользуемая, вызываемая слэш-командой техника, упакованная в виде файла SKILL.md в каталоге src/apothem/skills/<name>/. Навыки расширяют поверхность слэш-команд за пределы встроенного конвейера /plan.
Делегированный исполнитель
Постоянный ассистент с заданным назначением, определённый по каноническому пути:
src/apothem/agents/<name>.mdДелегированные исполнители выполняют исследование, аудит, проверку качества и управление памятью.