Métodos
Especificacions abans que codi
Especificacions per fases amb criteris d'acceptació abans d'escriure codi.
1 min de lectura
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é. Mirar abans de tocar, com vaig contar a Auditoria abans de tocar res.
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, panells 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 (el manual d'emergència).
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 (programari que treballa sol). 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 demanava 14 primitives concretes (les peces bàsiques: un botó, un camp). Quan es van acabar, es van comptar. I quan alguna no s'assemblava prou a l'HTML validat —com vaig contar a Del prototip al disseny validat—, es va refer.
Més feina abans de començar, molta menys feina després.