Skip to content

v0.1.0

Choose a tag to compare

@Dougladmo Dougladmo released this 29 Sep 19:19
· 31 commits to main since this release
7b712c6

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. implement passa por Design → Revisão do design → Implementação → Síntese. architecture para antes de implementar. research e review vão por Plano → Pesquisa → Crítica → Síntese.
  • Esforço × teto. O tamanho do grafo sai do esforço (manual, auto, low, medium, high ou max) contra um teto de agentes. O padrão é 24 com esforço auto, 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.md com 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 research consulta 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:painel sobe o painel e /graph-eng:painel stop para.

No terminal

  • graph-watch live mostra o grafo ao vivo em texto. snapshot tira uma foto do estado, e agent mostra o detalhe de um nó.
  • Durante a run, a sessão avisa os marcos no chat (⏳ RODANDO e ✅ TERMINADO).

Requisitos

  • Claude Code e node no PATH (testado no Node 22). Não tem dependência de runtime nem npm install.

Histórico completo: https://github.com/Dougladmo/graph-eng/commits/v0.1.0