How-To gidsen

Hoe gebruik je het agent-team in de praktijk? Vier bouwstenen — agents, skills, commands en memory — stap voor stap uitgelegd, met echte voorbeelden die je meteen kunt overtypen.

Vier begrippen die je nodig hebt

De setup bestaat uit vier soorten bouwstenen. Ken je deze, dan begrijp je alles.

BouwsteenWat het isWanneer je het gebruikt
Agent Een gespecialiseerde rol (architect, tester, ...) met eigen taken en grenzen Als een taak specialistische aandacht vraagt of parallel werk kan
Skill Een kant-en-klare werkwijze die je oproept met /naam Terugkerende klussen: project starten, sessie afsluiten, onderhoud
Command Een klassiek slash-commando, ook opgeroepen met /naam Kleine, vaste acties (in deze setup grotendeels vervangen door skills)
Memory Feiten die Claude onthoudt tussen sessies Zodat je niet elke keer opnieuw je voorkeuren hoeft uit te leggen
Alles is gewoon tekst
Agents, skills, commands en standaarden zijn Markdown-bestanden in de map ~/.claude. Je kunt ze openen, lezen en aanpassen met elke teksteditor. Er is geen verborgen magie — wat er staat, doet Claude.

Agents gebruiken

Een agent is een collega met één duidelijke rol. Je stuurt ze meestal niet los aan — de projectmanager (PM) doet dat voor je. Je praat met de PM, en die zet de juiste specialisten in de juiste volgorde in.

De agents in het team

AgentDoet
Business ManagerBewaakt of het werk binnen scope blijft
Project ManagerRegisseert: zet agents in, bewaakt voortgang, houdt het dossier bij
ArchitectOntwerpt de structuur vóór er gebouwd wordt
DeveloperSchrijft de code, met tests op de bedoeling
Ops AgentControleert omgeving, migraties en of de app opstart
Code ReviewerKeurt codekwaliteit; jaagt op dode code en duplicatie
TesterKlikt door de echte browser; niets door zonder testrapport
Security ExpertValt aan volgens OWASP ASVS; bewijst elk lek
Documentatie AgentHoudt de docs gelijk met de code
Research AgentZoekt opties en bronnen uit
Strategisch AdviseurBouwt je persoonlijk profiel op; praat alleen met jou

Zo zet je ze in

In de praktijk gewoon in gewone taal, tegen de PM:

tegen Claude
Ik wil een nieuwe factuur-module bouwen. Zet het team op:
laat de architect eerst ontwerpen, ik wil dat vóór de bouw beoordelen.

De PM maakt dan een plan, laat de architect ontwerpen, legt het aan jou voor, en gaat pas bouwen na jouw akkoord. Wil je één specialist rechtstreeks? Vraag het gewoon: "laat de security-expert deze auth-code toetsen tegen OWASP ASVS L2."

Poorten zijn er met een reden
De PM start géén developer zonder goedgekeurd ontwerp en keurt géén fase goed zonder een testrapport met een expliciet ✅ of ❌. Dat voelt soms streng, maar het is precies wat voorkomt dat er ongeteste code naar productie sluipt.

Skills gebruiken

Een skill roep je op door /naam te typen. Het is een ingepakte werkwijze — je hoeft niet te onthouden hóé iets moet, alleen wélke skill past.

SkillWat het doet
/start-projectStart een nieuw project: leest je standaarden, stelt de juiste vragen, maakt een plan van aanpak
/statusToont de huidige stand van het project uit het dossier
/sessie-afsluitenRondt netjes af: dossier bij, geheugen opslaan, geleerde lessen, commit
/quickKleine klus zonder overhead — geen team, geen plan
/loop-werklijstWerkt een lange lijst taken batch voor batch af, met vangnet en commits
/periodiek-onderhoudMaandelijkse controle: drift, patronen, standaarden, doelen
/adviseurLaat de Strategisch Adviseur meekijken op je aanpak
1

Typ de skill in het gesprek

Bijvoorbeeld /start-project. Claude neemt meteen de bijbehorende rol en werkwijze aan.

2

Volg de vragen

De skill stuurt het gesprek. Bij /start-project vraagt de PM door tot je doel en eisen helder zijn — precies als bij een echt ontwikkelbedrijf.

3

Klaar

De skill levert zijn resultaat en stopt. Je kunt gewoon verder praten.

Weet je niet welke skill?
Dat hoeft niet. Beschrijf gewoon wat je wilt ("ik wil vandaag stoppen en morgen verder") en de PM stelt de passende skill zelf voor.

Commands gebruiken

Commands werken hetzelfde als skills — je roept ze op met /naam. Het verschil is historisch: commands zijn de oudere, eenvoudigere vorm. In deze setup zijn de meeste vervangen door rijkere skills. Je merkt in de praktijk geen verschil: typ / en Claude toont wat beschikbaar is.

tegen Claude
/update_documentatie

Eigen skill of command maken? Het is één Markdown-bestand in ~/.claude/skills/naam/SKILL.md. Zie de architectuurpagina voor het formaat.

Memory gebruiken

Elke nieuwe sessie start Claude zonder herinnering aan de vorige. Memory lost dat op: het is een setje korte feiten die Claude bij het begin van elke sessie inleest. Zo hoef je je voorkeuren, werkwijze en projectafspraken niet telkens opnieuw uit te leggen.

Iets laten onthouden

tegen Claude
Onthoud dat ik altijd in de test-map ontwikkel, nooit in productie.

Claude schrijft dat als één feit weg in ~/.claude/projects/<project>/memory/ en zet een verwijzing in het geheugenoverzicht MEMORY.md. Volgende sessie weet Claude het weer.

Wat je wél laat onthouden
Voorkeuren, werkwijzen, terugkerende afspraken, waar dingen staan. Dus: "de essentie", niet elke losse stap.
Wat je níét in memory zet
Wachtwoorden of sleutels (nooit), en dingen die de code of git-historie al vastleggen. Onthoud de kern van een probleem, niet elke keer dat je het omzeilde.

Een compleet project starten

Het typische verloop van idee tot oplevering:

1

Start met /start-project

De PM en Business Manager openen het gesprek en vragen door tot je doel helder is.

2

Beoordeel het plan van aanpak

Je krijgt een gefaseerd plan met wie wat doet. Jij keurt goed of stuurt bij — dit is een poort.

3

Laat het team bouwen

Architect → ontwerp (jij keurt goed) → developer bouwt → reviewer, tester en security toetsen.

4

Sluit af met /sessie-afsluiten

Dossier bij, geheugen opgeslagen, lessen geborgd, alles gecommit. Morgen pak je naadloos op.

Goede opdrachten geven — de zes principes

De kwaliteit van wat je terugkrijgt hangt af van hoe je het vraagt. De setup werkt met zes principes; pas ze toe en je krijgt onderbouwde keuzes in plaats van bevestiging van je eigen aanname.

#Principe
1Beschrijf de situatie — niet de oplossing die je al in je hoofd hebt
2Benoem het doel zo neutraal mogelijk
3Laat de AI éérst vragen stellen vóór er iets gebouwd wordt
4Vraag vijf oplossingen, nooit één — dat dwingt afweging af
5Eis bronplicht: markt-standaard? voor- en nadelen?
6Vraag tegenmotivatie bij afwijken van de standaard — jij beslist

Gestuurd

"Bouw de invoice-service met MongoDB en microservices, net als vorig project. Zet het op."

→ Je krijgt wat je vroeg, niet wat je nodig had. Bias ingebakken.

Onbevooroordeeld

"Invoice-verwerking, ~50k/mnd, auditeerbaar. Stel eerst vragen. Geef 5 opties met bronnen en jouw advies + waarom. Ik beslis."

→ Een onderbouwde keuze die je kunt verdedigen.

Veelgestelde vragen

Moet ik alle agents apart aansturen?

Nee. Praat met de projectmanager in gewone taal; die zet de juiste specialisten in.

Werkt dit alleen in het Nederlands?

De setup is Nederlandstalig ingesteld, maar je past dat aan in settings.json en de standaarden. Code en commit-berichten zijn Engels.

Kan ik agents of skills aanpassen?

Ja — het zijn Markdown-bestanden in ~/.claude. Open, lees, wijzig. Je verandert direct hoe het team werkt.

Wat als ik gewoon snel iets kleins wil?

Gebruik /quick — geen team, geen plan, geen dossier. Recht op je doel af.