Ingénierie Spécification-First (Développement IA piloté par RFC)

1. Vue d'ensemble du concept et problème systémique

Le piège principal pour les débutants en vibe coding est la précipitation. Le développeur ouvre son IDE agentique et tape immédiatement dans le chat : "Génère-moi une page panier avec codes promo". L'agent produit 1000 lignes de code en 15 secondes, mais :

• Un hook obsolète est utilisé à la place du gestionnaire d'état moderne du projet.
• Les codes promo sont calculés côté client au lieu du backend (faille de sécurité).
• Les noms des types sont dupliqués et la localisation est totalement ignorée.

Spec-First Engineering est la règle d'or du codage productif avec l'IA : ne jamais toucher au code sans un plan approuvé. L'ingénieur agit en tant qu'architecte principal, définissant un contrat exhaustif (implementation_plan.md), négociant les cas limites et ne donnant l'ordre de génération à l'agent qu'en dernier lieu.

2. Taxonomie architecturale et modèle mental

┌─────────────────────────────────────────────────────────────┐
│                 CYCLE D'INGÉNIERIE SPÉCIFICATION-FIRST      │
├─────────────────────────────────────────────────────────────┤
│ 1. Exploration de l'intention                               │
│    • Brainstorming, Entretien sur les cas limites ("Grill-Me")│
│    • Définition des Anti-Objectifs (ce qui NE doit PAS être)│
├─────────────────────────────────────────────────────────────┤
│ 2. Création d'un artefact de spécification formelle         │
│    • Types & Contrats de données (Interfaces TypeScript / Zod)│
│    • Carte des mutations de fichiers ([NEW], [MODIFY], [DELETE])│
│    • Critères de vérification (Commandes de tests automatisés)│
├─────────────────────────────────────────────────────────────┤
│ 3. Validation humaine et approbation par les pairs          │
│    • L'ingénieur examine le plan et apporte des corrections │
├─────────────────────────────────────────────────────────────┤
│ 4. Exécution autonome déterministe                          │
│    • L'agent exécute le plan étape par étape sans déviations│
└─────────────────────────────────────────────────────────────┘

3. Scénarios d'ingénierie pratiques en production

01. Interviewer le modèle avant le développement (Pattern Grill-Me)

Avant de rédiger le plan, le développeur donne l'instruction suivante : "Je souhaite intégrer le système de paiement Stripe. Pose-moi 5 questions pointues sur le traitement des webhooks, les paiements récurrents et la sécurité, avant d'écrire le plan". Cela permet de révéler les problèmes cachés dès la phase d'idée, plutôt qu'en production.

02. Protection contre l'érosion architecturale

Si un projet est mené par une équipe de trois ingénieurs utilisant des agents, toutes les modifications passent d'abord par une PR vers le dossier docs/specs/. L'équipe visualise l'intention avant que le modèle ne génère 50 nouveaux composants.

4. Pièges, erreurs courantes et sécurité

• Analysis Paralysis (Bureaucratie excessive) : Rédiger un plan de 20 pages pour changer la couleur d'un bouton est une perte de temps. Pour les modifications triviales, la règle de l'édition directe s'applique. La spécification est nécessaire pour les tâches impactant plus de 2 fichiers ou la logique métier.
• Dérive du plan pendant l'exécution (Spec Drift) : Si, lors du codage, l'agent découvre un nouveau détail et modifie arbitrairement l'architecture sans mettre à jour la spécification, le système perd sa maîtrise. Exigez que l'agent mette à jour le plan face à toute difficulté imprévue.

5. Conclusion stratégique pour l'ingénieur 2026

Dans un monde où la génération de code coûte zéro centime, la compétence d'ingénierie la plus précieuse n'est pas la vitesse de frappe, mais la profondeur et la précision de la formulation de la spécification technique. Celui qui maîtrise la spécification contrôle le système.