Van Code naar Spec

Door Michiel Kouwenhoven, senior developer

We hebben de beperkingen van de traditionele monolithische aanpak achter ons gelaten. In zulke systemen zijn alle functionaliteiten als één complex, verweven geheel gebouwd, die vaak star en lastig aan te passen is. In plaats daarvan maken we plaats voor een krachtige, composable aanpak. Hierbij breken we de software op in onafhankelijke, transparante bouwstenen. Het resultaat? Een geoptimaliseerde basis van herbruikbare componenten en slimme ‘accelerators’ waarmee we eenvoudig de beste best-in-class oplossingen uit de markt integreren. 

Hiermee hebben we een belangrijke stap gezet, waar we nog wel werken met een statische codebase. 

In de loop van de tijd verouderen afhankelijkheden en veranderen integraties waardoor zelfs de modernste architectuur langzaam verandert in 'legacy' als er geen onderhoud plaatsvindt.

Van code naar spec

In de traditionele wereld zullen zowel de code als de documentatie onderhouden moeten worden. Het probleem? De code van vandaag is morgen alweer verouderd, waardoor een statisch project per definitie achterloopt.In de wereld van AI is 'spec-driven development' een van de opkomende termen.Dit houdt in dat er eerst door een ontwikkelaar een specificatie wordt geschreven op basis waarvan AI vervolgens de code gegenereerd.

Een specificatie zijn één of meerdere gestructureerde documenten, geschreven in menselijke taal, waarin het doel, de functionaliteit en de overige requirements van software beschreven worden. Het is eigenlijk de instructieset op basis waarvan de AI-agent aan de slag gaat met programmeren. Afhankelijk van de mate van implementatie is hierbij niet de code de bron van waarheid, maar de specificatie. Onderhoud verschuift naar het up-to-date houden van de specificatie.

De agentic workflow

Een AI-agent is geen simpele chatbot maar een autonoom systeem dat in staat is complexe taken uit te voeren door middel van: plannen, redeneren, tools en acties.De agent begrijpt de specificaties en creëert in de planfase een gestructureerd plan waarin het taken opdeelt in meerdere concreet uitvoerbare stappen.

Voor iedere stap wordt uit verschillende bronnen de benodigde informatie verkregen. Indien nodig geacht kunnen hierbij ook beschikbaar gestelde tools (bijvoorbeeld een web search of call naar een extern systeem) worden gebruikt, of informatie uit een vorige stap.

Belangrijk hierbij is dat het wiel niet helemaal opnieuw hoeft te worden uitgevonden: bestaande code en eerdere lessen kunnen naadloos worden geïntegreerd.

Pas nadat dit plan is opgesteld, begint de agent met de uitvoering.

Het is een proces waarbij het eindresultaat stapsgewijs wordt uitgebreid en verbeterd naarmate het proces vordert.

Autonomie met vangrails

Bij AI denken veel mensen direct aan 'hallucinaties' of onvoorspelbare code. In deze opzet kiezen we echter voor een lage autonomie voor de agent. Dit klinkt misschien beperkend, maar het is juist de kracht van deze methode: De agent volgt exacte instructies en werkt binnen strikte kaders. In plaats van te gissen weet de agent wat te bouwen, hoe het te bouwen en in welke volgorde.

Door deze human-in-the-loop aanpak behoud je als gebruiker altijd de regie. Je krijgt de flexibiliteit van user-input, zoals voorkeuren voor accelerators of specifieke styling, maar met de voorspelbaarheid van de context en andere informatie vanuit de organisatie. Het resultaat is een startpunt dat direct klantspecifiek is. Of je nu kiest voor Magento, Storyblok, of een zoekmachine zoals Algolia; de agent integreert de juiste accelerators op basis van jouw unieke stack.

Businesswaarde: sneller, agnostisch en toekomstbestendig

De overstap van 'pre-built' naar 'genereren' levert directe winst op voor de business:

• Kortere time-to-market

  Je begint op dag één met de functies die waarde toevoegen voor de eindgebruiker, jouw unieke stack van commerce platform, cms en search. Met de design tokens uit jouw global design system.

  Een global design system bewaakt je merkidentiteit via design tokens: de kleinste bouwstenen zoals kleur en typografie. Deze standaarden garanderen een consistente merkervaring. 

• Minder technical debt

  Omdat de basis wordt gegenereerd met de laatste specificatie, start je niet met een achterstand. Onderhoud verschuift van het handmatig bijwerken van verouderde afhankelijkheden of andere onderdelen naar het up-to-date houden van de specificatie.
  

• Technologie agnostisch

  De technische requirements zijn beschreven in de specificatie, een wijziging in de techniek betekent daardoor alleen een aanpassing aan de specificatie, de bron. Deze aanpak maakt deze opzet technologie-onafhankelijk, waardoor je wendbaar blijft en heel snel in kan spelen op veranderingen in de markt. 

Conclusie: de toekomst is agentic

Dit is pas het begin; de echte kracht van deze aanpak schuilt in de schaalbaarheid. Denk aan het integreren van security-checks (OWASP), het genereren van initiële content of het schrijven van volledige test-suites. Zodra dit fundament stevig staat kun je de teugels wat laten vieren en  meer leunen op de autonome kracht van agentic AI.

In het snel veranderende vakgebied van AI is het onzeker hoe de toekomst er precies uitziet, maar of de bubbel nou barst of niet, AI gaat niet verdwijnen. Met de komst van agents vindt er een verschuiving plaats van het genereren van content door een chatbot naar een digitale werknemer die effectief werk kan verrichten. Of je een volgend project nou begint met het schrijven van een specificatie of niet.

Bij Kega staan we als digital agency niet stil, we onderzoeken dergelijke ontwikkelingen en zijn bezig deze naar de praktijk te brengen.