Architecture d'une configuration Agent IA CLI

Conception modulaire et optimisation du contexte

Groupe de Travail IA & Mathématiques
2025-2026

Plan de la présentation

  1. Vue d'ensemble : schéma global
  2. Le fichier CLAUDE.md : méta-prompt permanent
  3. Les Agents : sous-processus spécialisés
  4. Les Skills : savoir-faire invocables
  5. Les Commandes : slash commands
  6. Les Hooks : automatisation
  7. Les Serveurs MCP : protocole standard
  8. Workflow concret : exemple complet
  9. Multi-plateforme et conclusion

🏗️ Partie 1

Vue d'ensemble

Schéma global : Agent → Résultat

Agent Principal (Claude Code)
lit
CLAUDE.md (Méta-prompt)
charge
Skills + Instructions de Référence
appelle
Scripts Python / Node.js
exécute
Serveurs MCP (connexions externes)
produit
Résultat final (PDF, HTML, etc.)

Pourquoi cette architecture ?

  • 💾 Contexte limité : Les modèles IA ont une fenêtre de contexte finie
  • 🧩 Modularité : Charger uniquement ce qui est nécessaire
  • 🎯 Spécialisation : Agents experts dans leur domaine
  • ♻️ Réutilisabilité : Skills utilisables par plusieurs agents
  • 📈 Extensibilité : Ajouter des capacités selon les besoins

📄 Partie 2

Le fichier CLAUDE.md

CLAUDE.md : Méta-prompt permanent

Définition : Fichier texte qui définit le rôle global, l'expertise et les règles d'exécution de l'agent

Localisation

./CLAUDE.md (racine du projet)

Structure d'un CLAUDE.md

# MyProject Agent

## Rôle
Tu es un expert en [DOMAINE]

## Expertise
- Compétence 1
- Compétence 2
- Compétence 3

## Stack technique
[Technologies utilisées]

## Skills
[Skills disponibles]

## Workflow
[Étapes recommandées]

## Règles strictes
À FAIRE :
- ...

À NE JAMAIS FAIRE :
- ...

Exemple : CLAUDE.md d'enseignant

Rôle : Expert en création de ressources pédagogiques mathématiques

Expertise : LaTeX, Beamer, reveal.js, exercices interactifs

Stack : Python (compilation), Node.js (web)

Rules : Formules en LaTeX, vérifier la compilation, tester les exercices

🤖 Partie 3

Les Agents

Agents : Experts autonomes

Définition : Sous-processus spécialisé avec un system prompt dédié, des outils accessibles et une autonomie d'action limitée à son domaine

Avantages

  • Contexte réduit et ciblé
  • Utilisation de modèles légers (Haiku)
  • Isolation du contexte principal
  • Rapport final autonome

Exemples d'agents

latex-main-worker

Création de documents LaTeX structurés

debug-tex-log

Analyse des erreurs de compilation

beamer-worker

Présentations Beamer avec overlays

reveals-creator

Présentations reveal.js interactives

Localisation et structure

.claude/
├── agents/
│   ├── latex-main-worker.md
│   ├── debug-tex-log.md
│   ├── beamer-worker.md
│   └── reveals-creator.md
│
└── agents-data/
    ├── latex-templates/
    ├── beamer-examples/
    └── error-patterns/

Principe : Agent = system prompt + données de référence

💡 Partie 4

Les Skills

Skills : Savoir-faire invocables

Définition : Capacités/workflows réutilisables qui peuvent être activées à la demande par les agents

Caractéristiques

  • Peuvent inclure des scripts Python/Node.js
  • Documentation complète intégrée
  • Réutilisables par plusieurs agents
  • Chargés en contexte uniquement si activés

Exemples de Skills

tex-compiling-skill

Compilation LaTeX avec détection d'erreurs

reveals-presentation

Création de présentations reveal.js

pdf-extraction

Extraction et analyse de PDFs

educational-app-builder

Génération d'apps web éducatives

Structure d'un Skill

skills/
└── tex-compiling-skill/
    ├── README.md (description)
    ├── skill.md (instructions complètes)
    ├── examples/ (exemples d'utilisation)
    ├── scripts/
    │   ├── compile.py
    │   └── error-parser.py
    └── templates/ (templates LaTeX)

Activation : Le skill n'est chargé en contexte que si nécessaire, de deux manières :

  • Par l'utilisateur — via une commande slash (/createTex, /commit...)
  • Par l'agent lui-même — il détecte le besoin et déclenche le skill automatiquement

Partie 5

Les Commandes

Commandes = Prompts réutilisables

Principe : Une commande est simplement un prompt sauvegardé dans un fichier .md, invocable via /nomDeLaCommande

C'est la forme la plus simple d'un skill.

Un skill sans scripts, sans assets, sans sous-dossiers — juste un prompt.

Stockage

.claude/commands/

Emplacement dédié aux commandes

.claude/skills/

Fusion possible : une commande peut vivre dans un skill

Ex. : /createBeamer, /commit, /ficheTexnique — un seul fichier .md chacun

🔗 Partie 6

Les Hooks

Hooks : Automatisation transparente

Définition : Scripts qui s'exécutent automatiquement avant ou après certaines opérations (PreToolUse / PostToolUse)

Deux types de hooks

PreToolUse

S'exécute avant un outil (validation, préparation)

PostToolUse

S'exécute après un outil (correction, nettoyage)

Exemple : Hook de correction UTF-8

Problème : Les fichiers générés ont parfois un mauvais encodage

Solution : Hook PostToolUse

Hook PostToolUse (Write):
{
  "action": "fix-encoding",
  "encoding": "UTF-8",
  "target": "all-generated-files"
}

Résultat : Tous les fichiers écrits
sont automatiquement en UTF-8

✅ Pas d'intervention manuelle nécessaire !

Configuration des hooks

.claude/
└── config/
    └── settings.json

{
  "hooks": {
    "PostToolUse": [
      {
        "tool": "Write",
        "action": "fix-encoding",
        "encoding": "UTF-8"
      },
      {
        "tool": "Edit",
        "action": "fix-encoding",
        "encoding": "UTF-8"
      }
    ]
  }
}

🔌 Partie 7

Les Serveurs MCP

MCP : Model Context Protocol

Définition : Protocole standardisé pour exposer des outils et connecter l'agent à des services externes

Caractéristiques

  • Serveurs dédiés avec API standardisée
  • Isolation des dépendances (venv Python)
  • Outils exposés via le protocole MCP
  • Configuration JSON centralisée

Exemples de serveurs MCP

1
latex-compiler-server
Compilation LaTeX avec détection d'erreurs avancée
2
competences-server
Accès à la base des compétences du programme
3
encoding-fixer-server
Correction automatique des problèmes d'encodage
4
datagouv-server
Accès aux données publiques françaises

Structure d'un serveur MCP

mcp_servers/
└── latex-compiler-server/
    ├── package.json (ou requirements.txt)
    ├── index.js (ou main.py)
    ├── src/
    │   ├── tools.json (description des outils)
    │   └── compiler.js
    └── venv/ (environnement isolé)

Configuration : Référencé dans le settings.json de Claude Code

🌍 Partie 9

Multi-plateforme et conclusion

Adaptabilité à d'autres plateformes

Concept clé : Cette architecture n'est pas spécifique à Claude.

Demander simplement à Claude ce qu'il faudrait faire pour changer de fournisseur.

Avantage : Si vous changez de fournisseur IA, vous conservez les skills et agents

Ressources et documentation

Documentation Claude Code :
code.claude.com/docs/fr/

Concepts clés abordés :

  • Configuration du projet
  • Création d'agents spécialisés
  • Développement de skills réutilisables
  • Automatisation avec hooks
  • Intégration de serveurs MCP

🎯 Conclusion

  • Architecture modulaire : Adaptée aux limites du contexte
  • Synergie totale : Agents, skills, commandes, MCP, hooks = écosystème cohérent
  • Système vivant : Extensible et évolutif selon les besoins
  • Productivité décuplée : Automatisation des tâches répétitives
  • Déterminisme : Scripts et agents réduisent l'imprévisibilité

🚀 L'architecture Claude Code transforme l'IA en assistant autonome et fiable

Merci de votre attention

Questions ?

Présentation générée avec reveal.js
Groupe de Travail IA & Mathématiques - 2025-2026