Razvoj vođen specifikacijama

Wiki Hrvatski

Razvoj vođen specifikacijama je pristup u kojem jasno zapisane definicije proizvoda i tijeka rada usmjeravaju implementaciju, dokumentaciju, pregled i provjeru.


Definicija

U ovom pristupu specifikacija nije samo početni planski dokument. Djeluje kao stalna referenca za:

  • namjena proizvoda
  • granice djelokruga
  • potrebno ponašanje
  • kriteriji prihvatljivosti
  • mjerila pregleda

Zašto je to važno u radu uz pomoć umjetne inteligencije

AI povećava brzinu isporuke, ali također može povećati odstupanje proizvoda kada je namjera nejasna.

Razvoj vođen specifikacijama pomaže time što timovima daje stabilno uporište koje se može pregledati, ažurirati i koristiti za procjenu generiranog rezultata.

Tipični slojevi

Uobičajeni slojevi u sustavu vođenom specifikacijama uključuju:

  • specifikacija proizvoda
  • smjernice za provedbu
  • dokumentaciju o trenutnom stanju
  • demo ili ponašanje aplikacije
  • pravila i testovi validacije
  • provedba pravila u CI/CD-u

Način uobičajenog kvara

Čest način da stvari krenu po zlu jest da najvidljiviji artefakt postane zadani izvor istine.

Primjeri:

  • najnoviji upit
  • trenutni prototip
  • trenutni prečac implementacije
  • ustajala stranica dokumentacije

Razvoj vođen specifikacijama smanjuje taj rizik tako što jasno određuje koji izvori imaju prednost pri odlučivanju.

Let Books kontekst

U Let Books, razvoj vođen specifikacijama podržavaju:

  • AGENTS.md
  • AGENTS-Implementation.md
  • README.md
  • docs/Development.md
  • docs/Deployment.md