Build in Public #10 : La fin de la bidouille, comment j'industrialise le Vibe Coding (MCP + Notion)

TL;DR : J'ai atteint les limites du "chat" avec l'IA. Perte de contexte, hallucinations et coûts qui explosent. J'ai donc refondu mon workflow en connectant Cursor à Notion via le protocole MCP. Fini l'improvisation : place aux Epics, aux PRD générés par l'IA et aux fichiers de contexte .md. Voici comment je passe de l'artisanat à l'industrie.

---

Dans le dernier épisode, je parlais de croissance B2B avec ResumeRank. Aujourd'hui, retour sur le Vibe Coding et un changement de méthode qui a tout changé.

1. Le problème : l'IA est un junior amnésique

Il y a une phase "lune de miel" avec le Vibe Coding. Tu ouvres Cursor ou Lovable, tu tapes une idée, et bam, l'app apparaît. C'est magique.

Et puis, il y a la gueule de bois.

Ton projet passe de 5 fichiers à 50. Tu demandes une modification sur la page d'accueil, et l'IA casse le backend. Elle oublie les règles que tu lui as données il y a deux jours. Elle tourne en rond.

Résultat :

1. Tu brûles des crédits (tokens) pour rien.
2. Tu perds du temps à réexpliquer le contexte.
3. Tu introduis des bugs de régression.

J'ai vécu ça ces dernières semaines sur mes deux projets (ResumeRank et Sam Tennis). J'ai compris que coder avec l'IA ne dispense pas d'être organisé. Au contraire, ça l'exige.

Le problème technique, c'est la fenêtre de contexte. L'IA ne peut "voir" qu'une quantité limitée d'informations à la fois. Plus tu discutes, plus le début de la conversation s'efface.

J'ai donc arrêté de tout garder dans le chat. J'ai externalisé la mémoire du projet.

---

2. La solution : connecter Cursor à Notion via MCP

Le MCP (Model Context Protocol) est une révolution dont on parle trop peu. Pour faire simple : c'est un standard qui permet à l'IA (Claude/Cursor) de se brancher directement sur tes outils (Notion, Google Drive, Slack, base de données).

Au lieu de copier-coller des specs depuis Notion vers Cursor, Cursor va les lire tout seul.

Mon Notion, structuré comme un Product Manager

J'ai structuré mon Notion comme le ferait un chef de projet dans une boîte tech. Fini les notes en vrac. Tout est hiérarchisé selon une méthode éprouvée dans l'industrie logicielle : Projet → Epics → User Stories → Tâches.

Voici à quoi ressemble l'organisation globale de Sam Tennis dans mon Notion :

Les Epics : la colonne vertébrale du projet

Si tu ne connais pas le terme, un Epic c'est un gros chantier fonctionnel qui prend 2 à 4 semaines. C'est un concept emprunté aux méthodologies Agile (Scrum/Kanban) utilisées par toutes les équipes tech du monde.

Concrètement, au lieu de te dire "je vais ajouter plein de trucs à mon app", tu découpes ta vision en blocs indépendants et livrables :

• Epic "Gamification V1" : ajouter le système de points, les quiz et les niveaux
• Epic "Intégration Stripe" : mettre en place les abonnements payants
• Epic "Onboarding" : améliorer le parcours d'inscription des nouveaux utilisateurs

Chaque Epic a une date de début, une date de fin estimée, et un objectif clair. C'est ta roadmap :

Des Epics aux tâches : le découpage

Chaque Epic est ensuite découpé en User Stories (le besoin vu du côté utilisateur) puis en Tâches (le travail technique précis).

Prenons l'Epic "Gamification V1" :

• User Story : "En tant qu'utilisateur, je veux voir mon score après un quiz pour suivre ma progression."
• Tâche 1 : Créer le composant ScoreCard.tsx
• Tâche 2 : Ajouter la table user_scores dans Supabase
• Tâche 3 : Connecter l'API qui calcule le score

Pourquoi c'est important pour le Vibe Coding ? Parce que quand tu dis à Cursor via MCP : "Récupère les specs de l'Epic 'Gamification' dans Notion", l'IA ne reçoit pas juste une phrase vague. Elle reçoit toute la hiérarchie : l'objectif de l'Epic, les User Stories, les tâches précises, les critères d'acceptation. Elle a la Big Picture qui lui manquait.

En pratique

1. J'ouvre Cursor.
2. J'active le serveur MCP Notion (c'est natif ou via un script simple).
3. Je dis à l'IA : "Récupère les specs de l'Epic 'Gamification' dans Notion et propose-moi un plan d'implémentation."

L'IA lit la doc, comprend les contraintes métier que j'ai écrites il y a 3 semaines, et génère le code en respectant TOUT le contexte.

Le gain : J'économise 2 à 3 prompts de "mise en contexte" à chaque session. Sur un mois, ce sont des dizaines d'euros et des heures de gagnées.

---

3. La puissance des fichiers de contexte (.md)

En plus de Notion, j'ai créé une série de fichiers Markdown (.md) à la racine de mes projets. Ce sont les "Tables de la Loi" que l'IA doit lire avant de coder.

L'astuce "Learning Opportunity"

Quand je suis bloqué ou que je ne comprends pas un bug, j'utilise cette technique :

"Explique-moi pourquoi ça a planté, et mets à jour le fichier @tech_rules.md pour qu'on ne refasse plus jamais cette erreur."

L'IA apprend de ses erreurs et met à jour sa propre documentation. Le système devient plus intelligent à chaque bug.

---

4. Devenir un "Senior Vibe Coder"

Ce changement d'organisation marque une transition. Au début, on est des Juniors qui s'émerveillent que l'IA écrive du code. Ensuite, on devient des Seniors qui réalisent que le code n'est que la finalité. La vraie valeur, c'est l'architecture et la clarté de la demande.

Avec ce système (Notion + MCP + Fichiers Contextuels), je ne suis plus en train de "discuter" avec un chatbot. Je suis en train de piloter une équipe de devs virtuels avec une roadmap claire.

---

Récap : Les 3 leçons à retenir

1. Le prompt est éphémère, la documentation est permanente

Si tu te lances dans le Vibe Coding, ne mets pas toute ta valeur dans le prompt. Structure ton projet ailleurs (Notion, Obsidian, Linear) et utilise le MCP pour connecter tes notes aux mains de l'IA.

2. 80% de planification, 20% de code

C'est contre-intuitif, mais c'est la clé. Passer du temps à écrire des fichiers .md clairs avant de coder réduit drastiquement les allers-retours et les bugs de régression.

3. Un système qui apprend vaut plus qu'un dev qui sait

Chaque bug corrigé enrichit le fichier @tech_rules.md. Au bout de 3 mois, tu as un assistant IA qui connaît toutes les subtilités de ton projet. C'est un avantage compétitif que personne d'autre n'a.

---

Questions fréquentes

Comment connecter Cursor à Notion via MCP ?

Le MCP (Model Context Protocol) est un standard qui permet à Cursor de lire directement tes bases Notion. Tu actives le serveur MCP Notion dans les paramètres de Cursor, et ensuite l'IA peut chercher, lire et utiliser tes documents Notion comme contexte. Plus besoin de copier-coller.

C'est quoi un Epic exactement ?

Un Epic, c'est un gros chantier fonctionnel qui prend généralement 2 à 4 semaines. C'est un concept issu des méthodologies Agile (Scrum/Kanban). Au lieu de lister des tâches en vrac, tu regroupes tout ce qui concerne un même objectif sous un Epic. Par exemple : "Gamification V1" regroupe toutes les tâches liées aux quiz, aux scores et aux niveaux. Ça donne de la visibilité sur l'avancement global et ça permet à l'IA de comprendre le pourquoi derrière chaque tâche technique.

Combien de fichiers .md faut-il pour un projet ?

Pour un projet sérieux, je recommande au minimum 3 : tech_stack.md (technologies), tasks.md (tâches en cours) et rules.md (règles pour l'IA). L'ajout de user_audit.md et seo_audit.md est un plus qui fait la différence sur le long terme. Le tout, c'est de les mettre à jour régulièrement.

Est-ce que ça marche aussi avec Lovable ?

Partiellement. Lovable a son propre système de "Custom Knowledge" qui remplit un rôle similaire (mémoire à long terme). Mais le MCP et les fichiers .md sont plus puissants car tu gardes le contrôle total. C'est l'une des raisons pour lesquelles je recommande Cursor pour les projets sérieux.

---

À très vite, Guillaume 👋