Journal de build : reprendre une app vibe codée sans chercher où vous en étiez
Un journal de build Notion pour vos apps vibe codées : une entrée par session, ce qui est fait, en cours et la suite. Le gabarit et le rituel de reprise.
Un journal de build est une page Notion où chaque session de vibe coding laisse une entrée courte : ce qui est fait, ce qui reste en cours, la prochaine étape, l’outil utilisé et la dernière version qui marche. Quand vous rouvrez votre app après une semaine, vous lisez l’entrée du dessus et vous savez où reprendre.
Le scénario est connu de tous ceux qui construisent une app avec Lovable, Bolt, Cursor ou Claude Code. Vous avancez vite pendant trois soirées, puis la vie reprend le dessus. Huit jours plus tard, vous rouvrez le projet, et plus rien n’est clair : quelle fonctionnalité était terminée, laquelle était à moitié faite, ce que vous aviez décidé de ne pas faire.
Ce guide montre comment tenir ce journal sans y passer vos soirées. Il fait partie du guide pour organiser ses projets de vibe coding dans Notion, et reprend la structure que j’ai construite pour VibecodingOS.
Pourquoi l’historique de votre outil ne suffit-il pas ?
Votre outil garde tout, et c’est justement le problème. L’historique d’une conversation de vibe coding mélange les demandes, les essais ratés, les corrections, les retours en arrière et les messages d’erreur. La dernière étape utile s’y trouve, quelque part, entre deux cents messages.
Trois choses manquent à cet historique :
- Un résumé. Il raconte tout ce qui s’est passé, il ne dit pas où vous en êtes.
- Ce qui a été vérifié. L’outil sait ce qu’il a écrit, pas ce que vous avez testé dans le navigateur.
- La continuité entre outils. Le jour où vous passez de Lovable à Cursor, l’historique reste dans le premier outil.
Relire une conversation entière pour retrouver le fil prend souvent plus de temps que la tâche elle-même. Le journal de build remplace cette relecture par une lecture de trente secondes.
Qu’est-ce qu’un journal de build ?

C’est une base Notion, avec une page par session de travail. Une session, c’est une soirée, une matinée, un créneau où vous ouvrez votre outil avec une intention. Chaque entrée tient en cinq à dix lignes, jamais plus.
La règle qui fait marcher le journal : on l’écrit à la fin de la session, pas au début de la suivante. À la fin, vous savez exactement où vous en êtes. Une semaine plus tard, vous ne le savez plus, et c’est précisément pour ce moment-là que l’entrée existe.
Le journal ne remplace ni votre liste de fonctionnalités, ni vos tests. Il les relie : chaque entrée cite la fonctionnalité travaillée, et dit si une nouvelle version stable a été atteinte. Quand j’ai construit VibecodingOS, c’est la base que j’ai voulue la plus simple à remplir, parce que c’est celle qu’on abandonne en premier si elle demande un effort.
Que noter à chaque session ?
Voici le gabarit d’entrée que j’utilise. Cinq rubriques, toujours dans le même ordre, pour que l’œil sache où chercher.
| Rubrique | Ce que vous y écrivez | Exemple |
|---|---|---|
| Fait | Ce qui marche et que vous avez vérifié vous-même | Le client accepte un devis en ligne |
| En cours | Ce qui est commencé, avec l’endroit précis où vous vous êtes arrêté | Le paiement : le bouton existe, la confirmation n’arrive pas |
| La suite | La toute prochaine action, assez petite pour une session | Relier le paiement au devis accepté |
| Outil | L’outil utilisé pendant la session | Lovable |
| Version stable | Oui ou non, et comment y revenir si oui | Oui, point de restauration du 20 octobre |
Deux détails font la différence. Dans En cours, écrivez le symptôme, pas une intention : « la confirmation n’arrive pas » vous remet dans le problème, « finir le paiement » ne vous dit rien. Et dans La suite, une seule action. Trois actions, c’est déjà une liste de tâches, et elle n’a pas sa place ici.
Ajoutez au besoin une ligne Décision quand vous avez tranché quelque chose pendant la session : garder une bibliothèque, abandonner une fonctionnalité, changer la structure d’une table. C’est le genre d’information que votre outil vous proposera de défaire un mois plus tard.
Comment tenir le journal sans y passer dix minutes ?

Le journal tient en trois gestes, répartis sur la session.
- Au début : relire la dernière entrée. Trente secondes. Vous repartez de « La suite » plutôt que d’une idée du moment.
- Pendant : noter les décisions au fil de l’eau. Une ligne suffit, au moment où vous tranchez.
- À la fin : demander le compte rendu à l’outil. C’est l’astuce qui fait tenir le journal dans la durée.
Votre outil a toute la session sous les yeux. En fin de session, demandez-lui un compte rendu au format de votre gabarit : ce qui a été fait, ce qui reste en cours, la prochaine étape. Vous relisez, vous corrigez ce qu’il présente comme fait alors que vous ne l’avez pas testé, et vous collez le résultat dans Notion. Deux ou trois minutes en tout.
Corrigez toujours la rubrique Fait. L’outil a tendance à y mettre ce qu’il a écrit, pas ce qui fonctionne. Seul ce que vous avez vérifié dans le navigateur mérite d’y figurer.
Certains outils peuvent aussi écrire directement dans Notion, à condition d’être connectés à votre espace. Dans ce cas, le compte rendu arrive tout seul dans la base, et vous n’avez plus qu’à le relire.
Comment reprendre un projet vibe codé après une semaine ?
La reprise est le moment où le journal rapporte tout ce qu’il a coûté. Voici le rituel que je suis, en cinq minutes :
- Lire la dernière entrée, et seulement elle.
- Ouvrir l’app et vérifier « Fait » : les parcours notés comme terminés marchent-ils toujours ?
- Repérer la dernière version stable, pour savoir à quoi revenir si la session tourne mal.
- Donner le contexte à l’outil : collez l’entrée du journal dans votre premier message, avec la fiche de l’app si vous en tenez une.
- Commencer par « La suite », pas par l’idée qui vous est venue dans le métro.
Le quatrième point compte plus qu’il n’y paraît. Un outil qui reçoit « voici où nous en étions, voici la prochaine étape » repart dans la bonne direction. Un outil qui reçoit « continue le paiement » repart de ce qu’il devine. Si les idées vous viennent plus vite que vous ne les codez, rangez-les dans un tracker d’idées plutôt que dans le journal.
Journal de build, Git ou historique de l’outil : quelle différence ?
Les trois se complètent. Aucun ne remplace les deux autres.
| Ce qu’il garde | Historique de l’outil | Git | Journal de build |
|---|---|---|---|
| Le code, version par version | Oui, dans l’outil | Oui, partout | Non |
| Ce que vous avez vérifié | Non | Seulement si vous l’écrivez dans le message | Oui, rubrique « Fait » |
| La prochaine étape | Non | Non | Oui |
| Les décisions et leur raison | Noyées dans la conversation | Rarement | Oui |
| Lisible en trente secondes | Non | Non | Oui |
Git et l’historique de votre outil servent à revenir en arrière dans le code. Le journal sert à revenir dans le projet. C’est d’ailleurs lui qui dit à quel point de l’historique revenir quand une modification casse tout : c’est le sujet de l’article sur la version stable en vibe coding.
Partir d’un template
VibecodingOS est le template Notion que j’ai construit pour mener des apps vibe codées. Le journal de build y est une base à part entière, reliée aux stories et à la recette : chaque session note ce qui a été fait et les versions stables atteintes. Le template fournit aussi le texte de compte rendu de fin de session à donner à votre outil, et une page par étape, du cadrage à l’exploitation.
Questions fréquentes
Qu’est-ce qu’un journal de build en vibe coding ?
C’est une base Notion où chaque session de travail avec votre outil laisse une entrée courte : ce qui est fait et vérifié, ce qui reste en cours, la prochaine étape, l’outil utilisé et la dernière version stable. Il sert à reprendre un projet en trente secondes plutôt qu’en relisant toute la conversation.
Combien de temps faut-il pour tenir un journal de build ?
Deux à trois minutes par session. Demandez à votre outil un compte rendu au format de votre gabarit en fin de session, relisez-le, corrigez la rubrique « Fait » et collez-le dans Notion. Le temps gagné à la reprise suivante est largement supérieur.
Faut-il un journal si j’utilise déjà Git ?
Oui. Git garde l’état du code et permet d’y revenir. Il ne dit ni ce que vous avez testé, ni la prochaine étape, ni pourquoi vous avez pris une décision. Le journal donne ce contexte, et indique à quel commit revenir quand une modification casse quelque chose.
Que faire si j’ai oublié de remplir le journal ?
Demandez à votre outil de résumer la dernière session à partir de la conversation, puis vérifiez vous-même ce qui marche avant de remplir « Fait ». Ne recopiez jamais un résumé sans l’avoir confronté à l’app : c’est le seul moyen que la rubrique reste fiable.
Le journal de build marche-t-il à plusieurs ?
Oui, et il devient encore plus utile. Ajoutez une propriété Personne à chaque entrée : chacun voit qui a travaillé sur quoi, et celui qui reprend une fonctionnalité lit les entrées de son collègue avant d’ouvrir l’outil.