De kaart is de architectuur

In de tweede workshop met een distributeur die in vier Europese landen verkoopt, vroeg de CIO wanneer hij het architectuurdiagram te zien zou krijgen. Achter ons twee dagen whiteboard: één klantorder, gevolgd van een e-mail in het ene land tot een verzonden doos in een ander, door drie bedrijfssystemen, drie keer met de hand overgetypt. We zeiden dat het whiteboard het ontwerp was. Overtuigd keek hij niet. Dit is het langere antwoord, en het geldt of u nu onderdelen, patiënten, polissen of pakketten beweegt.

Groei stokt bij de overdrachten

Groei komt als meer volume, nieuwe markten of een overname. Wat breekt, is zelden een team; het is de ruimte tussen teams: de order die van het ene systeem naar het andere wordt gekopieerd, de pdf die een mens leest en overtypt, het maandcijfer dat uit spreadsheets wordt samengesteld. Elk daarvan is een overdracht tussen een mens, een systeem en een document, en een overdracht met de hand heeft de capaciteit van de werkweek van die mens. Als de omzet verdubbelt, ontstaat daar de wachtrij.

Daarom volgt de kaart die we in de eerste week tekenen één stuk werk dat door groei wordt afgeknepen, van begin tot eind, door welke systemen en landen ook. Bij de overdrachten komt alles te staan wat we later bouwen.

Een overdracht is een afspraak

Op het whiteboard is een overdracht een pijl. In het systeem is zij een schriftelijke afspraak: hoe de data eruitziet, wat elk veld betekent, welke totalen moeten kloppen, wanneer het binnenkomt en wie elk uiteinde beheert. Blijft het „het bestand dat we elke nacht sturen", dan faalt het stil: een datumnotatie verandert na een update, een totaal ontbreekt, en niemand merkt het een maand lang. Onder een afspraak wordt een bestand dat haar breekt in zijn geheel tegengehouden, en de eigenaar hoort het dezelfde ochtend.

Ze schrijven kost het grootste deel van de eerste maand, omdat twee teams die al jaren een bestand uitwisselen met „geleverd" vaak iets anders bedoelen. Ze zijn ook het eerste wat een nieuwe markt nodig heeft: toen het vierde land van de distributeur aansloot, bestond het werk uit één nieuwe afspraak en een tabel die zijn productcodes aan die van de anderen koppelt.

Een stap heeft een soort

Voordat iemand een AI-model kiest, wordt elk vak op de kaart gemarkeerd als een van drie soorten werk.

Lezen maakt van iets dat voor mensen is geschreven data waarmee een systeem kan werken: de pdf van een leverancier in regels met batchnummers en vervaldatums, een e-mail in een order, een verwijsbrief in een dossier, een serviceticket in een categorie. Hier verdient AI haar plek, omdat de invoer geen vaste vorm heeft en er geen regel voor te schrijven is.

Controleren heeft één juist antwoord: een hoeveelheid tegen wat besteld is, een voorraad tegen het niveau waarop je bijbestelt, een ticketcategorie tegen het team dat erover gaat. Dat hoort in gewone software, die per run niets kost en die het team kan lezen. AI kan deze som ook maken, maar rekent voor elke som af en heeft er soms een fout.

Beslissen verandert iets waaraan het bedrijf wordt gehouden: goederen worden in het magazijn aanvaard, een rapport wordt afgetekend, een order wordt aan een klant bevestigd. Dat hoort bij een mens met een naam, die het bewijs op één scherm ziet en ja of nee zegt.

Stappen schuiven maar één kant op, van AI naar gewone software. Blijft de documentindeling van een leverancier lang genoeg gelijk, dan krijgt de leesstap een vaste parser en wordt een controlestap. Voor een overheidsinstantie bouwden we ticketsortering zo, binnen het eigen netwerk van de instantie: AI leest en classificeert, vaste regels sturen elk ticket naar een team, en de medewerkers van de instantie passen die regels zonder ons aan.

Een beslissing zegt hoeveel de AI mag

Elke beslisstap draagt één extra regel op de kaart: hoe ver de AI daar wordt vertrouwd. Ze mag alleen voorstellen, of werk voorbereiden dat een mens goedkeurt, of handelen en achteraf rapporteren. Dat niveau wordt op bewijs verdiend, per soort geval, en het staat op de kaart naast de stap, waar de verantwoordelijke manager het ziet. Omdat de kaart ook weet wat elke stap voedt, weet zij wanneer het bewijs verouderd is. Bij een orderbalie die we voor een hardwareleverancier testten, zegt de regel naast de leesstap: komt er een nieuw orderformaat binnen, dan gaat elke beslissing die erdoor gevoed wordt terug naar „een mens keurt goed", tot zij zich opnieuw heeft bewezen. Een instellingenscherm in een AI-tool kan die regel niet uitdrukken; het weet niet waar zijn invoer vandaan komt.

Eén vastlegging loopt langs de kaart

Elke overdracht wordt vastgelegd met haar resultaat, elke leesstap met wat hij las en waar, elke beslissing met het bewijs, de persoon en het tijdstip. Voor een groep die de cijfers van meer dan twintig bedrijven samenvoegt tot één rapport voor het bestuur, dwingt die vastlegging een eenvoudige regel af: een verkeerd cijfer wordt nooit in het rapport gecorrigeerd, alleen in de eigen boeken van het bedrijf. Ziet een cijfer er vreemd uit, dan zegt de vastlegging welk bedrijf, welk systeem, welke regel.

Het draaiende systeem leest de kaart

Het verschil tussen een whiteboard en een architectuurdiagram is dat ons systeem op de kaart draait. De afspraken, de soorten stappen, de vertrouwensniveaus en de routeringsregels staan in één map met bestanden en een volledige wijzigingsgeschiedenis, in de eigen omgeving van de klant. De kaart wijzigen betekent die bestanden wijzigen via de gewone goedkeuringen van de klant. Een AI-prompt is daar één bestand, en bevat nooit de regels van het bedrijf.

Dat telt zwaarder nu veel software met AI wordt geschreven. Een AI-programmeertool doet precies de taak die voor hem ligt, goed, zonder besef van hoe die in het geheel past. De kaart zegt waar elk soort werk thuishoort voordat iemand, mens of AI, het schrijft. Een wijziging zonder plek op de kaart wordt niet aanvaard.

De kaart waar houden

De meest voorkomende fout in systemen die vóór ons zijn gebouwd, is een kaart die één keer is getekend en achterbleef terwijl het werk veranderde, tot de overdracht waar iedereen op vertrouwt een spreadsheet is die op vrijdag wordt gemaild. Een kaart blijft alleen waar als het dagelijkse werk niet zonder haar kan: de wachtrij met uitzonderingen is geordend naar de stappen van de kaart, de testgevallen zijn per stap gelabeld, en elke wijziging aan het systeem is een wijziging aan de kaart.

Als wij vertrekken, is zij van twee mensen met een naam aan de kant van de klant: de manager die verantwoordelijk is voor het werk en wijzigingen goedkeurt zoals elke andere verandering in de werkwijze van zijn team, en één engineer die haar met ons bouwde. Over het juiste detailniveau hebben we ons meer dan eens vergist; een kaart met elke klik erop is even nutteloos als een zonder.

Zo probeert u het op één stuk werk: haal de mensen die het doen de kamer in, volg het van begin tot eind, schrijf de vijf regels van de afspraak bij elke pijl, leest, controleert of beslist in elk vak, en een naam bij elke beslissing. Vraag dan of een engineer die u nooit heeft ontmoet hieruit uw volgende markt zou kunnen aansluiten. Zo niet, dan is het nog een diagram.