Communitygithub.com

haidrrrry/loop-engineering-skills

Le cerveau manquant des agents de codage IA — des portes de vérification écrites avant le code, une mémoire de style Reflexion qui apprend de chaque échec, et des boucles d'auto-correction avec des ancres réelles. Installation en une commande pour Claude Code ; prompts copier-coller pour toute IA.

Qu'est-ce que loop-engineering-skills ?

Ce skill apporte une mémoire de style Reflexion aux agents de codage IA, telle que décrite dans la recherche de Shinn et al. (2023). Il permet à l'agent de réfléchir par écrit à chaque tentative, de stocker cette réflexion dans un fichier `.loop/LESSONS.md`, et de relire les réflexions récentes avant d'agir. Ce mécanisme surpasse largement les tentatives aveugles (+22 % sur les tâches de décision, +11 % sur le code) et améliore de 8 points une mémoire sans réflexion. Le gain provient des raisons écrites, pas de la répétition. Le protocole inclut des étapes avant et après chaque action, avec des règles pour la réflexion sur les échecs, la maintenance du fichier (graduation des leçons en règles permanentes, suppression des entrées anciennes), et des consignes claires sur ce qui ne doit pas être stocké (secrets, narration, leçons en double). Il prend en charge Claude Code via une commande d'installation unique, et peut être utilisé avec tout agent IA via des prompts copier-coller. Les échecs à éviter incluent le 'théâtre de la mémoire' (écrire sans lire), le surajustement à un incident isolé, et la croissance illimitée du fichier.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add haidrrrry/loop-engineering-skills

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Mémoire en boucle

Mémoire verbale de style Reflexion : l'agent réfléchit par écrit à chaque tentative, stocke la réflexion, et relit les réflexions récentes avant d'agir. La recherche (Shinn et al., 2023) montre que ce mécanisme — réfléchir, stocker, relire — dépasse largement les tentatives aveugles (+22 % sur les tâches de décision sur 12 essais, +11 % sur le code) et bat la mémoire sans réflexion de 8 points. Le gain provient des raisons écrites, pas de la répétition.

Le protocole

Avant d'agir (chaque tâche)

  1. Lire .loop/LESSONS.md.
  2. Appliquer la section Règles permanentes sans condition.
  3. Lire les 3 entrées les plus récentes. Si l'une d'elles est pertinente pour la tâche en cours, indiquer en une ligne comment elle modifie votre approche. Si aucune n'est pertinente, continuez — ne forcez pas.

Après avoir agi (chaque tentative, réussite ou échec)

Ajouter exactement une entrée dans le format du fichier :

## [date] — [tâche, 5 mots max] — RÉUSSI|ÉCHEC
- Ce qui s'est passé : [une ligne]
- Cause racine / pourquoi cela a fonctionné : [une ligne]
- Prochaine fois : [une instruction spécifique et vérifiable]

Critère de qualité pour "Prochaine fois" :

  • ❌ "Faire plus attention avec la base de données" — pas vérifiable
  • ✅ "Exécuter npx prisma migrate deploy avant tout script d'initialisation" — vérifiable
  • ❌ "Se souvenir que l'API est délicate" — vague
  • ✅ "Le point de terminaison /users pagine à 50 ; toujours passer ?page= lors du comptage"

Réflexion sur l'échec, spécifiquement

Lorsqu'une tentative a échoué, la réflexion doit répondre : qu'est-ce que j'ai cru qui était faux ? Les tentatives échouées viennent généralement d'une hypothèse fausse, pas d'une faute de frappe. Nommez l'hypothèse. C'est la leçon.

Maintenance (lorsque le fichier dépasse ~30 entrées)

  1. Lire toutes les entrées de la plus ancienne à la plus récente.
  2. Toute leçon qui apparaît 2 fois ou plus est promue en Règles permanentes, réécrite comme une seule ligne impérative.
  3. Supprimer les 20 entrées les plus anciennes après la promotion.
  4. Ne jamais supprimer les Règles permanentes sans l'approbation de l'utilisateur.

Ce qu'il NE faut PAS stocker

  • Secrets, clés, jetons, données personnelles — jamais, même s'ils ont causé l'échec.
  • Narration ("J'ai ensuite essayé X, après quoi Y…") — ne stocker que les conclusions.
  • Leçons en double — si elle est déjà là, ne pas la rajouter ; envisager de la promouvoir.
  • Blâme ou autocritique — les leçons sont des instructions, pas des sentiments.

Modes d'échec à éviter

  • Théâtre de la mémoire : écrire des entrées mais ne jamais les lire. L'étape de lecture est la valeur ; l'étape d'écriture seule est un journal intime.
  • Surajustement à un incident : un hoquet environnemental ponctuel n'est pas une leçon. Si cela ne peut pas se reproduire, ne pas l'enregistrer.
  • Croissance illimitée : un fichier de 200 entrées que personne ne lit est une mémoire morte. Compressez.

Skills associés