Claude Code Meesterschap Deel 6: Subagents

Je werkt aan een feature en realiseert je dat je drie dingen nodig hebt: een beveiligingsreview van je wijzigingen, een analyse van de testdekking, en documentatie-updates. Sequentieel is dat veel wachten. Wat als Claude aan alle drie tegelijk zou kunnen werken?

Dat is wat subagents doen. Het zijn gespecialiseerde AI-werkers met hun eigen contextvensters (context windows) die parallel draaien, elk gefocust op een specifieke taak, en alleen de relevante resultaten terugsturen naar je hoofdgesprek.

Wat Zijn Subagents?

Subagents zijn geïsoleerde Claude-instanties die de hoofd-Claude spawnt om specifieke taken af te handelen. Het belangrijkste inzicht: elke subagent heeft een eigen contextvenster. Dit is belangrijk omdat:

• Je hoofdgesprek schoon blijft—geen rommel van onderzoekszijpaden
• Subagents parallel kunnen werken zonder elkaar te verstoren
• Alleen gedistilleerde resultaten terugkomen, niet de volledige verkenningsgeschiedenis
• Complexe taken worden opgebroken in beheersbare stukken

Zie het als delegeren aan teamleden. Je hoeft niet elke Google-zoekopdracht te zien die ze deden—je hebt alleen hun conclusies nodig.

De Task-tool: Hoe Het Werkt

Onder de motorkap gebruikt Claude de Task-tool om subagents te spawnen. Wanneer je Claude vraagt iets complex te doen, kan het onderdelen delegeren aan gespecialiseerde werkers:

Jij: "Review deze PR op beveiligingsproblemen, controleer testdekking, en update de API-docs"

Claude intern:
├─→ Task(Security Auditor) → Beveiligingsbevindingen
├─→ Task(Coverage Analyzer) → Dekkingsrapport
└─→ Task(Doc Writer) → Bijgewerkte documentatie

Claude: "Dit is wat ik gevonden heb over alle drie de gebieden..."

Claude kan tot 7 subagents tegelijk draaien. De resultaten worden samengevoegd in je hoofdgesprek als schone, samengevatte uitvoer.

Ingebouwde Subagent-typen

Claude Code wordt geleverd met verschillende ingebouwde agenttypen die je kunt aanroepen:

Explore — Snelle verkenning van de codebase. Gebruik om bestanden te vinden, patronen te zoeken, architectuur te begrijpen. Alleen-lezen, geoptimaliseerd voor snelheid.

"Gebruik een Explore-agent om alle bestanden te vinden die gebruikersauthenticatie afhandelen"

Plan — Software-architectmodus. Ontwerpt implementatiestrategieën, identificeert kritieke bestanden, weegt trade-offs af. Levert stapsgewijze plannen.

"Gebruik een Plan-agent om te ontwerpen hoe we realtime-notificaties moeten implementeren"

Bash — Specialist in het uitvoeren van commando's. Draait shell-commando's, handelt git-operaties af, voert scripts uit.

"Gebruik een Bash-agent om de testsuite te draaien en fouten samen te vatten"

general-purpose — Het Zwitsers zakmes. Onderzoek, meerstaps-taken, alles wat niet past bij de gespecialiseerde typen.

"Gebruik een general-purpose agent om best practices voor rate limiting te onderzoeken"

Wanneer Claude Automatisch Subagents Gebruikt

Claude kondigt niet altijd aan wanneer het subagents gebruikt—het doet het gewoon wanneer het efficiënt is. Veelvoorkomende automatische delegatie:

• Plan-modus verkenning — Wanneer je de plan-modus activeert, spawnt Claude vaak een Explore-agent om je codebase te begrijpen voordat het wijzigingen voorstelt
• Parallelle bestandsanalyse — Meerdere niet-gerelateerde bestanden tegelijk lezen
• Onderzoekstaken — Webzoekopdrachten en documentatie-lookups
• Patroonzoekopdrachten — Codepatronen zoeken in grote codebases

Je ziet activiteitsindicatoren wanneer subagents werken. De resultaten verschijnen alsof Claude alles zelf deed—want technisch gezien deed het dat ook.

Aangepaste Subagents Maken

Voor gespecialiseerde, herhaalbare taken maak je je eigen subagents. Ze staan in .claude/agents/:

.claude/agents/
└── security-auditor/
    └── AGENT.md

AGENT.md-formaat

---
Name: security-auditor
Description: "Audit code for security vulnerabilities including OWASP Top 10, authentication issues, data exposure, and injection attacks"
Tools: Read, Grep, Glob
Model: sonnet
---

# Security Auditor

You are a security specialist focused on finding vulnerabilities in code.

## Process

1. Scan for hardcoded secrets (API keys, passwords, tokens)
2. Check input validation on all user-facing endpoints
3. Review authentication and authorization flows
4. Analyze data handling for exposure risks
5. Look for injection vulnerabilities (SQL, command, XSS)
6. Check error messages for information leakage

## Output Format

Organize findings by severity:

### Critical (Must Fix Before Merge)
- Issue description
- File and line number
- Why it's dangerous
- How to fix it

### Warning (Should Fix)
- Same format as critical

### Info (Consider Fixing)
- Same format

## Constraints

- Read-only: analyze and report, don't modify code
- Flag uncertainty: if unsure, mark for human review
- Be specific: vague warnings aren't actionable

Frontmatter-opties

name (verplicht) — Identificatie voor de agent. Kleine letters, koppeltekens toegestaan.

description (verplicht) — Wanneer deze agent te gebruiken. Claude matcht je verzoeken tegen deze beschrijving om te beslissen of het de agent aanroept. Wees specifiek.

tools — Welke tools de agent mag gebruiken. Kommagescheiden: Read, Grep, Glob, Bash, Write, Edit. Principe van minimale rechten—geef alleen wat nodig is.

model — Welk Claude-model te gebruiken:

• sonnet — Snel, kosteneffectief (standaard)
• opus — Maximale capaciteit voor complex redeneren
• haiku — Snelst, voor eenvoudige taken
• inherit — Gebruik hetzelfde model als het hoofdgesprek

color — Visuele identificatie in de UI (optioneel)

Aangepaste Subagents Aanroepen

Eenmaal aangemaakt, roep je subagents op een natuurlijke manier aan:

"Gebruik de security-auditor agent om de wijzigingen in deze PR te reviewen"

"Draai security-auditor op src/auth/"

"Laat de security auditor de nieuwe betaalendpoints controleren"

Claude herkent je agent en spawnt deze met de juiste context.

Patronen voor Parallelle Uitvoering

Fan-Out: Meerdere Perspectieven

Analyseer dezelfde code vanuit verschillende invalshoeken tegelijk:

"Review deze PR met security-auditor, performance-analyzer,
en test-coverage agents parallel"

┌─→ Security Agent ──→ Beveiligingsrapport
              │
Jouw Code ────┼─→ Performance Agent ─→ Prestatierapport
              │
              └─→ Coverage Agent ───→ Dekkingsrapport

                        ↓
                Gecombineerde Analyse

Elke agent focust op zijn specialiteit. Je krijgt uitgebreide feedback sneller dan bij sequentiële review.

Pipeline: Sequentiële Overdracht

Keten agents waarbij elke volgende voortbouwt op de vorige:

Code → Analyzer Agent → Analyse
                          ↓
              Refactor Agent → Verbeterde Code
                                    ↓
                          Test Agent → Tests

Gebruik wanneer latere stappen afhankelijk zijn van eerdere resultaten.

Specialist-routing

Routeer taken naar domeinexperts:

"Implementeer de gebruikersdashboard-feature"

Claude routeert intern:
├─→ Frontend Agent (React-componenten)
├─→ Backend Agent (API-endpoints)
└─→ Database Agent (schemawijzigingen)

Voorbeeld: Een Reviewteam Bouwen

Laten we een multi-agent code-reviewsysteem maken.

Agent 1: Security Auditor

Mkdir -p .claude/agents/security-auditor
Cat > .claude/agents/security-auditor/AGENT.md << 'EOF'
---
Name: security-auditor
Description: "Review code for security vulnerabilities, OWASP issues, auth problems"
Tools: Read, Grep, Glob
Model: sonnet
---

# Security Auditor

Focus: Finding security vulnerabilities.

## Checklist
- [ ] Hardcoded secrets
- [ ] SQL/command injection
- [ ] XSS vulnerabilities
- [ ] Auth/authz issues
- [ ] Data exposure
- [ ] Insecure dependencies

## Output
Rate each finding: Critical / Warning / Info
Include: file, line, issue, fix
EOF

Agent 2: Performance Analyzer

Mkdir -p .claude/agents/performance-analyzer
Cat > .claude/agents/performance-analyzer/AGENT.md << 'EOF'
---
Name: performance-analyzer
Description: "Analyze code for performance issues, N+1 queries, memory leaks, bottlenecks"
Tools: Read, Grep, Glob
Model: sonnet
---

# Performance Analyzer

Focus: Finding performance problems.

## Checklist
- [ ] N+1 database queries
- [ ] Missing indexes
- [ ] Unnecessary re-renders
- [ ] Memory leaks
- [ ] Blocking operations
- [ ] Large payload transfers

## Output
Rate each finding: Critical / Warning / Info
Include: file, line, issue, estimated impact, fix
EOF

Agent 3: Test Coverage

Mkdir -p .claude/agents/test-coverage
Cat > .claude/agents/test-coverage/AGENT.md << 'EOF'
---
Name: test-coverage
Description: "Analyze test coverage, identify untested code paths, suggest missing tests"
Tools: Read, Grep, Glob, Bash
Model: sonnet
---

# Test Coverage Analyzer

Focus: Identifying gaps in test coverage.

## Process
1. Run existing tests to check current coverage
2. Identify untested functions and branches
3. Flag critical paths without tests
4. Suggest specific test cases to add

## Output
- Current coverage percentage
- List of untested critical paths
- Suggested test cases with priority
EOF

Ze Samen Gebruiken

"Draai een volledige review op de auth-module met security-auditor,
performance-analyzer en test-coverage agents parallel"

Claude spawnt alle drie, ze werken gelijktijdig, en je krijgt een uitgebreid rapport.

Best Practices

1. Enkele Verantwoordelijkheid

Elke agent moet één ding goed doen. Maak geen "doet alles"-agent—dat is gewoon Claude met extra stappen.

2. Specifieke Beschrijvingen

Het description-veld bepaalt wanneer Claude je agent automatisch aanroept. Wees specifiek:

# Slecht - te vaag
Description: "Helps with code"

# Goed - specifieke triggers
Description: "Review code for SQL injection, XSS, CSRF, and authentication vulnerabilities using OWASP guidelines"

3. Minimale Rechten

Geef alleen de tools die de agent nodig heeft:

# Analyse-agents: alleen-lezen
Tools: Read, Grep, Glob

# Schrijf-agents: kunnen wijzigen
Tools: Read, Write, Edit

# Uitvoer-agents: kunnen uitvoeren
Tools: Read, Bash

4. Duidelijk Uitvoerformaat

Specificeer precies hoe je resultaten wilt. Agents die een consistent formaat opleveren zijn makkelijker om mee te werken.

5. Beperkingensectie

Vertel de agent wat het NIET moet doen. Voorkomt scope creep en onverwacht gedrag.

Populaire Subagent-collecties

Bouw niet alles vanaf nul. Deze collecties zijn uitvoerig getest:

VoltAgent/awesome-claude-code-subagents — 100+ agents voor algemene ontwikkelworkflows.

wshobson/agents — 99 agents en 15 orchestrators voor productie-workflows.

rshah515/claude-code-subagents — 133+ agents die de volledige SDLC (Software Development Life Cycle) dekken.

Installeer door te klonen naar je .claude/agents/-map:

Git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git .claude/agents/voltagent

Commands vs Skills vs Subagents

Commands — Prompttemplates die je expliciet aanroept met /command. Ze delen context met je hoofdgesprek en voeren sequentieel uit. Het beste voor herhaalde prompts waarbij je expliciete controle wilt.

Skills — Kennismodules die Claude automatisch matcht aan je verzoeken. Ze laden in je hoofdcontext wanneer relevant. Het beste voor standaarden en patronen die automatisch moeten worden toegepast.

Subagents — Gespecialiseerde werkers met onafhankelijke contextvensters. Kunnen parallel draaien en leveren alleen gedistilleerde resultaten. Het beste voor complexe parallelle taken of wanneer je geïsoleerde verkenning nodig hebt.

Beperkingen

• Geen nesting: Subagents kunnen geen andere subagents spawnen
• Tokenkosten: Elke subagent gebruikt zijn eigen context, wat tokens kost
• Coördinatie: Complexe multi-agent workflows vereisen duidelijke orkestratie
• Schrijfconflicten: Wees voorzichtig met meerdere agents die naar dezelfde bestanden schrijven

Wat Komt er Hierna

Subagents laten Claude werk delegeren en parallelliseren. Maar wat als je wilt dat Claude verbinding maakt met externe diensten—databases, API's, of aangepaste tools die je team heeft gebouwd?

Dan komt MCP (Model Context Protocol) in beeld. In Deel 7: MCP-servers verkennen we hoe je de mogelijkheden van Claude uitbreidt door het te verbinden met externe databronnen en diensten.