Skip to content

edneimonteiro/elephant-gun

v0.1.0Apache-2.0

Design documents and review them with fresh-context agents in GitHub Copilot CLI.

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.

SkillFunção
egm-brainstormEsclarecer ideias e confrontá-las por sete lentes.
egm-draftElaborar o design por seções aprovadas.
egm-reviewRevisar o documento em etapas.
egm-review-loopRepetir revisão com filhos novos e acompanhar achados.
egm-resolveDecidir sobre achados e aplicar correções aprovadas.
egm-drift-reportComparar documentação e código.
egm-bootstrapGerar 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).