LLI Wiki — My Digital Knowledge Base

Sous-agents spécialisés et orchestrateur avec Claude Code : quand déléguer, limites et coûts

Une petite équipe d'agents (SQL, PowerShell, Azure, relecteur de documentation) et un orchestrateur : format des fichiers, briefs, parallélisme, limites et coûts.

Un sous-agent est un spécialiste auquel Claude Code peut déléguer une tâche. Il travaille dans sa propre fenêtre de contexte, avec ses propres instructions et ses propres outils, puis revient avec un résumé. Sur un dépôt de DBA, j'utilise une petite équipe : un expert SQL, un expert PowerShell, un expert Azure, un relecteur de documentation en lecture seule, et un orchestrateur qui répartit le travail entre eux.

À quoi ressemble un fichier d'agent

Un agent est un fichier Markdown dans .claude/agents/. L'en-tête dit qui il est et ce qu'il peut faire ; le corps est son prompt système.

---
name: sql-expert
description: Use for T-SQL work: queries, procedures, DDL, migration scripts, tuning, and placeholder templates read by PowerShell.
tools: Read, Edit, Write, Grep, Glob
model: inherit
---

You are a SQL Server and Azure SQL expert for this repository.

## Standards
Follow rule `sql-script.md`. Do not copy it here.

## Safety
Read-only queries are fine. Never run DDL or DML against production: write the script, stop.

## Output
What was done / files changed / how it was validated.

Trois champs comptent surtout :

Mon équipe

Agent Écrit ? Rôle
sql-expert oui T-SQL, modèles, optimisation
powershell-expert oui fonctions, modules, tests Pester, lint
azure-expert oui YAML de pipelines, Azure SQL, Batch, identités
docs-expert oui README, changelogs, commentaires
docs-reviewer non vérifie la documentation contre le code, constats confirmés uniquement
orchestrator non découpe une demande multiple et l'aiguille

Convention de nommage : <domaine>-expert écrit, <domaine>-reviewer ne fait que lire. Le mot indique le risque avant même l'appel.

Quand déléguer, et quand ne pas le faire

Déléguez quand :

Ne déléguez pas quand :

Comment briefer un agent

Un agent ne connaît que ce que contient le brief. Un bon brief a quatre parties, que j'utilise comme modèle :

Task: add a -WhatIf switch to function Remove-Foo in the shared module.
Context: the function is called by two applications; do not change its return contract.
Constraints: follow rule powershell-function; do not commit; do not run any entry script.
Expected outcome: changed files, lint clean, one Pester test.

Donnez des noms de règles, pas leur contenu. Dites ce qui est interdit. Ne mettez jamais de secret ni de donnée personnelle dans un brief.

L'orchestrateur

L'orchestrateur n'a aucun outil d'écriture. Il lit la demande, choisit les agents, séquence le travail dépendant (le SQL d'abord, puis le PowerShell qui le consomme), parallélise l'indépendant, valide ce qui revient et rédige la synthèse. Si un agent échoue deux fois, il me remonte le problème au lieu de boucler.

flowchart TD
    U["Demande"] --> O["Orchestrateur"]
    O --> Q["sql-expert"]
    O --> P["powershell-expert"]
    O --> Z["azure-expert"]
    Q --> P
    P --> D["docs-expert"]
    D --> R["docs-reviewer : lecture seule"]
    R --> O
    Z --> O
    O --> S["Synthèse pour le DBA"]

Limites et coûts

Retour d'expérience

Mastodon LLIMastodon SocialFosstodon