Dérive Silencieuse
L'IA produit du code qui semble correct mais qui s'écarte subtilement de votre intention. Sans le savoir, vous accumulez de la dette technique invisible.
Méthodologie Open Source
Multi- Adversarial Agent Driven Development
Quand l'IA code plus vite que vous ne spécifiez, votre méthodologie doit évoluer. MADD fournit le cadre pour contrôler la dérive et forcer la convergence entre l'intention et l'implémentation.
$
npx degit madd-sh/madd-boilerplate-opencode my-project$
npx degit madd-sh/madd-boilerplate-docker-cagent my-project$
npx degit madd-sh/madd-boilerplate-claude my-project$
npx degit madd-sh/madd-boilerplate-codex my-projectLe Constat
Le développement assisté par IA change tout,
sauf nos méthodologies.
Faux Alignement
L'agent dit "c'est fait" mais a laissé des TODO, des implémentations partielles, des edge cases ignorés. Le code passe les tests mais ne résout pas le problème.
Perte de Contexte
Chaque session repart de zéro. Les décisions architecturales se perdent. Les conventions s'érodent. Le projet devient un patchwork incohérent.
Validation Biaisée
L'agent qui génère le code est le même qui le documente. C'est le renard qui garde le poulailler. L'auto-évaluation masque les problèmes.
Les Fondamentaux
6 Principes pour Zéro Dérive
L'intention est un artefact de première classe
L'intention n'est pas une conversation oubliée. C'est un document versionné, structuré, qui répond à "pourquoi" et "quoi" avant tout "comment".
→ Avant de générer du code, l'intention doit être formalisée et validée.
Le contrat est exécutable
Une spécification qu'on ne peut pas vérifier automatiquement n'est pas un contrat, c'est un souhait. Chaque requirement a des critères de validation automatisables.
→ Tests, assertions, schemas : le contrat se vérifie lui-même.
Aucun agent ne valide son propre travail
Un agent qui génère du code ne peut pas être la source de vérité sur la qualité de ce code. La validation doit toujours venir d'un agent qui n'a pas participé à la production.
→ Architecture obligatoire à 4 rôles minimum.
La rétro-spécification est la mémoire du système
Ce qui a été réellement implémenté doit être documenté objectivement, indépendamment de ce que l'agent de développement déclare avoir fait.
→ Un agent Scribe indépendant analyse le code et produit la vérité.
Les fondations précèdent les features
Quand le coût marginal de développement baisse, investir dans l'architecture devient rationnel. On priorise ce qui dé-risque la suite.
→ Le séquençage favorise la solidité, pas l'impression immédiate.
Les skills sont des contrats de connaissance
L'IA a des données d'entraînement obsolètes. Les skills injectent la connaissance à jour et définissent les critères de qualité entre phases.
→ Chaque transition est médiatisée par un skill explicite.
L'Architecture
4 Agents, Zéro Conflit d'Intérêt
Chaque agent a un rôle unique. Aucun ne valide son propre travail.
📋
Spec
Formalise l'intention
↓
alimente
📜
Contrat
Intention + Critères de validation
↓
↓
↑
guide
rétro-spécifie
⚡
Dev
Implémente le contrat
→
🔍
Audit
Vérifie contre le contrat
📝
Scribe
Documente la réalité
📋
Agent SpecL'Architecte d'Intention. Formalise le "pourquoi" et le "quoi".
- Produit l'Intention Document
- Définit les critères de validation
- Structure le contrat exécutable
⚡
Agent DevLe Développeur. Transforme l'intention en code.
- Génère l'implémentation
- Respecte le contrat
- Documente ses choix techniques
🔍
Agent AuditLe Vérificateur. Audite sans complaisance.
- Analyse le code produit
- Vérifie l'alignement intention/code
- Identifie les dérives et risques
📝
Agent ScribeLe Témoin. Documente la réalité objective.
- Analyse ce qui existe vraiment
- Compare specs vs réalité
- Produit la rétro-spécification
Migration
MADD vs Méthodologies Legacy
| Aspect | Scrum / Kanban / SAFe | MADD |
|---|---|---|
| Goulot d'étranglement | Temps de développement | Clarté d'intention |
| Unité de travail | Story / Ticket | Intention + Contrat |
| Estimation | Points / Jours | Obsolète (trop rapide) |
| Validation | Code review humaine | Audit par agent indépendant |
| Documentation | Souvent négligée | Rétro-spec automatique |
| Rythme | Sprints fixes (2-3 sem) | Cycles adaptatifs |
| Coordination | Cérémonies d'équipe | Contrats inter-agents |
| Mémoire projet | Dans les têtes | Rétro-spec versionnée |
Démarrage Rapide
Commencer avec MADD
1
Sépare tes agents
Utilise 2-3 modèles différents : Gemini pour les specs, Claude pour le dev, GPT pour l'audit. Ne laisse jamais un agent valider son propre travail.
2
Formalise avant de coder
Avant chaque session de dev, écris un Intention Document : pourquoi, quoi, critères de succès. C'est ton contrat.
3
Audite chaque livraison
Passe le code produit à ton agent d'audit avec un skill de due diligence. Ne merge jamais sans audit indépendant.
4
Génère la rétro-spec
Un 4ème agent (ou toi) analyse ce qui a été réellement implémenté et met à jour la documentation. C'est ta mémoire projet.
1
Assigne les rôles
Architecte d'Intention (PM/PO), Orchestrateur d'Agents (dev senior), Arbitre d'Alignement (QA ou pair). Chaque rôle est responsable d'une phase.
2
Centralise les skills
Un repo partagé avec tous les skills : Spec Skill, Dev Skill, Audit Skill, Retro-Spec Skill. Versionnés comme du code.
3
Rétro-spec comme source de vérité
La rétro-spécification est partagée et mise à jour à chaque cycle. C'est le point de départ de toute nouvelle itération.
1
Sprints → Cycles d'intention
Plus de durée fixe. Un cycle commence quand une intention est formalisée et se termine quand la rétro-spec est validée.
2
Stories → Intention Docs + Contrats
Chaque story devient un Intention Document avec des critères de validation exécutables. Plus de "c'est bon pour moi".
3
Definition of Done → Skill d'Audit
La DoD devient un skill formel que l'agent d'audit exécute. Vérifiable, reproductible, non-négociable.
4
Rétrospectives → Consolidations
Plus de "comment améliorer le process". On consolide les rétro-specs et on améliore les skills.
Prêt pour Zéro Dérive ?
MADD est open source. Rejoignez la communauté et contribuez à définir le futur du développement assisté par IA.