Welke afspraken maak je in een team over het werken met AI?

Kort antwoord

Goede werkafspraken over AI gaan over vijf dingen: waar de gedeelde instructies staan, wie ze bijhoudt, wat je altijd controleert voor iets naar buiten gaat, wie koppelingen en geheugen beheert, en wanneer iets persoonlijks gedeeld moet worden. Leg ze vast op de plek waar de AI ze leest, zoals een gedeeld project, een CLAUDE.md of Cursor Team Rules, niet alleen in een document.

Beleid zegt wat mag, afspraken zeggen hoe je werkt

Een AI-beleid regelt welke tools zijn toegestaan en welke gegevens er nooit in gaan. Dat is nodig, en daar is een apart stuk over een AI-beleid opstellen. Maar een team dat elke dag met AI werkt, loopt tegen andere vragen aan: waarom geeft de AI bij mij een ander antwoord dan bij jou, wie heeft deze instructie veranderd, en wie had dit moeten nakijken? Daar zijn werkafspraken voor.

De vijf afspraken die het verschil maken

Afspraak Waarom Waar je hem vastlegt
1. Waar staan de gedeelde instructies? Anders schrijft iedereen zijn eigen versie in zijn eigen chat Een gedeeld project, een CLAUDE.md in de repo, Cursor Project of Team Rules
2. Wie houdt ze bij? Een instructie zonder eigenaar veroudert Can edit voor één of twee mensen, de rest Can view
3. Wat controleer je altijd? AI schrijft overtuigend, ook als het fout is In de instructies zelf, plus een vaste controle door een mens bij alles wat naar buiten gaat
4. Wie beheert koppelingen en geheugen? Een gedeelde sleutel geeft iedereen dezelfde toegang Bij de Owner of beheerder van elke tool
5. Wanneer wordt iets persoonlijks gedeeld? Goede prompts en projecten verdwijnen met hun maker Vaste regel: zodra twee mensen het gebruiken, gaat het naar een gedeelde plek

Maak het concreet met één regel die je meteen kunt overnemen: een wijziging in gedeelde AI-instructies krijgt een eigenaar, een datum en een korte reden. Dan zie je later wie wat veranderde en waarom.

Wat de tools je hiervoor geven

Claude Code. Een CLAUDE.md in de projectmap (./CLAUDE.md of ./.claude/CLAUDE.md) gaat via versiebeheer met het hele team mee. Voor afspraken die voor de hele organisatie gelden is er een managed CLAUDE.md, op Windows in %ProgramFiles%\ClaudeCode\CLAUDE.md, op macOS in /Library/Application Support/ClaudeCode/CLAUDE.md en op Linux in /etc/claude-code/CLAUDE.md, uit te rollen via MDM of Group Policy. Persoonlijke voorkeuren horen in CLAUDE.local.md, niet in het gedeelde bestand.

Cursor. Project Rules in .cursor/rules staan onder versiebeheer. Team Rules gelden voor de hele organisatie en worden in het Cursor-dashboard door teambeheerders beheerd, op de Team- en Enterprise-plannen. User Rules zijn persoonlijk: daar hoort geen teamafspraak in.

Claude (chat). Een gedeeld project bundelt instructies en kennis voor iedereen die erin mag. Owners zetten geheugen aan of uit onder Organization settings > Capabilities. Of geheugen voor een lid standaard aanstaat, hangt onder meer af van de aanmaakdatum van de organisatie en eerdere accountinstellingen; controleer daarom de organisatie- en gebruikersinstellingen. Eigen koppelingen (connectors) voegt op Team alleen een Owner toe, onder Organization settings > Connectors; leden verbinden zich daarna zelf. Let op: een gedeelde sleutel in zo’n koppeling geeft iedereen die hem gebruikt dezelfde toegang.

Het misverstand: een afspraak in een document is een afspraak met de AI

Veel teams schrijven hun afspraken in een Word-bestand of op een wiki. De mensen lezen het één keer; de AI nooit. Een afspraak werkt pas als hij staat op de plek waar de AI hem oppakt: de instructies van het project, de CLAUDE.md, de regels van Cursor. En zelfs dan is het context, geen slot. De documentatie van Claude Code zegt dat CLAUDE.md geen afgedwongen configuratie is. Gebruik hooks voor vaste controles en managed settings voor centraal beheerde instellingen; instructies in CLAUDE.md blijven context en garanderen geen naleving. Houd elk bestand kort: Anthropic adviseert onder de 200 regels.

Wat dit voor een team betekent

Elke tool heeft zijn eigen plek voor afspraken: Claude een project en een CLAUDE.md, Cursor zijn regels, ChatGPT weer iets anders. Een team dat drie tools gebruikt, onderhoudt dus drie versies van dezelfde afspraak, en die lopen uit elkaar. Spreek dan in elk geval af welke versie leidend is en wie de andere bijwerkt. Zie ook wat je kwijtraakt als je AI-kampioen vertrekt en shadow AI voorkomen.

Waar Bombos past

Bombos is een plugin die Claude, Claude Code, ChatGPT, Copilot, Cursor en eigen agents één gedeeld geheugen geeft. Een afspraak staat er één keer, en de aangesloten AI-tools kunnen dezelfde vastgelegde afspraken ophalen; regels die het team de AI onderweg leert, komen erbij, navolgbaar, zodat je ziet waarop een antwoord rust. Eén persoon kan het eerst zelf proberen voor zijn eigen agents.

Vragen die hierbij horen

Wat is het verschil tussen een AI-beleid en werkafspraken?

Een AI-beleid zegt welke tools mogen en welke gegevens er nooit in gaan. Werkafspraken zeggen hoe het team er dagelijks mee werkt: waar instructies staan, wie ze bijhoudt en wat je controleert. Je hebt allebei nodig.

Wordt een afspraak in CLAUDE.md afgedwongen?

Nee. De documentatie van Claude Code noemt CLAUDE.md context, geen afgedwongen configuratie. Gebruik hooks voor vaste controles en managed settings voor centraal beheerde instellingen; instructies in CLAUDE.md blijven context en garanderen geen naleving.

Hoe lang mag zo'n instructiebestand zijn?

Anthropic adviseert onder de 200 regels per CLAUDE.md. Kort en concreet werkt beter dan een handboek.

Bronnen

  1. How Claude remembers your project (Claude Code docs)
  2. Rules (Cursor docs)
  3. Use Claude's chat search and memory to build on previous context (Claude Help Center)
  4. Get started with custom connectors using remote MCP (Claude Help Center)
  5. Manage project visibility and sharing (Claude Help Center)
Het eerste half uur · kosteloos

Wat vergeet jullie AI?

  1. 01Je vertelt welke AI jullie gebruiken en waar het steeds opnieuw moet.
  2. 02We laten zien wat een gedeeld geheugen daar verandert, op jullie eigen voorbeelden.
  3. 03Je krijgt het plan mee. Dat houd je, ook zonder Bombos.
Piet Baudoin
Piet BaudoinJe spreekt Piet, van het team van BombosNederlands team uit Utrecht en Nijmegen · data in Europa
We reageren dezelfde werkdag.