Agents du framework

Les agents sont des unités d'exécution instanciées par les skills dans leur propre contexte. Chaque agent dispose d'un rôle précis, d'un modèle calibré à sa tâche, et de permissions d'outils strictement délimitées.

Le framework fournit 8 agents intégrés qui couvrent l'ensemble du cycle de développement sans dépendre de plugins externes.

Catalogue

Agent	Modèle	Type	Rôle
executor	sonnet	Lecture/Ecriture	Implémentation selon le plan
code-reviewer	opus	Lecture seule	Review 3 passes (qualité, sécu, tests)
security-reviewer	opus	Lecture seule	OWASP Top 10, secrets, auth
quality-reviewer	sonnet	Lecture seule	Anti-patterns, SOLID, complexité
test-engineer	sonnet	Lecture/Ecriture	Stratégie de tests, couverture
explore	haiku	Lecture seule	Exploration rapide du codebase
debugger	sonnet	Lecture seule (pas d'écriture)	Diagnostic root cause
analyst	opus	Lecture seule	Clarification des besoins, specs

Utilisation dans les skills

Les agents sont référencés dans les steps des skills via leur identifiant namespaced :

agents:
  - type: shingan:code-reviewer
    model: opus
    persona: reviewer

Exemple dans un step de skill :

## Step 4 — Review

Invoke agent `shingan:code-reviewer` on the files modified in step 3.
The agent performs a 3-pass review and produces a review report.
Gate: proceed only if verdict is APPROVED or APPROVED_WITH_COMMENTS.

Préfixe shingan:

shingan: est le namespace du plugin. Il permet de distinguer les agents du framework de ceux d'autres plugins installés simultanément (par exemple oh-my-claudecode:executor).

Règles de résolution :

• shingan:executor — agent executor du présent framework
• executor sans préfixe — résolution selon le plugin actif par défaut dans le contexte courant
• En cas de conflit, le préfixe explicite prend toujours la priorité

Sélection du modèle

Les agents utilisent le modèle le mieux adapté à leur charge de travail :

• haiku — scan, exploration, extraction rapide (faible coût)
• sonnet — implémentation, review qualité, tests (bon équilibre coût/qualité)
• opus — analyse approfondie, sécurité, clarification des besoins (puissance maximale)

Le modèle peut être surchargé à l'appel si le contexte le justifie, mais les valeurs par défaut sont calibrées pour couvrir 95 % des usages sans ajustement.