Реестры артефактов

Канонический реестр групп артефактов. Этот документ несёт полные перечисления команд, правил, помощников, хуков, навыков, output-стилей, дисциплины эволюции артефактов и объявлений пустых классов артефактов; содержательные таблицы живут здесь. Раскладка исходников проекта предоставляет сжатое всегда загруженное представление.

1. КомандыCopy Anchor Link

Сорок пять команд регистрируются из src/apothem/commands/*.md (нерекурсивно) — полный, всегда актуальный справочник по каждой команде — это генерируемый справочник команд, а тринадцатистадийный конвейер /research (от /research-ideate до /research-disseminate), а также оркестраторы обёрнутых рабочих процессов /audit и /fortress перечислены там полностью. Каждая команда — первоклассный зарегистрированный файл; оркестратор /plan лишь сцепляет уже первоклассные стадии плана и не несёт собственной стадийной логики, поэтому по-прежнему нет монолитного диспетчера и нет группировки подкоманд.

Тридцать пять команд может вызывать модель (disable-model-invocation: false): модель может запустить команду, когда запрос соответствует её описанию. Десять вызываются только оператором: /freshify, /github-deploy-fresh, /github-deploy-next, /release-readiness, /elevate, /fortress, /workflow, /plan-execute, /research-experiment и /research-publish. Флаг каждой команды записан в src/apothem/commands/README.md.

Не-плановые, не-исследовательские команды аудита и возвышения:

Команды плановой конвейераCopy Anchor Link

Плановый конвейер поставляется как восемь первоклассных команд — по одной на стадию, каждая вызывается напрямую как /plan-<stage> из своего зарегистрированного файла src/apothem/commands/plan-<stage>.md.

Команды рабочего процесса оператора и оркестратораCopy Anchor Link

Три команды входят в глубокую процедуру, а не несут собственную стадийную логику: две точки входа рабочего процесса оператора (каждая поддержана одноимённым навыком-братом) плюс тонкий оркестратор планового конвейера.

2. ПравилаCopy Anchor Link

Поведенческие правила живут под src/apothem/rules/ — небольшое всегда загруженное ядро плюс больший набор с фильтрацией по пути (загружаемый по требованию при касании совпадающих артефактов). Полное перечисление по каждому правилу — со столбцами Scope (всегда загружено / фильтрация по пути) и Implements — это исходно-генерируемый reference/rules.mdx, обновляемый из src/apothem/rules/*.md генератором инвентаря справки; обращайтесь к нему за авторитетным текущим списком.

Разграничение фасетов CM-21 (три правила совместно реализуют CM-21 с различными, непересекающимися фасетами): творческие фильтры и когнитивная идентичность → cognitive-identity.md; методология генерации (протоколы написания и переписывания) → clean-room-generation.md; техники планирования/обзора → planning-techniques.md. Каждое правило владеет своим фасетом; остальные ссылаются наружу.

Указатель на схему interactive-questions. Каноническая схема вызова структурированного запроса — обязательные поля, таблица-сводка полей, два исполнимых проработанных примера (одиночный выбор в §2.1 и множественный выбор в §2.2) — живёт в src/apothem/rules/interactive-questions.md §2 «Structured-Inquiry Shape». Нижестоящие артефакты могут копировать §2.1 или §2.2 как шаблоны вызова; трёхсегментная схема аннотации опций, которую несёт тело description каждой опции, задана в §3 того же файла.

3. ПомощникиCopy Anchor Link

Четырнадцать постоянных определений помощников поставляются с экосистемой; командные паттерны правила оркестрации диспетчеризуют к ним. Каждое определение живёт по указанному ниже пути к файлу.

Worker              File                                       Pattern         Model Policy
------------------- ------------------------------------------ --------------- -------------
Citation Auditor    src/apothem/agents/citation-auditor.md    Audit           host-selected
Codebase Explorer   src/apothem/agents/codebase-explorer.md   Research        host-selected
Convention Auditor  src/apothem/agents/convention-auditor.md  Audit           host-selected
Dependency Auditor  src/apothem/agents/dependency-auditor.md  Audit           host-selected
Design Critic       src/apothem/agents/design-critic.md       Audit           host-selected
Fact Checker        src/apothem/agents/fact-checker.md        Audit           host-selected
MCP Builder         src/apothem/agents/mcp-builder.md         Generation      host-selected
Memory Auditor      src/apothem/agents/memory-auditor.md      Audit           host-selected
Prompt Evaluator    src/apothem/agents/prompt-evaluator.md    Quality         host-selected
Quality Gate        src/apothem/agents/quality-gate.md        Quality         host-selected
Refactor Surgeon    src/apothem/agents/refactor-surgeon.md    Implementation  host-selected
Research Scout      src/apothem/agents/research-scout.md      Research        host-selected
Security Scanner    src/apothem/agents/security-scanner.md    Audit           host-selected
Test Runner         src/apothem/agents/test-runner.md         Quality         host-selected

4. ХукиCopy Anchor Link

Установленные записи хуков Claude Code используют exec-форму: command — это ${PYTHON_BIN}, а args содержит путь к скрипту в ${HARNESS_ROOT}/.apothem/support/ (например, hooks/dispatch.py и conformity/gate.py). Форма -m apothem.hooks.dispatch предназначена для разработки из чекаута исходного кода с PYTHONPATH=src. Диспетчер импортирует src/apothem/hooks/lib/resolve_root.py для определения корня экосистемы и делегирует работу двум вспомогательным модулям, которые лежат рядом с ним, в самом src/apothem/hooks/: src/apothem/hooks/emit_hook_context.py форматирует полезные нагрузки событий для ассистента, а src/apothem/hooks/session_start_bootstrap.py выполняет подготовительную работу SessionStart, которую диспетчер передаёт при маршрутизации этого события. Сообщения хуков, которые показываются ассистенту при срабатывании поддерживаемых событий, хранятся как Markdown-файлы контекста в src/apothem/hooks/messages/ — по одному на каждый вариант события: postcompact.md, precompact.md, posttooluse-proactive-compaction.md, pretooluse-askuserquestion-recommended.md, pretooluse-bash.md, pretooluse-bash-plan-guard.md, pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-edit.md, pretooluse-edit-header-guard.md, pretooluse-eval-guard.md, pretooluse-notebookedit.md, pretooluse-write.md, pretooluse-write-header-guard.md, pretooluse-write-plan-guard.md, sessionstart.md, skill-index.md, stop.md. Каждый маршрутизируемый файл контекста загружается диспетчером, когда срабатывает его событие и его аргумент контекста зарегистрирован в settings.json. pretooluse-conformity.md поставляется как доступный вариант без текущей записи маршрутизации в settings.json. skill-index.md генерируется из каталога навыков и команд и читается загрузчиком начала сессии, а не маршрутизируется через settings.json. pretooluse-dependency-guard.md маршрутизируется по сопоставителям Write и Edit, а pretooluse-eval-guard.md — по сопоставителям Write, Edit и Bash|PowerShell.

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24                    30s      Verify state externalized before compaction. Codex and Qwen Code register it; the Claude Code settings.json template does not
PostCompact       CM-24                    30s      Restore working state after compaction. Codex and Qwen Code register it; the Claude Code settings.json template does not
Stop              CM-14/CM-22/CM-24/CM-26  60s      Session-end externalization
PreToolUse        CM-7/CM-22               10s      Write/Edit/NotebookEdit validation — codebase-isolation, frontmatter, license-header, and plans-locality checks plus the conformity gate. Bash validation — git artifact isolation and plans-locality
PostToolUse       Proactive compaction     10s      Proactive-compaction advisory on every tool call; the Claude Code settings.json template routes it on the all-tools matcher
UserPromptSubmit  —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
Notification      —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event

Соглашение. Строки, где Automates — это —, принимаются dispatch.py, но не подключены в settings.json; столбец Timeout показывает умолчание уровня диспетчеризации, которое применяется, если и когда событие позже будет подключено.

Канонический блок значений Timeout. Столбец Timeout этой таблицы — единственный источник истины для значений тайм-аута хуков по всей экосистеме. Поля timeout по каждому хуку в settings.json, зеркальные таблицы в site/content/docs/reference/settings-reference.mdx § Hook Events и site/content/docs/reference/artifact-schema.mdx § Hooks Pipeline, а также руководство по правилам в src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness — все выводятся из этого столбца. Будущие пересмотры тайм-аутов приземляются здесь, а потребители перевыводят при следующем обращении.

Каденция обзора шаблона настроекCopy Anchor Link

settings.json — единственный шаблон Claude Code. Каждая команда хука использует exec-форму вместо обёртки, специфичной для оболочки, поэтому кросс-ОС-поведение обозревается внутри одного файла, а не сравнением парных шаблонов. Новые записи разрешений, события хуков, тайм-ауты и сообщения статуса приземляются в этот файл атомарно.

5. НавыкиCopy Anchor Link

Переиспользуемые навыки живут под src/apothem/skills/, по одной папке на навык.

Навык с disable-model-invocation: true запускается, только когда оператор вызывает его по имени. Двадцать навыков может вызывать модель. Четыре — ручные, потому что они меняют состояние за пределами рабочего дерева или зависят от того, что момент выбирает оператор: Dependency Upgrade, Secret Rotation, Workflow и Issue Lifecycle. Два навыка-набора — это шаблоны только для справки, читаемые по пути. Индекс навыков при запуске сессии перечисляет имена навыков, вызываемых моделью, и ручных навыков по доменам.

Соглашение. Путь каждой строки — это папка; точка входа — файл SKILL.md внутри неё — например, src/apothem/skills/plan-suite/SKILL.md — согласно соглашению о навыках «папка-с-SKILL.md», объявленному в раскладке исходников проекта.

6. Output-стилиCopy Anchor Link

Четыре output-стиля живут под src/apothem/output-styles/.

7. Эволюция артефактовCopy Anchor Link

Обязательно. Когда переиспользуемый паттерн, исправление или техника повторяется (2+ экземпляров в сессии или отмечено в памяти как повторяющееся), экосистема должна эволюционировать. Цикл состоит из четырёх шагов: Detect паттерна во время любого взаимодействия; Search по существующим навыкам, правилам, командам, хукам и памяти на предмет перекрытия; Act путём эволюции совпадающего артефакта на месте (обновить процедуру, антипаттерны, область охвата) или создания нового, когда забота подлинно ортогональна; Validate, что перекрёстные ссылки по-прежнему разрешаются и зависимые артефакты остаются согласованными. Предпочитайте уточнение созданию — новые артефакты усложняют поверхность сопровождения. См. src/apothem/rules/persistent-conventions-vigilance.md §2+§4 для полного протокола, включая закрытый каталог триггеров обнаружения пробелов по каждому классу артефактов.

8. Пустые классы артефактовCopy Anchor Link

Поверхности, объявленные в реестре экосистемы, но намеренно пустые до срабатывания триггера активации. Каждая строка записывает зарезервированную поверхность, файл или каталог, который выстраивает каркас класса, и триггер, продвигающий строку из пустой-аттестации в заполненную.

Пустая-аттестация — это положительное объявление, а не пробел. Каркас класса (если он существует) — это канонический no-op-артефакт, отслеживающий момент активации. Продвижения из пустой-аттестации в заполненную приземляются в соответствующем разделе реестра атомарно с первым непустым значением каркаса.