36 repos, 36 gewoontes
Een groeiend tech-bedrijf had 36+ Git-repositories, en in elke repo golden andere regels of helemaal geen. De ene repo gebruikte conventional commits, de andere vrije tekst. Ook teststandaarden en PR-templates verschilden per project. Niemand had dat zo bedoeld, het was gewoon zo gegroeid.
Met AI-tooling werd dat probleem goed voelbaar. Elke nieuwe Claude Code-sessie startte blanco, zonder de conventies en teamafspraken van het project. De output was daardoor inconsistent. Het team moest die handmatig bijwerken, terwijl AI dat werk juist had moeten schelen.
Twee lagen: wat overal geldt, en wat hier geldt
We bouwden met Claude Code een virtual monorepo-patroon met twee lagen.
Laag 1 is de foundation: gedeelde regels die voor elk project gelden. Daarin staan de Git-workflow (branch-namen, commit-format, PR-proces), teststandaarden, richtlijnen voor code review en security-regels. Ook de model-delegatie staat hier: welke AI-taak naar welk model gaat. Zo gaat zwaar denkwerk naar een sterk model en implementatie naar een snel model. Research gaat naar een model met brede kennis.
Laag 2 is de workspace. Elk project erft de foundation en vult die aan met eigen tools, deployment-stappen en lokale conventies. De workspace wijkt alleen van de foundation af waar dat echt nodig is.
Elk project kreeg daarnaast CODEOWNERS-bestanden, PR-templates en geautomatiseerde kwaliteitschecks. Die configuratie laadt automatisch bij elke sessie.
Een nieuw project opzetten: van 30+ minuten naar 5 minuten.
Geen blanco sessies meer
Elke Claude Code-sessie start nu met de juiste context: de foundation-regels, de projectconfiguratie en de bestaande patterns in de codebase. De output is consistent, of je nu in repo 3 werkt of in repo 36.
Het team werkt op twee machines: een laptop voor het dagelijkse werk en een server voor automatisering en langlopende taken. Tailscale houdt beide in sync. De gedeelde configuratie synchroniseert automatisch en machine-specifieke instellingen blijven lokaal.
Vijf minuten in plaats van dertig
Een nieuw project opzetten kostte eerst 30+ minuten handwerk: bestanden kopiëren, configuratie aanpassen, conventies opschrijven. Nu duurt het vijf minuten. De foundation-installer zet alles klaar en de eerste Claude Code-sessie werkt direct met de juiste standaarden.
Over 36+ repos telt dat op. Reviews gaan minder over stijl en de AI-output past bij de bestaande code in elk project.