Hoe we met AI bouwen.

Hoofdstuk 1: zonder AI begonnen, er steeds meer mee gebouwd

Kwaliteitsmanagement voor gereguleerde industrie.

SolidQMS begon zoals de meeste software: een ervaren engineer en iemand met veel verstand van kwaliteitsmanagement aan één tafel. We bouwden eerst een stevige basis: een Ruby on Rails-monoliet, een domeinmodel dat inmiddels meer dan 140 modellen telt, en multi-tenancy, zodat elke organisatie een eigen afgeschermde omgeving heeft. Daarna groeide het product mee met wat kwaliteitsmanagers nodig hadden: non-conformiteiten, audits, risicobeheer, trainingen en documentbeheer.

Het product zelf veranderde in die tijd niet zo veel. De manier waarop we het bouwden wel. Naarmate de codebase groeide, werd AI van een handig hulpje een vast onderdeel van het werk. Eerst om code aan te vullen, later om hele stukken te schrijven. Claude Code werd onderdeel van de dagelijkse ontwikkeling. Het schrijft nieuwe code, herstructureert bestaande code en zoekt dingen uit in de codebase, en er kijkt altijd een engineer mee.

Dat ging door tot in de pipeline. Claude Code draait mee in CI en doet op elke pull request een code-review, naast de automatische tests. Nieuwe functies ontwerpen en bouwen we steeds vaker samen met AI. De engineer en de domeinexpert bepalen de architectuur, maken de keuzes en beslissen wanneer iets af is. De AI doet een groot deel van het bouwwerk.

Het product kreeg zelf ook AI-functies, maar alleen waar het de kwaliteitsmanager echt werk scheelt: bij 8D-analyses, leveranciersbeoordelingen en het nakijken van documenten. De grootste verandering zat in hoe we bouwen. Wie de beslissingen neemt, is hetzelfde gebleven.

Bij SolidBowtie draaiden we de volgorde om. Bij SolidQMS kwam AI pas nadat de basis er stond. SolidBowtie bouwden we er vanaf de eerste regel code mee. Brainstorm, specificatie, architectuur en implementatie liepen allemaal via Claude Code en het superpowers-framework. In de commits staat Claude als co-auteur.

Omdat we opnieuw begonnen, konden we ook de stack anders kiezen. In plaats van Redis en losse Node-processen draait SolidBowtie volledig op de Solid-stack: Solid Queue, Solid Cache en Solid Cable, alles op PostgreSQL. Dat scheelt een proces om te beheren. Voor deployment kozen we Kamal met Docker in plaats van Capistrano. De interface is Hotwire waar het kan. Alleen de bowtie-editor zelf, waarin je met meerdere mensen tegelijk werkt, is gebouwd in React (React Flow).

In SolidBowtie is AI een kernfunctie. Je beschrijft je risico in gewone taal en Claude Opus 4.8 maakt er een complete bowtie van, met dreigingen, gevolgen, barrières en escalatiefactoren. Die werk je daarna zelf verder uit. Achter de schermen houden we de AI kort. We parsen de JSON-output defensief, controleren alle waarden tegen whitelists, begrenzen de output en geven elke gebruiker een rate limit.

Bij SolidQMS voegden we AI toe aan software die er al was. SolidBowtie hebben we er vanaf het begin omheen ontworpen. Daar kwamen we uit na alles wat we bij SolidQMS hadden geleerd.