Workflows dynamiques avec Claude Code : chaque tâche peut avoir son propre environnement

Claude Code peut désormais écrire instantanément son propre harnais, adapté à la tâche à accomplir. Cette capacité est appelée workflow dynamique : il écrit dynamiquement des scripts d'orchestration, exécute des dizaines à des centaines de sous-agents en parallèle dans une seule session, et s'auto-vérifie avant de vous présenter les résultats.

Le harnais par défaut de Claude Code est excellent pour écrire du code, mais les tâches plus spécialisées comme la recherche, l'analyse de sécurité, les équipes d'agents et les revues de code nécessitaient auparavant la construction d'un harnais personnalisé sur Claude Code pour atteindre des performances optimales.

Les workflows permettent de créer dynamiquement ces harnais personnalisés, qui sont réutilisables, partageables, et permettent à Claude de résoudre les problèmes de manière plus native que l'approche par défaut.

Dans cet article, je vais partager mes premières expériences et réflexions sur l'utilisation des workflows. Notez que les workflows consomment davantage de tokens et sont mieux adaptés aux tâches complexes et à forte valeur ajoutée.

0. Introduction

La section d'introduction contient des notes de Practice Brother.

Une lecture formidable ; les workflows pourraient être la meilleure invention depuis les skills. Ils sont une version améliorée des goals et valent vraiment la peine d'être appris. Cet article explique en termes simples les différents scénarios d'application des workflows.

L'auteur original est Thariq @trq212, un employé clé d'Anthropic qui partage fréquemment des astuces sur Claude Code.

Le contenu est long ; n'hésitez pas à passer directement aux sections qui vous intéressent. Pour ressentir directement ce qu'il peut faire, voir la section 1 ;

Pour comprendre pourquoi il est nécessaire, voir les sections 3 à 5

; pour copier directement des solutions d'implémentation, allez à la section 6.

1. Exemples de prompts

Ces exemples montrent ce que les workflows peuvent faire. Vous pouvez directement demander à Claude des requêtes similaires :

• Faire en sorte que plusieurs théories concurrentes tentent de reproduire des tests instables.
• Extraire les corrections récurrentes des sessions passées.
• Localiser les causes racines dans les canaux d'incident Slack.
• Obtenir plusieurs points de vue critiques sur un plan d'affaires.
• Classer des CV et les valider.
• Utiliser une sélection par tournoi pour nommer un outil CLI.
• Effectuer un refactoring sur l'ensemble du codebase.
• Vérifier les affirmations techniques d'un brouillon de blog par rapport au code réel.

2. Comment fonctionnent les workflows

Les workflows exécutent des fichiers JavaScript contenant des fonctions spéciales pour générer et coordonner des sous-agents. Les outils JavaScript standard comme JSON, Math et Array peuvent être utilisés pour traiter les données. Les workflows peuvent choisir le modèle utilisé par les sous-agents et décider s'ils s'exécutent dans un worktree isolé. En cas d'interruption, le workflow peut reprendre là où il s'était arrêté.

3. Pourquoi les workflows sont nécessaires

Le harnais par défaut termine la planification et l'exécution dans une seule fenêtre de contexte. Cela fonctionne bien pour les tâches de codage, mais échoue pour les tâches de longue durée, massivement parallèles, hautement structurées ou adversariales. Plus précisément, il présente trois modes d'échec :

• Paresse de l'agent : Face à des tâches complexes en plusieurs parties, Claude s'arrête prématurément, ne terminant qu'une partie (par exemple, traiter 35 des 50 revues de sécurité).
• Biais d'auto-préférence : Lorsqu'on lui demande de valider ou de juger des résultats par rapport à une grille d'évaluation, Claude a tendance à favoriser ses propres conclusions.
• Dérive des objectifs : La fidélité se perd au fil des interactions ; chaque résumé omet des détails, y compris les exigences et contraintes des cas limites.

Les workflows contrecarrent cela en orchestrant des sous-agents indépendants, chacun avec sa propre fenêtre de contexte, son objectif ciblé et son isolement.

4. Workflows dynamiques vs statiques

Auparavant, les workflows statiques construits avec le SDK Agent Claude ou claude -p coordonnaient plusieurs instances de Claude Code de manière générique, vous obligeant à couvrir tous les cas particuliers. Avec Claude Opus 4.8 et les workflows dynamiques, Claude peut désormais écrire des harnais adaptés à des scénarios spécifiques.

5. Schémas pratiques pour utiliser les workflows

Vous pouvez déclencher un workflow en le demandant directement ou en utilisant ultracode dans votre prompt pour garantir que Claude Code en crée un. Les schémas courants incluent :

• Classifier et exécuter : Un agent classifieur détermine le type de tâche et l'oriente vers différents agents ou comportements ; il peut également classifier la sortie une fois terminé.
• Diffuser et synthétiser : Diviser une tâche en de nombreuses petites étapes, exécuter un agent pour chacune, et synthétiser les résultats. Utile lorsque de nombreuses étapes bénéficient de fenêtres de contexte propres et non interférentes. La synthèse agit comme une barrière, attendant que tous les agents aient terminé avant de fusionner la sortie structurée.
• Validation adverse : Pour chaque agent généré, exécuter un agent adverse distinct pour valider la sortie par rapport à une grille ou des critères.
• Générer et filtrer : Générer plusieurs idées sur un sujet, les filtrer par grille d'évaluation ou validation, et ne conserver que les résultats vérifiés de la plus haute qualité après déduplication.
• Tournoi : Faire concourir N agents sur la même tâche en utilisant différentes méthodes. Des agents de jugement par paires déterminent les gagnants jusqu'à ce qu'il n'en reste qu'un.
• Boucler jusqu'à complétion : Pour les tâches dont la charge de travail est inconnue, générer continuellement des agents jusqu'à ce qu'une condition d'arrêt soit remplie (par exemple, plus de nouvelles découvertes, plus d'erreurs dans les logs).

6. Scénarios d'application

• Migration et refactoring : Bun a utilisé des workflows lors de la réécriture de Zig vers Rust. Il décompose les tâches en étapes séquentielles (sites d'appel, tests échoués, modules), génère des sous-agents pour chaque correction dans un worktree, effectue des revues adversariales et fusionne. Évitez les commandes gourmandes en ressources pour maximiser le parallélisme.
• Recherche approfondie : La compétence /deep-research de Claude Code utilise des workflows pour diffuser des recherches web, extraire des sources, vérifier les affirmations de manière adverse et synthétiser un rapport cité. Cela s'applique également à la recherche non web, comme la compilation de rapports de statut Slack ou l'exploration de fonctionnalités d'un codebase.
• Validation approfondie : Pour les rapports nécessitant des citations pour chaque fait, un workflow peut identifier les affirmations, faire vérifier chacune par des sous-agents, et utiliser un agent vérificateur pour garantir la qualité des sources.

• Tri : Pour les grandes listes nécessitant une mesure qualitative (par exemple, classer les tickets par sévérité), classer plus de 1000 lignes dans un seul prompt réduit la qualité et fait exploser le contexte. Utilisez des tournois, des pipelines par paires, ou un classement par lots parallèles ; chaque comparaison est son propre agent.

• Mémoire et respect des règles : Lorsque Claude omet des règles même dans CLAUDE.md, créez un workflow avec un vérificateur de règles pour chaque règle. Utilisez une personnalité sceptique pour examiner les règles afin d'éviter les faux positifs. Inversement, extrayez les corrections récurrentes des sessions récentes, regroupez-les avec des agents parallèles, et validez de manière adverse si la règle aurait empêché l'erreur avant d'affiner CLAUDE.md.

• Triage à grande échelle : Un workflow de triage classifie les éléments, déduplique par rapport aux enregistrements existants, et agit. Un modèle de « quarantaine » empêche les agents lisant du contenu non fiable d'exécuter des actions à privilèges élevés, en déléguant celles-ci à des agents de traitement. Utilisez avec /loop pour un fonctionnement continu.

• Exploration et goût : Utile pour les décisions de design ou de nommage qui reposent sur le « goût » et bénéficient de grilles d'évaluation. Claude explore les solutions tandis qu'un agent de révision les évalue par rapport à une grille. Les solutions peuvent être classées ou sélectionnées via un tournoi.
• Évaluation : Exécutez des évaluations légères en générant des agents indépendants dans un worktree et un agent de comparaison pour noter les sorties par rapport à une grille.
• Modèle et routage intelligent : Créez un agent classifieur adapté à la tâche pour décider quel modèle utiliser. Par exemple, expliquer un module d'authentification dépend du nombre de fichiers ; un classifieur recherche d'abord cela, puis oriente vers Sonnet ou Opus en fonction de la complexité.

7. Quand ne pas utiliser les workflows

Les workflows sont récents et ne sont pas nécessaires pour chaque tâche ; ils consomment significativement plus de tokens. Utilisez-les de manière créative pour des tâches allant au-delà des usages conventionnels. Pour le codage de routine, demandez-vous si le calcul supplémentaire est nécessaire ; la plupart des tâches de codage n'ont pas besoin de cinq relecteurs.

8. Conseils pour créer des workflows

• Rédaction des prompts : Les prompts détaillés fonctionnent le mieux. Les workflows ne sont pas réservés aux grandes tâches ; vous pouvez demander un workflow rapide pour une revue adverse rapide d'une hypothèse.
• Combiner avec /goal et /loop : Pour les workflows répétables comme le triage ou la recherche, utilisez /loop pour les intervalles et /goal pour des exigences de complétion strictes.
• Budget de tokens : Définissez un budget de tokens clair (par exemple, 10k tokens) dans le prompt pour limiter l'utilisation.
• Sauvegarde et partage : Appuyez sur 's' dans le menu du workflow pour sauvegarder. Déposez-les dans ~/.claude/workflows ou distribuez-les via des skills. Référencez les fichiers JavaScript de workflow dans SKILL.md. Pour plus de flexibilité, demandez à Claude de traiter les workflows de skill comme des modèles plutôt que des scripts littéraux.

9. Un nouveau point de départ

Les workflows offrent une nouvelle façon puissante d'étendre Claude Code. Considérez cela comme un point de départ pour explorer de nouvelles méthodes pour accomplir des tâches avec Claude. Il reste encore beaucoup à découvrir sur la meilleure façon de les utiliser.

https://x.com/trq212/status/2061907337154367865