Repositories begrijpen

Het woord "repository", of kortweg "repo", klinkt voor veel mensen alsof het iets ingewikkelds is dat alleen developers begrijpen. In werkelijkheid is het simpel: een repo is gewoon een map met alle bestanden van één project, waarbij elke aanpassing wordt bijgehouden. Vergelijk het met een ordner voor een klant. Alle documenten van dat project zitten in die ene ordner, netjes bij elkaar, en als je iets verandert, blijft de oude versie ergens bewaard zodat je altijd kan teruggrijpen als iets misgaat.

Een repo doet precies dat, maar dan voor een systeem dat je bouwt in plaats van papieren documenten. Waarom dit belangrijk is. Zonder repo's eindig je met bestanden die overal verspreid staan, oude en nieuwe versies die door elkaar liggen, en geen idee meer wat de laatste werkende versie was. Met een repo per systeem heb je altijd één duidelijke plek, je kan precies zien wanneer en wat er is veranderd, en je kan een systeem netjes overdragen of live zetten zonder dat er losse fragmenten zoekraken.

Denk aan een builder die meerdere systemen tegelijk onderhoudt. Een repo voor het systeem dat leads beoordeelt. Een andere repo voor het systeem dat content voorbereidt. Weer een andere voor het systeem dat outreach-berichten verstuurt.

Elk systeem in zijn eigen, afgebakende map, in plaats van alles op één grote hoop. De praktische conclusie: vanaf het moment dat je met Claude Code begint te bouwen, geef je elk systeem zijn eigen repo. Eén duidelijke map per probleem dat je oplost, in plaats van alles mengen in chaos.