N'utilisez pas Claude Code sans avoir fait ceci

AAI LABS
컴퓨터/소프트웨어창업/스타트업AI/미래기술

Transcript

00:00:00La vérité est que l'IA ne révolutionnera jamais le processus de création de logiciels, du moins pas de la manière dont vous le pensez.
00:00:05Certes, cela accélère tout, et il est également plus facile de s'en remettre quand les choses tournent mal.
00:00:10Mais les processus établis sur plus de 60 ans de création de produits sont toujours aussi importants aujourd'hui, juste pour des raisons différentes ;
00:00:16avant, ils étaient mis en œuvre pour s'assurer que les humains disposaient d'une méthode structurée pour développer ces produits.
00:00:21Mais aujourd'hui, cela a changé pour permettre aux agents d'IA de travailler comme le faisaient les humains.
00:00:25Ainsi, pour que les agents d'IA fonctionnent correctement, vous devez configurer leur environnement de la bonne manière afin qu'ils suivent réellement le processus.
00:00:32Et nous allons passer en revue toutes les étapes que vous devez franchir avant même de commencer à construire.
00:00:36Planifier correctement vos exigences est la chose la plus importante à faire avant d'écrire une seule instruction.
00:00:41C'est l'étape où, quel que soit le niveau des modèles, vous devrez y consacrer du temps.
00:00:45Il existe désormais plusieurs façons de planifier.
00:00:46Vous pouvez planifier votre application en utilisant Claude Code en mode planification, mais sa planification est très axée sur la technique, pas sur le produit.
00:00:52Comme nous l'avons mentionné dans la vidéo précédente, avec l'évolution des agents,
00:00:56le mode planification n'a pas besoin d'être aussi détaillé ou technique et devrait plutôt se concentrer lourdement sur l'aspect produit
00:01:01car les nouveaux modèles sont puissants et la planification doit être différente de ce qu'elle était avec les premiers modèles peu performants.
00:01:07Ainsi, au lieu du mode planification de Claude, vous pouvez créer un autre agent pour vous aider à planifier votre application.
00:01:11Il contient les instructions pour aider à construire un PRD correct avec un modèle pour guider Claude sur les exigences exactes.
00:01:18Une fois l'agent configuré, vous pouvez donner une instruction à Claude pour l'utiliser et planifier l'application que vous souhaitez construire.
00:01:23Il charge en fait l'agent planificateur et continue de poser des questions jusqu'à ce qu'il comprenne toutes les exigences.
00:01:28Il continue de poser des questions jusqu'à ce que vous soyez satisfait de la planification.
00:01:32Maintenant, pour comprendre le MVP, l'agent est conçu pour poser de nombreuses questions.
00:01:36Et à la fin, il vous demandera s'il y a autre chose dont vous avez besoin dans votre application.
00:01:40Si oui, vous pouvez ajouter les éléments que vous souhaitez que l'agent implémente.
00:01:43Si vous êtes satisfait de toutes les questions et pensez que l'agent a compris le plan, vous pouvez simplement lui dire que c'est tout.
00:01:49Après la session de questions-réponses, il crée un document PRD et l'enregistre dans le dossier du projet.
00:01:54Ce document contient les détails de toutes les exigences dont vous avez discuté.
00:01:57L'implémentation est divisée en phases et contient toutes les décisions de conception clés et tout ce qui est nécessaire pour l'application.
00:02:04Maintenant que vous avez affiné l'application que vous voulez construire, l'étape suivante consiste à définir correctement un fichier Claude.md.
00:02:10Ce fichier est important car il contient toutes les instructions que vous voulez que votre agent suive.
00:02:15Vous liez le document PRD afin qu'il puisse accéder directement à toutes les exigences de l'application sans que vous ayez à répéter quoi que ce soit ici.
00:02:21Ce fichier ne doit contenir que les choses que l'agent ne connaît pas au lieu de mentionner celles qu'il connaît déjà.
00:02:27Il fait référence aux règles que vous voulez que le projet suive.
00:02:30Vous pouvez ajouter vos conventions de projet et toutes les instructions que vous voulez que Claude suive spécifiquement lors de l'implémentation.
00:02:37L'approche idéale est de ne pas créer le fichier Claude.md à partir de la commande init, mais de le créer vous-même
00:02:43car cette commande génère le fichier en fonction de la base de code existante, et non de ce qu'il doit réellement savoir.
00:02:49Mais ce fichier n'est pas un fichier que l'on écrit une fois et qu'on oublie.
00:02:53Vous devez continuer à y ajouter des éléments pour qu'il puisse améliorer progressivement le processus de création d'applications pendant que vous travaillez.
00:02:58Comme nous en avons parlé dans notre vidéo précédente, ce fichier est chargé une fois et reste dans le contexte indéfiniment, servant de guide de travail.
00:03:05Assurez-vous donc que ce fichier ne contient pas de choses inutiles ou spécifiques à un domaine d'implémentation.
00:03:12Les éléments à ajouter à ce fichier sont les meilleures pratiques, vos conventions de codage, votre style d'écriture et vos conventions,
00:03:19et d'autres choses similaires, mais pas ce qu'il peut deviner par lui-même, comme la structure du projet.
00:03:24Pour cela, il peut lire la structure des fichiers et la comprendre par lui-même.
00:03:28Prenez donc votre temps lors de la rédaction de ce fichier et assurez-vous qu'il est bien adapté à vos besoins avant d'implémenter l'application.
00:03:36La chose suivante à configurer sont vos compétences, vos agents et tout MCP que vous souhaitez utiliser, le tout avant la construction.
00:03:42Les MCP sont plus faciles à connecter.
00:03:44Vous pouvez simplement connecter le service externe auquel vous voulez que l'agent accède et les installer via leurs commandes d'installation.
00:03:50Par exemple, nous voulions notre backend sur Supabase, nous avons donc connecté le MCP Supabase à notre agent dans le projet.
00:03:57Si vous utilisez Shadcn UI pour les composants d'interface et Playwright pour les tests de navigation,
00:04:01vous devez les connecter tous avant de construire l'application afin que les agents puissent accéder à ces outils pendant la création.
00:04:07Mais c'était seulement pour la connexion aux services externes ; vous devez également configurer les agents.
00:04:12Vous pouvez configurer autant d'agents que nécessaire.
00:04:14Vous avez déjà un agent planificateur dédié pour la planification.
00:04:16Vous pouvez aussi créer un agent de commit chargé de valider, de lancer les pré-vérifications et de suivre les messages de commit conventionnels.
00:04:23Vous pouvez avoir un agent de refactorisation qui améliore le code et les performances globales.
00:04:28Et un agent de vérification qui utilise le MCP Playwright pour vérifier si l'interface et le flux utilisateur fonctionnent comme prévu.
00:04:39En plus des agents, vous devez également configurer des compétences (skills).
00:04:42Vous pouvez en créer autant que nécessaire via le Skill Creator disponible sur le dépôt GitHub open source.
00:04:49Vous pouvez ajouter autant de références que vous voulez et inclure des scripts pour qu'il puisse les exécuter et utiliser leur résultat.
00:04:55Pour distinguer l'usage des agents et des compétences : implémentez comme compétences les flux de travail répétitifs nécessitant guide et références.
00:05:04Par exemple, vous pouvez créer une compétence front-end car c'est un flux répétitif qui doit suivre des directives constantes dans toute l'appli.
00:05:11Utilisez des agents pour les tâches qui nécessitent une fenêtre de contexte dédiée.
00:05:14Vous pouvez aussi utiliser la compétence front-end open source activement utilisée par le créateur de Claude Code lui-même.
00:05:20Vous devez également ajouter des règles spécifiques aux chemins pour certains aspects de votre application.
00:05:23Ces règles définissent le chemin auquel elles s'appliquent et incluent toutes les instructions pour cette partie spécifique.
00:05:29Vous pouvez en configurer autant que vous voulez et les lier dans votre Claude.md pour que l'agent sache qu'il doit les suivre.
00:05:36Comme dit plus tôt, Claude.md est pour les principes généraux ; les règles par chemin sont donc adaptées aux implémentations spécifiques.
00:05:46Nous couvrons toutes ces configurations et bien plus sur la création de produits avec l'IA sur cette chaîne, alors abonnez-vous.
00:05:54Mais même avec toutes ces instructions positives, il reste une lacune.
00:05:58Les agents ont tendance à agir et peuvent implémenter des choses au-delà de vos contraintes positives.
00:06:03Par conséquent, vous devez explicitement dire à l'agent ce qu'il ne doit pas faire.
00:06:06Vous pouvez créer ce fichier dans votre dossier docs et le lier dans Claude.md pour que l'agent connaisse ces contraintes.
00:06:12Il doit contenir des instructions sur mesure, spécifiant tout ce que vous ne voulez pas que l'agent crée.
00:06:19Les contraintes négatives sont vitales car les specs positives laissent un vide implicite, et les négatives le comblent, évitant les expérimentations inutiles.
00:06:29Elles donnent un objectif plus clair sur ce à quoi le résultat ne doit pas ressembler.
00:06:32Par exemple, si vous ne voulez pas la combinaison bleu/violet par défaut de l'IA, dites-le explicitement au lieu de simplement le suggérer.
00:06:41Mais avant de poursuivre, un mot de notre sponsor, Way in Video.
00:06:44Si vous travaillez avec de longues vidéos, vous connaissez la difficulté : des heures à chercher le bon moment, puis encore plus de temps à monter.
00:06:52Way in Video règle tout cela. C'est une plateforme d'IA vidéo qui comprend réellement votre contenu.
00:06:56Leur compétence de clipping IA sur OpenClaw prend n'importe quelle vidéo, trouve les moments viraux, les recadre en vertical et ajoute des sous-titres.
00:07:04Pas de code, pas de config. Lancez juste la compétence et vos clips sont prêts à être postés. Tout simplement.
00:07:08Pour quelque chose de précis, vous pouvez chercher dans la vidéo en anglais courant. Tapez "réaction drôle" et l'IA s'y rend directement.
00:07:16Elle gère aussi les résumés et les transcriptions avec identification des locuteurs. Parfait pour les podcasts et les streams.
00:07:22Que vous recycliez du contenu ou automatisiez votre flux, Way in Video vous fait gagner des heures chaque semaine.
00:07:27Arrêtez de perdre du temps sur le montage manuel. Cliquez sur le lien en commentaire épinglé pour commencer.
00:07:32C'est une chose que la plupart des frameworks d'IA utilisent : l'usage de documents multiples pour différents objectifs.
00:07:38Mais le cœur de tous ces documents est le document de progression et d'apprentissage.
00:07:42Le fichier de progression est critique car sur une application à grande échelle, l'agent perd le fil des fonctionnalités déjà implémentées.
00:07:52Sans ce fichier, l'agent doit revenir en arrière, relire l'implémentation et la comparer aux docs pour savoir ce qui a été fait.
00:07:58Cela crée une surcharge et gaspille à la fois du temps et des jetons (tokens).
00:08:01Créez donc un fichier de progression pour que l'agent sache exactement où en sont les choses en un seul coup d'œil.
00:08:07Mais suivre la progression ne suffit pas, l'agent doit aussi savoir ce qui n'a pas fonctionné.
00:08:11Il vous faut donc un fichier d'apprentissage où l'agent consigne ses erreurs, leurs causes et comment il les a résolues.
00:08:17Ainsi, lorsqu'il rencontre une situation similaire plus tard, il ne commet pas deux fois la même erreur.
00:08:22Comme ces deux fichiers doivent être mis à jour activement pendant l'implémentation,
00:08:26vous devez donner des instructions explicites dans Claude.md pour que l'agent continue de les enrichir durant la construction.
00:08:34Ces deux fichiers sont les plus essentiels pour toute configuration.
00:08:38Vous pouvez les utiliser lorsque vous créez votre propre environnement de codage.
00:08:41Nous avons déjà fait une vidéo expliquant comment construire vos propres frameworks, que vous pouvez voir sur la chaîne.
00:08:46Mais si vous ne voulez pas vous donner cette peine,
00:08:49vous pouvez simplement vous appuyer sur les frameworks de codage car ils utilisent différents mécanismes pour faire exactement cela.
00:08:56Une autre erreur courante est de n'implémenter les tests qu'à la fin du développement.
00:09:00C'est problématique car si vous demandez à un agent d'écrire des tests après coup,
00:09:05ils ne seront pas aussi efficaces que s'ils avaient été écrits au préalable.
00:09:09Lors de la rédaction des tests, l'agent doit se référer au PRD et déduire de là comment la fonctionnalité devrait se comporter.
00:09:16L'agent doit ensuite écrire les tests à partir de ces exigences déduites,
00:09:19en faisant de la rétro-ingénierie sur la fonctionnalité et les points de défaillance potentiels d'après le PRD.
00:09:24Une fois les tests prêts, vous pouvez les lancer pour vérifier si l'implémentation répond bien aux exigences.
00:09:29L'intérêt d'écrire les tests d'abord est qu'après l'implémentation, l'agent ne connaît que ce qui a été réellement fait.
00:09:35Il optimisera les tests pour les fonctions existantes, et non pour les fonctionnalités requises dans les spécifications.
00:09:41Cela peut vous faire rater des tests sur des fonctions spécifiées mais mal implémentées.
00:09:46Comme l'agent s'aligne sur l'approche implémentée, il peut négliger certains tests,
00:09:50omettant des cas limites qui auraient été captés si les tests dérivaient directement des specs.
00:09:55Ne donnez pas d'instructions vagues comme "teste l'application", car Claude optimisera juste pour l'implémentation actuelle.
00:10:02À la place, implémentez des tests guidés par les specs pour que l'agent sache exactement quoi optimiser.
00:10:07Si vous appréciez notre contenu, pensez à cliquer sur le bouton Hype pour nous aider à toucher plus de monde.
00:10:14Un autre problème fréquent est l'absence de suivi des incidents dès le début.
00:10:19Sans cela, les bugs s'accumulent sans trace de leur origine, et à mesure que l'appli grandit, le suivi devient difficile.
00:10:26Maintenir des journaux (logs) précis pendant les tests est donc crucial.
00:10:29Beaucoup utilisent GitHub pour cela, et c'est une excellente plateforme pour gérer les tickets (issues).
00:10:34Le combiner avec des messages de commit Git bien structurés guide Claude sur ce qui a été fait et permet de suivre les progrès.
00:10:42L'un des atouts de Git est de pouvoir annuler des commits si un changement casse la base de code.
00:10:47Et pour tester quelque chose d'expérimental, vous pouvez utiliser le "work tree" pour le faire isolément.
00:10:51Vous pouvez configurer l'agent pour qu'il valide après chaque étape en utilisant des messages détaillés pour rester clair.
00:10:58Mais GitHub convient aux profils techniques ; les membres non-techniques peuvent avoir du mal à soumettre des tickets.
00:11:03Pour eux, connecter l'agent à un outil de gestion comme Trello ou Notion est idéal.
00:11:08Cela permet de consigner les bugs, de suivre l'avancement et de collaborer sur les correctifs.
00:11:12Connectez le MCP de l'outil choisi pour que l'agent puisse y accéder, déplacer les tickets et gérer les rapports efficacement.
00:11:20Ajoutez une instruction dans Claude.md spécifiant que l'agent doit utiliser le MCP Notion pour le suivi des bugs.
00:11:28Mettre cela en place au début est précieux pour la montée en charge et le travail d'équipe, assurant un suivi efficace.
00:11:36Même si votre appli fonctionne bien en test, le code généré par IA n'est pas nativement prévu pour de nombreux utilisateurs simultanés.
00:11:43C'est pourquoi beaucoup trouvent les implémentations IA peu performantes en production.
00:11:47Il faut donc s'y préparer également.
00:11:49Si vous avez une estimation, indiquez à l'agent le nombre d'utilisateurs attendus et le fait qu'ils seront connectés simultanément.
00:11:56L'agent devra alors écrire des cas de test pour le stress-test de la charge basé sur ces infos.
00:12:01Il existe plusieurs outils de test, choisissez celui qui correspond à vos besoins.
00:12:05Nous avons utilisé K6 pour une application Next.js car il est simple à mettre en œuvre.
00:12:10Vous pouvez aussi utiliser le mode planification de Claude pour tracer plusieurs approches techniques détaillées.
00:12:17Claude planifie selon le PRD et le nombre approximatif d'utilisateurs simultanés attendus.
00:12:23Claude pose plusieurs questions sous différents angles et clarifie les problèmes potentiels qui pourraient surgir en production.
00:12:29Cela aide l'appli à échouer gracieusement si des problèmes surviennent et optimise l'expérience utilisateur.
00:12:34Avec ce mode, vous clarifiez votre intention et faites planifier l'évolutivité par l'agent.
00:12:39Ce plan est la dernière pièce pour transformer votre idée en un produit prêt pour la production.
00:12:43Tous les agents et compétences mentionnés sont disponibles dans AI Labs Pro pour cette vidéo, téléchargeables pour vos projets.
00:12:53Si vous appréciez notre travail et souhaitez soutenir la chaîne, c'est le meilleur moyen de le faire.
00:12:57Le lien est dans la description.
00:12:59Cela nous amène à la fin de cette vidéo.
00:13:00Pour nous soutenir et nous aider à continuer, vous pouvez utiliser le bouton Super Thanks ci-dessous.
00:13:07Comme toujours, merci d'avoir regardé et à bientôt pour la prochaine.

Key Takeaway

Le succès du développement logiciel avec Claude Code repose sur une configuration rigoureuse de l'environnement incluant des fichiers de contexte dynamiques, des agents spécialisés et des tests pilotés par les spécifications avant d'écrire la moindre ligne de code.

Highlights

La mise en place d'un document PRD via un agent planificateur dédié remplace le mode planification technique de Claude pour se concentrer sur les besoins produit.

Le fichier Claude.md sert de guide contextuel permanent et doit contenir uniquement les conventions de codage et les règles métier que l'IA ne peut pas deviner seule.

L'intégration d'outils via le Model Context Protocol (MCP), comme Supabase pour le backend ou Playwright pour les tests, est un prérequis avant toute phase de construction.

Les contraintes négatives explicites dans un fichier dédié évitent que l'agent n'implémente des solutions inutiles ou hors de propos comme des schémas de couleurs par défaut.

L'écriture de tests de rétro-ingénierie basés sur le PRD avant le développement empêche l'IA d'optimiser ses tests uniquement pour le code qu'elle vient de générer.

L'utilisation de fichiers de progression et d'apprentissage réduit la consommation de jetons en évitant que l'agent ne doive relire toute la base de code pour se situer.

Timeline

Transition de la méthode humaine vers l'autonomie des agents

  • L'IA accélère le développement mais nécessite des processus structurés hérités de 60 ans d'ingénierie logicielle.
  • La configuration de l'environnement dicte la capacité de l'agent à suivre un flux de travail cohérent.

Les méthodes de développement traditionnelles évoluent pour devenir des cadres de travail adaptés aux agents d'IA. L'objectif n'est plus seulement de guider l'humain, mais de structurer l'environnement pour que l'IA agisse avec la même rigueur. Cette préparation est une condition sine qua non avant d'entamer la construction d'un produit.

Planification stratégique et création du PRD

  • L'utilisation d'un agent planificateur externe produit un PRD plus axé sur le produit que le mode planification natif de Claude.
  • Le document final de spécifications divise l'implémentation en phases et consigne les décisions de conception clés.

La planification des exigences est l'étape la plus chronophage et la plus critique. Un agent spécialisé pose des questions itératives jusqu'à la définition complète du MVP. Le résultat est un fichier PRD stocké localement qui sert de source de vérité pour toutes les étapes suivantes, évitant ainsi les ambiguïtés techniques lors du codage.

Configuration du fichier Claude.md et des règles de contexte

  • Le fichier Claude.md centralise les instructions persistantes et les liens vers les documents de référence comme le PRD.
  • Ce fichier exclut les informations évidentes telles que la structure des dossiers pour se concentrer sur les conventions de style.

La création manuelle du fichier Claude.md est préférable à la commande d'initialisation automatique qui se base sur une base de code potentiellement incomplète. Ce document reste dans le contexte de l'IA indéfiniment. Il doit être enrichi progressivement pour affiner le processus de création sans surcharger la fenêtre de contexte avec des détails inutiles que l'IA peut déduire par simple lecture de fichiers.

Écosystème d'outils MCP et agents spécialisés

  • L'installation des services via MCP permet à l'IA d'interagir directement avec des outils comme Supabase, Shadcn UI ou Playwright.
  • La distinction entre compétences (flux répétitifs) et agents (fenêtres de contexte dédiées) optimise la gestion des tâches.

Avant la construction, chaque service externe doit être connecté pour que l'agent puisse y accéder en temps réel. Des agents dédiés sont configurés pour des rôles précis : commits Git, refactorisation ou vérification d'interface. Les compétences, comme celles pour le front-end, automatisent les flux de travail redondants tout en respectant des directives constantes.

Gestion des contraintes négatives et documentation de progression

  • Les contraintes négatives comblent le vide laissé par les instructions positives en interdisant explicitement certaines actions.
  • Les fichiers de progression et d'apprentissage empêchent la répétition d'erreurs et la perte de fil conducteur sur les grands projets.

Les agents ont tendance à improviser au-delà des specs si des limites ne sont pas fixées, comme l'utilisation de couleurs non désirées. Parallèlement, un journal de bord actif permet à l'IA de savoir exactement ce qui a été fait. Le fichier d'apprentissage consigne les échecs passés pour garantir que l'IA ne reproduise pas deux fois le même bug technique.

Tests dirigés par les spécifications et suivi des bugs

  • L'écriture des tests avant le code garantit la conformité aux exigences initiales du PRD.
  • La connexion à des outils comme Notion ou Trello via MCP facilite le suivi des incidents pour les profils non-techniques.

Rédiger les tests après le développement conduit l'IA à valider ce qui existe déjà plutôt que ce qui était requis. En utilisant le PRD comme base de test, on détecte les fonctions mal implémentées ou les cas limites oubliés. L'intégration de gestionnaires de tickets permet de maintenir une trace historique des bugs, essentielle pour la scalabilité du projet.

Optimisation pour la production et tests de charge

  • Le code généré par IA nécessite des ajustements spécifiques pour supporter des utilisateurs simultanés en production.
  • L'outil K6 permet d'effectuer des stress-tests basés sur les estimations de trafic fournies à l'agent.

Une application fonctionnelle en local peut échouer sous charge si l'IA n'a pas anticipé l'évolutivité. Le mode planification de Claude est utilisé pour simuler différents scénarios de production et forcer l'IA à prévoir des mécanismes de gestion d'erreur. Cette étape finale transforme un prototype en un produit robuste capable d'échouer gracieusement.

Community Posts

View all posts