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
-
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. -
Detectar retomada vs. nova. Varra
.easy-loop/runs/*/state.json(na raiz do repositório) em busca destatus: runningouawaiting_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). -
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## Limitsdo 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.mdapenas 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 ocontract.md. -
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, escrevaspec.md(objetivo + critério de aceitação + essa linha de base), copie ocontract.mdaprovado, escreva ostate.jsoninicial (iteration: 1,phase: "generate",best_score: -1,status: "running") e umlog.jsonlvazio. Concluído quando o diretório de execução corresponder a essa estrutura estate.jsoncontiver esses valores iniciais. -
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 paraguideline.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. -
Roteirizar o resultado do executor. Na notificação de conclusão, leia
state.jsone aja conforme ostatus:done→ reporte sucesso (contrato atendido).awaiting_approval→ apresente a descoberta/operação pendente doreport.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.
-
Reconectar a uma execução retomada. Leia o
state.jsonda execução. Seawaiting_approval→ vá para a etapa 5. Serunning→ reconcilie comlog.jsonle continue da próxima fase conformereferences/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.