Sub-Agenten-Design in Claude Code

Problem: Große Coding-Aufgaben brauchen mehr als eine Art von Experten, aber eine einzelne Claude-Sitzung beginnt zu kämpfen, wenn du sie bittest, alle gleichzeitig zu sein.

Schneller Gewinn: Füge diesen Prompt bei jedem Review ein, das mehr als einen Blickwinkel braucht:

Create sub-agents and analyze this from these perspectives:
- Senior engineer: Review architecture decisions
- Security expert: Identify vulnerabilities
- Performance reviewer: Find optimization opportunities

Du bekommst drei Spezialisten-Lesarten parallel, zurück in ein paar Minuten.

Warum ein Kontext scheitert

Bitte Claude, Code zu reviewen, Performance zu tunen und Sicherheit in einem Atemzug zu prüfen, und die Antworten werden generisch. Jeder Blickwinkel kämpft um Platz im selben Kontextfenster. Alles wird flach.

Sub-Agenten beheben das, indem jeder Sichtweise ihren eigenen Kontext bekommt. Jeder Agent bleibt in seiner Spur, wählt eigene Tools und arbeitet mit eigener Methode. Du ziehst die Erkenntnisse am Ende zusammen.

Claude Code gibt dir zwei Wege, sie auszuführen:

1. Task Tool: Das eingebaute Tool startet isolierte Sub-Agenten, jeder mit eigenem Kontextfenster.
2. Prompting für Perspektiven: Ein einzelner Prompt, der mehrere Experten-Sichtweisen in einem Durchlauf anfordertr.

Task startet echte parallele Arbeit. Perspektiv-Prompts simulieren es innerhalb einer Sitzung. So oder so steigt die Analysequalität.

1. Die parallelisierbaren Aufgaben finden

Gute Kandidaten für eine Sub-Agenten-Aufteilung:

• Code-Review aus mehreren Blickwinkeln
• Recherche über verschiedene Technologien
• Dokumentations-Review für verschiedene Zielgruppen
• Performance-Analyse über verschiedene Metriken

Sub-Agenten überspringen wenn Arbeit sequentiell ist:

• Datei-Edits, die voneinander abhängen
• Sequentielle Build-Schritte
• Datenbank-Migrationen

2. Spezialisten-Rollen designen

Wähle die Sichtweisen, die zu deiner Domäne passen. Einige Prompt-Templates, die sich bewähren:

Code-Qualitäts-Review:

Analyze this codebase using sub-agents with these specialist roles:
- Factual reviewer: Check technical accuracy against documentation
- Senior engineer: Review architecture decisions and patterns
- Security expert: Identify vulnerabilities and attack vectors
- Consistency reviewer: Check coding standards compliance
- Redundancy checker: Find duplicate logic to consolidate

User-Experience-Analyse:

Create sub-agents for UX review of this feature:
- Creative thinker: Suggest innovative interaction solutions
- Beginner user: Test ease of use and onboarding friction
- Designer: Evaluate visual hierarchy and spacing
- Marketing analyst: Assess conversion potential
- Accessibility auditor: Check WCAG compliance

3. Die Analyse orchestrieren

Jeder Sub-Agent wählt seine eigenen Tools. Sicherheits-Agenten greifen zu Schwachstellen-Scannern. Performance-Reviewer ziehen Profiling-Tools hinzu. Architekten schauen sich die Struktur an. Ein einzelner Agent kann nicht alle drei auf dieselbe Weise abdecken.

Plan-Modus für sichere Lesevorgänge

Bevor du Spezialisten-Sub-Agenten auf kritischen Code loslässt, wechsle in den Plan-Modus. Drücke Shift+Tab zweimal in Claude Code. Damit bleibt der Lauf schreibgeschützt während sie arbeiten.

Dann fordere das Multi-Perspektiven-Review an:

Use sub-agents to validate this API design from:
- Backend perspective: Data flow and scalability
- Frontend perspective: Consumption patterns and DX
- Security perspective: Authentication and authorization gaps

Der Plan-Modus zahlt sich aus, wenn ein Sub-Agent sonst versuchen könnte, Dinge eigenständig zu reparieren.

Das Konsolidierungsmuster

Sobald die Sub-Agenten fertig sind, bringst du die Ausgaben zusammen:

1. Einzelberichte: Jeder Agent schreibt seine eigenen Erkenntnisse auf.
2. Konfliktlösung: Einen Gewinner wählen, wenn zwei Empfehlungen widersprechen.
3. Prioritätsranking: Fixes nach Auswirkung sortieren.
4. Aktionsplan: Die Schritte zur Implementierung darlegen.

Häufige Fehler

Fehler: Sub-Agenten für winzige Aufgaben starten.

Tippfehler, einzeilige Patches, schnelle Umbenennungen. Der Koordinations-Overhead vernichtet den Gewinn. Agenten überspringen.

Besser: Spar dir das Spezialistenteam für knifflige, vielschichtige Probleme:

Use sub-agents to redesign this authentication system:
- Security expert: Audit current vulnerabilities
- UX designer: Simplify the login flow
- Performance engineer: Optimize token handling

Fehler: Rollen stapeln, die sich größtenteils überlappen.

"Security expert, penetration tester, vulnerability scanner, security architect" ist dieselbe Sichtweise in vier verschiedenen Hüten.

Besser: Rollen wählen, die verschiedene Seiten des Problems abdecken und sich nicht gegenseitig stören.

Hintergrundausführung

Jeder Sub-Agent kann jetzt im Hintergrund laufen. Drücke Ctrl+B während er arbeitet:

You: Audit our authentication module for security issues
Claude: I'll spawn a sub-agent to analyze the auth module...
[Sub-agent starts]
You: [Press Ctrl+B]
You: While that runs, let's optimize the database queries...

Verfolge den Hintergrundlauf mit /tasks. Wenn er fertig ist, weckt er den Haupt-Agenten und übergibt die Ergebnisse.

Blockierende Spezialisten werden zu parallelen. Die vollständige Async-Abdeckung findest du im Background Agents-Leitfaden.

Kosten-Gewinn

Sub-Agenten strecken Claude Sonnet, ohne für Opus zu zahlen. Parallele Analyse bringt dich nah an Opus-Niveau-Ausgabe zu Sonnet-Preisen.

Wo die Ersparnisse herkommen:

• Mehrere Experten-Sichtweisen in einer Sitzung
• Parallele Arbeit kürzt die Gesamtlaufzeit
• Spezialisierter Kontext vermeidet das flache Generalist-Lesen
• Bessere Ausgabe als ein einzelnes Premium-Modell
• Hintergrundausführung eliminiert das Warten

Rollenwechsel

Bei längeren Projekten rotierst du die Spezialisten-Besetzung über Komponenten hinweg.

Woche 1 - Kernarchitektur:

Analyze the database design using sub-agents:
- Data architect: Schema optimization and normalization
- Security expert: Access control and encryption
- Performance optimizer: Query patterns and indexing

Woche 2 - API-Schicht:

Review API endpoints with these specialist sub-agents:
- Backend engineer: Implementation quality and patterns
- Documentation writer: API clarity and examples
- Integration specialist: Third-party compatibility

Iterative Verfeinerung

Sub-Agenten passen gut zu progressiven Durchläufen:

1. Breite Perspektiven beim ersten Blick
2. Spezialisierter Deep-Dive beim zweiten
3. Nutzer-fokussiertes Review beim dritten

Das Ergebnis ist vollständiger, nutzer-zentrierter und fängt Dinge auf, die ein einzelner Agent übersehen würde.

Wo Sub-Agenten sich auszahlen

• Architektur-Reviews: Mehrere technische Linsen gleichzeitig
• Dokumentations-Audits: Verschiedene Zielgruppen lesen verschiedene Dinge
• Code-Qualitätsgates: Viele Qualitätsdimensionen in einem Durchlauf
• Produktstrategie: Funktionsübergreifende Lesart
• Wettbewerbsanalyse: Verschiedene Marktwinkel

Fang mit Code-Reviews an. Geh zu strategischer Arbeit über, sobald du den "Juckreiz nach Parallelität" spürst.

Nächste Schritte

• Ausführungsmuster: Wann parallel, sequentiell oder im Hintergrund.
• Grundlage: Agent Fundamentals deckt die Basics ab.
• Implementierung: Custom Agents für spezialisierte Szenarien.
• Koordination: Task Distribution für große Multi-Agenten-Projekte.
• Optimierung: Planning Modes für sichere Sub-Agenten-Läufe.
• Kontextverwaltung: Qualität über ein ganzes Team hinweg hochhalten.

Probier es beim nächsten Code-Review. Die Spezialisten-Aufteilung ist die Art von Sache, die du beim ersten Mal merkst.