Skip to content
Apothem
Comparação

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

TarefaConfiguração manualGerenciada pelo Apothem
Escrever regrasEditar à mão um único GEMINI.mdRenderizadas: orientação para todo o projeto em GEMINI.md; regras em .gemini/.apothem/support/
Manter as regras alinhadas com outros harnessesManual, por ferramentaAutomático no apothem update
Instalar / remover a configuraçãoEscrever e excluir GEMINI.md à mãoapothem install / apothem uninstall
Verificar se a configuração está corretaInspeção manualapothem 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

  1. Execute apothem profile init para criar o perfil compartilhado, caso ainda não o tenha.
  2. Mova as regras do seu GEMINI.md existente para o corpus compartilhado.
  3. Execute apothem install --harness gemini-cli --project <path> para renderizar e gravar o GEMINI.md.
  4. Execute apothem verify --harness gemini-cli --project <path> para confirmar que a configuração foi gravada.
  5. Use apothem update --harness gemini-cli --project <path> para cada mudança posterior.

Leia a seguir

On this page