Razvoj na podlagi specifikacij

Wiki Slovenščina

Razvoj na podlagi specifikacij je pristop, pri katerem jasno zapisane opredelitve izdelka in delovnih tokov usmerjajo implementacijo, dokumentacijo, pregled in preverjanje.


Definicija

Pri tem pristopu specifikacija ni le začetni načrtovalni dokument. Deluje kot stalna referenca za:

  • namen izdelka
  • meje obsega
  • zahtevano vedenje
  • merila sprejemljivosti
  • merila za pregled

Zakaj je to pomembno pri delu s pomočjo umetne inteligence

Umetna inteligenca poveča hitrost dostave, vendar lahko poveča tudi premikanje izdelka, kadar je namen nejasen.

Razvoj na podlagi specifikacij ekipam daje stabilno izhodišče, ki ga je mogoče pregledati, posodobiti in uporabiti za presojo ustvarjenega rezultata.

Tipične plasti

Pogosti sloji v sistemu, ki temelji na specifikacijah, vključujejo:

  • specifikacija izdelka
  • navodila za izvedbo
  • dokumentacijo o trenutnem stanju
  • obnašanje demo ali aplikacije
  • pravila validacije in testi
  • izvajanje pravil v CI/CD

Način običajne napake

Pogost način zdrsa je, da najvidnejši artefakt postane privzeti vir resnice.

Primeri:

  • zadnji poziv
  • trenutni prototip
  • trenutna bližnjica izvedbe
  • zastarela dokumentacijska stran

Razvoj na podlagi specifikacij to tveganje zmanjša tako, da jasno določi, kateri viri imajo pri odločitvah prednost.

Let Books kontekst

V Let Books razvoj, ki temelji na specifikacijah, podpirajo:

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