Ralph Loop for Kiro Specs
O Problema
Seção intitulada “O Problema”Você desenhou a spec no Kiro IDE — requirements, design, tasks, tudo estruturado. Agora precisa implementar. Task por task, prompt por prompt, revisando cada saída manualmente. Com 15 tasks, são 15 ciclos de copiar prompt, colar no terminal, verificar resultado, corrigir erro, tentar de novo.
E quando o agente comete o mesmo erro na task 8 que já tinha cometido na task 3? Você corrige de novo. E de novo na task 12.
A Solução
Seção intitulada “A Solução”Ralph Loop pega as specs que você criou no Kiro IDE e as executa automaticamente via kiro-cli. Um comando, e ele implementa task por task até o fim — ou até você mandar parar.
A diferença: Ralph aprende com os próprios erros. Se a task 3 descobre que o projeto usa npm run test:unit em vez de npm test, a task 4 já sabe disso antes de começar. Correções são registradas imediatamente e relidas em cada iteração.
Baseado em ralph-loop-kiro-specs por mreferre, licenciado sob Apache License 2.0.
Quando Usar
Seção intitulada “Quando Usar”- Specs prontas no Kiro IDE que precisam ser implementadas via CLI
- Projetos com muitas tasks onde execução manual é repetitiva
- Specs onde o agente precisa respeitar padrões do codebase existente
- Situações onde erros se repetem entre tasks e você quer que o agente pare de cometê-los
Instalação
Seção intitulada “Instalação”npx skills add https://gitlab.com/fabriciotelles/skills -s ralph-loop-kiro-specsComo Funciona
Seção intitulada “Como Funciona”Um comando inicia o loop. Cada iteração implementa exatamente uma task — nunca mais, nunca menos.
graph LR
A[1. Load Context] --> B[2. Pick ONE Task]
B --> C[3. Understand]
C --> D[4. Implement]
D --> E[5. Verify Exit Criteria]
E --> F[6. Update Tracking]
F -->|Tasks remain| B
F -->|All complete| G[Generate Dashboard]
O que acontece em cada iteração
Seção intitulada “O que acontece em cada iteração”- Load Context — Lê README, docs, steering files e a spec completa
- Pick ONE Task — Encontra a próxima task incompleta. Uma por vez, sem atalhos
- Understand — Lê o código existente, estuda padrões, e relê todas as correções acumuladas
- Implement — Implementa a task e subtasks. Se algo falha, registra a correção na hora
- Verify — Confirma cada critério de saída antes de marcar como concluída
- Track — Marca
[X], registra progresso, padrões descobertos e tempo gasto
O sistema de auto-correção
Seção intitulada “O sistema de auto-correção”Cada erro vira uma entrada no progress.md:
- ❌ `npm test` → ✅ `npm run test:unit` (projeto usa scripts separados)- ❌ import sem extensão → ✅ `from 'lib/index.js'` (ESM exige extensão explícita)A próxima iteração lê essa lista antes de tocar em qualquer código. Erros não se repetem.
Ao final: um dashboard
Seção intitulada “Ao final: um dashboard”Quando todas as tasks estão concluídas, Ralph gera um summary.html com status geral, árvore de tasks com detalhes por hover, e tabela de timing por task.
./ralph-loop-kiro-specs-script.sh <max_iterations> <specs_name>| Argumento | Descrição |
|---|---|
max_iterations | Quantas iterações no máximo. Defina pelo menos o número de tasks + margem para retries. |
specs_name | Nome do diretório da spec em .kiro/specs/ |
# Implementar a spec "auth-feature" em até 15 iterações./ralph-loop-kiro-specs-script.sh 15 auth-featureVocê escolhe entre modo automático (tasks rodam sem pausa) ou manual (pausa entre cada task para revisão).