Que fait AgentFlow ?
Présentation
AgentFlow transforme votre tableau Kanban existant en un pipeline de développement IA entièrement autonome. Au lieu de construire une infrastructure d'orchestration personnalisée, il utilise votre outil de gestion de projet (Asana, GitHub Projects, Linear) comme une machine d'état distribuée — les tâches progressent à travers des étapes, les agents IA lisent et écrivent l'état via des commentaires, et les humains interviennent via la même interface qu'ils utilisent déjà.
Le résultat est une observabilité complète du pipeline depuis votre téléphone, une récupération gratuite en cas de panne (l'état vit dans votre outil de gestion de projet, pas en mémoire), et une intervention humaine à tout moment en faisant glisser une carte.
Quand utiliser cette compétence
- Utilisez-la lorsque vous devez orchestrer plusieurs travailleurs Claude Code sur un cycle de développement complet (construction, revue, test, intégration)
- Utilisez-la lorsque vous voulez des contrôles de qualité déterministes (tsc/eslint/tests) avant la revue IA sur le code généré par IA
- Utilisez-la lorsque vous voulez une visibilité complète du pipeline depuis votre tableau Kanban ou votre téléphone
- Utilisez-la lorsque vous gérez un projet solo ou en équipe qui nécessite un dispatch de tâches autonome avec suivi des coûts
- Utilisez-la lorsque vous avez besoin d'une orchestration résistante aux pannes qui survit aux redémarrages de session
Concepts clés
Pipeline Kanban en 7 étapes
Les tâches progressent à travers : Backlog, Recherche, Construction, Revue, Test, Intégration, Terminé. Chaque étape a des contrôles spécifiques. Le tableau Kanban EST la couche d'orchestration — pas de base de données séparée, pas de file d'attente de messages, pas d'infrastructure personnalisée.
Orchestrateur sans état
Un balayage unique piloté par crontab s'exécute toutes les 15 minutes. Pas de démon, pas de dépendance de session. S'il plante, le prochain balayage reprend là où il s'est arrêté car tout l'état vit dans votre outil de gestion de projet.
Déterministe avant Probabiliste
Les contrôles durs (tsc + eslint + tests) s'exécutent avant toute revue IA, capturant environ 60% des problèmes à coût quasi nul. La revue IA vient ensuite, en tant que deuxième couche.
Revue contradictoire
Un agent IA différent révise le code et doit lister 3 choses qui ne vont pas avant de décider d'approuver. Cela empêche les approbations automatiques.
Dispatch par priorité transitive
Les tâches qui débloquent le plus de travail en aval sont construites en premier, calculant automatiquement le chemin critique.
Compétences / Commandes
/spec-to-board
Décompose un SPEC.md en tâches atomiques sur votre tableau Kanban avec dépendances cartographiées.
/sdlc-orchestrate
Distribue les tâches aux travailleurs en fonction de la priorité transitive et de la détection de conflits. S'exécute comme un balayage crontab.
/sdlc-worker --slot <N>
Exécute un travailleur dans un slot de terminal qui prend les tâches, construit le code et crée des PR. Exécutez 3-4 travailleurs en parallèle.
/sdlc-health
Tableau de bord en temps réel de l'état du pipeline montrant l'étape actuelle, l'agent assigné, le nombre de tentatives et le coût accumulé pour chaque tâche.
/sdlc-stop
Arrêt gracieux : les travailleurs actifs terminent leur tâche en cours, les tâches non commencées retournent dans le Backlog.
Guide étape par étape
1. Rédigez votre cahier des charges
Créez un fichier SPEC.md pour votre projet décrivant ce que vous voulez construire.
2. Décomposez en tâches
claude -p "/spec-to-board"
Ceci lit votre SPEC.md, le décompose en tâches atomiques, cartographie les dépendances et les crée sur votre tableau Kanban.
3. Démarrez les travailleurs
Ouvrez 3-4 fenêtres de terminal, chacune comme un slot de travailleur :
# Terminal 2 — Constructeur
claude -p "/sdlc-worker --slot T2"
# Terminal 3 — Constructeur
claude -p "/sdlc-worker --slot T3"
# Terminal 4 — Réviseur
claude -p "/sdlc-worker --slot T4"
# Terminal 5 — Testeur
claude -p "/sdlc-worker --slot T5"
4. Démarrez l'orchestrateur
# Ajoutez dans crontab (s'exécute toutes les 15 minutes)
crontab -e
# Ajoutez : */15 * * * * ~/.claude/sdlc/agentflow-cron.sh >> /tmp/agentflow-orchestrate.log 2>&1
5. Surveillez et intervenez
Ouvrez votre tableau Kanban sur votre téléphone. Regardez les tâches progresser dans le pipeline. Faites glisser n'importe quelle carte vers "Nécessite intervention humaine" pour intervenir. Exécutez /sdlc-health pour un tableau de bord dans le terminal.
6. Arrêtez le pipeline
claude -p "/sdlc-stop"
Contrôles de qualité
Chaque étape impose des contrôles spécifiques avant la promotion :
- Construction vers Revue :
tsc+eslint+npm testdoivent tous réussir (déterministe) - Revue vers Test : Le réviseur contradictoire doit lister 3 problèmes avant d'approuver
- Test vers Intégration : Seuil de couverture de 80% sur les nouveaux fichiers
- Intégration vers Terminé : Suite de tests complète sur main après fusion ; auto-revert en cas d'échec
Suivi des coûts
Suivi des coûts par tâche avec plafonds par étape (valeurs par défaut Sonnet) :
- Recherche : ~0,10€
- Construction : ~0,40€
- Revue : ~0,10€
- Test : ~0,05€
- Intégration : ~0,03€
Barrières de sécurité automatiques : avertissement à 3€/8€, arrêt dur à 10€/20€ (Sonnet/Opus) avec escalade humaine.
Sécurité et récupération
- Auto-revert : Les échecs d'intégration déclenchent un
git revert(nouveau commit, jamais de force-push) - Tâches bloquées : Après 2 tentatives échouées, les tâches sont escaladées vers une revue humaine
- Détection d'agent mort : Heartbeat toutes les 5 minutes, réassignation après un délai de 10 minutes
- Arrêt gracieux :
/sdlc-stopvide les travailleurs, renvoie les tâches non commencées au backlog - Détection de dérive de périmètre : Les fichiers du diff PR comparés à la liste prévue des fichiers
- Détection de dérive du cahier des charges : Comparaison du hachage SHA-256 détecte les changements de spécifications en cours de sprint
Installation
# Clonez le dépôt
git clone https://github.com/UrRhb/agentflow.git
# Copiez les compétences et les prompts dans la configuration de votre Claude Code
cp -r agentflow/skills/* ~/.claude/skills/
cp -r agentflow/prompts/* ~/.claude/sdlc/prompts/
cp agentflow/conventions.md ~/.claude/sdlc/conventions.md
Ou installez-le en tant que plugin Claude Code :
/plugin marketplace add UrRhb/agentflow
/plugin install agentflow
Bonnes pratiques
- À faire : Rédigez un SPEC.md clair avant d'exécuter
/spec-to-board - À faire : Commencez avec 3-4 travailleurs pour un projet typique
- À faire : Surveillez depuis votre tableau Kanban et faites glisser les cartes vers "Nécessite intervention humaine" si nécessaire
- À faire : Consultez périodiquement LEARNINGS.md — il capture les schémas d'échec courants
- À ne pas faire : Sauter les contrôles de qualité déterministes — ils capturent la plupart des problèmes à moindre coût
- À ne pas faire : Force-push sur main — AgentFlow utilise
git revertpour la sécurité - À ne pas faire : Exécuter plus de travailleurs que le parallélisme de votre projet ne le supporte
Dépannage
Problème : Le travailleur semble bloqué ou mort
Symptômes : La carte de tâche n'a pas bougé depuis 15 minutes ou plus, pas de nouveaux commentaires
Solution : L'orchestrateur détecte les agents morts via le heartbeat et les réassigne après 10 minutes. Si le problème persiste, exécutez /sdlc-health pour vérifier le statut et faites glisser manuellement la carte vers le Backlog.
Problème : Barrière de coût déclenchée
Symptômes : Tâche déplacée vers "Nécessite intervention humaine" avec le tag COST:CRITICAL Solution : Consultez le fil de commentaires de la tâche pour le contexte accumulé. Décidez si vous voulez augmenter le budget, simplifier la tâche ou la diviser en morceaux plus petits.
Problème : Échec du test d'intégration après la fusion
Symptômes : Tâche auto-revert de main Solution : L'auto-revert préserve la stabilité de main. Consultez le contexte de tentatives de la tâche dans les commentaires, qui porte ce qui a été essayé et ce qui a échoué. Le prochain travailleur assigné utilisera ce contexte.
Compétences liées
@brainstorming- À utiliser avant AgentFlow pour concevoir votre SPEC.md@writing-plans- Complète la rédaction du cahier des charges pour la décomposition des tâches@test-driven-development- Fonctionne bien avec les contrôles de qualité d'AgentFlow@subagent-driven-development- Approche alternative pour la coordination multi-agents
Ressources supplémentaires
- Dépôt AgentFlow
- Documentation d'architecture
- Registre des écarts (45 modes d'échec)
- Guide de démarrage
Limitations
- N'utilisez cette compétence que lorsque la tâche correspond clairement au champ d'application décrit ci-dessus.
- Ne traitez pas le résultat comme un substitut à une validation, des tests ou une revue experte spécifiques à l'environnement.
- Arrêtez-vous et demandez des éclaircissements si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.