Razvoj vođen specifikacijom u Let Books

Let Books je koristan studijski primjer razvoja vođenog specifikacijom jer repozitorij već sadrži više slojeva proizvodne namjere, a ne samo implementacijske artefakte.

Projekt još nije puna hostana aplikacija. Trenutno uključuje proizvodnu specifikaciju, implementacijske smjernice, javnu dokumentaciju i lokalni statični demo. Zbog toga je dobar primjer kako projekt može ostati usklađen i prije nego što postoji konačni produkcijski stack.

Sloj specifikacije

AGENTS.md je jezgrena proizvodna specifikacija. Definira svrhu projekta, domenu, tokove rada, granice opsega, smjer lokalizacije, privatnost, neobaveznost AI-ja i kriterije prihvatanja.

Odgovara na pitanja kao što su:

• zašto projekt postoji
• koji su tokovi rada prvoklasni
• šta mora raditi bez AI-ja
• šta su buduće ideje, a ne sadašnje obaveze
• šta se računa kao uspješan prvi demo

To je razlika između općeg opisa i prave specifikacije. Prava specifikacija ograničava implementacijske izbore.

Sloj taktičkih smjernica

AGENTS-Implementation.md dodaje drugi sloj. Ne zamjenjuje proizvodnu specifikaciju, nego objašnjava kako se rad u ovom repozitoriju sada treba izvoditi.

Primjeri uključuju:

• pravila javnog imenovanja
• pravila implementacije dokumentacije
• očekivanja o metapodacima statičnog mjesta
• ograničenja demoa
• očekivanja o lokalizaciji i provjeri
• uredničku dokaznu politiku za javno pisanje

To je važno u radu uz pomoć AI-ja zato što svako pravilo ne pripada dugoročnoj proizvodnoj specifikaciji. Neka su pravila taktička, urednička ili specifična za repozitorij. Održavanje te razlike jasnom smanjuje šum i sprječava da se proizvodna specifikacija pretvori u odlagalište implementacijskih detalja.

Sloj trenutnog stanja

README.md predstavlja treći sloj: opis trenutnog stanja.

Objašnjava šta danas postoji, čega još nema, čemu služi statični demo i kako je javna stranica objavljena. To je ključan dio usklađivanja, jer projekti često podbace kada čitaoci pobrkaju ambiciju s implementacijom.

U Let Booksu README izričito razlikuje trenutne isporuke od budućih planova. To saradnicima, institucijama i recenzentima pomaže razumjeti zrelost projekta bez nagađanja.

Sloj dokumentacije

Područje docs/ dodaje četvrti sloj. docs/README.md, docs/Development.md, docs/Deployment.md, vodiči za stil i područje sources određuju kako znanje treba biti organizirano, validirano i objavljeno.

Tu repozitorij postaje više od zbirke datoteka. Postaje platforma znanja sa:

• arhitekturom dokumentacije
• pravilima uredničkih dokaza
• višejezičnom izdavačkom strukturom
• pravilima objave javne dokumentacije
• razvojnim i validacijskim smjernicama

To je upravo vrsta okvira koja pomaže da isporuka uz pomoć AI-ja ostane sljediva.

Sloj demoa

Statični demo je važan, ali namjerno nije jedina autoriteta. Pravila za blog i izvore već razlikuju kanoničnu dokumentaciju od statusa implementacije.

To znači da demo može provjeravati tokove rada, otkrivati probleme upotrebljivosti i pomagati u objašnjavanju vanjskim akterima, a da pritom sam od sebe ne postane konačna proizvodna istina.

To je zrelo pravilo. Bez njega prototipi često postanu slučajni mehanizmi upravljanja. Tim počne kopirati prototip zato što postoji, a ne zato što odražava odobrenu proizvodnu odluku.

Sloj provjere

Let Books već dokumentira i način razmišljanja o provjeri.

docs/Development.md i docs/Deployment.md opisuju validacijske slojeve kao što su:

• dimni testovi lokalizacije
• validacija strukturiranih datoteka
• generiranje metapodataka
• provjera obaveznih datoteka
• opcionalne pravopisne provjere i linting
• automatizacija objave

To nisu samo detalji o alatima. To je dokaz da projekt kvalitet tretira kao ponovljiv sistem.

Zašto je to važno za AI-podržanu isporuku

Ako AI pomoćnik doprinosi Let Booksu, ne mora izmišljati proizvod od početka. Repozitorij već sadrži lanac namjere:

1. proizvodni smjer u AGENTS.md
2. taktička pravila isporuke u AGENTS-Implementation.md
3. trenutno stanje u README.md
4. pravila znanja i objave u docs/
5. status izvršivog prototipa u statičnom demou
6. smjernice za validaciju i objavu u razvojnoj i implementacijskoj dokumentaciji

Taj lanac ne uklanja greške. Ali ih čini lakšim za otkrivanje i pregled.

Glavna lekcija

Razvoj vođen specifikacijom ne znači samo napisati dugačak dokument sa zahtjevima prije početka kodiranja.

U praksi znači izgraditi pouzdan lanac između:

• proizvodne namjere
• taktičkih pravila
• javne dokumentacije
• demoa
• validacije
• objave

Let Books već pokazuje da takav lanac može postojati i prije pune pozadinske aplikacije.

To je jedan od najsnažnijih argumenata za razvoj vođen specifikacijom u AI-podržanom radu: što je lanac namjere jasniji, to je manja vjerovatnoća da će se brz izlaz pretvoriti u brzu zbrku.