Ce que j'aurais aimé savoir avant de vibecoder

Le vibecoding, ça a l'air magique. Tu décris ce que tu veux, l'IA code. En quelques heures, tu as un projet fonctionnel.

Sauf que personne ne t'explique les pièges.

J'ai commencé à vibecoder il y a plusieurs mois. Aujourd'hui, j'accompagne des gens qui veulent lancer leur SaaS avec l'IA. Et je vois toujours les mêmes erreurs, celles que j'ai faites moi-même.

Ces erreurs m'ont coûté des heures. Parfois des jours. Une fois, j'ai dû repartir de zéro sur un VPS entier.

Voici les 6 erreurs que j'aurais aimé éviter.

Si tu veux d'abord comprendre pourquoi le vibecoding coince là où on ne l'attend pas, commence par là. Ici, on passe aux cas concrets.

Erreur 1 : Ne pas comprendre ce qu'on fait

C'est la plus vicieuse.

L'IA te propose une solution. Elle a l'air logique. Tu acceptes. Et sans t'en rendre compte, tu te retrouves embarqué dans un développement complexe alors que ton besoin était simple.

Mon exemple : Je voulais un chat basique entre utilisateurs. L'IA m'a proposé une architecture WebSocket complète avec du real-time. Ça semblait pro. Le problème ? Je voulais juste stocker les messages dans Supabase et les afficher. Pas besoin de WebSocket. Pas besoin de real-time. Ça aurait coûté inutilement cher en ressources.

J'ai refusé parce que j'avais l'expérience pour voir le piège. Mais si j'avais débuté, j'aurais suivi aveuglément. Et j'aurais passé des jours sur une usine à gaz pour un besoin de 30 minutes.

Le truc : L'IA ne connaît pas ton contexte. Elle propose souvent la solution "complète" ou "propre" selon les standards. Mais toi, tu veux peut-être juste un truc qui marche, vite, pas cher.

Avant d'accepter une suggestion, demande-toi : "Est-ce que je comprends pourquoi elle propose ça ? Est-ce que c'est vraiment nécessaire pour mon cas ?"

Erreur 2 : Pas de Git, pas de doc

Le scénario classique : ton code marche, tu demandes une petite modification, l'IA touche à plusieurs fichiers, et plus rien ne fonctionne. Tu veux revenir en arrière. Sauf que tu n'as pas commité.

Je l'ai payée plusieurs fois, celle-là, jusqu'à perdre du code pour de bon. J'ai raconté cette histoire en détail, avec le minimum vital de Git pour que ça ne t'arrive pas.

La règle tient en une phrase : commite dès que ça marche, même avec un message moche. Et documente juste assez pour que toi-même dans deux semaines tu comprennes ce que tu as fait.

Erreur 3 : Négliger la sécurité

Quand tu débutes, la sécurité semble secondaire. Tu veux que ça marche d'abord.

Le problème, c'est que réparer après coup est un calvaire. Changer tous tes secrets parce qu'ils traînent dans l'historique. Reset un VPS parce qu'il a été compromis. Des heures, parfois des jours.

Moi, j'ai dû wipe totalement un VPS. Repartir de zéro, réinstaller tous les services, reconfigurer tous les accès. J'en parle dans mes premiers articles, c'était douloureux.

Le minimum vital tient en trois gestes et cinq minutes de setup. Je les détaille dans l'article sur Git, parce que tout part de là : ce que tu commites, tu ne le reprends plus.

Erreur 4 : Prompts imprécis

Tu sais ce que tu veux dans ta tête. Le problème, c'est que l'IA n'est pas dans ta tête.

C'est exactement comme un client en web design qui dit "je veux un site moderne et dynamique". Ça ne veut rien dire. Impossible de lui livrer ce qu'il veut s'il ne le décrit pas précisément.

Avec l'IA, c'est pareil. Mais en pire.

Pourquoi en pire ? Parce qu'un humain partage tes biais de perception. Il voit les choses sous un angle similaire. Il peut deviner ce que tu veux dire. L'IA, non. Elle prend tes mots au pied de la lettre et part dans sa propre direction.

Ce que j'ai appris : Sortir de sa tête, c'est une compétence. Formuler clairement ce qu'on veut, avec le bon vocabulaire, en tenant compte du fait que l'autre n'a pas le contexte, ça s'apprend. Et plus tu pratiques, plus tes prompts deviennent précis, plus l'IA te donne ce que tu veux du premier coup.

C'est un investissement. Mais c'est ce qui fait la différence entre perdre 30 minutes à corriger l'IA et obtenir le bon résultat en 2 minutes.

Erreur 5 : Tout faire en une conversation

Si le mécanisme de la fenêtre de contexte ne te parle pas encore, je l'ai expliqué en détail ici.

L'IA a une mémoire limitée. Elle s'appelle la "fenêtre de contexte". Et quand elle est pleine, l'IA commence à oublier ce que tu lui as dit au début.

Le piège : tu veux tout faire en une seule session. Tu enchaînes les demandes. Tu ajoutes des features. Et à un moment, l'IA se contredit ou oublie des trucs importants.

Ce qui m'est arrivé : Je voulais implémenter une feature ambitieuse. J'ai poussé la conversation trop loin. Le contexte a saturé. J'ai dû m'arrêter en plein milieu.

Session suivante : l'IA était complètement perdue. Elle ne comprenait plus ce qu'on avait commencé. Elle ratait la mise en place. J'ai dû tout supprimer et tout recommencer.

La leçon : Si j'avais commencé une nouvelle conversation plus tôt, j'aurais pu finir cette feature en une seule session propre. Au lieu de ça, j'ai perdu le double de temps.

La règle : 1 tâche = 1 session. Quand tu sens que ça devient long, /clear et tu recommences avec un contexte frais. C'est contre-intuitif, mais ça va plus vite.

Erreur 6 : Ne pas tester assez vite

On ne passe jamais trop de temps à planifier. Avoir un plan clair avant de coder, c'est essentiel.

Par contre, on peut ne pas passer assez de temps à tester. Et là, ça devient un cauchemar.

Le problème : Tu avances, tu avances, tu finis ton projet. Et c'est seulement à la fin que tu testes vraiment. Tu découvres un bug. Mais maintenant, le code est complexe. L'IA a du mal à trouver d'où vient le problème. Et même quand elle le trouve, elle a du mal à comprendre ce que tu voulais exactement, parce que tu l'as codé il y a longtemps et le contexte est perdu.

Ce que j'ai appris : Teste chaque étape. Pas à la fin. À chaque étape. Dès que l'IA a implémenté quelque chose, vérifie que ça marche. Si c'est cassé, corrige maintenant, pas dans 3 jours.

C'est le meilleur moyen d'éviter de te retrouver avec un projet "fini" mais impossible à débugger.

Si tu ne retiens que ça

Le vibecoding est puissant. Mais ce n'est pas magique.

Ces 6 erreurs sont normales quand tu débutes :

1. Ne pas comprendre ce qu'on fait → L'IA t'emmène dans des directions inutiles
2. Pas de Git, pas de doc → Impossible de revenir en arrière
3. Négliger la sécurité → Des jours perdus à réparer
4. Prompts imprécis → L'IA part à côté
5. Tout en une conversation → Le contexte sature et l'IA oublie
6. Ne pas tester assez vite → Bugs impossibles à corriger à la fin

Franchement, tu vas quand même en faire au moins deux. Moi je les ai toutes faites. La différence, c'est que maintenant tu sauras les reconnaître. Commence par la plus bête : va vérifier que ton .gitignore contient bien ton .env.

Pour aller plus loin :

• Installer Claude Code en 5 minutes, même si le terminal te fait peur
• Prendre en main Claude Code, les commandes de survie pour être autonome