Apothem vs. as regras brutas do CodeBuddy
Por que encaminhar as regras de projeto do CodeBuddy pelo Apothem, em vez de escrever à mão os arquivos .codebuddy/rules em cada projeto.
O CodeBuddy lê as regras do projeto em .codebuddy/rules/*.md. Você pode escrever esses arquivos à mão, por projeto, para sempre. O adaptador codebuddy do Apothem renderiza um deles a partir do perfil compartilhado e o mantém consistente em todos os harnesses e em todos os projetos. Esta página compara 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 regras | Copiar e colar as mesmas disciplinas em .codebuddy/rules/ em cada projeto | Renderizadas a partir de um único corpus compartilhado |
| Fonte de verdade | Os arquivos de cada projeto | Um cohort canônico |
| Manter as regras alinhadas entre harnesses | Derivar novamente por ferramenta | Projetadas automaticamente |
| Atualizar as regras | Editar à mão em cada projeto | apothem update --harness codebuddy --project <path> |
| Remover a configuração | Exclusão manual | apothem uninstall com backup com marca de tempo |
| Compartilhar skills e comandos reutilizáveis | Copiar à mão cada pasta de skill para ~/.codebuddy/skills/ e manter as cópias atualizadas | Gravados em ~/.codebuddy/skills/ pelo adaptador, uma cópia para todos os projetos, e atualizados no apothem update |
O que o Apothem gerencia
O adaptador codebuddy renderiza as regras compartilhadas em um arquivo dedicado <project>/.codebuddy/rules/apothem-rules.md. Ele também grava duas pastas no seu diretório pessoal que todos os projetos compartilham: as skills, e os comandos encapsulados como skills, vão para ~/.codebuddy/skills/, e as regras e os templates que essas skills citam vão para ~/.config/apothem/rules/ e ~/.config/apothem/templates/. Seu arquivo de memória CODEBUDDY.md, suas permissões e servidores MCP em .codebuddy/settings.json e quaisquer outros arquivos de regras que você escrever continuam pertencendo inteiramente ao operador: o adaptador reconhece essas superfícies, mas nunca as edita. Toda mudança nas regras compartilhadas re-renderiza o arquivo de regras na próxima execução de apothem update.
Caminho de migração
- Execute
apothem profile initpara criar o perfil compartilhado, se você ainda não tiver um. - Mova as disciplinas dos seus arquivos existentes em
.codebuddy/rules/para o corpus compartilhado. - Execute
apothem install --harness codebuddy --project <path>para renderizar o arquivoapothem-rules.mdao lado das suas regras, que permanecem intocadas. - Execute
apothem verify --harness codebuddy --project <path>para confirmar que a configuração foi aplicada. - Use
apothem update --harness codebuddy --project <path>para cada mudança posterior.
Leia a seguir
Apothem versus a configuração manual do Trae
Manter à mão as regras do Trae sob .trae/rules/ versus renderizá-las a partir do perfil compartilhado do Apothem.
Apothem versus a configuração manual do Antigravity
Manutenção manual do contexto global e dos arquivos de plugin do Antigravity CLI, em comparação com gerenciá-los pelo perfil compartilhado do Apothem.