📝 O Prompt que Dispara o Loop
O ponto de partida de qualquer task runner e o prompt que carrega a capability de loop do Claude Code. Com uma unica linha, o agente sabe como montar o sistema de loop, iterar sobre tarefas e se auto-agendar.
📋 Prompt Pronto (copie e use)
Load the loop skill, work through plan.md one task at a timeEsse prompt faz tres coisas: carrega o "loop skill" (capability nativa do Claude Code), aponta para o arquivo plan.md como fonte de tarefas, e instrui o agente a processar uma tarefa por ciclo.
"I know this is a very, very basic example, but I want to stay simple on purpose. But it wrote the prompt: slash loop work through plan.md one task at a time."
⚙ O que Acontece Internamente
O Claude Code carrega o loop skill como primeira acao: "it loads the loop skill as the very first thing"
Identifica que plan.md contem uma lista sequencial de tarefas
Configura o /loop automaticamente e agenda o primeiro wake-up
O agente escreve o prompt do loop sozinho: "/loop work through plan.md one task at a time"
📋 Template de plan.md
O plan.md e o contrato entre voce e o loop. Cada tarefa deve ser especifica, verificavel e independente. Tarefas vagas geram resultados vagos. Tarefas interdependentes quebram o isolamento do loop.
📄 Template (copie e adapte)
# Plan - [Nome do Projeto]
## Tasks
- [ ] **Task 1: Setup inicial**
Criar a estrutura de diretorios e arquivos base.
Criterio: diretorios existem, arquivos criados sem erros.
- [ ] **Task 2: Implementar componente X**
Criar o componente principal com props tipadas.
Criterio: componente renderiza sem erros, tipos corretos.
- [ ] **Task 3: Adicionar estilos**
Aplicar Tailwind CSS seguindo o design system.
Criterio: visual consistente, responsivo em mobile.
- [ ] **Task 4: Escrever testes**
Testes unitarios para cada funcao publica.
Criterio: todos os testes passam, coverage > 80%.
- [ ] **Task 5: Documentacao**
README com instrucoes de uso e exemplos.
Criterio: novo dev consegue rodar seguindo o README.✓ Boas Praticas
- ✓Uma tarefa por checkbox
- ✓Criterio de aceitacao explicito
- ✓Tarefas independentes entre si
- ✓Ordem logica de execucao
✗ Anti-Patterns
- ✗"Fazer o app funcionar" (vago demais)
- ✗10+ tarefas (fragmentacao excessiva)
- ✗Tarefas que dependem de input externo
- ✗Sem criterio de "done"
🔍 Monitorando o Progresso
Depois de disparar o loop, o agente trabalha autonomamente. Cada ciclo segue o mesmo padrao: acordar, verificar a proxima tarefa, executar, validar e agendar o proximo wake-up. Voce pode acompanhar diretamente no terminal.
"It says this is sequential task list, it's going to do the first task, and then it's going to schedule a quick wake up. So it sets up the slash loop by itself."
📊 O Ciclo de um Wake-up
Wake-up
O /loop acorda o agente com o prompt que ele mesmo escreveu
Verificar plan.md
Le o arquivo, identifica a proxima tarefa nao marcada
Executar tarefa
Implementa, gera arquivos, roda comandos necessarios
Validar e marcar
Verifica criterio de aceitacao, marca [x] no plan.md, agenda proximo wake-up
"It's resuming with a slash loop wake up. And look at that. I didn't write this prompt myself at all."
⚙ Configurando Exit Conditions
Um loop sem exit condition e o erro mais caro que voce pode cometer. O agente vai rodar indefinidamente, gastando tokens sem convergir para um resultado. Sempre defina quando o loop deve parar.
🛑 Tres Formas de Parar
1. Conclusao natural
Todas as tarefas do plan.md marcadas como [x].
/goal All tasks in plan.md are checked off2. Max iterations
Safety net: pare apos N ciclos, independente do estado.
/loop --max-iterations 10 work through plan.md one task at a time3. Condicao de falha
Se uma tarefa falhar 3 vezes, pare e reporte.
If a task fails validation 3 times, stop the loop and report what went wrong.🎯 Ponto de Reflexao
A exit condition mais segura e a combinacao de /goal (conclusao natural) + max iterations (safety net). Assim, se algo der errado e o agente nao conseguir completar, ele para em vez de queimar tokens indefinidamente.
🔄 Variacoes do Prompt
O prompt basico funciona para task lists simples, mas cenarios diferentes pedem variacoes. Aqui estao prompts adaptados para os casos de uso mais comuns.
Load the loop skill. Work through refactor-plan.md one file at a time.
For each file: refactor, run tests, commit if green. Skip if tests fail after 2 retries.Ideal para refactoring incremental com safety net de testes.
Load the loop skill. Work through migration-plan.md one step at a time.
After each step, validate by running the app and checking for errors.
Never proceed to the next step if the current one has errors.Para migracoes de versao ou framework com validacao rigorosa.
Load the loop skill. Work through docs-plan.md one section at a time.
For each section: read the source code, write documentation, include code examples.
Mark the task done when the doc file is created and has at least 200 words.Geracao de documentacao a partir de codigo-fonte.
❓ Questionamentos
Antes de sair usando o task runner em tudo, vale levantar as questoes que o proprio Cole Medin coloca sobre a abordagem basica.
O loop simples escala?
Para 5 tarefas, funciona. Para 50, o context window vai explodir. Cole Medin observa que "if you loop for a while, you're going to completely bloat your context for your LLM and overwhelm it." O task runner simples tem limite natural de escala.
Qualidade vs. velocidade
O loop executa rapido, mas sem revisao humana entre tarefas. Para PoCs e exploracao, e aceitavel. Para codigo de producao, Cole e direto: "there is no way you're gonna convince me that loop engineering is the way to get the best results possible."
Custo de um loop basico
Mesmo o loop mais simples acumula tokens rapido. Cada wake-up recarrega o contexto. Para 5 tarefas com validacao, espere gastar entre 50k e 200k tokens dependendo da complexidade.
🎯 Ponto de Reflexao
O task runner e a porta de entrada. Comece aqui, entenda o mecanismo, e quando precisar de mais controle, passe para o modulo 4.2 (orchestrator + workers). A progressao e deliberada: simples primeiro, complexo quando necessario.
📋 Resumo do Modulo
Proximo Modulo:
4.2 -- Loop Intermediario: GitHub Issue Bot (orchestrator + workers paralelos)