Garder la main
Édition 2026 · v1.0

L'IA écrit. Toi, tu décides.

Dix chapitres pour rester ingénieur à l'ère des agents IA.

Pas un guide pour fabriquer de l'IA. Un guide pour coder avec.

Sommaire

11 chapitres

Les premiers chapitres posent le mindset et la méthode. Les derniers descendent dans la pratique

00

Mindset

Le dev devient architecte et réviseur. Comprendre le déplacement du rôle et les anti-patterns à éviter.

20 min/Fondamentaux
01

Comprendre les LLMs

Tokens, fenêtre de contexte, hallucinations, non-déterminisme. Le modèle mental qui sous-tend tout le reste.

30 min/Fondamentaux
02

Prompt Engineering

Anatomie d'un prompt qui marche, par modèle. Bibliothèque copiable par cas d'usage.

45 min/Fondamentaux
03

Méthodologie

Le cœur opérationnel : Spec-Driven Development + le cycle Explore → Plan → Code → Verify d'Anthropic.

60 min/Intermédiaire
04

Context Engineering

Le paradigme shift de 2026 : concevoir le pipeline d'information, pas juste écrire un bon prompt.

60 min/Intermédiaire / Avancé
05

Claude Code

Setup, CLAUDE.md, Skills, Hooks, Subagents, MCP, patterns avancés (Writer/Reviewer, fan-out, CI/CD).

75 min/Avancé
06

Outils & Écosystème

Cursor, Cline, Windsurf, Copilot, Gemini CLI — matrice de choix par profil et par stack.

40 min/Intermédiaire
07

IA en équipe

Versionner le contexte, gouverner les prompts, mesurer la maturité IA de l'équipe.

45 min/Avancé
08

Sécurité & éthique

Ce qu'on n'envoie jamais à un LLM. Hooks de scan, .aiexclude, AI Act, responsabilité humaine.

30 min/Fondamentaux
09

Labs pratiques

NestJS, Next.js, Laravel, DevOps — applications du cycle Explore → Plan → Code → Verify avec prompts exacts.

Variable (hands-on)/Tous niveaux
10

Glossaire

Toutes les définitions du livre au même endroit : token, contexte, agent, MCP, eval, prompt injection, et le reste.

Référence/Tous niveaux
L'auteur

Jean Jacques BAGUI

Ingénieur Full Stack & IA

Je suis ingénieur, et je code encore tous les jours, sur des produits qui tournent et que des gens utilisent. Les agents IA font maintenant partie de mes outils, au même titre que mon éditeur ou mon terminal.

Ce guide est né de là. L'IA a rendu mon métier plus rapide sans jamais alléger ma responsabilité sur ce que je livre. J'ai écrit ce que j'aurais aimé lire : comment aller vite avec ces outils tout en continuant à comprendre son propre code.

Pour qui

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.

Sources & lectures

Ce que je lis, regarde et consulte.

Une sélection courte : docs officielles, cours, articles, talks, et outils qui ont nourri ce guide. Pour chacun, une raison précise.

Documentation officielle

  • Référence canonique de Claude Code : permissions, hooks, slash commands, subagents, MCP, mode CI. À garder en onglet ouvert quand on configure son `.claude/`.

  • Prompt caching, extended thinking, tool use, structured output, prefilled responses. Tout ce qu'on utilise au niveau API se trouve là.

  • 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.

  • 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.

  • AGENTS.md — format de contexte cross-tool
    Communauté (Anthropic, OpenAI, Cursor…)

    Le fichier de contexte unique que la plupart des agents savent désormais lire. Un seul fichier au lieu d'un par outil. Référence du Module 4.

  • Code source officiel des SDKs. Bonus : les exemples du repo montrent les patterns idiomatiques (caching, streaming, batches).

Cours et formations

  • Cours officiels : prompt engineering, tool use, agents, Claude Code. Format vidéo + notebooks. Le bon premier pas pour structurer ses connaissances.

  • 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 agents
    Erik 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.

  • Critique réfléchie de la mode des architectures multi-agents. Argumente pour des agents simples avec contexte partagé. Indispensable contre-poids au hype.

  • Le talk où Karpathy décrit le LLM comme un nouveau type d'OS (modèle = CPU, context window = RAM). Le guide pousse l'image d'un cran en te plaçant, toi, dans le rôle de l'OS. Base du Module 1.

  • La source du cycle Explore → Plan → Code → Verify et des conseils CLAUDE.md / permissions / subagents. À lire avant le Module 3 et le Module 5.

  • Context Engineering — la pratique émergente
    Birgitta 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.

  • La source de la « hausse du code dupliqué » citée aux Modules 4 et 7 : analyse de millions de lignes montrant l'explosion du copié-collé et du churn depuis l'adoption des assistants.

  • DORA & Stack Overflow Developer Survey
    Google Cloud DORA / Stack Overflow

    Les enquêtes de référence sur l'adoption réelle de l'IA par les équipes (≈ 80 %+) et ses effets mesurés sur la livraison. À citer plutôt que des chiffres d'adoption non sourcés.

  • 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.

  • Le guide canonique : structure XML, chain-of-thought, prefilled responses, few-shot. À lire en complément du Module 2 du guide.

Vidéos & talks

  • Suite pratique de « Intro to LLMs ». Karpathy démontre son workflow concret en live (ChatGPT, Claude, Cursor). Sans bullshit, posé.

  • 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 officiel
    Commission 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.

  • La source du « ~1 génération sur 2 introduit une faille » (Module 8) : ~45 % des tâches de code générées par LLM ouvrent une vulnérabilité OWASP quand le contexte ne l'impose pas.

  • L'étude académique fondatrice (≈ 40 % de programmes vulnérables générés par Copilot). Le chiffre exact a vieilli, le constat structurel non. Base chiffrée du Module 8.

Outils & catalogue

  • 1000+ Skills, agents, commands, MCPs prêts à l'emploi. Soutenu par Vercel/Neon/Anthropic. Le starter pack du guide est sur /templates ; pour tout le reste, c'est ici.

  • Implémentations de référence canoniques (filesystem, fetch, git, memory, sequential-thinking, time). Note : les serveurs GitHub/Postgres/Slack ont été confiés aux éditeurs courant 2025 — pour ceux-là, va sur le dépôt officiel du service.

  • Pour faire tourner Claude Code en CI sans réinventer la tuyauterie : auth, commentaires de PR, sortie structurée. À préférer au `npm install -g` + `claude --print` maison (Module 5).

  • Aider
    Paul Gauthier

    Agent CLI multi-modèle open source. Alternative à Claude Code quand on veut piloter d'autres modèles (Gemini, GPT, modèles locaux).

  • Continue
    Continue

    IDE assistant open source, self-hostable, BYOM (bring your own model). Pour les entreprises avec contraintes de souveraineté.