Claude Code und Antigravity: Aufgaben delegieren ohne Scope Drift
Praktischer Handoff-Vertrag zwischen Claude Code und Antigravity: Datei-Isolation, Geheimnisschutz, reproduzierbare Tests und manuelles Review.
Wenn Entwickler zwei leistungsstarke Coding-Agenten miteinander verbinden — den Terminal-Agenten Claude Code und die Umgebung Antigravity — liegt das häufigste Problem nicht in der Codegenerierung, sondern im unkontrollierten Kontext-Drift (Scope Drift). Bei einer vagen Anweisung wie „Optimiere das Modul und aktualisiere die Tests“ werden oft unbeabsichtigt benachbarte Konfigurationen geändert und unnötige Token verbraucht.
Eine verlässliche Aufgabendelegation zwischen AI-Agenten erfordert einen klaren Handoff-Vertrag: eine explizite Liste erlaubter Dateien, Schutz von API-Geheimnissen, einen reproduzierbaren Testbefehl und eine manuelle Abnahme über Git Diff.
Warum unbeschränkte Delegation zu Drift führt
AI-Agenten führen Anweisungen im Rahmen des gesamten sichtbaren Datei-Baums aus. Wenn ein Agent ohne strikte Grenzen arbeitet, entstehen typische Risiken:
- Ausweitung des Arbeitsbereichs: Das Modell beschließt eigenständig, Hilfsfunktionen umzuschreiben oder das gesamte Projekt neu zu formatieren.
- Sicherheitsrisiken: Der Agent liest
.env-Dateien und gibt geheime Schlüssel versehentlich in Test-Logs aus. - Widersprüchliche Architekturen: Claude Code und Antigravity verwenden unterschiedliche Annahmen über Modulstrukturen.
API-Schlüssel und Systemkonfigurationen sollten daher strikt außerhalb des Aufgabenkontexts verwaltet werden. Bei der Nutzung von Claude Code mit BetterToken wird die Authentifizierung sicher über Umgebungsvariablen im Terminal gesetzt. Im BetterToken Dashboard können Entwickler den genauen Token-Verbrauch für jeden Request nachvollziehen.
Der Handoff-Vertrag (Handoff Contract)
Verwenden Sie ein strukturiertes Manifest mit klaren Schranken:
Schritt-für-Schritt: Sichere Delegation
Befolgen Sie diese vier Schritte für eine saubere Übergabe:
Schritt 1. Spezifikation in separater Datei definieren
Erstellen Sie eine Spezifikationsdatei (task_handoff.md) ohne sensible Daten:
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.
Schritt 2. Arbeitsverzeichnis und Rechte isolieren
Stellen Sie sicher, dass keine Geheimnisse im Prompt enthalten sind und .env in .gitignore eingetragen ist.
Schritt 3. Automatische Verifikation ausführen
Führen Sie den definierten Testbefehl aus:
Schritt 4. Manuelle Prüfung via Git Diff
Der Entwickler behält die volle Kontrolle vor dem Merge:
Empfehlungen und Szenarien
- Refactoring einzelner Funktionen: Nutzen Sie kompakte Handoff-Dateien und lokale Tests.
- API-Integrationen: Verwalten Sie API-Schlüssel über Umgebungsvariablen und prüfen Sie die BetterToken Dokumentation.
Fehlerbehebung
- Dateien außerhalb des Scopes geändert: Whitelist in
Allowed Scopeverschärfen. - Endlosschleifen bei Tests: Feste Abbruchgrenzen für Reparaturversuche setzen.
- Verbindungs- oder Auth-Probleme: Base URL und Guthaben in BetterToken überprüfen.