Ingénierie de Boucles : Concevoir des Systèmes qui Guident vos Agents IA de Codage
Arrêtez de guider manuellement les agents IA. Apprenez à concevoir des boucles qui orchestrent les agents avec des motifs, des outils CLI et une mémoire pour une automatisation de niveau production.
Ingénierie de Boucles : Concevoir des Systèmes qui Guident vos Agents IA de Codage
Si vous tapez encore manuellement des instructions dans Claude Code, Grok ou Codex, vous laissez du levier sur la table. La prochaine évolution du développement assisté par IA ne réside pas dans de meilleures instructions — mais dans la conception de boucles qui guident les agents pour vous.
Comme le dit Peter Steinberger : "Vous ne devriez plus guider les agents de codage. Vous devriez concevoir des boucles qui guident vos agents." Boris Cherny, responsable de Claude Code chez Anthropic, renchérit : "Je ne guide plus Claude. J'ai des boucles qui guident Claude et décident quoi faire. Mon travail est d'écrire des boucles."
C'est l'idée centrale derrière l'Ingénierie de Boucles, un référentiel pratique de Cobus Greyling qui fournit des motifs, des modèles de démarrage et des outils CLI pour construire des systèmes d'orchestration d'agents. Il s'inspire des travaux d'Addy Osmani sur le sujet et est conçu pour les développeurs utilisant Grok, Claude Code, Codex, Cursor et autres agents IA de codage.
Pourquoi c'est important
Le point de levier a changé. Au lieu de rédiger des instructions individuelles, vous concevez désormais des systèmes de contrôle qui orchestrent les agents dans le temps. Cela signifie :
- Automatisation à un rythme : Les agents s'exécutent selon des plannings (toutes les heures, quotidiennement, sur PR) sans votre présence.
- Exécution parallèle sécurisée : Les arbres de travail isolent les modifications pour que les agents ne se marchent pas sur les pieds.
- Connaissances persistantes du projet : Les fichiers de compétences encodent les conventions, l'architecture et les contraintes de votre projet.
- Intégration réelle d'outils : Les connecteurs MCP (Model Context Protocol) donnent aux agents accès à vos outils réels — Git, tickets, CI.
- Mémoire et état : Une colonne vertébrale durable en dehors de toute conversation, pour que les agents n'oublient pas le contexte entre les exécutions.
Les Cinq Blocs de Construction + Mémoire
Le référentiel définit cinq primitives qui forment la base de toute boucle :
| Primitive | Rôle dans la Boucle |
|---|---|
| Automatisations / Planification | Découverte + tri à un rythme |
| Arbres de travail | Exécution parallèle sécurisée |
| Compétences | Connaissances persistantes du projet |
| Plugins & Connecteurs | Accès à vos outils réels (MCP) |
| Sous-agents | Séparation créateur / vérificateur |
| + Mémoire / État | Colonne vertébrale durable en dehors de toute conversation |
Les détails complets se trouvent dans docs/primitives.md, et une matrice multi-outils est disponible dans docs/primitives-matrix.md.
Anatomie d'une Boucle
Un flux de boucle typique ressemble à ceci :
flowchart LR
A[Planification / Automatisation] --> B[Compétence de Tri]
B --> C[Lire + Écrire ÉTAT / Mémoire]
C --> D[Arbre de Travail 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
Ce cycle s'exécute selon un planning, lit et écrit l'état, s'exécute en isolation, vérifie les résultats, et soit commit soit escalade. La barrière humaine est un mécanisme de sécurité critique — les boucles sans surveillance peuvent faire des erreurs sans surveillance.
Motifs de Production
Le référentiel inclut sept motifs 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 :
| Motif | Rythme | Démarrage | Semaine 1 | Coût en Tokens |
|---|---|---|---|---|
| Tri Quotidien | 1j–2h | boucle-minimale | Rapport L1 | Faible |
| Gardien de PR | 5–15min | gardien-pr | Surveillance L1 | Élevé |
| Nettoyeur CI | 5–15min | nettoyeur-ci | L2 prudent | Très élevé |
| Nettoyeur Dépendances | 6h–1j | nettoyeur-dépendances | L2 correctif uniquement | Moyen |
| Rédacteur Changelog | 1j ou tag | rédacteur-changelog | Brouillon L1 | Faible |
| Nettoyage Post-Merge | 1j–6h | nettoyage-post-merge | L1 hors pointe | Faible |
| Tri d'Issues | 2h–1j | tri-issues | L1 proposition uniquement | Faible |
Vous ne savez pas lequel choisir ? Utilisez le sélecteur interactif de motifs ou consultez patterns/registry.yaml pour un index lisible par machine.
Pour Commencer en 5 Minutes
# 1. Échafauder + obtenir votre score Loop Ready (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 Loop Ready 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.
Les trois CLI sont publiés sur npm à partir de versions taguées — pas besoin de cloner. Si vous contribuez depuis la source, vous pouvez développer depuis le monorepo :
cd tools/loop-init && npm ci && npm test && node dist/cli.js /path/to/project --pattern daily-triage --tool grok
cd tools/loop-audit && npm ci && npm test && node dist/cli.js /path/to/project --suggest
cd tools/loop-cost && npm ci && npm test && node dist/cli.js --pattern ci-sweeper --cadence 15m
Un déploiement progressif est recommandé : L1 (rapport uniquement) → L2 (correctifs assistés) → L3 (sans surveillance). Voir la liste de contrôle de conception de boucle pour plus de détails.
Outils CLI
Le référentiel fournit plusieurs paquets npm :
- loop-audit : CLI de Score de Préparation de Boucle (v1.5 + notation des contraintes) —
npx @cobusgreyling/loop-audit . --suggest - loop-init : Échafauder des démarreurs + budget/journal d'exécution + contraintes —
npx @cobusgreyling/loop-init . --pattern daily-triage --tool grok - loop-cost : Estimateur de dépense en tokens —
npx @cobusgreyling/loop-cost - loop-sync : Détection de dérive entre STATE.md et LOOP.md —
npx @cobusgreyling/loop-sync . - loop-context : Gestionnaire de mémoire avec état + coupe-circuit pour les longues exécutions —
npx @cobusgreyling/loop-context --check --ledger run.json - loop-mcp-server : Recherche d'exécution MCP pour motifs, compétences, état (repo v1 ; npm en attente)
Fonctionnement et Sécurité
L'ingénierie de 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 longues.
- La vérification vous incombe toujours. Les boucles sans surveillance font des erreurs sans surveillance.
- La dette de compréhension croît plus vite à 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, si.
Le référentiel inclut une documentation complète sur la sécurité :
- Modes de Défaillance — catalogue de style incident
- Anti-Motifs — erreurs de conception avant production
- Coordination Multi-Boucles — quand les boucles entrent en collision
- Exploitation des Boucles — coût, journalisation, quand arrêter
- Sécurité — liste de blocage, auto-merge, portées MCP
- Sécurité — signalement et risques d'automatisation sans surveillance
Contribuer
Le projet accueille les contributions, en particulier les histoires d'échecs et les nouveaux mappages de motifs. Consultez le guide de démarrage pour contributeurs pour des tâches de ~10 min à ~1 heure avec révision le jour même pour les histoires et les adoptants.
Conclusion
L'ingénierie de boucles est un changement de paradigme. Au lieu d'être la personne qui guide l'agent, vous devenez celle qui conçoit le système qui guide l'agent. Ce référentiel vous donne les motifs, les outils et les pratiques de sécurité pour rendre ce changement pratique.
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."
Ce post est basé sur le référentiel Loop Engineering par Cobus Greyling, sous licence MIT.