Compleet overzicht

Architecture First Spiekbriefje

15 hoofdstukken. 4 delen. Alle patronen op één pagina.

Het compounding vliegwiel

Docs → Types → Domeinen → Events → Quality gates → Ship → Verbeter ↻

Deze patronen vormen een systeem waarin shipsnelheid en codekwaliteit allebei verbeteren over tijd, in plaats van tegen elkaar ingeruild te worden.

I De omslag

01 De 10x wiskunde

Zonder architectuur geeft AI je 2x. Met architectuur 10x. Het eerste domein is traag. Bij het vijfde gaat alles compounding.

AI alleen	2-3x	Veel rework
AI + architectuur	5-10x	Minimaal rework

02 Je AI-partnerschap

Jij beslist over architectuur. AI bouwt de rest.

JIJ: Domain entities · API contracts · DB schema · Security · Error-strategie

AI: Variabelenamen · Testcases · Imports · CRUD boilerplate · Docs

03 Documentatie als code

5 bestanden, ~3k woorden, ~90 min. AI-nauwkeurigheid: 40% → 90%.

ARCHITECTURE.md: Stack + beslissingen
DOMAIN_PATTERNS.md: Feature-blauwdruk
API_CONVENTIONS.md: URLs, statuscodes, paginering
DATABASE_PATTERNS.md: Naamgeving, kolommen, enums
TESTING_STRATEGY.md: Wat, hoe, naamgeving

II Het fundament

04 Type safety pipeline

Eén schema, nul drift. Pydantic → OpenAPI → TypeScript.

847 compile-time fouten gevangen · 0 runtime type-fouten

Verbied any · Alle API-types via codegen · strict: true

05 Domeingrenzen

Organiseer op business-domein. AI-context: 16k regels → 1k regels.

AI first-try: 40% → 88% · Merge conflicts: 6+/wk → 0,4/wk

Service bezit logica · Geen cross-domain imports · Events dragen IDs

06 Events boven calls

8 deps → 1 event bus. Events zijn feiten (verleden tijd), geen commando's.

✓ user.deactivated

✗ send.notification

07 Beveiliging via architectuur

RLS op database-niveau. Geen context = geen data. Fail-safe als standaard.

Auth op middleware → Authz op policy → Isolatie op database

III Het vakmanschap

08 Quality gates

3 lagen, strikte snelheidsbudgetten, 87% bugs gevangen voor review.

Pre-commit	<5s	ruff, format, secrets
Pre-push	<60s	mypy, unit tests, security
CI/CD	<5m	Volledige suite, 80% coverage

Fixkosten: 1x bij commit → 1.200x in productie

09 Ship en verbeter

Fase 1: laat het werken (2u). Fase 2: maak het goed (30min, volgende ochtend).

Boy Scout Rule: elk bestand dat je aanraakt, één verbetering

Rule of Three: twee keer gekopieerd? extract bij de derde

40 features / 6 maanden · 45u totaal refactoring · 7% duplicatie

10 Testen voor vertrouwen

Altijd testen: business rules, autorisatie, isolatie, edge cases

Overslaan: framework-gedrag, triviale getters, layout tests

Naamgeving: test_{actie}_{scenario}_{resultaat}

11 Prompt engineering

Hefboomhierarchie: Docs > Types > Domeinen > Voorbeelden > De prompt zelf

Laat een werkend voorbeeld zien, vraag om het volgende. Pattern matching verslaat uitleggen.

IV Het draaiboek

12 De vijf valkuilen

Premature abstraction : Niet DRY'en tot de derde keer

Blinde AI-trust : Review als een junior-dev PR

Big-bang refactoring : Continue kleine verbeteringen

Documentatie overslaan : 90 min investering, 10x rendement

Perfection paralysis : Time-box, ship als de timer afgaat

Begin hier, deze week

1 Bouw je .claude/ directory 90 min
2 Installeer pre-commit hooks 30 min
3 Zet Pydantic → OpenAPI → TypeScript op 2 uur
4 Reorganiseer één module naar domeinstructuur 1 uur
5 Pas de Boy Scout Rule toe op elk bestand dat je aanraakt doorlopend

Wil je het volledige verhaal achter elk patroon?

Begin de gratis cursus