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, estilos de saída, 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. Comandos

Trinta comandos são registrados a partir de src/apothem/commands/*.md (não recursivo). 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. Os comandos que não são de plan nem de workflow:

Comandos da pipeline de plan

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ção

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. Regras

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 delegados

O ecossistema é entregue com doze 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
------------------- ------------------------------------------ --------------- -------------
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. Hooks

Cada comando de hook registrado usa a forma exec do comando do Claude Code (command: "python" mais um array args) e invoca seja -m apothem.hooks.dispatch ou -m apothem.conformity.gate. 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 sob src/apothem/hooks/: src/apothem/hooks/emit_hook_context.py formata as cargas úteis de eventos para o assistente, e src/apothem/hooks/session_start_bootstrap.py carrega 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 vivem como arquivos de contexto Markdown sob src/apothem/hooks/messages/ — um por variante de evento: 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. Cada arquivo de contexto roteado é carregado pelo despachante quando seu evento dispara e seu argumento de contexto está registrado em settings.json; três arquivos de contexto (pretooluse-conformity.md, pretooluse-dependency-guard.md, pretooluse-eval-guard.md) são entregues como variantes disponíveis sem uma entrada de roteamento atual em 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

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ção

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. Habilidades

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

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. Estilos de saída

Quatro estilos de saída vivem sob src/apothem/output-styles/.

7. Evolução de artefatos

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 vazias

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.