AI može ubrzati development, ali ne razjašnjava nejasan zahtjev. Ako modelu date nejasan problem, dobit ćete brže iteracije nečega što je možda "skoro dobro", ali nije ono što korisnik ili tim stvarno treba.
Spec-driven development je jednostavno rješenje: prije koda napišete dovoljno jasnu specifikaciju da se zna što radite, što ne radite, koji edge caseovi postoje i kako ćemo znati da je posao gotov.
Specifikacija nije birokracija
Loša specifikacija je dugačak dokument koji nitko ne čita. Dobra specifikacija je operativni artefakt: kratka, konkretna i dovoljno precizna da developer, reviewer i AI agent rade prema istim kriterijima.
Minimalna korisna specifikacija
- problem koji rješavamo
- korisnici ili workflow koji se mijenja
- non-goals i izričite granice opsega
- acceptance kriteriji
- edge caseovi i rizici
- utjecaj na postojeći sustav
Zašto AI bolje radi sa specifikacijom
AI modeli su dobri u popunjavanju praznina. To je korisno kada tražite ideje, ali opasno kada gradite feature koji mora poštovati postojeću arhitekturu, sigurnosna pravila i poslovne edge caseove.
Specifikacija smanjuje praznine koje model mora popunjavati sam. Ona također daje revieweru jasan okvir: review ne pita samo "radi li kod", nego "rješava li kod dogovoreni problem na dogovoreni način".
spec-kit, OpenSpec ili običan Markdown?
Alat je manje važan od discipline. spec-kit i OpenSpec mogu pomoći kada trebate formalniju strukturu, verzioniranje promjena ili veći timski proces. Za manje promjene često je dovoljan običan Markdown dokument u repozitoriju.
Markdown
Najbolji izbor za manje featurei kada tim već ima dobru disciplinu.
spec-kit
Koristan kada želite strukturiraniji AI-assisted workflow od ideje do plana.
OpenSpec
Dobar kad promjene traju dugo i kad treba jasna povijest odluka.
Specifikacija ne smije zamrznuti učenje
Najveća greška je tretirati spec kao ugovor koji se ne smije promijeniti. Dobar spec se mijenja kada naučite nešto novo, ali se promjena bilježi. Tako tim ne gubi kontekst zašto smo promijenili smjer.
To je posebno važno kod AI workflowa. Model može predložiti bolji pristup, ali promjena smjera mora završiti u specifikaciji, ne samo u chat historyju.
Zaključak
Spec-driven development nije sporiji način rada. Spor je kaos koji prvih par sati izgleda brzo, a onda pojede dane na rework, nejasne review komentare i promjene smjera.
Kada AI uđe u proces, potreba za specifikacijom postaje veća, ne manja. Dobro napisan spec modelu daje granice, a timu zajednički kontekst i jasne kriterije za review. Tako dobivate brzinu bez gubitka kontrole.
Pogledajte i tekst o upravljanju AI kontekstom za širu sliku.
Josip Budalić
HOTFIX tim
Josip vodi HOTFIX d.o.o. i radi na software arhitekturi, AI-assisted development workflowima, modernizaciji codebasea i praktičnoj isporuci softwarea.