Deel C · Module 06

Het geheel: assen & beslisboom

Wat gebruik je wanneer?

Zone: machine ± 15 min kern

Leerdoelen

Na deze module kun je:

  • voor een eis uit je team in hooguit vijf vragen bepalen welk mechanisme hem draagt, en dat onderbouwen met de assen wie trekt de trekker en wanneer laadt het;
  • voorspellen wat er gebeurt als hetzelfde op meerdere niveaus bestaat (samenvoegen, overschrijven op naam, of namespacen);
  • een bestaande setup beoordelen op verkeerd gekozen mechanismen, en twee combinaties ontwerpen waarin primitieven elkaar versterken.

Voorkennis-check

Twee vragen uit de vorige modules. Fout? Lees C2 Hooks en C4 Subagents terug.

Waar zitten we?

Alle extensies uit deel C hangen aan laag 4, de harness, maar ze grijpen op verschillende plekken in. CLAUDE.md, rules en skills sturen via de context (laag 2). Hooks en permissies zitten tussen model en tool. MCP voegt tools toe. Subagents starten een tweede loop (laag 3). Plugins verpakken het geheel voor de organisatie (laag 5).

De stof in drie lagen

Kern ± 5 min lezen, daarna casussen door de boom halen

Vijf modules, zeven mechanismen. Wat ze van elkaar onderscheidt, is niet wat ze doen (ze doen allemaal "iets met de agent"), maar twee assen:

As 1 · Wie trekt de trekker?

  • Het model (probabilistisch): skills, subagents, MCP-tools. Het model beslist of en wanneer.
  • De harness (deterministisch): hooks, permissieregels, rules met paths. Gebeurt altijd bij het event of de match.
  • Jij: /skill, @agent, /plugin install.

As 2 · Wanneer staat het in de context?

  • Altijd: CLAUDE.md, rules zonder paths, descriptions van skills en agents.
  • Bij een match: rules met paths, CLAUDE.md in een submap.
  • Bij gebruik: skill-inhoud, MCP-schema's.
  • Nooit (apart venster): subagent-werk, hooks (tenzij ze output teruggeven).

Skills are instructions the model reads. MCP servers are functions the model calls. Hooks are commands the harness runs. Subagents are workers the main agent spawns. Plugins are how you distribute the first four.

Shrikar Archak, Claude Code skills vs subagents vs hooks vs plugins vs MCP, shrikar.com (secundaire bron)

Daaruit volgt een beslisboom. Neem een eis en beantwoord de vragen. Of kies een casus en kijk welk pad hij neemt. De laatste vraag, "delen?", geldt voor elke uitkomst: dat is de plugin-as.

Samengevat: skills onderwijzen, subagents isoleren, hooks dwingen, MCP verbindt, plugins distribueren. CLAUDE.md en rules zijn het altijd-aan-geheugen van het project. Begin klein en voeg een mechanisme pas toe als je een duidelijke aanleiding ziet.

Verdieping matrix, groeipad, combinaties

De matrix

Alle mechanismen uit deel C naast elkaar
MechanismeWie start hetContextkostenGarantieWaarModule
CLAUDE.mdharness, bij sessiestartvolledig, elke requestverzoekCLAUDE.md, CLAUDE.local.mdC1
Rule met pathsharness, bij een bestandsmatchalleen na de matchverzoek.claude/rules/*.mdC1
Skillmodel (op description) of jij (/naam)description elke request; inhoud bij gebruikverzoek.claude/skills/<naam>/C1
Hookharness, op een lifecycle-eventnul, tenzij hij output teruggeeftafgedwongen (exit 2, decision)settings.json → hooksC2
Permissieregelharness, bij elke tool callnulafgedwongensettings.json → permissionsC2
MCP-servermodel roept tool aannamen bij start; schema bij gebruikverbinding, geen beleid.mcp.json, claude mcp addC3
Subagentmodel delegeert, of jij (@naam)description elke request; werk geïsoleerdisolatie (+ tool-beperking).claude/agents/*.mdC4
Pluginjij (installeren, aanzetten)som van zijn componentendezelfde setup overalmarketplace / --plugin-dirC5

Wat als hetzelfde op meerdere niveaus bestaat?

Elk mechanisme kan op meerdere niveaus bestaan (managed, user, project, local, plugin), en ze lossen conflicten verschillend op:

  • CLAUDE.md wordt samengevoegd: alle niveaus tegelijk in de context. Bij tegenspraak weegt het model.
  • Skills en subagents worden op naam overschreven: één definitie wint (skills: managed > user > project; subagents: managed > CLI-flag > project > user > plugin). Plugincomponenten hebben een namespace en botsen niet.
  • MCP-servers worden op naam overschreven: local > project > user, en de hele entry wint.
  • Hooks worden samengevoegd: alles wat matcht, vuurt. Bij beslissingen wint de strengste.

Het groeipad: voeg toe bij een aanleiding

Je hoeft niet alles vooraf in te richten. De docs geven per mechanisme een herkenbare aanleiding:

Aanleiding → mechanisme (naar "Build your setup over time")
Als je merkt dat …Voeg toe
Claude een conventie of commando twee keer verkeerd doetCLAUDE.md
je steeds dezelfde prompt typt om een taak te startenskill die jij aanroept
je voor de derde keer hetzelfde stappenplan in de chat plaktskill
je data kopieert uit een browsertab die Claude niet kan zienMCP-server
een zijtaak je gesprek vult met output die je niet meer bekijktsubagent
je wilt dat iets elke keer gebeurt zonder het te vragenhook
een tweede repository dezelfde setup nodig heeftplugin

Dezelfde aanleidingen gelden voor onderhoud. Een terugkerende reviewopmerking is een wijziging in CLAUDE.md, geen correctie in de chat. Een workflow die je steeds handmatig bijstuurt, is een skill die een nieuwe versie nodig heeft.

Combinaties

Each extension solves a different problem: CLAUDE.md handles always-on context, skills handle on-demand knowledge and workflows, MCP handles external connections, subagents handle isolation, and hooks handle automation.

Patronen die je vaak terugziet
CombinatieHoeVoorbeeld
Skill + MCPMCP levert de verbinding, de skill de kennisdatabaseserver + skill met schema en querypatronen
Skill + subagenteen skill start subagents voor parallel werk, of draait zelf in een fork (context: fork)/audit start security-, performance- en style-subagents
CLAUDE.md + skillsaltijd-aan-regels en naslag op aanvraag"volg onze API-conventies" + skill met de volledige stijlgids
Hook + skillde hook stelt vast, de skill weet hoe je het oplostPostToolUse-linter stuurt fouten naar Claude; /fix-lint bevat jullie regels
Hook + MCPeen hook start een externe actie via een MCP-toolSlack-melding als Claude een kritiek bestand wijzigt
Onder de motorkap verkeerde keuzes herkennen, de rand van de kaart

Symptoom → verkeerd mechanisme

Veelvoorkomende misclassificaties
SymptoomWaarschijnlijke oorzaakBeter
"Claude vergeet soms te linten"een "altijd"-regel als skill of in CLAUDE.mdhook (PostToolUse)
"Claude deployt uit zichzelf"skill met bijeffecten die het model mag startendisable-model-invocation: true
"Na een uur is Claude traag en verward"zoekwerk en logs in het hoofdgespreksubagent; CLAUDE.md inkorten
"De hook blokkeert alles, ook terechte gevallen"een oordeel (vraagt redeneren) in een deterministische hook gestoptskill voor het oordeel; hook alleen voor het harde deel
"Elke sessie kost 20k tokens voordat ik iets vraag"te veel altijd-aan: lange CLAUDE.md, veel plugins, MCP zonder tool searchrules met paths, skills, plugins uitzetten; meten met /context
"Een collega heeft een andere versie van onze review-skill"kopiëren tussen repo'splugin met version

"Always do X" is a Hook. "Decide whether to do X" is a Skill.

Ken Imoto, Claude Code Hooks vs Skills vs Subagents: Three Ways to Extend the Agent, and When Each Backfires, dev.to (secundaire bron)

De rand van de kaart

Naast de vijf klassieke primitieven noemen de docs nog meer mechanismen. Kort, zodat je ze kunt plaatsen:

  • Output styles: rol, toon en antwoordformaat voor een hele sessie. Eén actief tegelijk; ze vervangen de standaardinstructies in de system prompt. Net als CLAUDE.md is het een verzoek, geen garantie.
  • Dynamic workflows: een script dat Claude schrijft en dat veel subagents op de achtergrond draait, met één resultaat terug. Voor werk dat te groot is voor een handvol subagents (D1).
  • Code intelligence: een taalserver (LSP) via een plugin. Daarmee springt Claude naar definities in plaats van hele bestanden te lezen, en ziet het typefouten direct na een edit.
  • Cross-session messaging: Claude geeft een bevinding door van de ene sessie aan de andere.
  • Mods: plugins met een hooks-module in JavaScript die ook panes en commando's aan de interface toevoegen.

Pas de assen toe en ook deze vallen op hun plek. Een output style is altijd-aan context, net als CLAUDE.md. Een workflow is een georkestreerde vorm van subagents.

Uitgewerkt voorbeeld: de setup van een backendteam, bestand voor bestand

Een team met zes eisen. Elke eis landt in precies één mechanisme, en de setup als geheel wordt een plugin, omdat drie repo's hem delen.

Eisen → bestanden

backend-repo/
├── CLAUDE.md                          "Gebruik uv, tests met pytest -x, Python 3.13"
├── .claude/rules/migraties.md         paths: ["migrations/**"]
└── .claude/settings.json              → enabledPlugins: backend-tools@team

backend-tools/  (plugin, in de team-marketplace)
├── skills/release/SKILL.md            disable-model-invocation: true
├── agents/test-runner.md              tools: Bash, Read, Grep · model: haiku
├── hooks/hooks.json                   PreToolUse Bash → no-push-main.py
└── .mcp.json                          sentry (HTTP) + skill sentry-triage
  1. Altijd nodig, projectspecifiek: CLAUDE.md van de repo, niet in de plugin (die laadt daar niet). Kort.
  2. Alleen relevant bij migraties: een rule met paths. Kost niets zolang niemand aan migrations/ werkt.
  3. Procedure met bijeffecten: skill, alleen door mensen te starten. Gedeeld via de plugin, want alle drie de repo's releasen hetzelfde.
  4. Veel output, kort rapport: subagent, zonder schrijftools, op een goedkoper model.
  5. "Nooit": hook, want een instructie is een verzoek. Hij zit in de plugin, zodat elke repo de guardrail heeft.
  6. Extern systeem: MCP voor de verbinding, een skill voor hoe het team errors triageert. Twee mechanismen voor één eis, en dat is prima.
Doe-opdracht

Classificeer acht eisen, en audit daarna je eigen setup

Geen starterrepo: deel 1 is een denkoefening, deel 2 doe je op een project waaraan je echt werkt.

Deel 1: classificeer (eerst zelf, dan pas uitklappen)

  1. "Elke Python-edit moet door ruff format."
  2. "Claude moet weten dat we Postgres 16 gebruiken en nooit raw SQL in views schrijven."
  3. "Bij vragen over een productie-incident moet Claude de logs in Datadog kunnen doorzoeken."
  4. "Onze 30 pagina's API-richtlijnen moeten beschikbaar zijn bij werk aan endpoints."
  5. "Een dependency-audit over 400 packages mag mijn gesprek niet vullen."
  6. "Geen enkele sessie mag bestanden in infra/prod/ wijzigen."
  7. "De frontend-conventies gelden alleen in web/."
  8. "De vijf teams willen dezelfde review-skill en guardrails, met gecontroleerde updates."

Deel 2: audit je eigen setup

  1. Open een project waaraan je werkt en draai /context. Noteer de grootste posten vóór je eerste vraag.
  2. Loop je CLAUDE.md door en zet per sectie een label: altijd / alleen in map X / procedure / moet afgedwongen. Alles wat niet "altijd" is, verhuist.
  3. Kies één eis die nu als instructie bestaat maar eigenlijk een "nooit" is, en maak er een hook of deny-regel van. Test hem los (C2).
Verwacht resultaat (deel 1)
  1. Hook: PostToolUse op Edit|Write. "Elke" betekent dat het model hier geen keus mag hebben.
  2. CLAUDE.md: kort, altijd relevant. Wil je "nooit raw SQL" afdwingen, dan is een linter in CI beter dan een hook op elke edit.
  3. MCP (Datadog-server), eventueel met een skill voor jullie triagewerkwijze.
  4. Skill met een scherpe description, of een rule met paths op de API-map. Dertig pagina's in een rule is wel veel: dan liever een skill met ondersteunende bestanden.
  5. Subagent: veel output, kort rapport terug.
  6. Permissieregel: "deny": ["Edit(infra/prod/**)", "Write(infra/prod/**)"]. Een vast patroon, dus geen script nodig. Een hook is nodig als Bash ook geblokkeerd moet worden (sed -i, >).
  7. Rule met paths: ["web/**"].
  8. Plugin met version, in een team-marketplace; in een organisatie eventueel verplicht via managed settings.
Twijfel je tussen twee antwoorden?
  • Skill of rule? Hangt het aan bestanden (map, extensie), dan is het een rule. Hangt het aan een soort taak ("bij een release"), dan is het een skill.
  • Hook of permissieregel? Een vast patroon (pad, commando-prefix) is een regel. Is er logica nodig, of wil je loggen of invoer herschrijven, dan is het een hook.
  • Skill of subagent? Moet het resultaat in je gesprek blijven en wil je meekijken, dan een skill. Is het een zelfstandige zijtaak met veel tussenwerk, dan een subagent. Allebei kan ook: context: fork.
  • Twee mechanismen voor één eis is geen fout. Vaak is het juist goed: verbinding (MCP) plus kennis (skill), of oordeel (skill) plus garantie (hook).

Zelftoets