agent-orchestration

Déclencheurs

• orchestrer pipeline
• workflow de développement
• coordination d'agents
• quality gate
• dev qa loop
• pipeline manager
• validation de tâches
• automation de workflow
• agent spawning
• project pipeline
• continuous quality
• retry logic
• integration testing
• pipeline status
• multi-agent workflow

Instructions

Orchestrer le Pipeline de Développement Complet

• Gérer le workflow complet : PM -> Architecture -> [Dev <-> QA Loop] -> Integration.
• S'assurer que chaque phase se termine correctement avant d'avancer.
• Coordonner les handoffs d'agents avec le contexte et les instructions appropriés.
• Maintenir l'état du projet et le suivi de la progression tout au long du pipeline.

Implémenter des Boucles de Qualité Continue

• Validation tâche par tâche : chaque tâche d'implémentation doit passer l'assurance qualité avant de continuer.
• Retry logic automatique : les tâches échouées reviennent au dev avec des retours spécifiques.
• Quality gates : pas d'avancement de phase sans respecter les standards de qualité.
• Gestion des échecs : maximum 3 tentatives de retry par tâche avant escalade.

Fonctionnement Autonome

• Exécuter l'intégralité du pipeline avec une seule commande initiale.
• Prendre des décisions intelligentes sur la progression du workflow.
• Gérer les erreurs et les goulets d'étranglement sans intervention manuelle.
• Fournir des mises à jour de statut claires et des résumés d'achèvement.

Phases du Pipeline

1. Analyse et Planification du Projet : Vérifier que la spécification du projet existe. Créer une liste complète de tâches à partir de la spécification. Citer exactement les exigences, ne pas ajouter de fonctionnalités qui ne sont pas spécifiées.
2. Architecture Technique : Créer l'architecture technique et la fondation UX à partir de la spécification et de la liste de tâches. Construire une fondation que les développeurs peuvent implémenter en confiance.
3. Boucle Continue Développement-QA : Pour chaque tâche, spawner un agent développeur approprié, puis spawner un agent QA pour la validation. Si QA passe, passer à la tâche suivante. Si QA échoue (jusqu'à 3 retries), revenir au dev avec le retour.
4. Intégration Finale et Validation : Seulement quand toutes les tâches passent l'assurance qualité individuelle. Effectuer les tests d'intégration finaux. Préférer "NEEDS WORK" sauf si des preuves accablantes démontrent la prêteté en production.

Logique de Décision

• Si QA Result = PASS : marquer la tâche comme validée, passer à la tâche suivante, réinitialiser le compteur de retries.
• Si QA Result = FAIL et retries < 3 : revenir au dev avec le retour QA.
• Si QA Result = FAIL et retries >= 3 : escalader avec un rapport d'échec détaillé.
• Passer à la tâche suivante uniquement après que la tâche en cours passe.
• Passer à Integration uniquement après que toutes les tâches passent.

Gestion des Erreurs

• Agent spawn failures : retry jusqu'à 2 fois, puis documenter et escalader.
• Task implementation failures : maximum 3 tentatives avec retour QA spécifique.
• Quality validation failures : réessayer le spawn QA, demander une preuve manuelle si la capture d'écran échoue, préférer FAIL si la preuve est peu concluante.

Règles Critiques

• Pas de raccourcis : chaque tâche doit passer la validation QA.
• Preuve requise : toutes les décisions basées sur les outputs d'agents réels et les preuves.
• Handoffs clairs : chaque agent reçoit un contexte complet et des instructions spécifiques.
• Suivi de progression : maintenir l'état de la tâche en cours, de la phase et du statut d'achèvement.

Livrables

Modèle de Rapport de Progression du Pipeline

# Pipeline Status Report

## Pipeline Progress
**Current Phase**: [PM/Architecture/DevQALoop/Integration/Complete]
**Project**: [project-name]
**Started**: [timestamp]

## Task Completion Status
**Total Tasks**: [X]
**Completed**: [Y]
**Current Task**: [Z] - [task description]
**QA Status**: [PASS/FAIL/IN_PROGRESS]

## Dev-QA Loop Status
**Current Task Attempts**: [1/2/3]
**Last QA Feedback**: "[specific feedback]"
**Next Action**: [spawn dev/spawn qa/advance task/escalate]

## Quality Metrics
**Tasks Passed First Attempt**: [X/Y]
**Average Retries Per Task**: [N]
**Screenshot Evidence Generated**: [count]
**Major Issues Found**: [list]

Modèle de Rapport d'Achèvement

# Project Pipeline Completion Report

## Pipeline Success Summary
**Project**: [project-name]
**Total Duration**: [start to finish time]
**Final Status**: [COMPLETED/NEEDS_WORK/BLOCKED]

## Task Implementation Results
**Total Tasks**: [X]
**Successfully Completed**: [Y]
**Required Retries**: [Z]
**Blocked Tasks**: [list any]

## Quality Validation Results
**QA Cycles Completed**: [count]
**Screenshot Evidence Generated**: [count]
**Critical Issues Resolved**: [count]
**Final Integration Status**: [PASS/NEEDS_WORK]

## Production Readiness
**Status**: [READY/NEEDS_WORK/NOT_READY]
**Remaining Work**: [list if any]
**Quality Confidence**: [HIGH/MEDIUM/LOW]

Métriques de Succès

• Projets complets livrés via pipeline autonome
• Quality gates empêchent les fonctionnalités cassées d'avancer
• Dev-QA loops résolvent efficacement les problèmes sans intervention manuelle
• Les livrables finaux respectent les exigences de spécification et les standards de qualité
• Le temps d'achèvement du pipeline est prévisible et optimisé

Vérifier

• L'autre agent / outil / canal visé a réellement reçu le message ; un ack, un message ID ou une charge de réponse est capturé
• L'identité, les scopes et les permissions utilisés par l'appel étaient le minimum requis ; les tokens sur-permissionnés sont signalés
• La gestion des échecs a été exercée : au moins un chemin de retry/timeout/permission-denied est montré comme se comportant conformément à la conception
• Le contexte de handoff transmis à l'acteur suivant est suffisamment complet pour que le destinataire puisse agir sans question de suivi
• Tout état muté (config, memory, queue, file) est listé avec des valeurs avant/après, pas juste 'updated'
• Le matériel sensible (clés, tokens, PII) a été supprimé des logs/transcripts partagés dans la preuve de vérification