spec/write
spec-write je orodje za pisanje funkcionalnih specifikacij, v katerem specifikacija ni dolg dokument, ampak model. Vsaka zahteva, gradnik, vmesnik, podatkovni model in odločitev je oštevilčen zapis s statusom in tipiziranimi povezavami, zato ekipa v vsakem trenutku ve, kaj je potrjeno, kaj se je spremenilo in kaj je že implementirano.
Arhitekt, razvijalci in stranka delajo v istem dokumentu, vsak s svojo vlogo. Pogovor teče ob bloku besedila, status gre od osnutka prek pregleda do potrditve, iskanje razume slovenske oblike besed. Stranka nikoli ne vidi osnutkov ne internih komentarjev — pravilo velja že v poizvedbah na strežniku in je pokrito s testi, ne le skrito v vmesniku.
Besedilo lahko živi v aplikaciji ali kot Markdown v repozitoriju GitHub. V drugem primeru spec-write doda oštevilčene zapise, komentarje in iskanje, spremembe pa vrne kot v IDE: delovno drevo, commit s soavtorji, push, razreševanje sporov in najmanjši možni diff. Uvoz iz Worda in izvoz v .docx ali .md sta vgrajena.
Orodja za pisanje kode (Claude Code, Cursor, VS Code, Codex) specifikacijo berejo prek strežnika MCP z osebnim žetonom samo za branje. Razvijalec zahteve ne kopira več ročno, orodje pa vidi natanko toliko kot on.
Zasnoval in razvil sem ga od prve skice do produkcije: Nuxt 4 in TypeScript na spletu, FastAPI in MongoDB v zaledju, dvostopenjsko preverjanje in šifrirane skrivnosti, več kot 1000 testov e2e s Playwrightom ter Docker slike in izdaje prek GitHub Actions. Vmesnik je v slovenščini, dostop je zaenkrat samo z vabilom.