Hardik Pandya: kako izložiti dizajn sistem LLM-ovima
U svom tekstu Hardik Pandya identifikuje strukturalni problem korišćenja LLM-ova za dizajn: bez eksplicitnog konteksta dizajn sistema, modeli izmišljaju vrednosti koje izgledaju verovatno, zaboravljaju odluke između sesija i ne mogu da izvuku dizajnersku nameru iz izvornog koda. Do desete sesije rada na istom proizvodu, piše Pandya, rezultat „izgleda kao tri različita proizvoda koje su napravile tri različite ekipe.” Zatim opisuje četvorodelnu metodu koja čini dizajn sistem mašinski čitljivim pre nego što ikakva sesija kodiranja počne.
Prvi deo su spec fajlovi — strukturisana dokumentacija u markdown-u, organizovana u tri nivoa (osnove i tokeni, komponente i paterni), koju LLM čita na početku sesije umesto da zaključuje iz koda. Pandya to demonstrira sa 64 spec fajla koji pokrivaju kompletan Atlassian dizajn sistem. Drugi deo je troslojna CSS token arhitektura: primitivi izvornog dizajn sistema, pseudonimi na nivou projekta sa rezervnim vrednostima i reference na nivou komponenti koje koriste samo pseudonime, nikada sirove vrednosti. Ovo sprečava izmišljanje tako što modelu daje kompletan, autoritativan rečnik tokena. Treći deo je audit skripta koja skenira CSS fajlove u potrazi za hardkodovanim vrednostima i prekida CI build pri kršenjima. Četvrti deo je detekcija drifta — praćenje ažuriranja upstream biblioteka i označavanje spec fajlova na koje utiču izmene.
Pandya pruža jednu prompt za Claude Code koja izvršava svih šest koraka podešavanja: audit postojećeg CSS-a, generisanje fajla tokena sa 230+ imenovanim promenljivama, kreiranje hijerarhije spec fajlova, povezivanje audit skripti, zamena svih hardkodovanih vrednosti tokenima i konfigurisanje upstream praćenja. Primenjena na sopstveni projekat, ovo je eliminisalo 418 hardkodovanih vrednosti u 28 fajlova i dovelo broj do nule.
Praktična vrednost ovde nije specifična za AI — pristup sa spec fajlovima je u suštini strukturisana dokumentacija koja se istovremeno ispostavlja čitljivom za LLM-ove. Ekipe koje dokumentuju svoje dizajn sisteme na ovaj način imaju dvostruku korist: bolji onboarding i dosledeniji AI izlaz. Tekst je najkorisniji za dizajnere ili frontend inženjere koji redovno koriste AI alate za kodiranje i primetili su degradaciju konzistentnosti u dužim projektima.