---

Ontwikkelen met AI: alignment en comprehension debt

Opzet van het stuk. De vastgestelde tekst uit de brief is het vertrekpunt; de rest is een structuurvoorstel dat we invullen met hoe jullie het echt doen.

Wij bouwen zelf met AI. Cowie, onze coding agent, schrijft een groot deel van onze code. Maar we leveren niets op wat we niet begrijpen: elke wijziging wordt gelezen, getest en verantwoord door een engineer die weet waarom hij er staat. Dezelfde discipline die we van jouw AI-toepassing eisen, passen we toe op ons eigen gereedschap. Zo zijn we snel zonder dat je een zwarte doos in beheer krijgt.

Opzet

• Het probleem is niet slechte code maar onbegrepen code. Comprehension debt: code die werkt, maar die niemand in het team kan uitleggen. Hij hoopt zich op zoals technische schuld, alleen zie je hem niet in de tests. Je ziet hem pas als er iets moet veranderen.
• Waarom dit voor een klant telt. Een klant die onze code overneemt of laat beheren door een eigen team, erft die schuld. Dat is het tegenovergestelde van “het blijft werken zonder ons”.
• Wat alignment bij ons betekent. Niet alleen dat Cowie doet wat we vragen, maar dat wat hij bouwt aansluit bij hoe wij denken: conventies, architectuur, de reden achter een keuze.
• Hoe we de schuld aflossen voordat we opleveren.
• Wat we nog niet weten. Dit is werk in uitvoering. Een eerlijk stuk noemt ook wat nog niet opgelost is.