Skip to main content

Documentation Index

Fetch the complete documentation index at: https://skill.dev.br/llms.txt

Use this file to discover all available pages before exploring further.

​
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

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

  • 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

​
Capacidades

Uma task por vez

Cada iteração implementa exatamente uma task — nunca mais, nunca menos. Foco e rastreabilidade.

Auto-correção

Erros viram correções imediatas. A próxima iteração lê a lista antes de tocar em qualquer código.

Padrões de codebase

Convenções descobertas durante a implementação são registradas e seguidas nas iterações seguintes.

Dashboard de resumo

Ao final, gera um summary.html com status, árvore de tasks e tabela de timing.

​
Como funciona

Um comando inicia o loop. Cada iteração segue um ciclo estrito de seis fases:
1

Load context

Lê README, docs, steering files e a spec completa.
2

Pick one task

Encontra a próxima task incompleta. Uma por vez, sem atalhos.
3

Understand

Lê o código existente, estuda padrões, e relê todas as correções acumuladas.
4

Implement

Implementa a task e subtasks. Se algo falha, registra a correção na hora.
5

Verify exit criteria

Confirma cada critério de saída antes de marcar como concluída.
6

Update tracking

Marca [X], registra progresso, padrões descobertos e tempo gasto.

​
O sistema de auto-correção

Cada erro vira uma entrada no progress.md:
Corrections
- ❌ `npm test` → ✅ `npm run test:unit` (projeto usa scripts separados)
- ❌ import sem extensão → ✅ `from 'lib/index.js'` (ESM exige extensão explícita)
- ❌ UNRESOLVED: [descrição do problema que não pôde ser resolvido após 5 tentativas]
A próxima iteração lê essa lista antes de tocar em qualquer código. Erros não se repetem.

​
Uso

./ralph-loop-kiro-specs-script.sh <max_iterations> <specs_name>
ArgumentoDescrição
max_iterationsQuantas iterações no máximo. Defina pelo menos o número de tasks + margem para retries.
specs_nameNome do diretório da spec em .kiro/specs/.
Exemplo
# Implementar a spec "auth-feature" em até 15 iterações
./ralph-loop-kiro-specs-script.sh 15 auth-feature
Você escolhe entre modo automático (tasks rodam sem pausa) ou manual (pausa entre cada task para revisão).

​
Pré-requisitos

  • Kiro CLI (kiro-cli) instalado e no PATH
  • Kiro IDE instalado
  • Bash shell
  • Specs em .kiro/specs/<specs_name>/ com requirements.md, design.md e tasks.md

​
Exemplos de uso

Peça ao agente coisas como: 
"Configure o Ralph Loop no meu projeto"
"Rode a spec auth-feature com 20 iterações"
"O Ralph ficou preso na task 5, como resolvo?"
"Explique o sistema de correções do progress.md"
"Gere o dashboard de resumo da spec"

​
Instalação

npx skills add https://gitlab.com/fabriciotelles/skills -s ralph-loop-kiro-specs

​
Referências

​
Estrutura do skill

ralph-loop-kiro-specs/
├── SKILL.md                                    # Skill principal
├── scripts/
│   └── ralph-loop-kiro-specs-script.sh         # Script bash do loop runner
└── references/
    └── ralph-loop-kiro-specs-prompt.md          # Template do prompt do agente