Crew coding: com construïm amb una tripulació d'agents de Claude Code

A NORKÄRŸM construïm tots els productes amb Claude Code. No ho fem amb un sol agent que ho fa tot, sinó amb una tripulació: moltes sessions alhora, cadascuna amb una feina, revisades per altres i amb unes regles escrites. En diem crew coding. No és «vibe coding»: hi ha rols, revisors i regles.

Una sessió, un carril

En un sol ordinador hi treballen més de vint sessions de Claude Code alhora. Cadascuna porta un carril: una app, un mòdul o un repositori.

Cada sessió treballa en la seva pròpia carpeta (un worktree de git) i amb la seva pròpia banda de ports. Així cap sessió no toca els fitxers d'una altra, ni l'entorn on treballen les persones.

La documentació de Claude Code explica com obrir sessions en paral·lel amb worktrees perquè les edicions no xoquin. Nosaltres hem portat aquesta recepta a un equip sencer.

Les sessions que coordinen

Unes quantes sessions no construeixen producte: coordinen. Cadascuna porta el nom del seu rol. Cap no governa: veuen, avisen, reparteixen la feina o executen el que ha decidit una persona.

• Panell: el que espera la persona (i on ho contesta) i les sortides a producció.
• Missatges: entre sessions, i les decisions de la persona a qui les ha de fer.
• Fiscal i legal: ho porta a la persona responsable i a l'assessoria.
• Seguretat: secrets, permisos, dependències i auditories.
• Pantalles: la línia visual; revisa cada canvi de pantalla.
• Proves: la CI en vermell, els gates de proves i les proves de clicar a l'entorn de proves.
• Eines: per als agents: scripts, hooks i skills.
• Màquina: memòria, disc, ports i cost.
• Manteniment: el que no espera ningú: la feina oblidada i la neteja.
• Versions: els releases.

Les regles que ho fan fiable

• La primera regla: no inventar res. Cap agent no diu que una cosa està feta, provada o decidida si no ho està. «No ho sé» és una resposta bona, i qui dubta pregunta a qui ho sap.
• Primer el pla, després el codi. Una funció, una pantalla o un permís nou comença amb un pla curt per escrit, i el revisen alhora els revisors de pantalla, de seguretat i de legal, abans que hi hagi codi.
• Cada fusió als nostres productes necessita el sí d'una persona.
• La feina pesada (instal·lacions, compilacions, proves, captures) passa per una cua compartida, perquè la màquina no s'ofegui.
• Tots els missatges entre agents fan servir un sol format (INFO, PREGUNTA o BLOQUEIG) i van signats, perquè una persona sàpiga sempre qui ha dit què.
• Les lliçons apreses s'apunten on tots els agents les poden llegir.

El que fa sempre una persona

Hi ha coses que cap agent no fa pel seu compte: decidir que una feina es fusiona o es publica, promoure una versió, decidir sobre el producte i els diners, i donar secrets. Els agents ho preparen, ho proven i ho expliquen; la decisió és d'una persona.

La documentació de Claude Code recomana planificar abans d'editar. Nosaltres hi afegim una cosa: el pla el llegeixen revisors diferents alhora, i qui decideix és una persona.