Agentenmuster
Übersicht
Agentenmuster definiert das Koordinationsprotokoll für die Ausführung mehrerer Agenten in Sprints innerhalb des Sprint-Plugins. Es regelt, wie der Projektarchitekt Implementierungs- und Test-Agenten startet, wie Agenten Ergebnisse über strukturierte Berichte kommunizieren und wie parallele Agenten Konflikte vermeiden.
Voraussetzungen
- Sprint-Plugin installiert und konfiguriert (
/plugin install sprint) - Sprint-Verzeichnis initialisiert unter
.claude/sprint/[N]/ specs.mdmit klarem Umfang und Testkonfiguration geschrieben- Vertrautheit mit dem Sprint-Phasen-Lebenszyklus (siehe Skill
sprint-workflow)
Anweisungen
- Strukturieren Sie jeden Agenten-Spawn mit dem SPAWN REQUEST-Format. Geben Sie den Agentennamen, die Spezifikationsdatei, die er lesen soll, und etwaige Bereichseinschränkungen an:
SPAWN REQUEST Agent: python-dev Specs: .claude/sprint/1/backend-specs.md Contract: .claude/sprint/1/api-contract.md Scope: Authentication endpoints only - Stellen Sie sicher, dass jeder gestartete Agent nur die für seinen Aufgabenbereich relevanten Dateien erhält. Übergeben Sie die
api-contract.mdals gemeinsame Schnittstelle, damit Backend- und Frontend-Agenten synchron bleiben. - Sammeln Sie nach Abschluss strukturierte Berichte von jedem Agenten. Jeder Bericht muss Folgendes enthalten: erledigte Arbeit, geänderte Dateien, hinzugefügte Tests und Konformitätsstatus in Bezug auf die Spezifikation.
- Wenn Sie Agenten parallel ausführen, teilen Sie die Arbeit nach Domänengrenzen auf (z. B. Backend vs. Frontend vs. CI/CD). Weisen Sie gleichzeitigen Agenten niemals überlappende Dateipfade zu.
- Leiten Sie die Agentenberichte zur Überprüfung an den Projektarchitekten weiter. Der Architekt entscheidet, ob iteriert (erneutes Starten mit eingeschränkten Spezifikationen) oder zur nächsten Phase übergegangen wird.
- Übergeben Sie für Test-Agenten das in
${CLAUDE_SKILL_DIR}/references/ui-test-report.mdgezeigte UI-Testberichtsformat, damit die Ergebnisse einem einheitlichen Schema mit Testanzahlen, Abdeckung, Fehlschlägen und Konsolenfehlern folgen.
Ausgabe
- SPAWN REQUEST-Blöcke, die vom Sprint-Orchestrator zum Starten von Agenten verwendet werden
- Strukturierte Agentenberichte mit: Zusammenfassung, geänderte Dateien, Testergebnisse und Konformitätsstatus
- UI-Testberichte mit Bestanden/Fehlgeschlagen-Zählern, Abdeckungsdetails, Fehlerbeschreibungen und Konsolenfehlerprotokollen
- Aktualisierte
status.md, die nach jeder Iteration die erledigte und verbleibende Arbeit widerspiegelt
Fehlerbehandlung
| Fehler | Ursache | Lösung |
|---|---|---|
| Agent erhält falsche Spezifikationsdatei | Falscher Pfad im SPAWN REQUEST | Überprüfen Sie die Sprint-Verzeichnisnummer und den Dateinamen vor dem Starten |
| Überlappende Dateiänderungen durch parallele Agenten | Bereichsgrenzen nicht klar definiert | Teilen Sie die Arbeit nach Domänen auf; weisen Sie jedem Agenten eindeutige Verzeichnisse zu |
| Agentenbericht fehlt erforderliche Felder | Agentenanweisungen enthalten kein Berichtsformat | Fügen Sie die strukturierte Berichtsvorlage in die Agentenaufforderung ein |
| Endlose Iterationsschleife | Spezifikationen werden nie vollständig erfüllt | Überprüfen Sie status.md auf blockierende Probleme; der Orchestrator pausiert nach 5 Iterationen |
| Agent nicht gefunden | Falsch geschriebener Agentenname im SPAWN REQUEST | Überprüfen Sie, ob Agenten-Markdown-Dateien im Verzeichnis agents/ existieren |
Beispiele
Starten paralleler Implementierungsagenten:
SPAWN REQUEST
Agent: python-dev
Specs: .claude/sprint/1/backend-specs.md
Contract: .claude/sprint/1/api-contract.md
SPAWN REQUEST
Agent: nextjs-dev
Specs: .claude/sprint/1/frontend-specs.md
Contract: .claude/sprint/1/api-contract.md
Beide Agenten teilen sich dieselbe api-contract.md, um die API-Kompatibilität sicherzustellen.
Strukturiertes Agentenberichtsformat:
AGENT REPORT
Agent: python-dev
Status: COMPLETE
Files Modified: src/auth/routes.py, src/auth/models.py, tests/test_auth.py
Tests: 12 passed, 0 failed
Conformity: All backend-specs requirements implemented
Notes: JWT token expiry set to 24h per spec
Test-Agentenkoordination:
SPAWN REQUEST
Agent: qa-test-agent
Specs: .claude/sprint/1/specs.md
Run After: python-dev, nextjs-dev
SPAWN REQUEST
Agent: ui-test-agent
Specs: .claude/sprint/1/specs.md
Run After: qa-test-agent
Ressourcen
${CLAUDE_SKILL_DIR}/references/ui-test-report.md-- Strukturiertes UI-Testberichtsformat mit Abdeckungs- und Fehlerverfolgung- Sprint-Workflow-Skill für den Phasen-Lebenszyklus-Kontext
- API-Contract-Skill für das gemeinsame Schnittstellendesign
- Sprint-Plugin-README für die Architekturübersicht der Agenten