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

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

1. Команды

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

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

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

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

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

2. Правила

Поведенческие правила живут под 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. Помощники

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

Worker              File                                       Pattern         Model Policy
------------------- ------------------------------------------ --------------- -------------
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
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. Хуки

Каждая зарегистрированная команда хука использует exec-форму команды Claude Code (command: "python" плюс массив args) и вызывает либо -m apothem.hooks.dispatch, либо -m apothem.conformity.gate. Диспетчер импортирует 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, 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, stop.md. Каждый маршрутизированный файл контекста загружается диспетчером при срабатывании его события и когда его аргумент контекста зарегистрирован в settings.json; три файла контекста (pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-eval-guard.md) поставляются как доступные варианты без текущей записи маршрутизации в settings.json.

Event             Automates                Timeout  Purpose
----------------- ------------------------ -------- --------------------------------------------------
SessionStart      CM-14                    30s      Read memory, check plan state, report readiness
PreCompact        CM-24 §2.3               30s      Verify state externalized before compaction
PostCompact       CM-24 §6.2               30s      Restore working state after compaction
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       —                        10s      Accepted by src/apothem/hooks/dispatch.py whitelist for forward compatibility; no settings.json entry currently routes this event
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 — все выводятся из этого столбца. Будущие пересмотры тайм-аутов приземляются здесь, а потребители перевыводят при следующем обращении.

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

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

5. Навыки

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

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

6. Стили вывода

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

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

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

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

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

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