Elephant Gun
Design e revisão de documentos no GitHub Copilot CLI, com um agente que mantém o contexto (Elephant) e revisores em novos contextos (Goldfish). Derivado independente do Elephant-Goldfish Model, sob Apache-2.0. Não é um produto oficial do Google ou GitHub.
Instalação
Pré-requisito: GitHub Copilot CLI. A versão de referência desta integração é
1.0.106-11. Python é necessário apenas para os testes, não para usar o plugin.
Windows e macOS são as plataformas-alvo; veja a
evidência de validação antes de assumir suporte comprovado.
Use um checkout completo e mantenha-o acessível durante a sessão.
Windows (PowerShell):
$plugin = (Get-Location).Path
copilot --plugin-dir "$plugin" --add-dir "$plugin" --agent elephant-gun:egm
macOS:
plugin="$(pwd)"
copilot --plugin-dir "$plugin" --add-dir "$plugin" --agent elephant-gun:egm
Execute os exemplos acima na raiz do plugin. Para trabalhar em outro projeto,
salve primeiro o caminho absoluto do plugin, vá ao projeto-alvo e então execute
o comando copilot com esse caminho.
O modo --plugin-dir não instala nem altera a configuração global.
Para instalação persistente, use copilot plugin install com o caminho absoluto
do checkout, conforme o --help da sua versão. Depois, inicie uma nova sessão.
Confira copilot plugin list e /agent. Se necessário, conceda acesso ao caminho
instalado com --add-dir; não conceda acesso irrestrito a todo o computador.
O repositório remoto ainda não é configurado por este pacote. Quando publicado,
o formato de instalação será copilot plugin install OWNER/REPO; substitua pelo
destino real. Nenhum endereço remoto fictício é necessário no manifesto.
Uso
Na sessão do agente principal:
Use egm-brainstorm para explorar uma ferramenta de migração de configurações.
EGM artifact directory: docs/designs/migracao
Para revisar um documento:
Execute egm-review em docs/designs/migracao/design.md.
Use apenas esse documento e src/config como contexto dos revisores.
EGM artifact directory: docs/reviews/migracao
Também é possível invocar as skills diretamente pelos comandos namespaced
descobertos em /skills, por exemplo /elephant-gun:egm-review.
Todas carregam o mesmo contrato Copilot, sem exigir a seleção prévia do agente.
Se o host não conseguir resolver a instalação, informe o caminho absoluto do
pacote; não use caminhos de cache adivinhados.
| Skill | Função |
|---|---|
egm-brainstorm | Esclarecer ideias e confrontá-las por sete lentes. |
egm-draft | Elaborar o design por seções aprovadas. |
egm-review | Revisar o documento em etapas. |
egm-review-loop | Repetir revisão com filhos novos e acompanhar achados. |
egm-resolve | Decidir sobre achados e aplicar correções aprovadas. |
egm-drift-report | Comparar documentação e código. |
egm-bootstrap | Gerar contratos de diretórios de baixo para cima. |
O bootstrap oferece target_filename=EGM.md para preservar READMEs humanos e
pede aprovação ao descobrir mais de 15 subdiretórios. Scouts são somente leitura;
o principal escreve todos os contratos.
Aprovações e limites
O plugin produz documentação, não implementação de código. Ele não deve instalar dependências, executar builds ou fazer commits no projeto analisado. Revisões e correções respeitam os checkpoints humanos. Cancelar uma pergunta não aprova uma alteração. Em execução sem interação, o fluxo pausa no gate.
Revisores não recebem o histórico do principal e têm ferramentas estritamente de leitura/pesquisa. Isso não é um sandbox de filesystem: arquivos compartilhados ainda podem ser legíveis. O principal faz a síntese e grava os relatórios. Falha de um revisor aparece como etapa incompleta, nunca como aceite.
Chamadas a modelos usam sua configuração e podem consumir créditos do Copilot. O pacote não inclui um modelo, servidor MCP, daemon, hooks ou telemetria própria.
Desenvolvimento
Veja TESTING.md, o contrato Copilot e a origem e política de atualização.
Licença
Distribuído sob a licença Apache-2.0. Consulte NOTICE e UPSTREAM.md para os avisos de autoria do projeto de origem (Copyright 2026 Google LLC) e das modificações desta adaptação (Copyright 2026 Ednei Monteiro).