Pourquoi l'encodage de modèles de base de code sous forme d'instructions d'IA fonctionne mieux que l'écriture de documents que personne ne lit.
Chaque développeur connaît le paradoxe de la documentation : vous passez des heures à rédiger des documents expliquant le fonctionnement de votre base de code, puis votre coéquipier (ou votre futur moi) les ignore et demande à la place ChatGPT. L’IA donne une réponse plausible mais fausse, car elle ne connaît pas vos schémas spécifiques. Donc, vous déboguez pendant une heure, réalisez que l'IA a halluciné votre flux d'authentification et écrivez plus de documentation que personne ne lira.
J'ai rompu avec ce cycle en remplaçant la plupart de ma documentation traditionnelle par des compétences Claude : des instructions structurées qui enseignent à l'IA comment fonctionne cette base de code spécifique.
Le résultat : une IA qui suit mon architecture au lieu de deviner. Code cohérent entre les contributeurs. Et une documentation réellement utilisée, car le consommateur est une machine qui lit tout.
Les assistants de codage IA modernes sont remarquablement capables d’effectuer des tâches génériques. Demandez à Claude "d'ajouter un point de terminaison REST" et vous obtiendrez un code propre et fonctionnel. Mais cela ne correspondra pas à VOS modèles.
Dans ma base de code, les routes API utilisent Elysia avec des modèles de validation spécifiques. Les requêtes de base de données passent par Drizzle ORM avec un style de transaction particulier. Les tâches en arrière-plan utilisent Ingest avec des points de contrôle au niveau des étapes. Les vérifications d'authentification suivent un modèle de middleware spécifique.
Sans contexte, Claude produit du code qui fonctionne mais qui n'a pas sa place. Il peut utiliser les conventions Express dans une base de code Elysia. Il écrit du SQL brut au lieu d'utiliser l'ORM. Il place la logique métier dans les routes API au lieu des fonctions de service.
Le code réussit la vérification de type mais crée une dérive architecturale. Au fil des semaines, votre base de code devient un patchwork de modèles co...
[Courte citation de 8% de l'article original]