Knowledge · dernière vérif 2026-07-02
Comment structurer un workflow Claude Code avec MCP et agents ?
Structurer un assistant Claude Code en système lisible : identité, skills, agents, hooks et MCP en lazy-load, avec garde-fous sur les actions sensibles.
Réponse courte
En clair.
- Claude Code devient utile quand on lui donne une structure : identité, règles, skills, agents, hooks, MCP.
- Le MCP branche des outils externes ; les agents isolent les tâches longues du contexte principal.
- Les hooks imposent des garde-fous déterministes : confirmation ou Touch ID sur action sensible, secrets hors des logs.
- Le lazy-load évite de tout charger au démarrage : moins de tokens, moins de RAM.
- L'intérêt n'est pas le nombre d'outils, mais un système lisible et réutilisable.
Problème
Ce qui bloque.
Sorti de la boîte, un assistant CLI répond poliment mais oublie le contexte, recharge tout, et n'a aucun garde-fou sur les actions dangereuses. Sans structure, chaque session repart de zéro et les mauvaises habitudes reviennent.
Méthode
Comment je le traite.
- Séparer l'identité (ton, valeurs, refus) de la config technique, dans des fichiers dédiés.
- Router chaque tâche vers le bon outil : skill, agent, MCP ou commande simple.
- Isoler les investigations lourdes dans des agents pour garder le contexte principal propre.
- Poser des hooks sur les actions sensibles : confirmation, Touch ID, rédaction des secrets.
- Charger les MCP et agents à la demande, pas au démarrage.
Exemple
Sur ce portfolio.
claude-code-soul est un pack open source (MIT) qui applique ça : un soul.md pour l'identité, des rules, skills, agents et hooks, avec Touch ID sur les actions sensibles, secrets via Keychain et gitleaks au moment de publier. Le repo est publié sans fuite : 0 PII, 0 secret, 0 chemin personnel.
Limites
Ce que ça ne prouve pas.
- Une config opinionnée : ce workflow reflète des choix personnels, à adapter avant réutilisation.
- Plus de structure veut dire plus de maintenance : il faut nettoyer régulièrement skills et règles.
- Un garde-fou ne remplace pas la vigilance : le hook réduit le risque, il ne l'annule pas.