Quan els agents d'IA van comecar a escriure codi de forma autonoma, una cosa va quedar clara: la qualitat del resultat depenia mes de la claredat de les instruccions que de la capacitat del model. Un prompt vague genera codi vague. Una especificacio precisa genera codi que funciona.
Spec Driven Development (SDD) parteix d'aquesta observacio i la converteix en metodologia. No es tracta d'una moda mes de l'ecosistema IA, sino d'una evolucio natural en la forma de concebre el programari quan qui escriu la major part del codi es un agent, no una persona.
Que es Spec Driven Development
Spec Driven Development es un enfocament on l'especificacio del programari, el que i el per que, es defineix de forma completa i estructurada abans d'escriure una sola linia de codi. La spec es converteix en la font de veritat: el contracte entre la intencio del producte i la implementacio tecnica.
No es el mateix que Test Driven Development (TDD), on escrius tests abans de codi. En SDD, escrius la definicio completa del comportament esperat: fluxos d'usuari, regles de negoci, estructura de dades, criteris d'acceptacio i restriccions tecniques. Despres, un agent d'IA (o un equip huma) implementa seguint aquella spec com a guia.
La diferencia clau amb el desenvolupament tradicional es l'ordre:
- Desenvolupament tradicional: requisits vagues, codi, tests, documentacio (si hi ha temps).
- TDD: tests, codi, documentacio.
- Spec Driven Development: especificacio completa, implementacio (per agent o persona), verificacio.
Per que cobra sentit ara
Aquest enfocament no es nou conceptualment. La idea de definir be abans de construir apareix en l'enginyeria de programari des dels anys 70. El que ha canviat es el context:
- Els agents d'IA codifiquen rapid, pero necessiten instruccions precises. Un agent com Claude, GPT-4 o Copilot pot generar centenars de linies de codi funcional en minuts. Pero si la instruccio es ambigua, el resultat sera coherent amb l'ambiguitat. La spec elimina aquesta ambiguitat d'arrel.
- El cost d'iterar sobre una spec es molt menor que iterar sobre codi. Canviar un paragraf en un document d'especificacio porta minuts. Canviar una implementacio mal orientada pot costar dies.
- La spec es reutilitzable. Una bona especificacio serveix per generar tests, documentacio, diagrames i el propi codi. Es un actiu, no un tramit.
Beneficis concrets per a equips de desenvolupament
Menys retreball
Quan la implementacio es guia per una spec revisada i validada, les sorpreses disminueixen. L'equip sap que s'espera abans d'escriure codi, i els agents d'IA tenen prou context per generar solucions alineades amb la intencio del producte.
Millor comunicacio entre perfils
Les specs serveixen com a llenguatge comu entre producte, disseny i desenvolupament. Els product managers descriuen comportament. Desenvolupadors i agents implementen. QA verifica. Tothom llegeix el mateix document.
Escalabilitat de l'us de la IA
Si un agent d'IA rep una spec completa, pot treballar de forma mes autonoma i consistent. Aixo permet delegar mes tasques d'implementacio sense perdre control sobre la qualitat del resultat.
Documentacio viva
La spec no s'arxiva despres del sprint. Es mante actualitzada i funciona com a documentacio de referencia per a l'onboarding, auditories i evolucio del producte.
Comparativa de plataformes
Diverses eines han sorgit per facilitar la creacio, gestio i execucio de specs. Cadascuna amb un enfocament diferent:
| Plataforma | Enfocament | Format spec | Integracio amb agents | Llicencia |
|---|---|---|---|---|
| Open Spec | Specs com a codi font de primera classe | Markdown + YAML frontmatter | Nativa: Cursor, Claude, Copilot, Windsurf, OpenCode | Open source (MIT) |
| SpecStory | Capturar prompts com a specs versionables | Markdown a .specstory/ | Nativa: Cursor | Open source |
| Cursor Specs | Specs contextuals dins l'editor | Integrat a Cursor IDE | Propia: Cursor Agent | Propietaria |
| Claude Max / Specs | CLAUDE.md com a spec de comportament | Markdown (CLAUDE.md) | Propia: Claude Code | Propietaria |
| Copilot Workspace | D'issue a pla a implementacio | Generat des de GitHub Issues | Propia: GitHub Copilot | Propietaria |
Analisi per plataforma
SpecStory
SpecStory adopta un enfocament pragmatic: captura els prompts que funcionen i els converteix en especificacions versionables dins de .specstory/. Es especialment util per a equips que ja fan servir Cursor i volen documentar quins prompts generen millors resultats. El seu punt fort es la baixa friccio: no canvia el teu flux de treball, el millora. La limitacio es que esta lligat a l'ecosistema Cursor i les specs tendeixen a ser prompts evolucionats mes que veritables especificacions de producte.
Cursor Specs
Cursor ha integrat les specs com a ciutadans de primera classe dins del seu editor. Pots definir specs contextuals que l'agent de Cursor llegeix abans de generar codi. La integracio es fluida i l'experiencia d'us es bona. L'inconvenient principal es el lock-in: si el teu equip fa servir diversos editors o agents de diferents proveïdors, les specs de Cursor no son portables.
Claude Max / CLAUDE.md
Anthropic ha promogut CLAUDE.md com un fitxer de context i comportament per a Claude Code. No es exactament SDD, pero compleix una funcio similar: definir regles, convencions i restriccions que l'agent respecta en implementar. Es senzill i efectiu per a projectes individuals o equips petits. Per a projectes mes grans o multi-agent, queda curt en estructura.
Copilot Workspace
GitHub Copilot Workspace automatitza el cami des d'un issue fins a un pla d'implementacio i codi. Es util per a equips que viuen a GitHub i volen que l'agent proposi el seu propi pla abans de codificar. La limitacio es que les specs les genera la IA a partir de l'issue, no les escriu l'equip. Aixo redueix el control sobre la definicio del comportament.
Open Spec: la nostra opcio preferida
De totes les opcions, Open Spec es la que millor resol els reptes reals d'un equip que vol adoptar Spec Driven Development de forma seria i sostenible. Les raons:
Format obert i portable
Les specs a Open Spec s'escriuen en Markdown amb YAML frontmatter. Res de formats propietaris, res de lock-in amb un editor o un proveïdor d'IA concret. Si dema canvies d'agent o d'IDE, les teves specs continuen sent valides.
Agnostica respecte a l'agent
Open Spec esta dissenyada per funcionar amb qualsevol agent: Cursor, Claude, Copilot, Windsurf, OpenCode i qualsevol altre que respecti el format. Aixo permet a cada persona de l'equip fer servir l'eina amb la que se sent mes comoda, compartint les mateixes specs.
Les specs son codi font
A Open Spec, les specs es versionan al repositori juntament amb el codi. Es revisen en pull requests, es debaten en code review i es mantenen actualitzades com qualsevol altre fitxer del projecte. Aixo converteix la spec en un actiu viu, no en un document que s'escriu una vegada i s'oblida.
Suport per a SPEC.md
El format SPEC.md d'Open Spec inclou seccions estructurades per a objectius, context tecnic, restriccions, criteris d'acceptacio i dependencies. Aquesta estructura facilita que l'agent tingui tota la informacio necessaria per implementar sense ambiguitats.
Open source
Llicencia MIT. Pots auditar el codi, contribuir millores i adaptar-lo a les necessitats del teu equip sense dependre d'un proveïdor comercial.
Com comecar amb Spec Driven Development
Si vols provar SDD amb el teu equip, aquests son els passos que recomanem:
- Escull una tasca petita. Un bug, una funcionalitat menor, una millora d'UX. No intentis especificar tot el sistema de cop.
- Escriu la spec abans de tocar codi. Descriu que vols aconseguir, quines restriccions hi ha, quins criteris d'acceptacio s'han de complir. Fes servir el format SPEC.md d'Open Spec.
- Deixa que l'agent implementi. Passa la spec al teu agent d'IA (Cursor, Claude, Copilot) i deixa que generi el codi.
- Revisa el resultat contra la spec. Compleix els criteris d'acceptacio? Respecta les restriccions? Si no, ajusta la spec abans d'ajustar el codi.
- Itera. Ajusta la granularitat de les teves specs fins a trobar el nivell que funciona per al teu equip i els teus agents.
Spec Driven Development no es una metodologia mes. Es una resposta practica a una realitat nova: quan qui escriu codi es un agent d'IA, la claredat de les instruccions es converteix en el factor que determina la qualitat del resultat.
El teu equip necessita formacio en IA segura
L'EU AI Act exigeix alfabetitzacio IA per a tota la plantilla des d'agost 2026. Els nostres cursos cobreixen compliance, agents IA i governanca. FUNDAE pot subvencionar el 100% del cost.
