Cómo trabajamos con Claude: del commit a la rutina vigilada
Una IA que escribe por ti es rápida. Una IA que escribe por ti y que no puede romper nada sin que te enteres es otra cosa. En esta serie explicamos diez piezas por separado: commit, CLAUDE.md, hook, subagente, MCP, rutina, eval, gate, canario y bitácora. Aquí van juntas: qué problema resuelve cada una, en qué orden conviene ponerlas y los tres errores que más caro nos salieron.
- 01Qué esEl sistema en una frase
- 02Qué esEl mapa: qué resuelve cada pieza
- 03DecidirPor dónde empezar
- 04Paso a pasoDónde va cada lección
- 05CuidadoLos tres errores que más nos costaron
- 06PromptsUn prompt para ver qué pieza te falta
- 07CuidadoLo honesto
Cómo trabajar con Claude Code sin perder el control: el sistema en una frase
Guardar, enseñar, obligar, delegar, conectar, automatizar, medir, frenar, probar el freno y recordar. Diez verbos, diez piezas. Ninguna es un invento nuestro: casi todas son funciones de Claude Code o prácticas conocidas del software, cada una con su guía y su fuente oficial. Lo nuestro es el orden y lo que aprendimos al juntarlas.
Piensa en una cocina de restaurante. La receta escrita (CLAUDE.md), el cocinero que prepara aparte (subagente), el proveedor que trae el producto (MCP), la preparación de cada mañana (rutina), el cocinero que prueba el plato (eval), el que no deja salir un plato frío (gate) y el cuaderno donde se anota por qué cambió la receta (bitácora).
El mapa: qué resuelve cada pieza
| Pieza | Resuelve | Sin ella… |
|---|---|---|
| Commit | Volver atrás | Un cambio malo de la IA puede no tener vuelta |
| CLAUDE.md | No repetir instrucciones | Cada sesión empieza de cero |
| Hook | Que lo importante pase siempre | Depende de que Claude se acuerde |
| Subagente | Delegar sin llenar el chat | Tu conversación se llena de lo que no vas a volver a mirar |
| MCP | Llegar a tus herramientas | Copias y pegas a mano |
| Rutina | Trabajar sin ti | Todo espera a que abras una sesión |
| Eval | Saber si lo hizo bien | Adivinas si mejoró o empeoró |
| Gate | Frenar lo que no cumple | El error sale y lo ves después |
| Canario | Saber que el freno funciona | Un control en verde que no sabe ponerse en rojo |
| Bitácora | Recordar el porqué | En tres meses nadie sabe por qué está hecho así |
Por dónde empezar
Nuestra recomendación, de lo que más protege con menos esfuerzo a lo que pide más trabajo. No es una regla: si ya tienes alguna pieza, sáltala.
- Commit y CLAUDE.md. Un punto de guardado antes de cada cambio grande y un archivo con tus reglas. Se montan en una tarde.
- Un hook para lo que no puede fallar. Uno solo, el que más te duela: proteger un archivo, avisarte cuando Claude te necesita.
- Subagentes y MCP cuando los pidas a gritos. Cuando el chat se te llene de búsquedas o te canses de copiar datos de otra herramienta.
- Una rutina, decidiendo antes qué deja hecha. Si no puedes decir qué archivo o mensaje vas a revisar, todavía no está lista.
- Eval, gate y canario cuando algo salga a clientes o al público. Ahí un error ya no es tuyo: es de quien lo recibe.
- La bitácora, desde el primer día que tomes una decisión que no sea obvia. Es la más barata de todas.
Dónde va cada lección, de lo que más protege a lo que menos
Cada vez que algo sale mal aprendes algo. Esta es la regla que usamos para decidir dónde queda escrito, de lo más seguro a lo más frágil:
| Si la lección… | Va en… | Porque… |
|---|---|---|
| Se puede comprobar sola | Un gate o un hook | Salta aunque nadie se acuerde |
| Es sobre un archivo concreto | Un comentario dentro de ese archivo | Nadie lo toca sin leerlo |
| Es una regla de cómo trabajar | CLAUDE.md | Claude la lee en cada sesión |
| Es el porqué de una decisión | La bitácora | Se consulta cuando hace falta entender |
La trampa es quedarse abajo. Si la misma lección se escribe en la bitácora dos veces, está pidiendo subir: primero a una regla, y si se incumple otra vez, a un control que no dependa de nadie.
Los tres errores que más nos costaron
- Creer un verde que nunca vimos en rojo. Un control que siempre pasa puede estar ciego. Ahora cada control nuevo se estrena rompiendo a propósito lo que vigila: es el canario.
- Confundir «ejecutada» con «hecha». En julio de 2026, cuatro rutinas nuestras marcaron «ejecutada» cada día durante más de una semana sin producir nada. Ahora se mira lo que dejan, no la marca.
- Creerle a un medidor roto. Dos veces comparamos las guías de este Arsenal con las publicadas y salían «todas distintas». No lo estaban: la web añade un script al final de cada página y el medidor lo contaba como cambio. Si el cambio es pequeño y el resultado es demoledor, lo roto suele ser el medidor.
Un prompt para ver qué pieza te falta
Es nuestro, no de Anthropic.
El chequeo del sistema
Cuándo usarlo: una vez, en tu proyecto principal, para decidir qué montar primero.
Lo honesto
- Es nuestra forma de trabajar, no la única. Sirve para proyectos que duran y que tocan a clientes; para algo de una tarde, sobra.
- Varias piezas son de Claude Code, no del chat de claude.ai. Los hooks, por ejemplo, no existen en el chat.
- «Gate», «canario» y «bitácora» son palabras de la casa. Cada guía dice cómo se llama en la industria.
- Montarlo todo cuesta. Nosotros llegamos aquí en meses y a golpe de errores; no hace falta hacerlo en una semana.
- Las funciones cambian. Cada guía tiene su fecha de verificación; si pasó mucho tiempo, mira la fuente.
Empieza por un commit antes de cada cambio grande y un CLAUDE.md con tus reglas. Cada error que se repita, súbelo una capa: de la nota a la regla, y de la regla al control que no depende de que nadie se acuerde.
¿Y ahora qué?
Tres formas de seguir, según lo que prefieras.
El mensaje para tu grupo
¿Le sirve a alguien de tu equipo o de tu grupo? Cópialo tal cual o ábrelo directo en WhatsApp.
Te paso esta guía: Cómo trabajamos con Claude. Las diez piezas juntas, y por dónde empezar. https://iactn.com/arsenal/como-trabajamos-con-claude/Fuentes, leídas el 30-09 y el 01-10-2026
- How Claude remembers your project · Claude Code Docs. CLAUDE.md.
- Automate actions with hooks · Claude Code Docs. Los hooks.
- Create custom subagents · Claude Code Docs. Los subagentes.
- Connect Claude Code to tools via MCP · Claude Code Docs. MCP.
- Automate work with routines · Claude Code Docs. Las rutinas.
- Demystifying evals for AI agents · Anthropic Engineering. Los evals y probar en los dos sentidos.
- El resto de fuentes (git-scm, SonarQube, GitHub, Martin Fowler, Google SRE) están en la guía de cada pieza.