Jon

le plus gros gaspillage de tokens quand on dev avec l'IA, c'est rarement le code généré c'est tout le temps que ton IA passe à essayer de comprendre le code qu'elle a elle-même écrit 2 jours plus tôt et plus le projet grossit, plus ça part en cacahuète encore ce matin, un non-dev qui a build son CRM avec l'IA m'expliquait que c'était devenu un foutoir, alors qu'il voulait juste ajouter une petite feature à chaque nouvelle session, ton agent doit retrouver le contexte, explorer les fichiers, comprendre les décisions prises... bref, tu crames des tokens à redécouvrir ce que tu as déjà développé ma petite solution : intégrer la documentation automatique directement dans mon harnais de développement petit aperçu 👇 1/ mon développement repose sur 2 outils principaux : → Superpowers pour planifier, développer et tester chaque feature → Ponytail pour les code reviews et éviter de partir dans des trucs complètement over-engineerés l'idée, c'est de garder un workflow simple, mais rigoureux 2/ j'ai ensuite créé un skill custom pour la documentation à chaque feature terminée, Claude analyse les changements dans le code et met à jour les fichiers Markdown concernés architecture, fonctionnalités, décisions techniques, etc. tout se fait dans le workflow, sans avoir besoin de lui rappeler de documenter 3/ toute cette documentation est aussi accessible via Astro Starlight c'est pas nécessaire pour l'agent, c'est surtout pour moi Starlight transforme les fichiers Markdown en un vrai petit site de documentation, propre et navigable et tout reste dans le même repo GitHub que le code 4/ mais le plus important, c'est la synchronisation parce qu'une documentation obsolète, ça peut vite devenir pire que pas de documentation du tout j'ai donc ajouté quelques vérifications : → fin de feature : comparaison entre le code et la documentation → fin de session : hook pour détecter les éventuels oublis → avant de merge : tests et vérification de la documentation le but, c'est d'éviter que le code et la doc commencent à raconter deux histoires différentes 5/ et c'est là que ça devient intéressant quand je reprends un projet, mon agent peut directement consulter une documentation structurée au lieu de devoir tout réexplorer moins de contexte à reconstruire, moins de tokens gaspillés et surtout beaucoup moins de bordel quand le projet commence à grossir évidemment, ça ne remplace ni la lecture du code ni les tests mais ça évite de repartir de zéro à chaque nouvelle session et au final, mon harness reste ultra simple : Superpowers + Ponytail + 1 skill documentation + quelques hooks + CI pas besoin de 50 agents et de 200 skills pour développer proprement

je pense qu'on sous-estime complètement ce qui va se passer avec l'IA dans les 5 prochaines années le vrai game changer ça va pas être les modèles, mais la disparition de la friction regardez Grok Bot, Muse et cie y'a encore 3 ans fallait bidouiller des API, des connecteurs, configurer plein de trucs pour avoir un assistant qui gère vos mails et votre agenda aujourd'hui ça devient accessible en quelques minutes demain ce sera directement intégré à votre téléphone et tous les petits SaaS qui vendent 30$/mois pour faire UNE tâche que votre assistant personnel pourra faire nativement ? je pense qu'on va passer d'une époque où on payait pour des outils IA à une époque où on demande simplement à notre IA de faire les choses

quand on crée des apps métier pour des entreprises, on ne peut pas se permettre de faire n'importe quoi la qualité du code généré est excellent, on est plus en 2024 mais sans guidelines, elle fait ce qui marche pas forcément ce qui tient → une requête par ligne au lieu d'une seule → un pool de connexions sans timeout → des listes qui grossissent à chaque saison, jamais paginées avec 50 lignes en dev, tout est rapide avec 3 ans de données chez le client, c'est autre chose alors j'ai fait un skill d'audit de perf il lit le code et la base, calibre selon les vrais volumes, et sort les priorités P1, P2, P3 il ne modifie rien, il vérifie le skill en commentaire