Communitygithub.com

Loop Engineering Skills

O cérebro que faltava para agentes de IA de código — portões de verificação escritos antes do código, memória estilo Reflexion que aprende com cada falha e loops de autocorreção com âncoras reais. Instalação com um comando para Claude Code; prompts copiáveis para qualquer IA.

O que é Loop Engineering Skills?

Loop Engineering Skills fornece um sistema de memória reflexiva para agentes de codificação de IA, permitindo que eles aprendam com tentativas anteriores e evitem repetir erros. Baseado na pesquisa Reflexion (Shinn et al., 2023), o sistema melhora o desempenho em tarefas de decisão em +22% e em código em +11% em relação a tentativas cegas, armazenando reflexões escritas em vez de confiar apenas na memória. O protocolo envolve ler lições armazenadas antes de agir, registrar reflexões após cada tentativa (incluindo a falha específica e a crença errônea que a causou), e fazer manutenção compactando o arquivo de lições quando ele fica grande demais. A ferramenta é compatível com Claude Code (instalação com um comando) e qualquer outro agente de IA via prompts copiáveis, e enfatiza a qualidade das instruções futuras — elas devem ser verificáveis e específicas, não vagas ou subjetivas.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add haidrrrry/loop-engineering-skills

Perguntar na sua IA favorita

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

Documentação

Memória de Loop

Memória verbal estilo Reflexion: o agente reflete sobre cada tentativa por escrito, armazena a reflexão e lê reflexões recentes antes de agir. Pesquisas (Shinn et al., 2023) mostram que esse mecanismo — refletir, armazenar, reler — supera repetições cegas por ampla margem (+22% em tarefas de decisão em 12 tentativas, +11% em código) e supera memória sem reflexão em 8 pontos. O ganho vem de razões escritas, não de tentar com mais força.

O protocolo

Antes de agir (a cada tarefa)

  1. Leia .loop/LESSONS.md.
  2. Aplique a seção Regras permanentes incondicionalmente.
  3. Leia as 3 entradas mais recentes. Se alguma for relevante para a tarefa atual, declare em uma linha como ela muda sua abordagem. Se nenhuma for relevante, prossiga — não force.

Depois de agir (a cada tentativa, sucesso ou falha)

Adicione exatamente uma entrada no formato do arquivo:

## [data] — [tarefa, máx. 5 palavras] — SUCESSO|FALHA
- O que aconteceu: [uma linha]
- Causa raiz / por que funcionou: [uma linha]
- Da próxima vez: [uma instrução específica e verificável]

Padrão de qualidade para "Da próxima vez":

  • ❌ "Ser mais cuidadoso com o banco de dados" — não verificável
  • ✅ "Execute npx prisma migrate deploy antes de qualquer script de seed" — verificável
  • ❌ "Lembre-se que a API é complicada" — vago
  • ✅ "O endpoint /users pagina em 50; sempre passe ?page= ao contar"

Reflexão sobre falha, especificamente

Quando uma tentativa falhou, a reflexão deve responder: o que eu acreditava que estava errado? Tentativas fracassadas geralmente vêm de uma suposição falsa, não de um erro de digitação. Nomeie a suposição. Essa é a lição.

Manutenção (quando o arquivo excede ~30 entradas)

  1. Leia todas as entradas da mais antiga para a mais nova.
  2. Qualquer lição que aparecer 2+ vezes é promovida para Regras permanentes, reescrita como uma única linha imperativa.
  3. Apague as 20 entradas mais antigas após a promoção.
  4. Nunca apague Regras permanentes sem a aprovação do usuário.

O que NÃO armazenar

  • Segredos, chaves, tokens, dados pessoais — nunca, mesmo que tenham causado a falha.
  • Narração ("Então tentei X, depois do qual Y…") — armazene apenas conclusões.
  • Lições duplicadas — se já estiver lá, não adicione novamente; considere promovê-la.
  • Culpa ou autocrítica — lições são instruções, não sentimentos.

Modos de falha a evitar

  • Teatro da memória: escrever entradas, mas nunca lê-las. A etapa de leitura é o valor; a etapa de escrita sozinha é um diário.
  • Superajuste a um incidente: um soluço ambiental isolado não é uma lição. Se não pode se repetir, não o registre.
  • Crescimento ilimitado: um arquivo de 200 entradas que ninguém lê é memória morta. Comprima.

Habilidades Relacionadas