Généré le 27/10/2026 22:25

Protocole de Collaboration Claude Code ↔ Antigravity

🎯 Objectif

Garantir que chaque tâche technique aboutit à un résultat qui FONCTIONNE réellement, vérifié par les deux agents.

📋 Règles de Base

Règle 1 : Pas de Handoff Silencieux

Règle 2 : Tout Test Doit Passer

Règle 3 : Documentation de Handoff

Règle 4 : Relecture Obligatoire

🔄 Workflows Collaboratifs

Workflow A : Nouvelle Feature

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"
  ]
}

Workflow B : Correction de Bug

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

Workflow C : Tâche Complexe Multi-Phases

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"
}

📝 Templates de Communication

Template 1 : Demande de Revue

🔍 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]

Template 2 : Rapport de Revue

✅ 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]

Template 3 : Handoff Rapide

🔄 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`

🎮 Commandes Collaboratives

/sync

Synchronise 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

🚨 Cas Spéciaux

Cas 1 : Désaccord Technique

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

Cas 2 : Blocage Technique

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

Cas 3 : Urgence

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

📊 Métriques de Qualité

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

🎯 Objectif Final

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