Agents du framework

Les agents sont des unités d'exécution instanciées par les skills dans leur propre contexte. Chaque agent combine identité (rôle, contraintes) et mécanisme d'exécution (modèle, outils), et dispose de permissions strictement délimitées.

Le framework fournit 9 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
analyst	opus	Lecture seule	Clarification des besoins, specs
architect	opus	Lecture seule	Conception architecture, read-only
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	Diagnostic root cause

Permissions des outils

Les agents utilisent deux patterns de frontmatter distincts pour contrôler l'accès aux outils.

Agents en lecture seule utilisent disallowedTools pour bloquer l'écriture :

disallowedTools: Write, Edit, Bash   # analyst, architect
disallowedTools: Write, Edit         # code-reviewer, security-reviewer, quality-reviewer, explore

Agents avec accès en écriture utilisent allowed-tools comme liste blanche explicite :

allowed-tools: Read, Write, Edit, Bash, Glob, Grep   # executor, test-engineer
allowed-tools: Read, Bash, Glob, Grep                # debugger

Agent	Pattern	Outils bloqués/autorisés	Lecture seule ?
analyst	disallowedTools	Write, Edit, Bash bloqués	Oui
architect	disallowedTools	Write, Edit, Bash bloqués	Oui
code-reviewer	disallowedTools	Write, Edit bloqués (Bash autorisé)	Oui
security-reviewer	disallowedTools	Write, Edit bloqués (Bash autorisé)	Oui
quality-reviewer	disallowedTools	Write, Edit bloqués (Bash autorisé)	Oui
explore	disallowedTools	Write, Edit bloqués	Oui
debugger	allowed-tools	Read, Bash, Glob, Grep autorisés	Oui
executor	allowed-tools	Read, Write, Edit, Bash, Glob, Grep	Non
test-engineer	allowed-tools	Read, Write, Edit, Bash, Glob, Grep	Non

Utilisation dans les skills

Les agents sont invoqués depuis les step files via le bloc <delegation> :

<delegation>
agent: architect
tier: opus
mode: mandatory
exception: economy mode (`-e`) → work inline, no subagents
</delegation>

Le dispatch effectif dans Claude Code :

Agent(subagent_type="shingan:architect", model="opus", prompt="...")

Pour les runtimes alternatifs (OpenCode), le dispatch utilise le mécanisme natif du runtime.

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.

Format d'un fichier agent

Chaque agent est défini dans framework/agents/{name}.md avec :

Frontmatter YAML

Champ	Requis	Description
name	oui	Identifiant kebab-case
description	oui	Description avec "Utiliser quand :"
model	oui	Tier : haiku, sonnet ou opus
role	non	Libellé français du rôle
allowed-tools	si write	Liste des outils autorisés
disallowedTools	si read-only	Liste des outils bloqués

Corps du fichier

1. ## Identité — description du rôle en français
2. ## Menu d'actions — tableau CODE → Action pour usage interactif
3. <Agent_Prompt> — prompt système en anglais avec :
   • <Role> — identité et mission
   • <Responsibilities> — ce que l'agent fait
   • <Constraints> — règles strictes
   • <Output_Format> — template de sortie structuré