Apothem frente à configuração manual do Gemini CLI
Manter à mão o arquivo de regras GEMINI.md do Gemini CLI frente a renderizá-lo a partir do perfil compartilhado do Apothem.
O Gemini CLI lê um único arquivo de regras GEMINI.md. O adaptador de gemini-cli
do Apothem o renderiza 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 regras | Editar à mão um único GEMINI.md | Renderizadas: orientação para todo o projeto em GEMINI.md; regras em .gemini/.apothem/support/ |
| Manter as regras alinhadas com outros harnesses | Manual, por ferramenta | Automático no apothem update |
| Instalar / remover a configuração | Escrever e excluir GEMINI.md à mão | apothem install / apothem uninstall |
| Verificar se a configuração está correta | Inspeção manual | apothem verify --harness gemini-cli --project <path> |
O que o Apothem gerencia
O adaptador gemini-cli grava um bloco do Apothem, delimitado por sentinelas, em <project>/GEMINI.md. Esse bloco traz a orientação para todo o projeto e aponta para o material do Apothem. Regras, templates e hooks são gravados como arquivos de suporte em <project>/.gemini/.apothem/support/, e comandos, skills e agentes são gravados em <project>/.gemini/. O Gemini CLI documenta um objeto hooks em settings.json, que continua pertencendo ao operador, então o adaptador não registra nenhum hook e a intenção das barreiras de proteção é expressa na prosa das regras, e não em um ponto de interceptação de chamada de ferramenta. Cada mudança nas regras compartilhadas re-renderiza GEMINI.md 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 regras do seu
GEMINI.mdexistente para o corpus compartilhado. - Execute
apothem install --harness gemini-cli --project <path>para renderizar e gravar oGEMINI.md. - Execute
apothem verify --harness gemini-cli --project <path>para confirmar que a configuração foi gravada. - Use
apothem update --harness gemini-cli --project <path>para cada mudança posterior.
Leia a seguir
Apothem versus a configuração manual do Cursor
Manter à mão as regras MDC do Cursor sob .cursor/rules/ versus renderizá-las a partir do perfil compartilhado do Apothem.
Apothem vs. configuração bruta do GitHub Copilot
Manter à mão o copilot-instructions.md do GitHub Copilot versus renderizá-lo a partir do perfil compartilhado do Apothem.