Skills y memorias: cómo Claude Code deja de olvidar

La sesión se cayó y perdí tres semanas de contexto justo antes de coger el avión a Milán. Cuando volví cuatro días después, tenía dos horas para reconstruir dónde había dejado todo antes de una llamada de cliente. Lo que me salvó no fue memoria en sentido humano, ni el historial de chat. Fueron cien archivos markdown pequeños y una docena de skills versionadas.

Esta es la parte de trabajar con IA de la que nadie tuitea. No el modelo, no el prompt, no el agente. El cuaderno. Lo que el modelo lee antes de leer tu mensaje.

Lo que hacíamos antes

Antes, cada conversación con una IA empezaba desde cero. Abrías el chat, pegabas los archivos relevantes, volvías a explicar quién era el cliente, qué versión de Odoo estaba en producción, por qué el último parche tenía que tener esa forma. Veinte minutos recargando contexto antes de cualquier trabajo real. Y en cuanto el chat se cerraba — por accidente, por desbordamiento, por un fallo de red — todo eso se perdía. Otra vez.

Los consultores senior de cualquier disciplina han convivido siempre con esto a base de cuadernos, wikis, archivos de proyecto. Los buenos pasan media semana escribiendo cosas para que la otra media puedan ir rápido. Con Claude Code simplemente hicimos el cuaderno nativo: dos capas de contexto persistente que la IA carga automáticamente antes de cada sesión.

Capa uno: memorias

Las memorias son el cuaderno desestructurado. Un archivo markdown por aprendizaje, todos en una misma carpeta, indexados por un archivo llamado MEMORY.md que la IA lee al principio de cada conversación.

Una memoria típica tiene esta pinta:

---
name: livekit-sip-zadarma
description: Tres bugs que nos comimos el primer día del despliegue de María
type: feedback
---

Conectando livekit-sip con un trunk Zadarma detrás de NAT doméstico:

1. status=486 reason="flood" NO significa que te hayan limitado.
   Significa que el INVITE entrante no encajó con ningún trunk
   y la política es Drop. Fix: el trunk debe filtrar por IP origen,
   no por número.
2. nat_1_to_1_ip Y media_nat_1_to_1_ip son ambos obligatorios.
   use_external_ip es mutuamente excluyente — elige uno.
3. El usuario del SIP URI de Zadarma NO tiene que ser el número
   de teléfono. Filtrar por él en cualquier punto produce drops
   silenciosos.

Ese archivo tardó quince minutos en escribirse el día que me costó tres horas de debug. No me volverá a costar tres horas en ningún proyecto, nunca — no porque vaya a acordarme (no me acordaré), sino porque la IA lo lee cada vez que toco un problema de SIP.

Tenemos cien de estas. Algunas son duraderas: cómo desplegar módulos Odoo en producción sin romper traducciones, cuál es el régimen legal de un autónomo en España, cómo cablear una pasarela de pago en contexto es_ES. Otras son efímeras: con quién estoy trabajando esta semana, qué prefiere un cliente concreto en sus tickets de TPV, dónde vive la clave SSH de un contenedor específico.

La disciplina es pequeña pero real: cada vez que la IA y yo resolvemos un problema que costó más de media hora, uno de los dos escribe una memoria de feedback. La siguiente vez, ninguno de los dos tiene que recordarlo conscientemente — el cuaderno lo entrega en el momento justo.

Capa dos: skills

Las skills son la capa estructurada. Donde las memorias son "lo que aprendimos", las skills son "cómo trabajamos". Una skill es un paquete pequeño de archivos — un manifiesto, un punto de entrada, referencias — que enseña a la IA un dominio completo: cómo desplegar un contenedor Odoo, cómo auditar un proyecto de ingeniería ICT, cómo hablar al teléfono como la recepcionista de Lemon Tree Cloud.

Mantenemos unas treinta skills hoy. Unas cuantas ilustran el rango:

• oca-expert — conoce los 2.985 addons OCA disponibles para Odoo 16. Cuando un cliente pregunta "¿hay un módulo para X?", la IA invoca esta skill y responde en segundos.
• oci-creator — sabe desplegar un contenedor Odoo nuevo en Proxmox con la localización correcta, la configuración fiscal correcta, el checklist post-deploy correcto. Cliente nuevo en un vertical nuevo en un día, no una semana.
• voip-expert — el manual técnico de cualquier agente de voz IA entrante: trunks SIP, NAT, elección de voz/STT/TTS, grabación al CRM. Reutilizable para cualquier futuro cliente, no sólo para nosotros.
• maria-ltc — creada esta semana. La personalidad y la capa de negocio de nuestra propia agente de voz: quién es María, qué servicios vende LTC, cómo me escala un lead caliente por Telegram en mitad de una llamada. Hace pareja con voip-expert: manual técnico + identidad de negocio.

Las skills viven en git, junto al resto de nuestro código. Están versionadas, son diff-ables, son revisables como cualquier otro artefacto. Cuando mejoramos una skill, el cambio se hace visible para cada proyecto que la use — incluyendo proyectos futuros que aún no hemos empezado.

La separación entre voip-expert y maria-ltc importa. La primera es reutilizable: cualquier cliente que quiera su propio agente de voz puede adoptarla tal cual. La segunda es específica nuestra, y nunca la compartiremos. Tenerlas separadas es la diferencia entre una consultoría que revende un producto y una que construye un producto por cliente sobre un cimiento compartido.

La tercera pata: Odoo

Las memorias son lo que aprendimos. Las skills son cómo trabajamos. La tercera pata es lo que hicimos, y eso vive en Odoo.

Cada trozo de trabajo significativo — un módulo nuevo, un despliegue, una auditoría de cliente, una entrada de blog — abre una tarea en Odoo. El chatter de esa tarea recoge cada commit, cada informe, cada captura, cada nota. La IA está configurada para leer también esas tareas: cuando no conoce el estado de un proyecto, consulta Odoo, lee los últimos mensajes de chatter de la tarea relevante, y reanuda desde ahí.

Esta es la pata que convierte sesiones con IA en un negocio. Las memorias viven en una máquina de desarrollo; las skills viven en git; Odoo vive donde el cliente puede mirar, donde están las facturas, donde ingenieros, contables y María comparten la misma fuente de verdad.

La reconstrucción de dos horas

Volvamos al portátil tras Milán. La sesión estaba muerta, el historial de chat ido, las tareas en vuelo a medio terminar. Lo que hice realmente para recuperar:

1. Abrí una sesión nueva de Claude Code. La IA cargó MEMORY.md automáticamente — cinco segundos de indexación.
2. Le pregunté: "¿En qué estado estaba el proyecto voip-agent la semana pasada?". Cruzó memorias tagueadas voip-expert, la skill del mismo nombre, y las tareas Odoo abiertas en el proyecto Varios. Respuesta en menos de un minuto, con citas a archivos concretos.
3. Una de las tareas abiertas señalaba un borrador de skill de capa de negocio que habíamos discutido pero nunca construido. La construimos juntos en noventa minutos — la próxima vez que la conversación se caiga, la skill nueva ya estará en disco y en git.

Lo que no pasó: no tuve que volver a explicar la historia de los tres bugs de Zadarma. No tuve que volver a listar los servicios de LTC. No tuve que recordar bajo qué id de proyecto Odoo vivían las tareas. El cuaderno lo tenía todo.

Por qué importa para un consultor de pyme

Si vendes horas de experiencia, el peor momento de la semana es la primera media hora después de una reunión, cuando tienes que recargar el contexto de cualquier otro proyecto abierto. Si adoptas IA sin persistencia, no has automatizado nada — sólo has movido la recarga a la ventana de chat.

Si, en cambio, cada reunión termina con una memoria de una línea, cada flujo recurrente se empaqueta en una skill pequeña, y cada resultado de cliente vive en Odoo, entonces el valor de tu consultoría deja de depender de si te acuerdas de las cosas. Depende de si las escribiste. La IA hace el resto.

Para nosotros esto dejó de ser un truco de productividad y empezó a ser el producto. Vendemos consultoría IT de software libre que no cuesta lo que cuestan Salesforce o SAP — y podemos cobrar menos porque el coste de operar cada cliente baja a medida que crece el cuaderno. Cada memoria escrita es una hora futura ahorrada en cada cliente que toque ese dominio. Cada skill comiteada es una capacidad desplegable que la semana pasada no teníamos.

Si llevas una consultoría IT de cualquier tamaño, la pregunta que merece hacerse es: ¿cuál es el cuaderno de tu equipo, y está en una estantería compartida? Si está en la cabeza de cada uno, ese es el dato más caro sobre tu negocio.

Elegimos Claude Code porque el cuaderno es parte de la herramienta — no una feature que pegas encima, sino el sustrato. Pero el principio es más viejo que cualquier IA: la diferencia entre un experto y un principiante no es lo que sabe, es lo que escribió.