Addable Labs bygger mjukvara till stor del med AI-agenter och den här sajten är det första som en agentdriven mjukvarufabrik tog fram åt företaget från början till slut, i två byggen. Den här artikeln beskriver stegen, vad vi tittade på och de kontroller som står mellan en agents ändring och en publicerad sida.

Stegen

Varje körning gick igenom en fast sekvens och varje steg skrev ett dokument som nästa steg var tvunget att läsa: krav, en plan, en granskning av den planen, en nedbrytning i arbetspaket, genomförandet, en granskning av resultatet och publicering. Kraven förvandlade en kort uppdragsbeskrivning till numrerade påståenden med acceptanskriterier. I det första bygget valde planen tekniken och låste URL-strukturen, artiklarnas schema och färgpaletten, med de alternativ den förkastade; i det andra valde den designsystemet. Nedbrytningen delade upp planen i arbetspaket, vart och ett med ett eget beviskommando och en agent genomförde dem ett i taget på en lokal gren.

Steg ett till tre och grundarens första grindföre kodenkraven uppdragstext blir numrerade kravplanteknik, URL:er, schema, palettgranskningav planen, med tillägggrundarens grindden granskade planen godkännsSteg fyra till sexbyggetnedbrytningtio arbetspaket med varsitt bevisgenomförandeett paket i taget, en grengrindartio kontroller vid varje ändring10/10Granskningen av resultatet, grundarens andra grind och publiceringeninnan det blir offentligtgranskningav resultatet, tre granskningsspårgrundarens grindslutligt godkännandepubliceringaldrig enbart på en agents ordklart
Byggets sju steg och grundarens två grindar: den granskade planen före nedbrytningen och det slutliga godkännandet före publiceringen. Varje steg skrev ett dokument som nästa steg var tvunget att läsa.

Vad grundaren granskar

Loopen från en ändring till en publicerad sidaloopenändringen lokal commitgrindar10/10 måste klaragrundarenläser, godkännerpubliceradsidan är livenästa ändring
Varje ändring körs genom de tio grindarna och granskas sedan av grundaren; först då blir sidan publik.

Ingenting på den här sajten blir offentligt enbart på en agents ord. Men det första bygget kördes utan grind: krav, plan och tio arbetspaket gick igenom på fyra timmar och grundarens omdöme om den färdiga sajten var "en sida från 90-talet". Det andra bygget satte vår grind vid planen: vi valde en av tre renderade riktningar, svarade på planens öppna frågor och gav vårt omdöme om resultatet på förhandsvisningen morgonen därpå. Vi äger de delar som ingen agent kan avgöra: formuleringarna om företaget, den svenska texten, vilka privata projekt som får nämnas och stegen som rör domänen och driften.

Kvalitetsgrindarna

De tio kontrollerna i pnpm check och vad var och en vaktarpnpm check10/10buildwebbplatsen byggsPASSlinksinterna länkar finnsPASShtmlgiltig HTMLPASSpageslandmärken, h1, hopplänkPASScontrastvarje färgpar, båda temanPASSparitysv/en sidor och texterPASSfeedsgiltig RSS, alla artiklarPASScontentfakta sidorna måste angePASSlighthousefyra poäng på minst 95PASSlayoutkortraster vid fem bredderPASS
Grindtavlan: ett kommando kör de tio kontrollerna, i den här ordningen, vid varje ändring och varje pull request; var och en har ett test som bevisar att den misslyckas när något medvetet har gjorts sönder.

Ett enda kommando kör varje kontroll och samma kommando är inställt att köras på varje pull request. Det bygger webbplatsen, kontrollerar att varje intern länk leder någonstans, validerar HTML-koden, kontrollerar strukturen på varje sida – landmärken, en enda huvudrubrik, en hopplänk, alt-text – mäter kontrasten för varje färgpar i båda teman, bekräftar att varje engelsk sida har en svensk motsvarighet och att de två uppsättningarna gränssnittstexter har samma nycklar, validerar flödena och söker igenom resultatet efter de fakta som sidorna måste ange. Varje kvalitetsgrind har ett test som bevisar att den misslyckas när något medvetet har gjorts sönder.

Två ärliga iakttagelser

Det mesta av det agenterna skrev var inte kod: i det första bygget 6 900 rader krav, planer, sammanfattningar och granskningar mot 3 700 rader webbplats, kvalitetsgrindar och tester. Precision i dokumenten betydde mer än finurlighet i koden: den enda rättning som granskningen krävde var en grind som hade hårdkodat en platshållare som vi ska byta ut.

Dokument mot kod i det första bygget: 6 900 rader krav, planer, sammanfattningar och granskningar mot 3 700 rader webbplats, kvalitetsgrindar och testerdet första bygget, i raderdokument6 900krav, planer, sammanfattningar, granskningarkod3 700webbplats, kvalitetsgrindar, testerprecision i dokumenten betydde merän finurlighet i kodenden enda rättning som krävdes:en grind med en hårdkodad platshållare
Det mesta av det agenterna skrev var inte kod: i det första bygget 6 900 rader krav, planer, sammanfattningar och granskningar mot 3 700 rader webbplats, kvalitetsgrindar och tester. Precision i dokumenten betydde mer än finurlighet i koden – den enda rättning som granskningen krävde var en grind som hade hårdkodat en platshållare som grundaren ska byta ut.

Kvalitetsgrindarna fångar mekaniska misstag, inte osanningar: en saknad svensk sida eller en färg som inte klarar kontrastkravet fångas automatiskt; om en mening om en produkt är sann kan de däremot inte avgöra. Därför kan fakta om apparna spåras till en källa – den README som var och en hämtades från och datumet då den lästes – och vi läser ändå allt. Agenterna gjorde också misstag: en session tog en administrativ post i registret i stället för sin uppgift och behövde fjorton minuter för att ta sig runt det.

Webbplatsen är enkel: statisk HTML och CSS, två små skript (ett som växlar mellan mörkt och ljust läge och ett som tonar in innehållet när du rullar; sidan fungerar utan båda), ett typsnitt vi levererar från vår egen server och inga anrop till tredje part, ingen webbanalys. Det var ett beslut och den del som spelar roll – att inget laddas från någon annans servrar – verifieras av en kvalitetsgrind vid varje bygge.