Repository navigation
v0.1.0
Primeira versão do graph-eng, um plugin do Claude Code que roda uma tarefa complexa como um grafo pequeno de agentes: executor barato, revisor forte e um loop que só para quando os critérios de pronto fecham.
/plugin marketplace add Dougladmo/graph-eng
/plugin install graph-eng@graph-eng
Motor
- Esqueleto de fases por modo.
implementpassa por Design → Revisão do design → Implementação → Síntese.architecturepara antes de implementar.researchereviewvão por Plano → Pesquisa → Crítica → Síntese. - Esforço × teto. O tamanho do grafo sai do esforço (
manual,auto,low,medium,highoumax) contra um teto de agentes. O padrão é 24 com esforçoauto, e funciona sem configurar nada. - Executor barato, revisor forte. Os workers rodam em Sonnet. Planner, verificador e critic rodam no modelo da sessão.
- Paralelismo seguro. Leitura sempre roda em paralelo. Escrita só roda em paralelo quando os nós declaram arquivos disjuntos.
- O design é revisado antes de implementar. Design reprovado não é implementado.
- Toda implementação é verificada por outro agente, com um loop de verify e repair e uma crítica que devolve os gaps como nós novos.
- Síntese e gate humano. Polidores e um consolidador fecham a run num
REPORT.mdcom as premissas para você confirmar. - Retomada sem refazer. Uma run parada retoma do ponto em que estava, e dá para refazer um nó só, com ou sem os dependentes. Nós prontos não rodam de novo, e nenhum nó mexe na árvore com stash, reset ou checkout.
- Pesquisa com fonte. O modo
researchconsulta documentação externa (Context7, docs oficiais e a versão instalada da dependência).
Painel ao vivo
- Grafo em colunas de fase. Cada nó mostra o estado. Clicar num nó abre o prompt, as ferramentas recentes e o resultado. Tem tema claro e escuro.
- Ações sobre a run. Retomar, parar, refazer nó, copiar o comando pronto e ver os artefatos (
REPORT.md, o plano e a saída de cada nó). - Lista de runs como no Claude Code. Fixadas, grupos, arquivadas, apagar e seções recolhíveis, com as finalizadas recolhidas.
- Detecção de parada confiável. A parada é medida pelo histórico do agente, e o painel mostra por que uma run parou ou por que um nó foi pulado, falhou ou ficou bloqueado.
- Configurações pelo painel. O botão de engrenagem ajusta agentes, modelos, execução e aparência.
- O painel não cai com a sessão. Ele sobe num processo próprio, então fechar o painel ou a sessão do Claude não derruba o localhost.
/graph-eng:painelsobe o painel e/graph-eng:painel stoppara.
No terminal
graph-watch livemostra o grafo ao vivo em texto.snapshottira uma foto do estado, eagentmostra o detalhe de um nó.- Durante a run, a sessão avisa os marcos no chat (
⏳ RODANDOe✅ TERMINADO).
Requisitos
- Claude Code e
nodenoPATH(testado no Node 22). Não tem dependência de runtime nemnpm install.
Histórico completo: https://github.com/Dougladmo/graph-eng/commits/v0.1.0