Onboarding de codebase pour agent IA
Donne le bon contexte de codebase à un agent IA avant les edits : architecture, règles, commandes, risques et exemples.
Reponse rapide
L'onboarding de codebase doit apprendre à l'agent où vit l'architecture, quelles commandes prouvent les changements et quels fichiers ou opérations sont sensibles.
Pack de contexte
Inclus instructions projet, frontières de dossiers, règles domaine, exemples de bon code local, commandes de test, contraintes de déploiement et raccourcis interdits.
Signal de réussite
L'agent est onboardé quand il peut expliquer le chemin d'edit probable avant modification et choisir une commande de vérification après l'edit.
FAQ
Faut-il refaire l'onboarding à chaque tâche ?
L'agent doit au minimum lire les instructions projet et le code proche à chaque tâche. Un onboarding plus profond sert aux changements larges ou risqués.
Préparer le contexte agent
Guides associés
CLAUDE.md : le guide de tout développeur
Un fichier markdown pour donner à Claude Code les conventions réelles de ton codebase et obtenir du code cohérent dès la première session.
Claude Code peut écrire du code propre dans un projet, puis sortir du code générique dans le suivant. Dans mon expérience, la différence vient souvent de CLAUDE.md . C'est le fichier qui évite de répéter les mêmes conventions à chaque session, et c'est une grosse partie de mon gain avec Claude Code. Ce que c'est CLAUDE.md est un fichier markdown que Claude Code lit au début de chaque session. Pense y comme le doc d'onboarding que tu donnerais à un prestataire senior le premier jour : stack, conventions, règles, contexte. Sans ça, Claude infère les patterns depuis ce qu'il voit dans le codebase. Parfois il tombe juste. Souvent non, surtout pour les conventions implicites que ton équipe connaît sans les avoir écrites. Avec un bon CLAUDE.md , Claude produit du code qui suit tes règles sans avoir besoin de le répéter à chaque fois. Quoi y mettre 1. Stack et…
Lire le guideClaude Code Agents: When to Use Them
Claude Code Agents (subagents) let you spawn isolated work threads from the main session. Full guide: what they are, when to use them, how to write a custom one, and the patterns that actually ship.
Claude Code is great when you're driving one thread of work. When you need to run three threads in parallel, or want a fresh pair of eyes on a decision, or need to scope out a large refactor without polluting your main session that's what Agents are for. This is what Claude Code Agents actually are, when to use them, and how to write your own. What Claude Code Agents actually are An Agent (sometimes called a subagent) is an isolated work thread you spawn from the main Claude Code session via the Agent tool. It has its own context fresh, with no visibility into your conversation. You hand it a self contained prompt; it does the work; it returns a single message at the end. Three things make this different from just asking Claude another question: 1. Isolated context. The agent doesn't see what you've been doing. It can't…
Lire le guideConstruire des agents IA fiables
Beaucoup d'agents cassent parce qu'on demande au LLM de piloter trop de choses. Voici la structure que j'utilise pour les garder fiables.
Tout le monde construit des agents. Beaucoup cassent au troisième run. Le problème vient rarement du modèle seul. Le plus souvent, on lui demande de décider, corriger, router, réessayer, sauvegarder et expliquer en même temps. À ce niveau là, même un bon modèle finit par produire un truc fragile. Voilà la structure que je garde quand je veux qu'un agent tienne dans le temps sans devenir fragile. L'anatomie d'un agent fiable Un agent fiable a trois parties. Une seule devrait vraiment impliquer l'IA. Déclencheur : quelque chose de déterministe démarre l'agent. Un planning, un webhook, un dépôt de fichier, une soumission de formulaire. Pas "quand l'IA pense que c'est le bon moment". Contexte : l'agent rassemble ce dont il a besoin avant d'appeler l'IA. Le document, les données, les préférences utilisateur, les contraintes. L'appel IA se fait avec un contexte complet, pas au milieu d'une exploration floue. Action : après…
Lire le guide