Blog · Com treballem
Com construïm programari amb agents d'IA: qui decideix, què fa la màquina i què revisa una persona
Gairebé tot el codi que escrivim avui el tecleja un agent d'IA. Això no vol dir que ho decideixi ell. T'expliquem com repartim la feina entre la màquina i una persona, amb els números dels nostres propis repositoris.
En poques paraules
Cada projecte té un fitxer de regles escrit per Pedro Mulero. L'agent el llegeix abans de tocar res i allà hi ha el que no pot fer, començant per publicar.
L'agent escriu el codi, les proves i el missatge de cada canvi. A Perito Tacho consta com a coautor de 394 dels 395 commits que hi ha a 11/11/2026.
Res no surt a producció sense que una persona ho revisi en local. Un prototip ens costa dies. El que porta setmanes és decidir les regles i comprovar-les.
Vigència d'aquest article: 11/11/2026.
Qui decideix: una persona i unes regles per escrit
L'agent d'IA no tria què es construeix ni com es comporta el producte. Ho decideix Pedro Mulero i ho deixa per escrit en un fitxer que viu dins de cada repositori, l'AGENTS.md. És un format obert que entenen diversos agents de programació: un README pensat per a la màquina.
Les regles no són d'estil. Són les que, si es trenquen, fan mal de debò. Algunes, tal com són als nostres repositoris:
- A la web de Tarraco App Lab: «Todo lo que aquí se afirme sobre los productos tiene que ser cierto en los productos» (tot el que s'afirmi sobre els productes ha de ser cert als productes).
- A Perito Tacho, l'eina amb què es preparen dictàmens pericials: ni una sola petició sortint mentre funciona, perquè hi passen dades personals i material probatori.
- També a Perito Tacho: el mateix fitxer d'entrada ha de donar el mateix resultat byte a byte. Un dictamen que no es pot reproduir no es pot defensar a la sala.
- I una altra: tot número d'un informe s'ha de poder rastrejar fins al fitxer i el registre d'on surt. Si no té font, no s'imprimeix.
Cada regla nova porta qui la va fixar i quan, per exemple «Fijado por Pedro el 04/10/2026». Així, mesos després, se sap per què hi és i ningú no la treu per comoditat.
Què fa la IA
L'agent escriu el codi, escriu les proves, les passa i redacta el missatge de cada canvi. Treballem amb Claude, d'Anthropic. Cada commit en què intervé ho diu al peu («Co-Authored-By: Claude»), així que es pot comptar:
| Projecte | Primer commit | Commits a 11/11/2026 | Amb l'agent com a coautor |
|---|---|---|---|
| Web i ERP de Tarraco App Lab | 18/06/2026 | 247 | 239 |
| Perito Tacho | 24/07/2026 | 395 | 394 |
| Driver Solution | 18/05/2026 | 234 | 195 |
Que l'agent escrigui no vol dir que treballi sol. Cada sessió parteix d'un encàrrec concret i acaba amb el canvi fet a l'equip, sense publicar. Si una cosa no es pot comprovar, es diu. No s'omple amb el que sembla probable.
Què revisa una persona
Hi ha una frontera que no travessa cap agent: publicar. A la web de Tarraco App Lab, les ordres de desplegament no les executa cap agent i desplega Pedro després de revisar en local. A Perito Tacho, cap agent publica ni instal·la res.
Abans que res surti, una persona revisa tres coses:
- El resultat en local. La web es mira amb el servidor de desenvolupament, igual que en producció. Obrir l'HTML amb doble clic dona una pàgina trencada que no demostra res.
- El que s'afirma. Xifres, dates i normes. Una cita legal es contrasta amb el BOE o amb el Diari Oficial de la UE abans d'escriure-la, mai de memòria.
- El que se signa. Els documents de Perito Tacho els signa el pèrit i van a un jutjat. L'agent prepara l'esborrany i la persona el llegeix sencer abans d'emetre'l.
Les proves: cada regla, amb la seva
Una regla que ningú no comprova acaba oblidada. Per això a Perito Tacho moltes regles acaben igual: «Lo prueba test/…». La depuració del llibre registre la vigila test/depura-libro.test.js. La maquetació dels documents, test/maquetacion.test.js.
| Projecte | Fitxers de proves |
|---|---|
| Perito Tacho | 143 |
| Driver Solution | 31 |
| Web i ERP de Tarraco App Lab | 11 |
A la web de Tarraco App Lab les proves se centren en l'ERP: l'empremta de les factures, els rols, els accessos i la conciliació bancària. Perito Tacho no té servidor ni integració contínua: les proves es passen al mateix equip amb node --test. El seu nucli de càlcul no toca el disc ni la xarxa i no llegeix l'hora del rellotge. Per això el mateix fitxer dona sempre el mateix resultat i una prova ho pot comprovar.
Per què un prototip ens costa dies
Amb un agent, escriure codi ha deixat de ser el que és lent. L'historial de Perito Tacho ho mostra: el primer commit és del 24/07/2026 i el 27/07/2026 ja hi havia un llibre registre encadenat d'expedients i el programa arrencava com a aplicació de Windows. Aquell dia es van fer 14 commits.
El que porta temps és el que ve després: decidir les regles, provar-les amb dades reals i corregir el que una persona veu i la màquina no. Des d'aquell primer commit Perito Tacho en suma 395. Un prototip que funciona és el principi de la feina, no el final.
El que hem après
Si treballes amb agents d'IA, això és el que a nosaltres ens ha funcionat:
- Escriu les regles abans que calgui recordar-les. El que no és al fitxer de regles no existeix per a l'agent a la sessió següent.
- Posa data i nom a cada regla. Una norma sense autor acaba discutida o esborrada.
- Converteix les regles importants en proves. Una prova avisa sola. Un paràgraf, no.
- Reserva per a una persona el que no té marxa enrere: publicar, signar i enviar.
Pots veure el que hem construït així als nostres casos. Si tens cap pregunta sobre com treballem, escriu-nos des de la pàgina de contacte.
Preguntes freqüents
El codi l'escriu una IA?
En bona part, sí. Als nostres tres repositoris principals l'agent consta com a coautor de la gran majoria dels commits. Les decisions i la revisió són d'una persona.
Pot un agent publicar alguna cosa pel seu compte?
No. Els fitxers de regles dels nostres projectes ho prohibeixen de manera expressa: els desplegaments els fa Pedro després de revisar en local.
Com sabeu que el que fa l'agent funciona?
Amb proves automàtiques que es passen a l'equip (143 fitxers a Perito Tacho, 31 a Driver Solution i 11 a la web i l'ERP de Tarraco App Lab) i amb una revisió humana del resultat.
I les dades personals que gestiona cada programa?
Es decideix abans d'escriure una línia i queda per escrit a les regles del projecte. A Perito Tacho, per exemple, cap dada no surt de l'equip excepte tres excepcions autoritzades per escrit, cadascuna amb el seu abast.
Què és un AGENTS.md?
Un fitxer de text dins del projecte amb les instruccions per a l'agent: quines ordres fer servir, on és cada cosa i què no ha de fer mai. És un format obert.
Tens algun dubte sobre això?
Escriu-nos des del formulari de contacte i et contestarà una persona de l'equip.
Fonts
- AGENTS.md, format obert d'instruccions per a agents de programació: https://agents.md/
- Claude Code, documentació sobre els fitxers d'instruccions i la memòria: https://code.claude.com/docs/en/memory
- Driver Solution, web del producte: https://driversolution.es/