Arrêtez de solliciter les agents : concevez des boucles qui orchestrent les agents de codage IA
Passez de la sollicitation manuelle à la conception de systèmes en boucle qui orchestrent les agents de codage IA. Explorez les modèles, les outils CLI et un démarrage rapide en 5 minutes.
Pourquoi l'ingénierie des boucles est importante
Peter Steinberger a parfaitement capturé le changement : "Vous ne devriez plus solliciter les agents de codage. Vous devriez concevoir des boucles qui sollicitent vos agents." Boris Cherny, responsable de Claude Code chez Anthropic, fait écho : "Je ne sollicite plus Claude. J'ai des boucles qui tournent, sollicitent Claude et déterminent quoi faire. Mon travail est d'écrire des boucles."
Le point de levier est passé de la création de sollicitations individuelles à la conception de systèmes de contrôle qui orchestrent les agents dans le temps. C'est l'idée centrale derrière l'ingénierie des boucles — une méthodologie pratique pour construire des flux de travail automatisés et pilotés par des agents.
Qu'est-ce que l'ingénierie des boucles ?
L'ingénierie des boucles vous remplace en tant que personne qui sollicite manuellement un agent. Au lieu de cela, vous concevez un système — une boucle — qui le fait pour vous. Ce système planifie les tâches, gère l'état, exécute dans des environnements isolés et verrouille les actions risquées derrière une approbation humaine.
Le dépôt de référence, cobusgreyling/loop-engineering, fournit des modèles pratiques, des outils CLI et des démarreurs pour implémenter cette approche avec des agents de codage IA comme Grok, Claude Code, Codex, Cursor et OpenClaw.
Les cinq éléments de base + Mémoire
Chaque boucle est composée de cinq primitives plus une couche de mémoire/état :
| Primitive | Rôle dans la boucle |
|---|---|
| Automatisations / Planification | Découverte + triage à un rythme régulier |
| Worktrees | Exécution parallèle sécurisée |
| Compétences | Connaissance persistante du projet |
| Plugins & Connecteurs | Accès à vos outils réels (MCP) |
| Sous-agents | Division créateur / vérificateur |
| + Mémoire / État | Colonne vertébrale durable en dehors de toute conversation |
Ces primitives forment l'anatomie d'une boucle :
flowchart LR
A[Planification / Automatisation] --> B[Compétence de triage]
B --> C[Lire + Écrire ÉTAT / Mémoire]
C --> D[Worktree isolé]
D --> E[Sous-agent implémenteur]
E --> F[Sous-agent vérificateur<br/>tests + barrières]
F --> G[MCP / Git / Tickets]
G --> H{Barrière humaine ?}
H -->|sûr / autorisé| I[Commit / PR / Action]
H -->|risqué / ambigu| J[Escalader à l'humain<br/>avec contexte complet]
I --> A
J --> A
Modèles de production
Le dépôt inclut sept modèles de boucle prêts pour la production, chacun avec un rythme défini, un modèle de démarrage et un coût estimé en tokens :
| Modèle | Rythme | Coût en tokens |
|---|---|---|
| Triage quotidien | 1j–2h | Faible |
| Baby-sitter PR | 5–15m | Élevé |
| Nettoyeur CI | 5–15m | Très élevé |
| Nettoyeur de dépendances | 6h–1j | Moyen |
| Rédacteur de changelog | 1j ou tag | Faible |
| Nettoyage post-merge | 1j–6h | Faible |
| Triage de problèmes | 2h–1j | Faible |
Vous ne savez pas lequel choisir ? Utilisez le sélecteur de modèle interactif ou consultez patterns/registry.yaml.
Outils CLI : Commencez en 5 minutes
Le dépôt est livré avec plusieurs outils CLI publiés sur npm :
- loop-init : Générer des démarreurs + budget/journal d'exécution + contraintes
- loop-audit : CLI de score de préparation de boucle (v1.5 + notation des contraintes)
- loop-cost : Estimateur de dépenses en tokens
- loop-sync : Détection de dérive entre STATE.md et LOOP.md
- loop-context : Gestionnaire de mémoire avec état + disjoncteur pour les longues exécutions
- loop-mcp-server : Recherche d'exécution MCP pour les modèles, compétences, état
Démarrage rapide
# 1. Générer + obtenir votre score de préparation de boucle (imprimé automatiquement)
npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok
# 2. Estimer la dépense en tokens pour votre rythme
npx @cobusgreyling/loop-cost --pattern daily-triage --level L1
# 3. Réauditer après améliorations
npx @cobusgreyling/loop-audit . --suggest
# Optionnel : coller le badge de préparation de boucle dans votre README
npx @cobusgreyling/loop-audit . --badge
# 4. Voir les scores grimper : vide → L1 → L2
bash scripts/before-after-demo.sh
# 5. Commencer en mode rapport uniquement (exemple Grok)
/loop 1d Run loop-triage. Update STATE.md. No auto-fix in week one.
Tous les CLI sont publiés sur npm à partir de versions taguées — pas besoin de cloner.
Fonctionnement et sécurité
L'ingénierie des boucles amplifie le jugement — à la fois bon et mauvais. Mises en garde clés :
- Les coûts en tokens peuvent exploser avec les sous-agents et les boucles de longue durée.
- La vérification vous incombe toujours. Les boucles sans surveillance font des erreurs sans surveillance.
- La dette de compréhension croît plus rapidement à moins que vous ne lisiez ce que la boucle produit.
- Deux personnes peuvent exécuter la même boucle et obtenir des résultats opposés. La boucle ne le sait pas. Vous, oui.
Comme le dit Addy Osmani : "Construisez la boucle. Mais construisez-la comme quelqu'un qui a l'intention de rester l'ingénieur, pas seulement la personne qui appuie sur le bouton."
Le dépôt inclut une documentation détaillée sur les modes de défaillance, les anti-modèles, la coordination multi-boucles et la sécurité (liste de blocage, fusion automatique, portées MCP).
Contribuer
Le projet accueille les contributions, en particulier les histoires d'échec et les modèles de production. Voir CONTRIBUTING.md pour l'échelle de contribution et le backlog des premiers problèmes.
Conclusion
L'ingénierie des boucles est un changement de paradigme pour les développeurs travaillant avec des agents de codage IA. Au lieu de solliciter manuellement, vous concevez des systèmes qui orchestrent les agents dans le temps — avec planification, gestion d'état, barrières de sécurité et conscience des coûts. Les outils et modèles de ce dépôt vous donnent un point de départ pratique pour implémenter cette approche dès aujourd'hui.