Développement avec l’IA

Claude Code et Antigravity : déléguer des tâches sans dérive de contexte

Contrat de transition pratique entre Claude Code et Antigravity : isolation des fichiers, protection des secrets, tests reproductibles et revue manuelle.

BT

BetterToken

Équipe éditoriale
3 min de lecture

Lorsque les développeurs connectent deux agents de programmation performants — l'agent en ligne de commande Claude Code et l'environnement Antigravity — la principale difficulté réside dans la dérive du périmètre (scope drift). Donner une consigne trop générale mène souvent à des modifications imprévues dans l'arborescence et à une surconsommation de jetons.

Une délégation efficace exige un contrat de transition rigoureux : périmètre de fichiers restreint, protection absolue des secrets, commande de validation reproductible et validation manuelle via Git diff.

Pourquoi une délégation non restreinte entraîne des dérives

Les agents exécutent les instructions à l'échelle de l'arborescence disponible. Sans règles strictes, trois problèmes surviennent :

  1. Extension incontrôlée du périmètre : Le modèle décide de réécrire des fichiers utilitaires non concernés.
  2. Fuite de données sensibles : L'agent lit les fichiers .env et inclut des clés privées dans des journaux.
  3. Conflits d'architecture : Deux agents adoptent des conventions d'importation incompatibles.

Les clés d'API doivent être isolées du contexte de travail. Avec Claude Code via BetterToken, l'authentification est configurée par variables d'environnement dans le terminal. Sur le tableau de bord BetterToken, vous pouvez suivre la consommation réelle de jetons pour chaque requête.

Le contrat de transition (Handoff Contract)

Utilisez une structure explicite pour cadrer chaque délégation :

Champ du contratRôleExemple
GoalObjectif mesurableOptimiser l'analyse JSON dans parser.py
Allowed ScopeFichiers modifiablessrc/parser.py, tests/test_parser.py
ForbiddenActions interditesNe pas toucher à config/, .env ou aux interfaces publiques
Verification CommandCommande de testpytest tests/test_parser.py -v
Stop ConditionsCritères d'arrêt immédiatÉchec de tests hors périmètre, erreurs de types

Processus de délégation étape par étape

Suivez ces quatre étapes pour sécuriser vos échanges entre agents :

Étape 1. Rédiger le contrat dans un fichier dédié

Créez un fichier de spécification (task_handoff.md) sans données sensibles :

Handoff Spec: Optimize Parser

Context & Goal

  • Module: src/parser.py
  • Objective: Reduce memory allocations in parse_payload() without altering public API.

File Boundaries

  • Modifiable: src/parser.py, tests/test_parser.py
  • Read-only: all other files.
  • Strictly forbidden: .env*, secrets/*, infrastructure/*

Acceptance Criteria

  • All tests pass: pytest tests/test_parser.py
  • Benchmark demonstrates >= 20% latency reduction.
  • No new dependencies in requirements.txt.

Étape 2. Isoler l'espace de travail et les accès

Vérifiez que les fichiers .env figurent dans .gitignore et ne transmettez aucune clé d'API dans le texte de la tâche.

Étape 3. Exécuter la vérification automatisée

Lancez la commande de test spécifiée dans le contrat :

pytest tests/test_parser.py -v

Étape 4. Valider manuellement le diff Git

Le développeur valide chaque modification avant intégration :

git diff src/parser.py
git status --short

Recommandations par scénario

  • Refactorisation ciblée : Utilisez des contrats courts et des tests unitaires rapides.
  • Intégration d'API : Consultez la documentation BetterToken pour configurer vos clés en toute sécurité.

Diagnostic et dépannage

  1. Fichiers modifiés hors périmètre : Définir une liste blanche stricte dans Allowed Scope.
  2. Boucles de corrections répétitives : Limiter le nombre d'essais automatiques de l'agent.
  3. Erreurs d'authentification ou d'expiration : Vérifier l'URL de base et le solde sur BetterToken Docs.

Prêt à optimiser votre workflow LLM ?

Connectez vos modèles via une API unique, gérez les clés et maîtrisez vos dépenses d’IA.