Les Concepts MADD

L'Intention Document

L'artefact d'entrée. Le point de départ de tout cycle MADD.

L'Intention Document répond à trois questions fondamentales :

• Pourquoi ? — Le contexte business, le problème à résoudre
• Quoi ? — Ce qui doit être livré, les fonctionnalités attendues
• Comment savoir si c'est réussi ? — Les critères de validation mesurables

Structure recommandée

# Intention Document: [Feature Name]

## Context
Why this feature exists. The business problem it solves.

## Objective
What the user will be able to do once the feature is delivered.

## Requirements
- [ ] REQ-001: Requirement description
- [ ] REQ-002: Requirement description
- [ ] REQ-003: Requirement description

## Validation Criteria
- Criterion 1: How to verify REQ-001 is implemented
- Criterion 2: How to verify REQ-002 is implemented

## Out of Scope
What is NOT included in this intention.

## Dependencies
Prerequisites needed before starting.

Bonnes pratiques

• Un Intention Document = une unité de travail cohérente
• Chaque requirement doit avoir au moins un critère de validation
• Le "hors scope" est aussi important que le scope
• L'Intention Document est versionné avec le code

Le Contrat Exécutable

L'artefact de validation. Ce qui transforme un souhait en engagement vérifiable.

Un contrat est "exécutable" quand il peut être vérifié automatiquement. Pas de "ça a l'air bon" — soit ça passe, soit ça échoue.

Types de contrats

Le principe

Si on ne peut pas écrire un test pour vérifier un requirement, ce requirement est mal défini.

Le contrat exécutable est produit par l'Agent Spec en même temps que l'Intention Document. L'Agent Dev implémente pour satisfaire le contrat. L'Agent Audit vérifie que le contrat est respecté.

La Rétro-Spécification

L'artefact de mémoire. Ce qui documente objectivement ce qui existe vraiment.

La rétro-spec n'est pas ce que le développeur dit avoir fait. C'est ce qu'un agent indépendant (le Scribe) constate en analysant le code.

Pourquoi c'est différent

Contenu d'une rétro-spec

• État actuel : Ce qui existe dans le code
• Écarts : Différences entre intention et implémentation
• Dette technique : TODO, FIXME, workarounds identifiés
• Dépendances : Librairies, versions, contraintes
• Points d'attention : Risques, limitations connues

Usage

La rétro-spec devient le point de départ du prochain cycle. Quand un nouveau développement commence, l'Agent Spec consulte la rétro-spec pour comprendre l'état réel du système — pas la documentation marketing.

Le Cycle MADD

Les trois artefacts forment un cycle vertueux :

1. Intention → Contrat : L'Agent Spec formalise le besoin et définit les critères de succès
2. Contrat → Code : L'Agent Dev implémente pour satisfaire le contrat
3. Code → Audit : L'Agent Audit vérifie l'alignement
4. Code → Rétro-Spec : L'Agent Scribe documente la réalité
5. Rétro-Spec → Intention : Le cycle suivant part de la réalité documentée

Zéro dérive = chaque cycle est ancré dans la réalité du précédent.

Les Opérations

L'artefact d'exécution. Ce qui définit comment le système fonctionne au-delà du développement.

MADD ne s'arrête pas à la livraison du code. La spécification opérationnelle capture tout ce qui est nécessaire pour déployer, exécuter et surveiller le système en production.

Ce que couvrent les opérations

Pourquoi les opérations comptent dans MADD

Quand l'IA accélère le développement, l'écart entre "le code marche en local" et "le système tourne de façon fiable en production" devient le nouveau risque. Spécifier les opérations en amont — dans le contrat, pas en afterthought — assure que l'Agent Spec pense aux contraintes de déploiement et que l'Agent Dev construit avec la production en tête.