Le problème que Git n'a jamais résolu

Tu connais ce sentiment. Tu reviens sur un projet après quelques semaines de pause, et tu tombes sur des messages de commit cryptiques — voire aucun message du tout. Pourquoi avoir choisi cette bibliothèque ? Quels compromis avaient été envisagés ? Pourquoi cette approche a-t-elle été abandonnée ?

Git enregistre les modifications avec une précision obsessionnelle. Il ne capture pas les raisonnements.

Ce fossé devient critique quand l'IA débarque dans ton workflow. Les assistants de coding actuels sont puissants, certes. Mais ils manquent cruellement de contexte. Ils ignorent tes décisions architecturales. Ils ne peuvent pas t'expliquer pourquoi tu as refactoré ce module. Chaque session repart de zéro, comme si ton code soigneusement façonné était celui d'un parfait inconnu.

Persist-OS change cette équation.

C'est quoi, Persist-OS ?

En deux mots, Persist-OS est un outil en ligne de commande, local par défaut, qui offre à ton dépôt une mémoire durable et exploitable par l'IA. Considère-le comme un journal vivant des décisions, qui capture non seulement ce que fait ton code, mais surtout pourquoi il le fait.

Le concept clé repose sur les ADR — Architecture Decision Records. Ce sont des documents structurés qui consignent les décisions importantes prises pendant le développement : le contexte, les options envisagées, et le raisonnement derrière le choix final.

Mais Persist-OS va bien au-delà de la simple documentation. Il maintient des modules complets couvrant les fonctionnalités, l'architecture, les standards et les tests. Tout est conçu pour être lisible par une machine et consommable par l'IA. Tes outils d'IA peuvent enfin comprendre l'historique et les contraintes de ton projet.

Le Doctor : le médecin de ton projet

L'une des fonctionnalités les plus innovantes, c'est la commande « doctor ». Un validateur de santé déterministe qui vérifie l'état de ton projet, confirme que les décisions sont bien documentées, et détecte les dérives par rapport aux patterns établis.

C'est particulièrement précieux pour les équipes qui gèrent des architectures complexes ou les startups en pleine croissance. Au lieu de découvrir une dérive architecturale des mois plus tard, le doctor surveille en continu et livre des insights actionnables.

La nature déterministe est cruciale ici. Contrairement aux évaluations subjectives de qualité de code, le doctor fournit une validation reproductible — n'importe quel membre de l'équipe peut l'exécuter et obtenir les mêmes résultats.

Pourquoi le local-first change tout

À l'heure du tout-cloud, il y a quelque chose de rafraichissant dans l'approche locale de Persist-OS. La mémoire de ton projet vit dans ton dépôt, versionnée au côté de ton code. Pas de vendor lock-in. Pas d'abonnement pour accéder à tes propres décisions.

Pour les équipes qui souhaitent garder leurs discussions architecturales confidentielles ou protéger leurs décisions propriétaires, le local-first signifie que ton raisonnement ne quitte jamais ton infrastructure. Les modèles d'IA peuvent toujours accéder à cette mémoire et l'exploiter, mais la source reste sous ton contrôle.

S'intégrer dans les workflows modernes

Persist-OS s'insère naturellement dans les workflows de développement assistés par IA. Quand tu fais du vibe coding ou que tu travailles en pair programming avec un assistant IA, Persist-OS garantit que le contexte persiste. Ton IA ne se contente pas de voir ton code actuel — elle comprend ton parcours architectural.

Pour les startups qui avancent vite et cassent des choses, cette documentation se fait automatiquement. Fini le « on documentera plus tard » (qui ne vient jamais). Les décisions sont capturées au moment où elles sont prises. L'onboarding des nouveaux venus devient dramatiquement plus rapide quand ils peuvent demander pourquoi le projet ressemble à ça.

Par où commencer ?

Persist-OS est disponible sur GitHub et conçu pour une adoption sans friction. La CLI te guide pour capturer tes premières décisions, et la commande doctor aide à valider l'état de ton codebase existant.

Que tu bosses en solo, que tu gères une startup ou une équipe distribuée, la mémoire persistante d'un projet transforme ta façon de penser la durabilité du code.

Git enregistre ce qui a changé. Persist-OS enregistre pourquoi — et c'est toute la différence entre du code que tu maintiens et du code que tu comprends vraiment.