Documentação do Apothem

O Apothem é um gerenciador de configuração de harness agnóstico ao host. Você escreve um único perfil compartilhado em ~/.config/apothem/profile.yaml e o Apothem o materializa na superfície de configuração nativa de dezessete harnesses: Claude Code, Cursor, Gemini CLI, GitHub Copilot, Codex, Windsurf, Zed e o restante do catálogo registrado.

A unidade que o Apothem sincroniza é mais ampla do que apenas regras: regras, skills, subagentes, comandos de barra, hooks, output-styles, statuslines, templates, validadores de conformidade, schemas, templates de instrução por harness e o template de settings do Claude Code viajam juntos como um único corpus governado, materializado no formato nativo de cada harness ou em uma subárvore de suporte de propriedade do Apothem quando a ferramenta não tem uma primitiva equivalente. O perfil compartilhado também carrega as definições de servidores MCP.

Novo por aqui? Comece em dois passosCopy Anchor Link

1. Instalação — escolha uma via de instalação (plugins e extensões nativos das ferramentas, npx ou scripts de uma única etapa) e execute o primeiro passo guiado. Cada via precisa do Python 3.10 ou mais recente do sistema (com click e rich); os canais npx e de extensão precisam adicionalmente do Node.js 18 ou mais recente.
2. Chegue à sua primeira execução funcional — escreva um perfil compartilhado, materialize a partir dele a configuração nativa de um harness e verifique o resultado. Cerca de quinze minutos, de ponta a ponta.

Como o Apothem funcionaCopy Anchor Link

• Um perfil, muitas configurações nativas. Você escreve a intenção uma vez; o Apothem a traduz para a superfície de configuração nativa de cada ferramenta — sem nivelar ao menor denominador comum. Veja a postura agnóstica ao host.
• O laço operacional: planejar → endurecer → entregar. Um fluxo de planejamento (/plan) leva uma mudança por especificação, geração, revisão e execução; um fluxo de endurecimento (/fortress) conduz esse trabalho a um estado pronto para entrega; o portão de entrega fecha o laço. Veja o fluxo de comandos.
• Trabalho que sobrevive a fronteiras. O trabalho de longa duração externaliza todo o seu estado para uma suíte .apothem/plans/ local do projeto, de modo que uma nova sessão em qualquer conta ou máquina o retoma no lugar. Veja o planejamento retomável.

Comece por aquiCopy Anchor Link

• Instalação — as vias de instalação (plugins e extensões nativos das ferramentas, npx, scripts de uma única etapa) e uma primeira execução guiada.
• Uso — escreva seu perfil, instale-o em todos os harnesses, verifique-o e atualize-o.
• Harnesses — o catálogo de dezessete harnesses com a superfície nativa de cada ferramenta e seu comportamento de conversão.
• O fluxo de comandos — as etapas dos fluxos /plan e /research e a sequência de revisão de auditoria, com os orquestradores /audit e /fortress que as envolvem.

Aprofunde-seCopy Anchor Link

• Conceitos — o perfil compartilhado, os adaptadores de harness e o modelo de materialização.
• Arquitetura — a estrutura do código-fonte, a abstração do adaptador, o runtime autocontido e o fluxo CI/CD.
• Referência — a CLI, o esquema do perfil, as regras, as habilidades, os comandos, os hooks e os catálogos de output-styles.
• Como o Apothem se compara — uma matriz de diferenciação honesta e com concorrentes nomeados.

Governança e segurançaCopy Anchor Link

• Governança — o registro de disciplinas, o conformity gate e a fachada de versões.
• Segurança — a postura de cadeia de suprimentos e a política de segurança.
• Registro de alterações — as notas de versão, com a versão atual primeiro.