Registros de artefatos

Registro canônico dos conjuntos de artefatos. Este documento contém as enumerações completas de comandos, regras, trabalhadores delegados, hooks, habilidades, output-styles, disciplina de evolução de artefatos e declarações de classes de artefato vazias; as tabelas substantivas vivem aqui. A disposição do código-fonte do projeto fornece a visão condensada e sempre ativa.

1. ComandosCopy Anchor Link

Quarenta e cinco comandos são registrados a partir de src/apothem/commands/*.md (não recursivo) — a referência completa e sempre atual por comando é a referência de comandos gerada, e a pipeline /research de treze etapas (de /research-ideate a /research-disseminate), além dos orquestradores de workflow encapsulado /audit e /fortress, são enumerados ali por completo. Cada comando é um arquivo registrado de primeira classe; o orquestrador /plan apenas encadeia as etapas de plan que já são de primeira classe e não carrega lógica de etapa própria, então ainda não há um despachante monolítico nem agrupamento de subcomandos.

Trinta e cinco comandos são invocáveis pelo modelo (disable-model-invocation: false): o modelo pode executar um deles quando uma solicitação corresponde à sua descrição. Dez são invocados somente pelo operador: /freshify, /github-deploy-fresh, /github-deploy-next, /release-readiness, /elevate, /fortress, /workflow, /plan-execute, /research-experiment e /research-publish. A flag por comando é registrada em src/apothem/commands/README.md.

Os comandos de auditoria e de elevação que não são de plan nem de research:

Comandos da pipeline de planCopy Anchor Link

A pipeline de plan é entregue como oito comandos de primeira classe — um por etapa, cada um invocável diretamente como /plan-<stage> a partir de seu próprio arquivo registrado em src/apothem/commands/plan-<stage>.md.

Comandos de fluxo de trabalho do operador e de orquestraçãoCopy Anchor Link

Três comandos entram em um procedimento profundo em vez de carregar lógica de etapa própria: dois pontos de entrada de fluxo de trabalho do operador (cada um respaldado por uma habilidade irmã de mesmo nome) mais o orquestrador fino da pipeline de plan.

2. RegrasCopy Anchor Link

As regras de comportamento vivem sob src/apothem/rules/ — um pequeno núcleo sempre ativo mais um conjunto maior filtrado por caminho (carregado sob demanda ao tocar artefatos correspondentes). A enumeração completa por regra — com as colunas Scope (sempre ativa / filtrada por caminho) e Implements — é o reference/rules.mdx gerado a partir da fonte, atualizado de src/apothem/rules/*.md pelo gerador do inventário de referência; consulte-o para a lista autoritativa atual.

Delineação de facetas do CM-21 (três regras coimplementam o CM-21 com facetas distintas e não sobrepostas): filtros criativos e identidade cognitiva → cognitive-identity.md; metodologia de geração (protocolos de escrita e reescrita) → clean-room-generation.md; técnicas de planejamento/revisão → planning-techniques.md. Cada regra possui sua faceta; as demais remetem para fora.

Ponteiro do esquema de perguntas interativas. O esquema canônico de invocação de consulta estruturada — campos obrigatórios, tabela de resumo de campos, dois exemplos executáveis (seleção única em §2.1 e seleção múltipla em §2.2) — vive em src/apothem/rules/interactive-questions.md §2 "Structured-Inquiry Shape". Os artefatos descendentes podem copiar §2.1 ou §2.2 como modelos de invocação; o esquema de anotação de opções de três segmentos que o corpo description de cada opção carrega é especificado no §3 do mesmo arquivo.

3. Trabalhadores delegadosCopy Anchor Link

O ecossistema é entregue com catorze definições de trabalhadores persistentes; os padrões de equipe da regra de orquestração despacham para eles. Cada definição vive no caminho de arquivo listado abaixo.

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. HooksCopy Anchor Link

As entradas de hook do Claude Code instaladas usam a forma exec: command é ${PYTHON_BIN}, e args contém um caminho de script em ${HARNESS_ROOT}/.apothem/support/ (por exemplo, hooks/dispatch.py e conformity/gate.py). A forma -m apothem.hooks.dispatch serve ao desenvolvimento a partir de um checkout do código-fonte com PYTHONPATH=src. O despachante importa src/apothem/hooks/lib/resolve_root.py para a resolução da raiz do ecossistema e delega a dois auxiliares que ficam ao lado dele, em src/apothem/hooks/ em si: src/apothem/hooks/emit_hook_context.py formata as cargas úteis dos eventos para o assistente, e src/apothem/hooks/session_start_bootstrap.py executa o trabalho de preparação do SessionStart que o despachante delega quando roteia esse evento. As mensagens de hook apresentadas ao assistente quando os eventos suportados disparam ficam como arquivos de contexto em Markdown em src/apothem/hooks/messages/, uma por variante de evento: 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. Cada arquivo de contexto roteado é carregado pelo despachante quando o seu evento dispara, e o respectivo argumento de contexto está registrado em settings.json. pretooluse-conformity.md é entregue como variante disponível, sem uma entrada de roteamento atual em settings.json. skill-index.md é gerado a partir do catálogo de habilidades e comandos e lido pelo bootstrap de início de sessão, não roteado por meio de settings.json. pretooluse-dependency-guard.md é roteado nos matchers Write e Edit, e pretooluse-eval-guard.md nos matchers Write, Edit e 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

Convenção. As linhas em que Automates é — são aceitas por dispatch.py mas não estão conectadas em settings.json; a coluna Timeout mostra o valor padrão em nível de despacho que se aplica se e quando o evento for conectado mais tarde.

Bloco canônico de valores de timeout. A coluna Timeout desta tabela é a única fonte de verdade para os valores de timeout de hooks em todo o ecossistema. Os campos timeout por hook em settings.json, as tabelas espelho em site/content/docs/reference/settings-reference.mdx § Hook Events e site/content/docs/reference/artifact-schema.mdx § Hooks Pipeline, e a orientação de regras em src/apothem/rules/persistent-conventions-vigilance.md § Convention Awareness, todas derivam desta coluna. As futuras revisões de timeout aterrissam aqui e os consumidores re-derivam na próxima referência.

Cadência de revisão do modelo de configuraçãoCopy Anchor Link

settings.json é o único modelo do Claude Code. Cada comando de hook usa a forma exec em vez de um wrapper específico de shell, então o comportamento entre SO é revisado dentro de um único arquivo em vez de comparando modelos pareados. As novas entradas de permissões, eventos de hook, timeouts e mensagens de status aterrissam nesse arquivo de forma atômica.

5. HabilidadesCopy Anchor Link

As habilidades reutilizáveis vivem sob src/apothem/skills/, uma pasta por habilidade.

Uma habilidade com disable-model-invocation: true só é executada quando o operador a invoca pelo nome. Vinte habilidades são invocáveis pelo modelo. Quatro são manuais porque alteram o estado fora da árvore de trabalho ou dependem de o operador escolher o momento: Dependency Upgrade, Secret Rotation, Workflow e Issue Lifecycle. As duas habilidades de suíte são modelos somente de referência, lidos por caminho. O índice de habilidades de início de sessão lista os nomes invocáveis pelo modelo e os manuais por domínio.

Convenção. O Caminho de cada linha é uma pasta; o ponto de entrada é o arquivo SKILL.md dentro dela — p. ex. src/apothem/skills/plan-suite/SKILL.md — conforme a convenção de habilidade de pasta-com-SKILL.md declarada na disposição do código-fonte do projeto.

6. Output-stylesCopy Anchor Link

Quatro output-styles vivem sob src/apothem/output-styles/.

7. Evolução de artefatosCopy Anchor Link

Obrigatório. Quando um padrão, correção ou técnica reutilizável recorre (2+ instâncias em uma sessão, ou anotado na memória como recorrente), o ecossistema deve evoluir. O ciclo tem quatro etapas: Detect o padrão durante qualquer interação; Search as habilidades, regras, comandos, hooks e memória existentes em busca de sobreposição; Act evoluindo o artefato correspondente no lugar (atualizar procedimento, antipadrões, escopo) ou criando um novo quando a preocupação é genuinamente ortogonal; Validate que as referências cruzadas ainda resolvem e os artefatos dependentes permanecem consistentes. Prefira o refinamento à criação — novos artefatos acumulam superfície de manutenção. Consulte src/apothem/rules/persistent-conventions-vigilance.md §2+§4 para o protocolo completo, incluindo o catálogo fechado de gatilhos de detecção de lacunas em cada classe de artefato.

8. Classes de artefato vaziasCopy Anchor Link

Superfícies declaradas no registro do ecossistema mas intencionalmente vazias até que um gatilho de ativação dispare. Cada linha registra a superfície reservada, o arquivo ou diretório que estrutura a classe, e o gatilho que promove a linha de declaração-vazia para populada.

A declaração-vazia é uma declaração positiva, não uma lacuna. A estrutura da classe (quando existe) é o artefato canônico sem operação que rastreia o momento de ativação. As promoções de declaração-vazia para populada aterrissam na seção de registro relevante de forma atômica com o primeiro valor não vazio da estrutura.