Subagents in Claude Code: specialiseren zonder chaos

Wanneer een subagent helpt

Een subagent is nuttig voor een afgebakend onderzoek, een onafhankelijke review of werk in een duidelijk domein. Voor één kleine lineaire wijziging voegt delegatie vooral coördinatie toe. Splits dus op basis van zelfstandig leverbare resultaten.

Geef één duidelijke verantwoordelijkheid

Beschrijf het gewenste resultaat, toegestane bestanden, relevante context en verificatie. Een opdracht als “onderzoek de oorzaak en rapporteer bewijs” voorkomt dat diagnose ongemerkt in implementatie verandert.

Beperk tools en rechten

Een onderzoeker hoeft meestal niets te schrijven en een reviewer hoeft geen deploymentrechten. Geef elke rol alleen de hulpmiddelen die bij de opdracht horen en laat riskante acties door de hoofdsessie of een mens bevestigen.

Gebruik contextisolatie bewust

Een afzonderlijke context voorkomt dat elk detail de hoofdsessie vult, maar de subagent kent ook niet automatisch alle impliciete keuzes. Voeg daarom beslissingen, constraints en relevante paden expliciet toe.

Nee. Afstemming, dubbele context en conflicterende wijzigingen kunnen meer tijd kosten dan ze besparen.

Ontwerp de overdracht

Vraag om bevindingen, gewijzigde bestanden, uitgevoerde controles en resterende onzekerheden. De hoofdagent moet deze output kunnen toetsen en integreren zonder het volledige onderzoek opnieuw te doen.

Meet de coördinatiekost

Vergelijk doorlooptijd en foutpercentage met een eenvoudige uitvoering. Als taken elkaar vaak blokkeren of dezelfde bestanden wijzigen, verklein het aantal parallelle rollen. Meer agents is geen doel op zich.

--- name: test-auditor description: Reviews test coverage only tools: Read, Grep, Bash --- Report evidence; do not edit production code.

Zo maak je Claude Code subagents toetsbaar

De beslisreview voor Claude Code subagents richt zich eerst op één afgebakende onderzoeks- of reviewtaak met een unieke eigenaar, beperkte tools en een controleerbare hand-off. Leg voor Claude Code subagents vooraf vast welk gebruikersresultaat aanvaardbaar is, welke invoer noodzakelijk blijft en wie de uitkomst mag goedkeuren. Houd de eerste proef van Claude Code subagents klein genoeg om oorzaken en gevolgen afzonderlijk te kunnen beoordelen.

Ontwerp voor Claude Code subagents bewijs rond één realistische succesroute en simuleer daarnaast overlappende bestandswijzigingen, ontbrekende besliscontext en tools die ruimer zijn dan de gedelegeerde rol. Noteer bij Claude Code subagents per controle de verwachte uitkomst, het zichtbare bewijs en de herstelactie wanneer de controle faalt. De laatste beslisvraag voor Claude Code subagents luidt: “Zijn meer subagents altijd sneller?”

Claude Code subagents: van proef naar dagelijks beheer

Wijs voor Claude Code subagents één operationele eigenaar, één inhoudelijke reviewer en een duidelijke terugvalroute aan. Behandel de checklist voor Claude Code subagents als afzonderlijke werkstappen met bewijs, zodat interpunctie of formulering nooit onderdeel van de proceslogica wordt. Laat de betrokken gebruiker Claude Code subagents doorlopen zonder mondelinge hulp en registreer elke plek waar uitleg of handmatig herstel nodig blijft.

Neem voor Claude Code subagents wijzigingsrechten, logging, support en reviewmomenten op in hetzelfde beheerplan. Herhaal de praktijktest van Claude Code subagents na een wijziging in brondata, configuratie, model, integratie of gebruikersrol. Breid Claude Code subagents pas uit wanneer het team ook overlappende bestandswijzigingen, ontbrekende besliscontext en tools die ruimer zijn dan de gedelegeerde rol tijdig herkent, begrenst en herstelt.

Stop de uitrol van Claude Code subagents zolang overlappende bestandswijzigingen, ontbrekende besliscontext en tools die ruimer zijn dan de gedelegeerde rol niet zichtbaar wordt gemeld en door de aangewezen eigenaar kan worden hersteld.