Doctrine AIAD v1.9 · aiad-sdd v1.20.0 — Open Source
Le développement piloté par la spec,
pour l'ère des agents IA
SDD Mode transforme une intention humaine en code vérifié : Intent Statement, SPEC vivante, Execution Gate, Drift Lock et gouvernance réglementaire — sans jamais déléguer la paternité de l'intention.
npx aiad-sdd init
Comprendre AIAD et le SDD Mode en 90 secondes
Animation muette en six scènes. Lancez-la quand vous voulez ; chaque scène reste lisible sans animation.
-
1 / 6 — Le constat
Un agent IA écrit en minutes le code d'une semaine.
Mais qui garde l'intention ?
-
2 / 6 — Le risque
Sans cadre, le code dérive de ce que l'on voulait.
La spec vieillit, la dette s'accumule, et plus personne ne peut dire pourquoi.
-
3 / 6 — AIAD : qui fait quoi
AIAD organise les responsabilités autour de l'intention :
- Product Manager — construit-on la bonne chose ?
- Product Engineer — gardien de l'intention
- Agents Engineer — l'écosystème d'agents
- QA Engineer — la qualité dès le départ
- Tech Lead — la cohérence technique
La paternité de l'intention ne se délègue pas.
-
4 / 6 — SDD Mode : comment on développe
SDD Mode organise le cycle de développement :
- Intent Statement — le pourquoi, écrit par un humain
- Research — go ou no-go
- SPEC — une spécification vivante
- Execution Gate — SQS ≥ 4/5 avant de lancer l'agent
- Exécution — l'agent réalise
- Validation — technique, fonctionnelle, métier, gouvernance
- Drift Lock — code et SPEC dans la même PR
-
5 / 6 — Gouvernance intégrée
La gouvernance est dans le cycle, pas à côté : AI Act, RGPD, RGAA et RGESN disposent d'un droit de veto.
L'autonomie de l'agent se dose : points d'arrêt, seuil d'arrêt.
-
6 / 6 — L'essentiel
L'humain décide du pourquoi. L'agent exécute le comment.
npx aiad-sdd init
SDD Mode en chiffres
Le cœur du framework
Un cycle, sept étapes, zéro code sans spec validée
Le développement suit un cycle strict — on ne saute jamais d'étape. Chaque étape produit un artefact traçable, du POURQUOI humain jusqu'au verrou anti-drift de la PR.
1. Intent Statement
L'intention humaine en 5 champs : pourquoi maintenant, pour qui, objectif, contraintes, critère de drift. Auteur humain obligatoire.
Lire l'article →2. Research
Discovery ancrée dans le code, verdict gradué GO / CONDITIONAL GO / DEFER / NO-GO — tranché par l'humain.
Lire l'article →3. SPEC
La spécification vivante : scope, interface, comportement, cas limites, tests. Format prose ou EARS strict.
Lire l'article →4. Execution Gate
Le SQS score la SPEC sur 5 critères + le Test de l'Étranger. Gate fermée sous 4/5 — aucun agent ne démarre. L'ouvrir est un acte humain distinct du continuum d'autorité ; plafonds, seuil d'arrêt et périmètre y sont vérifiés dès qu'une action est irréversible. Pré-contrôle déterministe avant le SQS : à paraître.
Lire l'article →5. Exécution agent
Contexte optimisé (AGENT-GUIDE + ARCHITECTURE condensée + une seule SPEC), plan d'implémentation avant le code.
Lire l'article →6. Validation
Technique, fonctionnelle et gouvernance avec
Lire l'article →/sdd validate, puis validation métier : l'intention est-elle respectée ? Les 4 agents Tier 1 disposent d'un droit de veto fail-closed.7. Drift Lock
Code et SPEC synchronisés dans la même PR. Le drift est un échec de processus, pas une erreur d'agent.
Lire l'article →
Fondations
Trois principes fondateurs
Spec as Living Invariant
La SPEC n'est pas un document de passage : elle reste la source de vérité entre l'intention humaine et le code agent — avant, pendant et après l'implémentation. AIAD est spec-anchored : ni spec-first jetable, ni spec-as-source.
La SPEC vivante →Drift = échec de processus
Du code qui évolue sans ses artefacts n'est pas terminé. La mise à jour de la SPEC fait partie de la Definition of Done — vérifiée algorithmiquement par la matrice de traçabilité.
Le Drift Lock →Context Engineering Budget
Le Product Engineer est responsable du budget de contexte de chaque session : 60-70 % de la fenêtre au maximum, une seule SPEC à la fois, Intent en tête de contexte.
Le Context Budget →
Tier 1 — droit de veto
La gouvernance réglementaire intégrée au cycle
Quatre agents de gouvernance Tier 1 sont injectés dans chaque session qui touche leur périmètre ; le paquet livre en complément un agent CRA pour les produits logiciels. Verdict UNKNOWN = VETO : la politique est fail-closed, jamais d'auto-blanchiment silencieux.
AIAD-AI-ACT
Règlement (UE) 2024/1689, calendrier recalé sur l'Omnibus 2026/1744 : transparence en vigueur depuis le 2 août 2026, haut risque au 2 décembre 2027 (Annexe III) et au 2 août 2028 (Annexe I). Profil « agents à effet irréversible ».
En savoir plus →AIAD-RGPD
Privacy by Design : minimisation, bases légales, droits des personnes — et, pour les agents qui décident seuls, l'Art. 22 : une intervention humaine réelle, pas nominale.
En savoir plus →AIAD-RGAA
Accessibilité numérique RGAA 4.1 / WCAG 2.1 — dès que le code produit une interface utilisateur.
En savoir plus →AIAD-RGESN
Écoconception RGESN v2 : sobriété computationnelle sur toute décision technique — performance, ressources, dépendances.
En savoir plus →
L'écosystème humain
Cinq responsabilités, pas de rôles rigides
AIAD ne définit pas des postes mais des responsabilités à assumer — une personne peut en porter plusieurs. La règle d'or : chaque responsabilité a un porteur clairement identifié.
Product Manager
Responsable de la valeur. Construit-on la bonne chose ?
Détails →Product Engineer
Gardien de l'intention. Orchestre les agents IA sans trahir le POURQUOI.
Détails →Agents Engineer
Responsable de l'écosystème IA et du Harness Engineering. Un mode de permission n'est pas un contrôle : la protection repose sur l'isolation.
Détails →QA Engineer
Qualité intégrée dès le départ — efficacité n'est pas qualité, et les tests exploratoires restent 100 % humains.
Détails →Tech Lead
Cohérence technique long terme. Guide les décisions stratégiques, délègue l'opérationnel.
Détails →
Constitution AIAD
Sept valeurs immuables
Elles ne sont pas des aspirations — elles sont constitutives du framework. En retirer une fait s'effondrer l'ensemble.
1. Primauté de l'Intention Humaine
L'agent exécute. Il ne décide pas de ce qui mérite d'être construit.
2. Honnêteté sur les Contradictions
Dire la vérité sur les trade-offs plutôt que promettre l'impossible.
3. Sobriété Intentionnelle
Construire le nécessaire, pas l'impressionnant.
4. Ouverture Radicale
Open source : le savoir méthodologique se partage, il ne se verrouille pas.
5. Empirisme sans Concession
Valider par l'observation, pas par le consensus.
6. Responsabilité Partagée
Succès et échec appartiennent à l'équipe — jamais de culpabilisation.
7. Human Authorship
La paternité de l'intention ne se délègue pas. Si l'agent a rédigé l'Intent, la session est invalidée.
Prêt à passer en SDD Mode ?
Une commande installe la structure .aiad/, les 4 agents de gouvernance Tier 1 (plus l'agent CRA en complément), les 33 commandes slash et le CLAUDE.md configuré.
npx aiad-sdd init