Programar dirigint agents

Tres nivells

Treballo amb una estructura que es repeteix en cada projecte.

1. Jo dissenyo la feina. Defineixo l’objectiu, les regles i què vol dir «fet», i ho deixo escrit al disc, no només al xat.
2. Cursor supervisa. Amb Claude, revisa el que fan els agents, detecta bucles, proposa plans i redacta les instruccions exactes. Quan un agent local no pot, ho fa ell.
3. Els agents executen. Hermes orquestra amb models locals i delega el codi a OpenCode o a Pi, que treballen amb el seu propi bucle.

La clau és que cada nivell sap què no ha de fer. L’orquestrador no pica codi, l’obrer no decideix l’arquitectura i el supervisor no es posa a programar quan la seva feina és vigilar.

La flota: nou perfils

Perfil	Què fa
default	Opera el rack: models, gateway, GPU i diagnòstics
omitsis	Temes i blocs Gutenberg de WordPress amb la metodologia d’una agència de Barcelona
wp-qa	Revisió visual de WordPress per seccions, amb una PR per correcció
web360	Disseny web de cicle complet, des del concepte fins al SEO
visual	Imatge i vídeo locals a ComfyUI
3d	Disseny amb Blender i impressió 3D
informes	Informe diari de notícies d’IA local a les 07:00
1x2	Anàlisi de La Quiniela amb optimització de l’aposta
salud	Assistent de salut privat, només en local i sense missatgeria

A més, mantinc instàncies aïllades per a la finca familiar, per a les meves germanes, per a l’equip de Nuzic (que prepara el fine-tuning del seu LoRA educatiu) i per al meu fill, que té un tutor d’FP a Discord. Tot funciona al meu laboratori de Barcelona.

Skills, memòria i eines

• Més de 80 skills pròpies, que van des d’operar les GPU i enrutar codi fins a capturar webs, transcriure reunions o analitzar un electrocardiograma en local.
• Memòria en capes: memòria vectorial mem0 amb una col·lecció per perfil, memòria hologràfica local per a allò que és sensible i vaults d’Obsidian com a font de veritat documental.
• Integracions: Home Assistant, InfluxDB, SearXNG, Firecrawl, navegador headless, Figma, GitLab, Bitbucket, X i ComfyUI.
• Plugins i hooks propis: generació d’imatge demanant la GPU a l’àrbitre, estat del rack a Discord i un hook que impedeix que l’orquestrador es quedi sondejant els seus subagents.

Regles de govern

Totes neixen d’un incident real.

• CONFIRMO. El diagnòstic de només lectura és lliure, però escriure, reiniciar o tocar serveis exigeix una confirmació literal.
• No esborrar mai. Abans d’esborrar es fa una còpia i es passa a quarantena, i està prohibit fer servir rm -rf sense permís escrit.
• Merge només amb aprovació humana, verificada per l’API, i branques de producció prohibides.
• Aïllament per client. Cada client o persona té el seu perfil, el seu bot, la seva memòria i la seva col·lecció vectorial.
• Canal d’administració separat, amb les ordres d’infraestructura bloquejades a la resta.
• Privadesa per disseny en allò que és sensible: el perfil de salut no surt mai de la meva xarxa.

El playbook d’orquestració

1. Un orquestrador i, com a molt, de dos a quatre fills, sense néts.
2. Es reparteix per disc: un fill, un fitxer. Els cadenats i els briefs van per escrit.
3. Només es paral·lelitza el que és independent. Més velocitat no sempre dona un resultat millor.
4. Cada tasca va al model adequat: el que és gros, al cervell, i el que és rutinari, a la GPU de codi.
5. L’orquestrador espera els seus fills sense sondejar-los.
6. Un sol operador arrenca i atura serveis.
7. Es tria el model segons quants agents hi treballaran alhora.
8. Cal tancar el que s’obre, com els navegadors headless, i vigilar la memòria.
9. Una fase per sessió, amb una «definició de fet» que deixa un artefacte al disc.

Errors que ja he comès per tu

El que va passar	Com ho vaig resoldre
L’agent esquivava restriccions instal·lant eines pel seu compte	Barreres deterministes per perfil i canal
L’orquestrador va sondejar els seus fills fins a la crida 488	Un hook que el bloqueja i un temps màxim per fill
Bucles de 180, 245 i 370 crides a eines	Límits de torns, aturada en sec i regles explícites
Les GPU es quedaven al 100 % de matinada durant hores	La causa era el bolcat de memòria nocturn; el vaig acotar i va passar de 99 minuts a 8 segons
Es va demanar «memoritza» i l’agent va canviar codi	El protocol CONFIRMO
Diversos agents arrencaven el mateix servei alhora	Un únic operador
L’eina de visió aixafava les captures a 178 px	Captures en tessel·les de 1440 × 900
Els timeouts tallaven contextos llargs legítims	Una política de temps pensada per a 768K tokens

L’apliquem al teu equip?

Ensenyo aquest mètode a desenvolupadors, CTO i equips, i munto flotes d’agents per a empreses amb aquestes mateixes regles. El trobaràs a file.cat, als apartats de formació i d’agents.