Communitygithub.com

Easy Loop

Execute um loop agente planejador/gerador/avaliador no estilo Karpathy em seu repositório: um gerente negocia um contrato testável e, em seguida, aciona um executor de fundo retomável.

O que é Easy Loop?

O Easy Loop (`/easy-loop`) transforma sua sessão atual em um **gerente** que negocia um **contrato** testável com o usuário, lança um **executor** em segundo plano que itera por um ciclo de planejador, gerador e avaliador até que o contrato seja cumprido ou que seja necessária uma intervenção humana. O estado do loop é gravado em disco, não no contexto da sessão, permitindo que ele sobreviva a falhas ou ao fechamento da sessão — cada execução é reconstruível a partir de seu **diretório de execução**. O sistema divide-se em dois papéis inseparáveis: o gerente, que interage com o usuário (negociação, aprovação, lançamento e retomada) e nunca escreve código da aplicação; e o executor, um subagente em segundo plano que dirige as iterações, escreve estado em disco e para apenas quando precisa da atenção humana. É útil para tarefas longas, com múltiplos arquivos, que exigem avaliação independente, têm portões de aprovação ou precisam ser retomadas — oferecendo resumibilidade, relatórios opcionais com gráficos em HTML e controle de custos por camadas de modelo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add tundergod/easy-loop

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que Easy Loop faz?

/easy-loop faz desta sessão o gerente: negocie um contrato testável com o usuário, lance um executor em segundo plano que itera planejador → gerador → avaliador contra esse contrato e retorne ao usuário apenas quando o contrato for atendido ou algo precisar de um humano. Você é o gerente — siga references/role-manager.md.

Dois papéis, e eles não podem ser mesclados — um fala com o usuário, o outro é executado de forma destacada:

  • gerente — esta sessão principal. Voltado ao usuário: contrato, aprovações, lançamento, retomada. Nunca escreve código da aplicação.
  • executor — um subagente em segundo plano. Conduz iterações, gera um novo planejador/gerador/avaliador a cada rodada, grava estado em disco e para quando precisa de um humano. Nunca fala com o usuário.

O estado reside em disco, não no contexto: o loop sobrevive a uma falha ou a uma sessão fechada porque cada execução é reconstruível a partir de seu diretório de execução. Veja references/loop-protocol.md para a estrutura do diretório de execução, esquema de estado, reversão/retorno, roteamento de status e regras de retomada — você depende deles nas etapas 1 e 3–6.

Cada subagente que você gerar começa com contexto vazio. Injete o que ele precisa em seu prompt: guideline.md (disciplina compartilhada), o correspondente references/role-*.md e os caminhos de arquivo do diretório de execução. O código da aplicação é editado no repositório conforme os caminhos permitidos pelo contrato; a contabilidade do loop fica no diretório de execução — nada mais é escrito no repositório.

Fluxo de Trabalho

  1. Admissão. Confirme que a tarefa é digna de loop conforme references/role-manager.md (longa, com múltiplos arquivos, que precisa de avaliação independente, tem portões de aprovação ou deve ser retomada). Se não for, faça diretamente e pare. Concluído quando a tarefa é confirmada como digna de loop.

  2. Detectar retomada vs. nova. Varra .easy-loop/runs/*/state.json (na raiz do repositório) em busca de status: running ou awaiting_approval. Concluído quando você sabe se está retomando uma execução existente (pegue o run-id mais recente → etapa 6) ou iniciando uma nova (→ etapa 2).

  3. Negociar o contrato. Receba o objetivo do usuário. Gere um planejador para rascunhar contract.md (uma lista de verificação de afirmações testáveis, de 10 a 30 itens) em um caminho temporário, depois um avaliador em modo de planejamento para criticá-lo, e então o planejador mais uma vez para revisar — uma rodada, depois apresente. Combine os limites por execução com o usuário (max_iterations, no_progress_rounds, contract_invalid_rounds, operações proibidas) e registre-os no ## Limits do contrato. Ao apresentar o contrato, destaque que as camadas de modelo (## Models) estão desativadas por padrão e podem ser ativadas para控制ar custos; se o usuário quiser isso, registre as camadas por papel. Pergunte também qual apresentação de relatório eles desejam — o padrão é report.md apenas em markdown, opcionalmente HTML com gráficos — e registre em ## Report. Concluído quando a crítica do avaliador em modo de planejamento é abordada e o usuário aprova explicitamente o contract.md.

  4. Criar o diretório de execução. Construa-o conforme references/loop-protocol.md: execute a verificação uma vez para capturar o resultado de linha de base, escreva spec.md (objetivo + critério de aceitação + essa linha de base), copie o contract.md aprovado, escreva o state.json inicial (iteration: 1, phase: "generate", best_score: -1, status: "running") e um log.jsonl vazio. Concluído quando o diretório de execução corresponder a essa estrutura e state.json contiver esses valores iniciais.

  5. Lançar o executor em segundo plano. Gere o executor com a ferramenta Agent usando run_in_background: true, passando o envelope de transferência (caminho da execução, caminho do contrato, operações permitidas/proibidas, limites e ponteiros para guideline.md + references/role-*.md). O arcabouço notifica esta sessão quando o executor retorna. Informe ao usuário que o loop está em execução e que você retornará apenas na conclusão ou escalação. Concluído quando o executor em segundo plano é lançado com um envelope completo.

  6. Roteirizar o resultado do executor. Na notificação de conclusão, leia state.json e aja conforme o status:

    • done → reporte sucesso (contrato atendido).
    • awaiting_approval → apresente a descoberta/operação pendente do report.md, obtenha uma decisão, registre-a e relance (etapa 4) com o contrato ou aprovação atualizada. Se a escalação for uma solicitação de revisão do contrato (CONTRACT_INVALID), execute novamente o planejador da etapa 2 antes da aprovação. Não concluído até que seja relançado ou o usuário encerre a execução.
    • failed → reporte o bloqueador e pergunte como prosseguir. Concluído quando o usuário tiver o resultado e a execução for relançada ou explicitamente encerrada.
  7. Reconectar a uma execução retomada. Leia o state.json da execução. Se awaiting_approval → vá para a etapa 5. Se running → reconcilie com log.jsonl e continue da próxima fase conforme references/loop-protocol.md, depois relance o executor (etapa 4). Concluído quando o loop estiver em execução novamente ou entregue ao usuário.

Escalação

O executor opera sem intervenção e para para um humano apenas nos gatilhos descritos em references/loop-protocol.md. A conclusão é a AVALIAÇÃO POSITIVA em toda a lista de verificação de aceitação. Qualquer outra coisa, ele itera sem interromper o usuário.

Política de Aprovação

As operações sujeitas a aprovação são a lista canônica em references/loop-protocol.md. Um contrato aprovado não as anula — elas permanecem interrupções que o executor escala através do gerente.

Habilidades Relacionadas