aicodeguide : un guide textuel pour s'orienter dans le codage assisté par IA

Un guide, pas un outil : ce que contient réellement le dépôt

Le dépôt automata/aicodeguide n'est pas une bibliothèque ni un framework. C'est un guide rédigé en Markdown, porté par Vilson Vieira et Eric S. Raymond, dont l'objectif affiché est de rassembler en un seul endroit les pratiques et les outils du codage assisté par IA. Le README le formule ainsi : « Everything you wanted to know about using AI to help you code and/or to code for you. » Le problème visé est la dispersion : modèles publiés chaque semaine, éditeurs, protocoles (MCP, A2A, SLOP), vidéos et articles éparpillés. Le guide se présente comme une tentative de tout regrouper.

Deux publics sont nommés explicitement. D'abord le développeur qui code déjà mais n'utilise pas encore d'assistant, et à qui le guide veut montrer les outils récents et les bonnes pratiques. Ensuite la personne qui n'a jamais codé et s'intéresse au vibe coding pour construire son propre produit. Le guide revendique une posture critique, avec cette formule : être « super critic about what is really important and what's just hype ».

Le dépôt ne contient ni code exécutable, ni configuration, ni script d'installation d'après le README fourni. La langue principale et la licence ne sont pas renseignées dans les métadonnées du dépôt. C'est un point à noter avant toute réutilisation du contenu.

Trois termes, une seule pratique : la clarification du vocabulaire

La section la plus utile du guide est probablement celle qui distingue AI coding, vibe coding et agentic coding, trois expressions souvent employées l'une pour l'autre. Le guide les hiérarchise.

Le AI coding est la catégorie générale : utiliser des modèles, surtout des LLM, pour produire du code. Le guide rappelle que le domaine ne date pas d'hier, en citant la génération de code en Lisp dans les années 1950, et mentionne l'existence de pistes neurosymboliques. Il range dans cette catégorie aussi bien la complétion par tabulation dans un éditeur que l'usage d'un mode agent.

Le vibe coding est décrit comme du AI coding poussé plus loin, où l'auteur du prompt ne se préoccupe pas vraiment du code produit. Le guide attribue le terme à Karpathy en 2025 et y voit un facteur de démocratisation pour des personnes qui n'auraient jamais envisagé de coder.

L'agentic coding désigne l'exécution d'un agent sur plusieurs cycles, en boucle, avec un signal de retour comme les tests, ou l'orchestration de plusieurs agents en parallèle. Le guide cite GasTown comme exemple d'orchestrateur, sans détailler son fonctionnement. Cette taxonomie est claire et c'est le principal apport du texte. Elle reste toutefois descriptive : aucune mesure, aucun cas d'usage chiffré ne vient étayer les frontières entre les trois catégories.

Deux rôles possibles : IA copilote ou IA pilote

Le guide propose une grille simple pour situer sa pratique. Dans le premier cas, l'IA augmente le développeur : brainstorming d'idées de produit dans un chat, autocomplétion de docstrings dans un éditeur. Le guide reconnaît des gains réels, en particulier pour l'exploration créative et l'automatisation des tâches répétitives.

Dans le second cas, l'IA devient le pilote et le développeur passe copilote. C'est là que se situe le vibe coding, avec des exemples concrets de configuration : le mode agent de Cursor, ou l'exécution de Claude Code avec le drapeau `--dangerously-skip-permissions`. Le guide qualifie cette approche de puissante pour s'automatiser, tout en précisant qu'elle exige de bonnes pratiques de conception de systèmes. Il ne développe pas ces pratiques dans l'extrait disponible.

Ce qui manque, c'est le critère de bascule. À quel moment un projet doit-il passer du premier mode au second ? Le guide ne le dit pas. Il pose les deux régimes côte à côte et laisse le lecteur arbitrer, ce qui est cohérent avec son format FAQ mais laisse la décision entièrement à la charge du lecteur.

Une organisation FAQ et des listes de ressources maintenues à la main

Le guide assume une structure de FAQ, pensée pour la recherche et le saut d'une question à l'autre. Chaque section se termine par une liste de ressources externes, et le guide précise que les plus récentes sont placées en haut de liste. La mise à jour est manuelle : les auteurs indiquent qu'ils font de leur mieux pour tenir le guide à jour et invitent à ouvrir une pull request ou une issue, ou à passer par leur serveur Discord, pour signaler un manque.

Cette organisation a une conséquence pratique. La valeur du guide dépend du travail de tri, pas de son volume. Une liste de liens en haut de section est utile si quelqu'un a vérifié que les liens fonctionnent et que les articles tiennent encore. Le README ne décrit aucun contrôle automatique de liens ni aucune date de dernière vérification par ressource. C'est une fragilité structurelle : un guide dont le contenu principal est une liste de liens vieillit au rythme de ces liens.

Les ressources listées dans l'extrait couvrent des formats variés : articles de blog, podcasts, vidéos, publications Substack. Les noms cités incluent Yoav Aviram, Steve Yegge, Andrej Karpathy, Mary Rose Cook, Addy Osmani, Simon Willison, Thorsten Ball et Geoffrey Huntley. Le lecteur y trouvera de quoi creuser, à condition d'accepter que la sélection reflète le point de vue des deux auteurs.

Ce que le dépôt ne fournit pas

Il faut être direct : ce dépôt ne s'installe pas. Il n'y a pas de commande à exécuter, pas de clé de configuration à renseigner, pas de fichier de paramétrage à éditer d'après le matériel disponible. Le seul élément d'interface mentionné est le lien vers le site aicode.guide et le serveur Discord. Le README ne documente ni build, ni test, ni génération de site.

La licence n'est pas indiquée dans les métadonnées du dépôt. Pour un contenu textuel destiné à être réutilisé, cité ou traduit, c'est une information déterminante, et son absence signifie qu'il faut la chercher dans le dépôt lui-même avant toute reprise. De même, la langue principale n'est pas renseignée, ce qui n'empêche pas le README d'être en anglais.

Enfin, le guide ne remplace pas la documentation des outils qu'il cite. Il nomme Cursor, Claude Code, Codex, MCP, A2A, GasTown, mais ne fournit ni référence d'API, ni exemple de fichier de configuration, ni version minimale. Pour un lecteur qui veut configurer l'un de ces outils, le guide sert de point d'entrée, pas de manuel.

Face à une documentation officielle ou à un tutoriel exécutable

L'alternative la plus évidente est la documentation officielle de l'outil que vous utilisez déjà. Elle décrit les drapeaux, les fichiers de configuration et les limites de version, ce que le guide ne fait pas. La différence d'approche est nette : le guide adopte une position transverse et compare des pratiques, là où la documentation officielle reste dans le périmètre d'un produit.

Un tutoriel exécutable, de type projet guidé avec dépôt de départ et étapes vérifiables, répond à un autre besoin : apprendre en construisant. Le guide ne propose pas ce parcours. Il se lit, il ne se pratique pas. Quelqu'un qui apprend mieux en cassant puis réparant du code trouvera peu de matière ici.

Cela dit, la comparaison joue aussi en faveur du guide sur un point : la documentation officielle d'un éditeur ne vous dira pas comment situer le vibe coding par rapport à l'agentic coding, ni quels auteurs suivre pour prendre du recul. Le guide occupe cet espace, celui de la mise en perspective, et il le fait sans promotion d'un outil en particulier d'après l'extrait disponible.

Coût de maintenance et implications de licence

Le coût de maintenance repose sur les auteurs et sur les contributions. Le guide demande explicitement des pull requests, des issues et des signalements via Discord. Pour un lecteur, cela signifie que la fraîcheur n'est garantie par aucun mécanisme visible : pas de release publiée, pas de version taguée dans les métadonnées fournies. Le dernier push enregistré date du 23 mars 2026, ce qui donne un repère temporel mais ne dit rien du rythme de mise à jour des ressources individuelles.

Si vous envisagez de réutiliser le contenu, la question de la licence se pose avant toute autre chose. Elle n'apparaît pas dans les métadonnées du dépôt. Sans identifiant de licence explicite, on ne peut pas déterminer ce qui est autorisé en matière de copie, de modification ou de redistribution. Je ne peux pas trancher ce point à partir du matériel fourni, et il ne s'agit pas d'un avis juridique : il faut consulter le fichier de licence du dépôt, s'il existe, ou contacter les auteurs.

Pour un usage en lecture seule, la question est moins pressante. Pour une traduction, une reprise dans une formation interne ou une adaptation, elle devient le premier point à vérifier.

Conclusion éditoriale

Ce guide convient aux développeurs qui découvrent les assistants de code et aux débutants qui veulent comprendre le vocabulaire du vibe coding sans y passer des semaines. Il ne convient pas à ceux qui cherchent des tutoriels exécutables, des benchmarks de modèles ou une configuration prête à l'emploi. Avant de vous y fier, vérifiez la date du dernier commit et l'état des liens vers les ressources listées, car le guide mise sur leur fraîcheur.

Sources officielles

1. automata/aicodeguide on GitHub
2. Issues
3. Project website
4. README