Que fait Orchestrateur de Cycle Dev ?
Orchestrez l'ensemble du cycle de développement : brainstorm → plan → revue → issues → implémentation → revue de code → PR.
Désambiguïsation : Si l'utilisateur souhaite uniquement un PRD, dirigez vers /write-a-prd. S'il ne souhaite qu'un plan, dirigez vers /prd-to-plan. Ce skill est destiné au cycle de vie complet de bout en bout.
Le Pipeline en 7 Phases
Chaque phase est obligatoire. Aucune phase ne peut être sautée.
| # | Phase | Délègue à | Condition de validation |
|---|---|---|---|
| 1 | Brainstorm | write-a-prd | URL de l'issue enregistrée |
| 2 | Plan | prd-to-plan | Fichier plan existe dans docs/plans/ |
| 3 | Revue CEO | plan-ceo-review (recommander MODE MAINTENIR PÉRIMÈTRE) | Revue terminée, utilisateur approuve |
| 4 | Issues | Orchestrateur (découpage plan → issues GitHub) | Toutes les URLs d'issues enregistrées |
| 5 | Implémentation | Orchestrateur (tdd par issue, subagent-development) | Toutes les issues résolues, tests passent |
| 6 | Revue de code | daa-code-review | Revue propre |
| 7 | PR | commit + github-cli | URL de la PR enregistrée |
Logique de Réentrée
À chaque invocation :
Sans argument (/dev-cycle)
- Scanner
docs/dev-cycle/pour les fichiers*.state.mdavecstatus: in_progress - Si un → demander : « Reprendre {feature} (
{branch}) ? Actuellement à {phase}. » - Si plusieurs → lister avec les noms de branches, demander laquelle reprendre
- Si aucun → demander : « Sur quelle fonctionnalité travaillez-vous ? » → démarrer Phase 1
Avec argument (/dev-cycle {slug})
- Chercher
docs/dev-cycle/{slug}.state.md - Trouvé → reprendre à
current_phase - Non trouvé → créer le fichier d'état, démarrer Phase 1
Collision de Slug
Lors de la création d'un nouveau fichier d'état, vérifier docs/dev-cycle/ pour les slugs existants. Si le slug existe déjà (abandonné ou terminé), suffixer avec -2, -3, etc.
Chargement du Contexte lors de la Reprise
Avant de continuer, charger TOUS les artefacts référencés :
- Brainstorm :
gh issue viewl'issue PRD - Plan : Lire le fichier plan depuis le disque
- Revue CEO : Lire le fichier plan (inclut les révisions de la revue)
- Issues :
gh issue viewchaque issue d'implémentation - Implémentation : Vérifier le statut git sur la branche feature, examiner les issues fermées
Présenter le résumé : « Reprise de {feature} à {phase}. Voici où nous en étions : … »
Exécution des Phases
Phase 1 : Brainstorm
Invoquer write-a-prd. Faire confiance au flux interne du skill (entretien → PRD → issue GitHub). Enregistrer l'URL de l'issue dans le fichier d'état.
Phase 2 : Plan
Passer l'URL de l'issue PRD à prd-to-plan. Enregistrer le chemin du fichier plan (dans docs/plans/{feature}.md).
Phase 3 : Revue CEO
Passer le chemin du fichier plan à plan-ceo-review. Recommander le mode MAINTENIR PÉRIMÈTRE mais laisser le skill choisir son propre mode (Étape 0F). Enregistrer quand la revue est terminée et que l'utilisateur approuve.
Phase 4 : Issues
Possédée par l'orchestrateur. Lire les tranches verticales du plan. Pour chaque tranche, créer une issue GitHub avec gh issue create qui :
- Référence l'issue PRD
- Inclut les critères d'acceptation du plan
- Est créée dans l'ordre des dépendances
Enregistrer chaque URL d'issue dans le tableau des issues immédiatement après sa création. Voir references/phase-transitions.md pour la reprise après achèvement partiel.
Phase 5 : Implémentation
Possédée par l'orchestrateur. Créer la branche feature feat/{feature-slug} (voir la gestion des branches dans references/phase-transitions.md).
Distribuer un sous-agent par issue GitHub en suivant la méthodologie subagent-development :
- Chaque sous-agent invoque le skill
tdd - La revue de code s'exécute entre chaque distribution de sous-agent
- Le fichier d'état est mis à jour après chaque sous-agent terminé (pas en batch)
Enregistrer les événements par sous-agent :
- « Sous-agent démarré pour l'issue #N : {titre} »
- « Sous-agent terminé pour l'issue #N : {succès/échec} »
- « Revue de code après l'issue #N : {propre/problèmes bloquants trouvés} »
Phase 6 : Revue de Code
Invoquer daa-code-review sur tous les fichiers modifiés de la branche feature. Si des problèmes bloquants sont trouvés → corriger, relancer. Boucler jusqu'à ce que ce soit propre.
Si des problèmes architecturaux nécessitent une refonte du plan → déclencher une transition arrière vers la Phase 2.
Phase 7 : PR
Vérifier d'abord les conflits avec la branche par défaut. Invoquer commit pour un commit conventionnel, puis github-cli pour ouvrir la PR. Enregistrer l'URL de la PR, définir status: completed. Puis exécuter l'étape d'archivage (voir Archivage ci-dessous).
Fichier d'État
Chaque fonctionnalité est suivie dans docs/dev-cycle/{feature-slug}.state.md. Voir references/state-file-schema.md pour le format complet, les définitions des champs et les règles de transition.
Échec & Reprise
Voir references/phase-transitions.md pour :
- Logique de réessai de phase (bloqué → réessayer à la prochaine invocation)
- Transitions arrière (implémentation/revue de code → plan)
- Abandon de fonctionnalité. Les fichiers archivés sont déplacés vers
docs/archive/.
Gestion des Branches
- Phases 1 à 4 : Exécuter sur la branche courante (documentation uniquement)
- Phase 5 : Crée la branche
feat/{feature-slug} - Phase 7 : PR vers la branche par défaut (détectée via
gh repo view --json defaultBranchRef) - Reprise à la Phase 5+ : Basculer sur la branche feature si pas déjà dessus
Archivage
Lorsqu'une fonctionnalité atteint un état terminal (completed ou abandoned), archiver ses artefacts :
- Créer les répertoires d'archive :
mkdir -p docs/archive/dev-cycle docs/archive/plans - Déplacer le fichier d'état :
git mv docs/dev-cycle/{slug}.state.md docs/archive/dev-cycle/ - Déplacer le fichier plan : lire le chemin du plan depuis le tableau des artefacts, puis
git mv {plan_path} docs/archive/plans/ - Commiter les déplacements avec le message :
chore(dev-cycle): archive {slug}
L'archivage s'exécute automatiquement :
- À la fin de la Phase 7 (après que l'URL de la PR est enregistrée et le statut défini sur
completed) - Lors de l'abandon de la fonctionnalité (après que le statut est défini sur
abandoned)