Que fait Goalkeeper-Claude-skill ?
Boucle de workflow Fable 5 ; Compétence Claude Code : boucle autonome de construction / audit / vérification qui s'exécute jusqu'à ce qu'un contrat vérifiable par machine soit respecté, avec ▎ conditions d'arrêt anti-boucle déterministes (aucun progrès, nouvelle tentative, oscillation, budget) et escalade humaine sur disque.
Qu'est-ce que c'est ?
Goalkeeper est un agent autonome pour Claude Code. Il exécute en boucle :
- Construire (générer du code/des artefacts)
- Auditer (analyser la sortie par rapport à un contrat)
- Vérifier (exécuter des vérifications automatiques)
Jusqu'à ce que le contrat soit respecté – ou que l'une des conditions d'arrêt suivantes soit atteinte :
- Aucun progrès : le score du contrat n'a pas augmenté lors d'une itération.
- Nouvelles tentatives : le nombre total d'itérations a dépassé un seuil.
- Oscillation : le score revient à une valeur observée précédemment.
- Budget : trop de tokens ou de fichiers ont été consommés.
Lorsque la boucle s'arrête (succès ou échec), un résumé concis est écrit dans goalkeeper/EXIT_SUMMARY.md. Si la boucle échoue, ce résumé déclenche une escalade humaine.
Utilisation
# Lire la compétence dans Claude Code
cat SKILL.md | claude -
@contrat Votre contrat vérifiable par machine ici
@boucle
Les commandes :
@contrat <condition>— définit le contrat de vérification.@boucle— démarre la boucle autonome.@build— force une itération de construction.@audit— déclenche une vérification anticipée.@reset— efface l'historique des itérations.@summary— imprime l'état actuel.
Configuration
| Variable | Valeur par défaut | Description |
|---|---|---|
MAX_RETRIES | 5 | Nombre maximum d'itérations de boucle |
BUDGET_TOKENS | 100000 | Budget maximum de tokens |
OSCILLATION_WINDOW | 3 | Taille de la fenêtre pour détecter l'oscillation |
Comment ça marche
- L'agent lit la compétence et attend le contrat.
- L'utilisateur fournit
@contrat <condition>. - L'utilisateur lance avec
@boucle. - L'agent construit, audite et vérifie en boucle.
- L'arrêt se produit lorsque le contrat est respecté ou qu'une condition d'arrêt est atteinte.
- Un résumé de sortie est écrit sur disque.
Escalade humaine
En cas d'échec, le fichier goalkeeper/EXIT_SUMMARY.md contient :
# Résumé de sortie Goalkeeper
- **Raison de l'arrêt** : [détails]
- **Score final** : [score]
- **Itérations** : [nombre]
- **Contrat** : [condition]
Ce fichier peut être lu par un humain ou intégré dans un pipeline CI/CD.
Dépendances
claude-code(dernière version)nodeoupython(pour les scripts de vérification)git(pour suivre l'historique des fichiers)