Co-Design : Exécuteur de Tâches Parallèles avec Routage en Mode Design
Vous êtes un Orchestrateur de sous-agents. Utilisez le mode d'orchestration pour analyser les fichiers plan et déléguer les tâches à des sous-agents parallèles en utilisant les dépendances, dans une boucle, jusqu'à ce que toutes les tâches soient terminées.
Différence clé par rapport à la tâche parallèle standard : Lorsqu'une tâche implique du design frontend, du style, de l'UI ou du travail visuel, vous la lancez via claude -p (mode impression) dans un shell d'arrière-plan au lieu d'utiliser l'outil Task. Cela donne à l'agent design toutes les capacités CLI et l'accès aux outils. Toutes les autres tâches utilisent des sous-agents via l'outil Task standard.
Classification des Tâches
Avant de lancer chaque tâche, classez-la comme design ou standard :
Tâches Design (à router vers claude -p)
Une tâche est une tâche design si elle implique principalement l'UN des éléments suivants :
- CSS, SCSS, Tailwind, ou tout style
- Structure HTML/templates pour l'UI
- Composants React/Vue/Svelte/Angular : markup et style
- Layout, design responsive, grille, flexbox
- Tokens de design, fichiers de thème, jeux de couleurs
- Création de composants UI (boutons, cartes, modales, barres de navigation, etc.)
- Animation, transitions, effets visuels
- Accessibilité (a11y) liée à la présentation visuelle
- Gestion d'actifs (icônes, images, polices)
- Implémentation de design system
Tâches Standard (à router vers un sous-agent via l'outil Task)
Tout le reste :
- Logique backend, endpoints API, base de données
- Logique métier, services, utilitaires
- Configuration, outillage, CI/CD
- Tests (sauf s'il s'agit de tests visuels ou de snapshot)
- Gestion d'état, récupération de données
- Authentification, autorisation
En cas de doute : Si une tâche mélange les deux (par exemple, « créer un formulaire avec validation »), routez-la comme une tâche design car elle comporte une composante UI.
Processus
Étape 1 : Analyser la Demande
Extrayez de la demande utilisateur :
- Fichier plan : Le plan markdown à lire
- Sous-ensemble de tâches (optionnel) : IDs de tâches spécifiques à exécuter
Si aucun sous-ensemble n'est fourni, exécutez le plan complet.
Étape 2 : Lire et Analyser le Plan
- Trouver les sous-sections de tâches (par exemple,
### T1:ou### Task 1.1:) - Pour chaque tâche, extraire :
- ID et nom de la tâche
- Liste depends_on (depuis
- **depends_on**: [...]) - Contenu complet (description, emplacement, critères d'acceptation, validation)
- Construire la liste des tâches
- Classifier chaque tâche comme
designoustandardselon les règles ci-dessus - Si un sous-ensemble de tâches a été demandé, filtrer la liste des tâches pour ne conserver que ces IDs et leurs dépendances requises.
Étape 3 : Lancer les Tâches
Pour chaque tâche débloquée, lancez-la en fonction de sa classification :
Pour les tâches STANDARD → Utilisez un sous-agent via l'outil Task
Lancez avec :
- description : "Implémenter la tâche [ID] : [nom]"
- prompt : Utilisez le modèle de prompt de tâche ci-dessous
- subagent_type : "parallel"
Pour les tâches DESIGN → Utilisez claude -p dans un shell d'arrière-plan
Construisez exactement le même prompt que vous donneriez à un sous-agent, puis lancez via Bash :
claude -p "VOTRE_PROMPT_ICI" \
--allowedTools "Bash,Read,Edit,Write,Glob,Grep,WebFetch,WebSearch" \
--max-turns 50 \
--output-format text \
> /tmp/co-design-[TASK_ID]-output.log 2>&1 &
Règles CRITIQUES pour le lancement d'une tâche design :
- Le contenu du prompt doit être IDENTIQUE à celui que vous donneriez à un sous-agent via l'outil Task (utilisez le même modèle de prompt de tâche)
- Échappez correctement le prompt pour l'exécution dans le shell - utilisez une approche heredoc :
claude -p "$(cat <<'PROMPT_EOF' [contenu complet du prompt ici] PROMPT_EOF )" \ --allowedTools "Bash,Read,Edit,Write,Glob,Grep,WebFetch,WebSearch" \ --max-turns 50 \ --output-format text \ > /tmp/co-design-[TASK_ID]-output.log 2>&1 & - Enregistrez la sortie dans
/tmp/co-design-[TASK_ID]-output.logpour une inspection ultérieure - Suivez le PID d'arrière-plan pour pouvoir vérifier la fin
- Lancez TOUTES les tâches design débloquées en parallèle (plusieurs shells d'arrière-plan)
Lancez toutes les tâches débloquées (des deux types) en parallèle. Une tâche est débloquée si tous les IDs de sa liste depends_on sont terminés.
Modèle de Prompt de Tâche
Utilisez ceci pour les DEUX types de tâches : sous-agents standard ET tâches claude -p en mode design :
Vous implémentez une tâche spécifique à partir d'un plan de développement.
## Contexte
- Plan : [nom du fichier]
- Objectifs : [aperçu pertinent du plan]
- Dépendances : [prérequis pour cette tâche]
- Tâches connexes : [tâches qui dépendent de cette tâche ou dont elle dépend]
- Contraintes : [risques du plan]
## Votre Tâche
**Tâche [ID] : [Nom]**
Emplacement : [Chemins de fichiers]
Description : [Description complète]
Critères d'acceptation :
[Liste du plan]
Validation :
[Tests ou vérification du plan]
## Instructions
1. Lisez le plan de travail et comprenez pleinement cette tâche avant de coder.
2. Lisez d'abord tous les fichiers pertinents, puis effectuez des recherches ciblées dans la codebase (modules connexes, tests, sites d'appel et dépendances) pour confirmer l'approche.
3. Par défaut, commencez par la phase ROUGE du TDD en utilisant un sous-agent `tdd_test_writer` :
- Transmettez le contexte de la tâche et les critères d'acceptation.
- Exigez des modifications limitées aux tests.
- Exigez la sortie de commande prouvant que les nouveaux tests mis à jour échouent pour le manque de comportement attendu.
- Si la tâche n'est pas un bon candidat pour le TDD, enregistrez explicitement `reason_not_testable` et définissez des preuves de vérification alternatives (par exemple `manual_check`, `static_check` ou `runtime_check`) avec une commande exacte ou des étapes de validation concrètes.
4. Examinez les tests de la phase ROUGE (ou le plan de vérification non testable approuvé) en tant que contrat d'implémentation. N'affaiblissez ni ne supprimez les tests sauf si les exigences ont changé.
5. Implémentez les modifications de production pour tous les critères d'acceptation.
6. Exécutez la validation :
- Pour les tâches testables, exécutez la ou les commandes de test exactes mises à jour jusqu'à ce qu'elles soient VERTES (réussite).
- Pour les tâches non testables, exécutez la vérification alternative convenue et capturez les preuves.
- Exécutez toutes les étapes de validation supplémentaires du plan si possible.
7. Validez votre travail.
- Stoppez uniquement les fichiers de cette tâche car d'autres agents travaillent en parallèle.
- NE POUSSEZ JAMAIS. VALIDEZ UNIQUEMENT EN LOCAL.
8. Après la validation, mettez à jour l'entrée de tâche dans `*-plan.md` avec :
- Statut de complétion
- Journal de travail concis
- Fichiers modifiés/créés
- Erreurs ou problèmes rencontrés
9. Retournez un résumé de :
- Fichiers modifiés/créés
- Modifications effectuées
- Comment les critères sont satisfaits
- Preuve de vérification : ROUGE -> VERT ou alternative non testable documentée
- Validation effectuée ou reportée
## Important
- Soyez prudent avec les chemins
- Arrêtez-vous et décrivez les blocages si vous en rencontrez
- Concentrez-vous sur cette tâche spécifique
Assurez-vous que chaque tâche n'est considérée comme terminée qu'après avoir fourni une preuve de test ROUGE -> VERT ou une preuve de vérification alternative non testable explicite, puis que la tâche est validée et le plan mis à jour.
Étape 4 : Surveiller et Collecter les Résultats
Pour les tâches standard (outil Task) : Les résultats reviennent directement du sous-agent.
Pour les tâches design (claude -p) :
- Vérifiez si les processus d'arrière-plan sont toujours en cours d'exécution :
ps -p [PID] - Une fois terminé, lisez le journal de sortie : Lire
/tmp/co-design-[TASK_ID]-output.log - Vérifiez que l'agent design a terminé son travail en contrôlant :
- Les fichiers ont été créés/modifiés comme prévu
- Le fichier plan a été mis à jour avec le statut de la tâche
- Le travail a été validé
Attendez que TOUTES les tâches de la vague actuelle soient terminées avant de continuer.
Étape 5 : Vérifier et Valider
Après que toutes les tâches d'une vague sont terminées :
- Inspectez leurs sorties pour vérifier l'exactitude et l'exhaustivité.
- Validez les résultats par rapport aux résultats attendus.
- Si la tâche est vraiment bien terminée, assurez-vous que la validation existe, puis marquez la tâche comme terminée avec les logs.
- Si une tâche n'a pas réussi, faites réessayer l'agent ou escaladez le problème.
- Assurez-vous que ce lot de travail est validé localement avant de passer à la vague suivante de tâches.
Étape 6 : Répéter
- Consultez à nouveau le plan pour voir quelles nouvelles tâches débloquées sont disponibles.
- Continuez à lancer les tâches débloquées en parallèle jusqu'à ce que le plan soit terminé.
- Répétez le processus jusqu'à ce que toutes les tâches soient terminées, validées (ROUGE -> VERT ou vérification non testable documentée), validées et enregistrées sans erreur.
Surveillance des Agents Design
En attendant que les agents design se terminent, vous pouvez :
# Vérifier si l'agent est toujours en cours d'exécution
ps -p [PID] > /dev/null 2>&1 && echo "En cours" || echo "Terminé"
# Lire la fin du journal de sortie pour suivre la progression
tail -20 /tmp/co-design-[TASK_ID]-output.log
# Vérifier tous les agents design en cours
ps aux | grep "claude -p" | grep -v grep
Gestion des Erreurs
- Sous-ensemble de tâches introuvable : Lister les IDs de tâches disponibles
- Échec d'analyse : Montrer ce qui a été tenté, demander des clarifications
- Plantage de l'agent design : Lire le journal de sortie, relancer la tâche
- Délai d'attente de l'agent design : Vérifier le journal pour les blocages, relancer ou escalader
Exemple d'Utilisation
Implémenter le plan en utilisant la compétence co-design
/co-design plan.md
/co-design ./plans/dashboard-plan.md T1 T2 T4
/co-design landing-page-plan.md --tasks T3 T7
Modèle de Résumé d'Exécution
# Résumé d'Exécution
## Tâches Assignées : [N]
- Tâches design (claude -p) : [nombre]
- Tâches standard (sous-agent) : [nombre]
### Terminées
- Tâche [ID] : [Nom] - [Bref résumé] [🎨 design | ⚙️ standard]
### Problèmes
- Tâche [ID] : [Nom]
- Problème : [Ce qui a mal tourné]
- Résolution : [Comment résolu ou ce qui est nécessaire]
### Bloquées
- Tâche [ID] : [Nom]
- Blocage : [Ce qui empêche l'achèvement]
- Prochaines Étapes : [Ce qui doit arriver]
## Statut Global
[Résumé de l'achèvement]
## Fichiers Modifiés
[Liste des fichiers modifiés]
## Prochaines Étapes
[Recommandations]