Especificacions abans que codi

La regla del projecte

Hi ha una regla que no es discuteix: no s’implementa una fase fins que la seva especificació està revisada i tancada. Abans d’escriure codi, hi ha un document que diu què es fa, com es fa i com se sap que està bé.

Com està organitzat

El projecte té nou fases, de la 0 a la 8: fonaments del servidor, model de dades, frontend públic, migració de continguts, LaIA, panels de gestió, publicitat, newsletter i pas a producció. Cada fase té la seva especificació, amb el model de dades camp a camp, els criteris d’acceptació i els runbooks d’operacions.

A més, unes regles globals s’apliquen a tot: no inventar dades, seguretat per defecte, analítica sense cookies, commits petits i clars.

Per què en val la pena (sobretot amb agents)

Les especificacions són també el que permet treballar amb agents d’IA. Hi ha un paquet en anglès pensat per a ells, amb cada tasca numerada i els seus criteris. L’agent no improvisa: executa la tasca i el resultat es comprova contra l’espec.

Un exemple real: la spec del design system (tasca T2.1) demanava 14 primitives concretes. Quan es van acabar, es van comptar. I quan alguna no s’assemblava prou a l’HTML validat, es va refer.

Més feina abans de començar, molta menys feina després.