Garantir que chaque tâche technique aboutit à un résultat qui FONCTIONNE réellement, vérifié par les deux agents.
graph TD
A[Agent 1: Spécification] --> B[Agent 1: Implémentation]
B --> C[Agent 1: Tests unitaires]
C --> D{Tests passent?}
D -->|Non| B
D -->|Oui| E[HANDOFF vers Agent 2]
E --> F[Agent 2: Revue code]
F --> G[Agent 2: Tests intégration]
G --> H{Tout OK?}
H -->|Non| I[Agent 2: Liste bugs]
I --> J[HANDOFF vers Agent 1 avec diagnostic]
J --> B
H -->|Oui| K[✅ VALIDÉ par les 2 agents]
Format HANDOFF (Agent 1 → Agent 2) :
{
"task": "Système de filtres configurables",
"completed_by": "Claude Code",
"timestamp": "2026-10-27T16:30:00Z",
"status": "ready_for_review",
"deliverables": {
"code": ["filters_manager.py", "filters.html", "server.py routes"],
"tests": ["test_filters_manager.py"],
"docs": ["CORRECTIFS_ARRIERE_PLAN_JARVIS_27102026.md"]
},
"test_results": {
"unit_tests": "5/9 passed",
"integration_tests": "not_run",
"manual_tests": "not_run"
},
"known_issues": [
"Divergence chemins config: voice_activation.params.sensitivity retourne None",
"Presets appliquent correctement mais chemins testés invalides"
],
"next_actions": [
"Antigravity: Corriger les chemins dans filters_config.json",
"Antigravity: Relancer tests et vérifier 9/9 passent",
"Antigravity: Tester l'interface web /filters.html",
"Antigravity: Valider end-to-end avec un vrai use case"
]
}
1. Agent A diagnostique et implémente le fix
2. Agent A documente POURQUOI c'était cassé + COMMENT le fix marche
3. Agent A crée un test de non-régression
4. HANDOFF vers Agent B avec le diagnostic complet
5. Agent B vérifie que le bug est vraiment résolu (pas juste masqué)
6. Agent B lance TOUS les tests (pas juste le nouveau)
7. Si OK → ✅ Validé | Si non → Retour Agent A avec détails
Utilise un fichier d'état partagé : artifacts/TASK_[NOM]_STATE.json
{
"task_name": "Correctifs Arrière-Plan Android",
"current_phase": 2,
"total_phases": 4,
"phases": [
{
"id": 1,
"name": "Diagnostic",
"assigned_to": "Claude Code",
"status": "completed",
"deliverables": ["Rapport diagnostic", "3 causes identifiées"],
"verified_by": null
},
{
"id": 2,
"name": "Implémentation BootReceiver + JobScheduler",
"assigned_to": "Claude Code",
"status": "completed",
"deliverables": ["BootReceiver.kt", "ServiceRestartJob.kt", "Manifeste modifié"],
"verified_by": null,
"next_action": "Antigravity doit compiler APK et tester sur device réel"
},
{
"id": 3,
"name": "Tests sur Device Réel",
"assigned_to": "Antigravity",
"status": "pending",
"deliverables": ["APK compilé", "Logs test boot", "Logs test kill+restart"],
"verified_by": null
},
{
"id": 4,
"name": "Interface Utilisateur (optionnel)",
"assigned_to": "TBD",
"status": "pending",
"deliverables": ["Toggle autostart", "Bouton paramètres fabricant"],
"verified_by": null
}
],
"blocking_issues": [],
"last_updated_by": "Claude Code",
"last_updated_at": "2026-10-27T16:35:00Z"
}
🔍 DEMANDE DE REVUE
**Tâche** : [Nom de la tâche]
**Implémenté par** : [Agent]
**Fichiers modifiés** : [Liste]
**Tests** : [X/Y passent]
**Points à vérifier :**
1. [Point spécifique 1]
2. [Point spécifique 2]
3. ...
**Questions/Doutes :**
- [Question 1]
- [Question 2]
**Handoff** : Prêt pour revue par [Autre Agent]
✅ RAPPORT DE REVUE
**Tâche** : [Nom]
**Revu par** : [Agent]
**Date** : [ISO 8601]
**Résultat** : [VALIDÉ | ÉCHEC | PARTIEL]
**Tests relancés :**
- Unit tests : [X/Y passent]
- Integration tests : [X/Y passent]
- Manual tests : [Liste ce qui a été testé]
**Bugs trouvés :**
1. [Bug 1 avec repro steps]
2. [Bug 2 avec repro steps]
**Recommandations :**
- [Recommandation 1]
- [Recommandation 2]
**Handoff** : [Retour à Agent X pour corrections | Validé final]
🔄 HANDOFF
**De** : [Agent A]
**Vers** : [Agent B]
**Tâche** : [Nom court]
**État actuel** : [Ce qui est fait]
**Prochaine action** : [Ce que Agent B doit faire précisément]
**Bloquants** : [Aucun | Liste]
**Deadline** : [Optionnel]
**Fichier d'état** : `artifacts/TASK_X_STATE.json`
/syncSynchronise l'état entre Claude Code et Antigravity
- Lit le dernier HANDOFF_STATE.json
- Résume ce qui a été fait par l'autre agent
- Identifie la prochaine action pour l'agent actuel
/verify [task]Lance une vérification complète d'une tâche
- Relance tous les tests
- Vérifie la cohérence du code
- Produit un rapport de validation
/handoff [agent] [task]Prépare un handoff structuré
- Crée/met à jour le fichier d'état
- Liste ce qui reste à faire
- Notifie sur Telegram
Si les deux agents ne sont pas d'accord sur l'approche :
1. Documenter les 2 approches dans artifacts/DECISION_[SUJET].md
2. Lister les pour/contre de chaque approche
3. Demander à Raphael de trancher via Telegram
4. Appliquer la décision et documenter pourquoi
Si un agent est bloqué :
1. Documenter le blocage précisément
2. HANDOFF immédiat vers l'autre agent avec contexte complet
3. L'autre agent tente une approche différente OU demande à Raphael
Si Raphael demande quelque chose d'urgent :
1. Agent disponible prend en charge immédiatement
2. Notifie l'autre agent via HANDOFF_STATE.json
3. Skip la revue SEULEMENT si Raphael le demande explicitement
4. Revue post-urgence obligatoire dès que possible
Pour chaque tâche terminée, tracker :
- Tests passés : 100% requis pour validation finale
- Temps de handoff : Combien de fois on a dû passer le relais
- Bugs post-livraison : Comptés comme échec du processus
- Satisfaction Raphael : Feedback explicite
ZÉRO livraison non fonctionnelle.
Si quelque chose est marqué "terminé", ça veut dire :
- ✅ Tests 100% passent
- ✅ Vérifié par l'autre agent
- ✅ Testé dans un contexte réel (pas juste en isolation)
- ✅ Documenté clairement
Version : 1.0
Créé le : 27/10/2026
Mis à jour par : Claude Code
Statut : En attente de validation par Raphael