Garder la main.
Dix chapitres pour rester ingénieur à l'ère des agents IA.
Pas un playbook pour fabriquer de l'IA. Un playbook pour coder avec.
Sommaire
10 chapitresLes premiers chapitres posent le mindset et la méthode. Les derniers descendent dans la pratique
Mindset
Le dev devient architecte et réviseur. Comprendre le déplacement du rôle et les anti-patterns à éviter.
Comprendre les LLMs
Tokens, fenêtre de contexte, hallucinations, non-déterminisme. Le modèle mental qui sous-tend tout le reste.
Prompt Engineering
Anatomie d'un prompt qui marche, par modèle. Bibliothèque copiable par cas d'usage.
Méthodologie
Le cœur opérationnel : Spec-Driven Development + le cycle Explore → Plan → Code → Verify d'Anthropic.
Context Engineering
Le paradigme shift de 2026 : concevoir le pipeline d'information, pas juste écrire un bon prompt.
Claude Code
Setup, CLAUDE.md, Skills, Hooks, Subagents, MCP, patterns avancés (Writer/Reviewer, fan-out, CI/CD).
Outils & Écosystème
Cursor, Cline, Windsurf, Copilot, Gemini CLI — matrice de choix par profil et par stack.
IA en équipe
Versionner le contexte, gouverner les prompts, mesurer la maturité IA de l'équipe.
Sécurité & éthique
Ce qu'on n'envoie jamais à un LLM. Hooks de scan, .aiexclude, AI Act, responsabilité humaine.
Labs pratiques
NestJS, Next.js, Laravel, DevOps — applications du cycle Explore → Plan → Code → Verify avec prompts exacts.
Jean Jacques BAGUI
Ingénieur Full Stack & IA
Ingénieur full-stack & IA, je travaille sur des systèmes en production depuis plusieurs années : backend, data/IA, et plus récemment l'intégration d'agents LLM dans des contextes métiers concrets.
Ce playbook documente ce qu'il faut maîtriser pour travailler sérieusement avec les agents IA : fondamentaux, bonnes pratiques opérationnelles, et erreurs critiques à éviter.
Développeurs seniors
Tu utilises Claude, Cursor ou Copilot tous les jours. Tu veux passer un cran au-dessus : décider ce que fait l'outil, pas le subir.
Tech leads
Tu dois rendre l'usage de l'IA cohérent dans ton équipe : mêmes conventions, mêmes prompts, mêmes critères de revue.
Architectes & CTO
Tu dois répondre aux questions de sécurité, de coûts et de gouvernance avant d'ouvrir l'IA à toute l'entreprise.
Ce que je lis, regarde et consulte.
Une sélection courte : docs officielles, cours, articles, talks, et outils qui ont nourri ce playbook. Pour chacun, une raison précise.
Documentation officielle
- Claude Code — documentationAnthropic
Référence canonique de Claude Code : permissions, hooks, slash commands, subagents, MCP, mode CI. À garder en onglet ouvert quand on configure son `.claude/`.
- Anthropic API — documentationAnthropic
Prompt caching, extended thinking, tool use, structured output, prefilled responses. Tout ce qu'on utilise au niveau API se trouve là.
- Cursor — documentationCursor
Composer, .cursor/rules, agent mode, indexation du codebase. Indispensable si Cursor est ton IDE principal.
copilot-instructions.md, Copilot Autofix, Copilot Spaces. Pour intégrer Copilot dans un workflow GitHub natif.
- Vercel AI SDKVercel
SDK TypeScript pour intégrer LLMs dans une application : streaming, tool use, structured output, multi-provider. Le bon point de départ quand on construit une feature IA.
Le standard ouvert qui connecte les agents aux services externes (DB, GitHub, Sentry, Linear). Lire avant de construire son propre MCP server.
- Anthropic SDK (Python & TypeScript)Anthropic
Code source officiel des SDKs. Bonus : les exemples du repo montrent les patterns idiomatiques (caching, streaming, batches).
Cours et formations
- Anthropic AcademyAnthropic
Cours officiels : prompt engineering, tool use, agents, Claude Code. Format vidéo + notebooks. Le bon premier pas pour structurer ses connaissances.
- AI for Developers — DeepLearning.AIAndrew Ng & co
Courses courts (1–4h) sur des sujets précis : RAG, function calling, evals. La plupart sont gratuits et co-construits avec Anthropic, OpenAI ou Google.
Cours payants courts sur les sujets pointus : LLM evals, RAG en prod, agentic systems. Niveau senior, contenu dense.
Lectures de fond
- How to build effective agentsErik Schluntz, Barry Zhang — Anthropic
Référence essentielle : quand utiliser un workflow vs un agent, les 5 patterns d'agents qui marchent vraiment, ce qui ne marche pas.
- Don't build multi-agentsCognition
Critique réfléchie de la mode des architectures multi-agents. Argumente pour des agents simples avec contexte partagé. Indispensable contre-poids au hype.
- Intro to Large Language Models (1h general-audience)Andrej Karpathy
Le talk qui a posé l'analogie « LLM = CPU, context = RAM, OS = toi ». Référence centrale du module 1 du playbook.
- Context Engineering — la pratique émergenteBirgitta Böckeler — Thoughtworks
Articles courts qui ont popularisé le terme « context engineering » et la distinction prompt → contexte. À lire dans le tag « Engineering Effectiveness with AI » du Thoughtworks blog.
- Simon Willison — blogSimon Willison
Le blog le plus régulier et le plus pragmatique sur l'usage des LLMs en pratique. Annotations de presque toute publication majeure du domaine. À mettre dans son RSS.
- Prompt engineering guide — AnthropicAnthropic
Le guide canonique : structure XML, chain-of-thought, prefilled responses, few-shot. À lire en complément du Module 2 du playbook.
Vidéos & talks
- How I use LLMs (1h with Karpathy)Andrej Karpathy
Suite pratique de « Intro to LLMs ». Karpathy démontre son workflow concret en live (ChatGPT, Claude, Cursor). Sans bullshit, posé.
- AI Engineer Summit — playlists YouTubeAI Engineer
Les conférences pour développeurs autour de l'IA appliquée. Beaucoup de talks de praticiens (Notion, Vercel, Cursor, etc.), pas de marketing.
Sécurité & gouvernance
Le top 10 des vulnérabilités spécifiques aux applications LLM : prompt injection, exfiltration, supply chain. Référence centrale du module 8.
- EU AI Act — texte officielCommission européenne
Synthèse navigable du règlement européen sur l'IA. À consulter dès qu'on opère un produit IA touchant des utilisateurs européens.
Cadre américain de gestion des risques IA. Complémentaire de l'AI Act européen pour les boîtes qui opèrent sur les deux marchés.
Outils & catalogue
- aitmpl.com — catalogue Claude CodeCommunauté
1000+ Skills, agents, commands, MCPs prêts à l'emploi. Soutenu par Vercel/Neon/Anthropic. Le starter pack du playbook est sur /templates ; pour tout le reste, c'est ici.
- MCP servers reference (officiels)Anthropic
Implémentations de référence des serveurs MCP courants : filesystem, GitHub, Postgres, Slack, Brave Search. Bon point de départ pour comprendre et forker.
- AiderPaul Gauthier
Agent CLI multi-modèle open source. Alternative à Claude Code quand on veut piloter d'autres modèles (Gemini, GPT, modèles locaux).
- ContinueContinue
IDE assistant open source, self-hostable, BYOM (bring your own model). Pour les entreprises avec contraintes de souveraineté.