Conceitos

Uma referência rápida para os termos que você encontrará ao longo da documentação do Apothem.

Perfil compartilhadoCopy Anchor Link

Um arquivo YAML validado por schema em ~/.config/apothem/profile.yaml (substitua com --profile PATH). Ele é a única fonte da verdade para sua identidade, preferências e configuração; cada adaptador de harness o lê na instalação e deriva dele a configuração nativa desse harness.

Adaptador de harnessCopy Anchor Link

Um adaptador por plataforma que traduz o perfil compartilhado para o formato de configuração nativo de um harness específico. Os runtimes suportados estão listados em:

Claude Code, Cursor, Gemini CLI, etc.

Instalar o Apothem sempre significa: instalar o perfil compartilhado e então materializar um ou mais adaptadores.

Regra comportamentalCopy Anchor Link

Um arquivo Markdown sob src/apothem/rules/ que é carregado em toda interação (sempre ativo) ou apenas ao editar arquivos sob um caminho específico (filtrado por caminho). As regras codificam como o harness deve se comportar. Quatro regras são sempre ativas: agnostic-posture, authority-inquiry, session-closure e context-management. O índice de regras, apothem-rule-index, é carregado com elas e nomeia todas as outras regras e quando lê-las. Um harness que não delimita regras por caminho não carrega nenhuma das outras, então o índice é como uma sessão as encontra.

HookCopy Anchor Link

Um script Python registrado na configuração de hooks de um harness (settings.json no Claude Code) que dispara em eventos do ciclo de vida, como PreToolUse, PostToolUse, SessionStart e Stop; alguns adaptadores também registram PreCompact e PostCompact. Os hooks impõem mandatos de conformidade em tempo real antes que a saída chegue ao disco. Adaptadores para harnesses sem mecanismo de hook o omitem.

Conformity gateCopy Anchor Link

A fração mecânica do portão de pré-emissão de quinze barras (M1-M15) — os validadores verificáveis por máquina que são executados antes de um artefato ser emitido; consultivos por padrão, bloqueantes sob --strict. O portão de pré-emissão é o piso de qualidade; o conformity gate executa suas barras verificáveis por máquina, e os hooks impõem barras individuais em tempo real.

Suíte de planejamentoCopy Anchor Link

Um diretório estruturado em <project-root>/.apothem/plans/<suite-name>/ contendo um spec, um plano mestre, arquivos PHASE.md por fase e artefatos de saída. O pipeline /plan gerencia suítes de planejamento.

SkillCopy Anchor Link

Uma técnica reutilizável, invocável por comando de barra, empacotada como um arquivo SKILL.md sob src/apothem/skills/<name>/. As skills estendem a superfície de comandos de barra além do pipeline /plan integrado.

Trabalhador delegadoCopy Anchor Link

Um assistente persistente, de escopo definido, declarado no caminho canônico:

src/apothem/agents/<name>.md

Os trabalhadores delegados cuidam de pesquisa, auditoria, verificação de qualidade e gerenciamento de memória.