ADRs: Hemmeligheder i Vibe Coders værktøjskasse

Jeg er mere og mere overbevist om, at Architecture Decision Records er det mest undervurderede værktøj i en vibe coders værktøjskasse.

Drømmen er til sidst at sidde på en strand med en piña colada, bede min AI om at skrive kode, og have det forstå præcis hvad jeg ønsker uden at jeg stirrer på hver linje. At stole på, at når jeg beder den om at implementere noget, får det det rigtigt og committer ændringerne automatisk. Jeg reviewerer i PR'er, fanger problemer der, men jeg micromanager ikke hver tastaturskrabet.

Vi er ikke der endnu, men vi kommer tættere på.

Her er hvad jeg gør: Efter jeg har brugt tid på at raffinere et projekt og få tingene præcis som jeg vil have dem, beder jeg AI'en om at skrive ADR-filer, der dokumenterer disse beslutninger. Ikke bare vage filosofiske udsagn — faktiske beslutningsrekorder med konkrete eksempler, kodestykker, og detaljerede forklaringer på hvorfor jeg traf hver valg.

Magien sker, når jeg bevæger mig til det næste projekt. Jeg kan give disse ADRs til AI'en, og pludselig forstår den mine mønstre. Den ved, hvordan jeg strukturerer komponenter, hvordan jeg håndterer state, hvad mine arkitektur-præferencer er. AI'en anvender de samme beslutninger på tværs af nye projekter automatisk.

Det er ligesom at bygge et personligt bibliotek af kodepræferencer, der samles op over tid. Hvert projekt gør det næste hurtigere, mere konsistent, og mere pålidelig.

Det virkelig kloge? AI'en genererer disse ADRs for mig. Jeg behøver ikke at skrive dokumentation — jeg styrer bare AI'en til at skabe det baseret på hvad vi har bygget sammen.

Det er sådan vi skalerer. Ikke ved at arbejde hurtigere, men ved at kode vores præferencer så dybt, at AI'en forstår dem ligesom vi gør.

🎙️ Hør mere om det her — MCP servere og struktureret udvikling blev diskuteret på Verbos Podcast #86. → Lyt til episoden