Apothem versus a configuração manual do Zed
Manter à mão o arquivo de instruções plano .rules do Zed versus renderizá-lo a partir do perfil compartilhado do Apothem.
O Zed lê as instruções do agente a partir de um único arquivo plano .rules na
raiz do projeto (ao lado da família AGENTS.md / CLAUDE.md). O adaptador zed
do Apothem renderiza esse arquivo a partir do perfil compartilhado. Esta página
contrasta manter essa configuração à mão com gerenciá-la com o Apothem.
Comparação de esforço
| Tarefa | Configuração manual | Gerenciada pelo Apothem |
|---|---|---|
| Escrever instruções | Escrever à mão o arquivo .rules | Renderizadas a partir do corpus compartilhado |
Preservar um .rules anterior | Lembrar de copiá-lo para outro lugar você mesmo | O adaptador faz backup do arquivo existente antes de substituí-lo |
| Manter as regras alinhadas com outros harnesses | Manual, por ferramenta | Automático no apothem update |
| Compartilhar skills e comandos reutilizáveis | Copiar à mão cada pasta de skill para ~/.agents/skills/ e manter as cópias atualizadas | Gravados em ~/.agents/skills/ pelo adaptador, uma cópia para todos os projetos, e atualizados no apothem update |
| Verificar se a configuração está correta | Inspeção manual | apothem verify --harness zed --project <path> |
O que o Apothem gerencia
O adaptador zed renderiza as regras compartilhadas no arquivo plano .rules da
raiz do projeto. O Zed não tem hook PreToolUse, então a intenção de proteção vive
na prosa da regra em vez de em um ponto de interceptação de chamada de
ferramenta. O arquivo de instruções global ~/.config/zed/AGENTS.md e o bloco do
servidor de contexto MCP de .zed/settings.json são propriedade do operador e
ficam intocados. Cada mudança nas regras compartilhadas re-renderiza o arquivo no
próximo apothem update.
Caminho de migração
- Execute
apothem profile initpara criar o perfil compartilhado, caso ainda não o tenha. - Mova as instruções do seu
.rulesexistente (e qualquer conteúdo deAGENTS.mdespecífico do projeto que você queira compartilhar) para o corpus compartilhado. - Execute
apothem install --harness zed --project <path>para renderizar o arquivo.rules. O seu.rulesanterior recebe backup primeiro. - Execute
apothem verify --harness zed --project <path>para confirmar que a configuração foi gravada. - Use
apothem update --harness zed --project <path>para cada mudança posterior.
Leia a seguir
Apothem vs. configuração bruta do Windsurf
Manter à mão as regras do Windsurf em .devin/rules/ versus renderizá-las a partir do perfil compartilhado do apothem.
Apothem versus a configuração manual do OpenCode
Manter à mão a configuração, os comandos, as skills e os agentes do OpenCode versus renderizá-los a partir do perfil compartilhado do Apothem.