Configuration des modèles

Le framework permet de configurer quel modèle IA utiliser pour chaque persona et agent, de manière centralisée.

Pourquoi c'est important

Chaque modèle a des caractéristiques différentes :

Modèle	Forces	Coût	Usage recommandé
opus	Raisonnement profond, analyse complexe	Élevé	Architecture, review, analyse
sonnet	Bon équilibre qualité/vitesse	Moyen	Implémentation, tests
haiku	Rapide, économique	Faible	Scan, lookup, extraction

Configuration par défaut

Le fichier framework/models.md définit les assignations par défaut :

Personas

Persona	Modèle par défaut	Pourquoi
analyst	opus	Raisonnement profond pour clarifier les besoins
architect	opus	Décisions architecturales complexes
developer	sonnet	Bon équilibre pour le code
reviewer	opus	Détection fine des bugs et failles

Agents

Agent	Modèle par défaut	Pourquoi
explore-codebase	haiku	Scan rapide, pas de raisonnement complexe
explore-docs	haiku	Recherche et extraction simple
web-search	haiku	Lookup rapide
code-reviewer	sonnet	Analyse de code précise
snipper	sonnet	Éditions de code précises
action	haiku	Vérifications simples

Presets

Trois presets sont disponibles pour adapter rapidement le framework :

Budget — minimiser les coûts

models:
  preset: budget

Tout en sonnet sauf les agents de scan en haiku. Idéal pour le prototypage ou les budgets serrés.

Standard — équilibre coût/qualité (défaut)

models:
  preset: standard

Analyse et review en opus, implémentation en sonnet, scan en haiku. C'est le réglage par défaut.

Quality — maximiser la qualité

models:
  preset: quality

Tout en opus sauf les agents de scan. Pour le code critique (auth, paiement, infrastructure).

Override par projet

Ajoutez dans votre CLAUDE.md :

## Models
models:
  preset: standard
  override:
    developer: opus      # je veux opus pour le code aussi
    code-reviewer: opus  # review plus poussée

Ordre de résolution

1. CLAUDE.md > models > override     ← priorité la plus haute
2. CLAUDE.md > models > preset
3. framework/models.md               ← défaut du framework
4. Frontmatter du persona/agent      ← fallback

Pour les collaborateurs

Chaque développeur peut override les modèles dans le CLAUDE.md de son projet sans modifier le framework partagé.

Exemples

Développeur solo, budget limité

## Models
models:
  preset: budget

Équipe, code critique (fintech)

## Models
models:
  preset: quality

Personnalisé : opus pour l'analyse, haiku pour le reste

## Models
models:
  preset: budget
  override:
    analyst: opus
    architect: opus
    reviewer: opus

Chargement

Les modèles sont chargés par APEX au Step 00 (Init) :

1. Lire framework/models.md (défauts)
2. Lire CLAUDE.md section models: (preset + overrides)
3. Résoudre les conflits par ordre de priorité
4. Stocker les assignations dans le contexte de la tâche
5. Chaque step utilise le modèle assigné au persona actif