TL;DR :"Vibe Coding" — la pratique de guider de manière décontractée l'IA pour construire des logiciels — est à la mode. Mais sans structure, cela mène inévitablement à la "dérive contextuelle" et au code spaghetti. Pour construire des logiciels de niveau entreprise avec l'IA, vous avez besoin d'une architecture de contexte rigide.À Mercury, nous appelons cela "Le Protocole Codex."Cela considère votre documentation non pas comme une suggestion, mais comme la Loi immuable que l'IA doit consulter avant d'écrire une seule ligne de code.James ici, PDG de Mercury Technology Solutions.L'internet s'agite avec le "Vibe Coding." La promesse est séduisante : vous parlez de manière décontractée ("vibes") à une IA, et elle construit une application.
J'ai examiné les flux de travail populaires circulant dans les cercles de développement. Ils sont brillants pour les prototypes, mais ils ont un défaut fatal pour l'ingénierie sérieuse :
Ils supposent que l'IA se souvient du "Grand Tableau." Ce n'est pas le cas.
Les LLM souffrent d'entropie. Au fur et à mesure qu'une conversation s'allonge, l'IA oublie le schéma de base de données sur lequel vous vous êtes mis d'accord il y a 40 messages. Elle commence à inventer de nouveaux modèles. Le "Vibe" se transforme en chaos.Chez Mercury, nous avons affiné cela en un flux de travail rigoureux. Nous ne l'appelons pas Vibe Coding. Nous l'appelons
Ingénierie Contextuelle.
Voici le "Protocole Mercury" pour construire des logiciels avec l'IA en utilisant une Source Unique de Vérité que nous appelonsLe Codex.
La Philosophie de Base : "Le Codex"Le secret n'est pas le modèle (Claude vs. GPT-5). Le secret estMémoire Externalisée.
Vous devez traiter votre dossier de projet non seulement comme un endroit pour le code, mais comme un "Cerveau" pour l'IA. Nous imposons une structure de dossier stricte appelée
/codex.Pourquoi "Codex" ? Parce que cela implique l'autorité. Ce ne sont pas des notes ; ce sont des
Lois.Avant que l'IA n'écrive une seule ligne de code, elle doit consulter Le Codex.La Structure
Créez un dossier nommé /codex dans votre répertoire racine. Il contient cinq fichiers immuables :product-vision.md (Le Pourquoi) :L'objectif de haut niveau. (par exemple, "Un jeu de combat multijoueur en 3D utilisant ThreeJS").
tech-stack.md (Le Comment) :
Les outils spécifiques. (par exemple, "WebSockets pour le réseau, Rapier pour la physique. Pas de React, juste du JS vanilla").
- architecture.md (La Carte) :La structure des fichiers et le schéma de base de données.
- C'est le fichier le plus critique.implementation-plan.md (Le Chemin) :
- Une liste de tâches étape par étape. Chaque étapedoitavoir un test de vérification.
- progress.md (Le Journal) :Ce qui est fait, ce qui est en attente.Le Flux de Travail : Architecture --> Exécution --> VérificationNe vous contentez pas d'ouvrir un chat et de commencer à coder. Suivez cette boucle.
- Phase 1 : L'Architecte (Modèle : Claude Opus 4.5)Nous utilisons le modèle le plus intelligent et le plus lent pour écrire la loi.
Action : Vous agissez en tant que Chef de Produit. Vous déversez votre cerveau dans le chat.
Do not just open a chat and start coding. Follow this loop.
Phase 1: The Architect (Model: Claude Opus 4.5)
We use the smartest, slowest model to write the law.
Action: You act as the Product Manager. You dump your brain into the chat.
Invite : "Agissez en tant qu'Architecte Système. Créez les entrées pour product-vision.md et tech-stack.md en fonction de mon idée. Ensuite, proposez architecture.md. Ne rédigez pas encore de code. Ces fichiers iront dans Le Codex."
Résultat : Vous verrouillez le design. Vous interdisez explicitement à l'IA de prendre des décisions architecturales par la suite.
Phase 2 : Le Scribe (Modèle : Claude Sonnet 4.5 / Codex)
Nous utilisons le modèle rapide et 'agentique' pour exécuter la loi.
La Règle d'Or : Chaque nouvelle session de chat DOIT commencer par la consultation du Codex par l'IA.
Invite : "Consultez /codex/@architecture.md et /codex/@implementation-plan.md. Nous sommes actuellement à l'Étape 3. Implémentez l'Étape 3 en respectant strictement l'architecture définie dans Le Codex. Ne passez pas à l'Étape 4."
En forçant l'IA à lire le /codex à chaque fois, vous éliminez "le Dérive de Contexte". Peu importe si vous êtes à l'invite #1 ou à l'invite #100 ; l'IA est ancrée dans la même vérité.
Phase 3 : Le Vérificateur (Modèle : Humain + Outils de Navigateur)
C'est votre travail.
Les guides populaires suggèrent d'utiliser l'automatisation, mais j'insiste sur la Vérification Humaine.
Action : L'IA dit "L'Étape 3 est terminée."
Vous : Exécutez le code. Vérifiez les journaux. Le plan 3D vole-t-il réellement ?
Étape Cruciale : Si cela fonctionne, vous ordonnez à l'IA : "Mettez à jour /codex/@progress.md pour marquer l'Étape 3 comme complète. Mettez à jour /codex/@architecture.md si vous avez ajouté de nouveaux fichiers."
Ce n'est qu'alors que vous vous engagez sur Git.Git est votre point de sauvegarde.Si l'IA hallucine à l'Étape 4, vous faites git reset --hard et réessayez.
L'Avantage "Antigravité" : Arbitrage de Modèle
Le guide original suggère de choisir un outil. Je ne suis pas d'accord.
Utilisez l'Arbitrage de Modèle :
- Planification (L'Architecte) :UtilisezOpus 4.5.Il réfléchit profondément aux cas limites et rédige un Codex robuste.
- Codage (Le Scribe) :UtilisezSonnet 4.5.Il suit les instructions et est moins cher.
- Refactoring (Le Bibliothécaire) :UtilisezGemini 3 Pro.Il a une immense fenêtre de contexte pour lire l'ensemble de la base de code à la fois si les choses deviennent désordonnées.
Conclusion : De "Vibe" à "Vision"
"Vibe Coding" implique que vous pouvez simplement vous détendre pendant que l'IA travaille. C'est faux.
Ce flux de travail déplace votre effort de la Taper à la Gouvernance.
- Vous n'êtes plus un maçon.
- Vous êtes leGardien du Codex.Votre travail est de garantir que le
Codexreste propre. Si architecture.md devient désordonné, le code devient désordonné. Si implementation-plan.md est vague, l'IA sera bloquée.Maîtrisez le Codex, et vous pourrez construire des logiciels de niveau entreprise seul. Ignorez-le, et vous aurez juste un dossier plein de scripts cassés.
Mercury Technology Solutions : Accélérez la Digitalité.
Mercury Technology Solutions: Accelerate Digitality.
