Seis personas de un equipo de software revisando juntas una decisión de arquitectura en una pizarra

Caso de uso: un equipo de software donde las decisiones de arquitectura dejan de perderse

7 min de lectura

Escenario simulado: seis personas con Claude Code y Cursor, decisiones de arquitectura que se pierden y una memoria compartida por MCP, con cifras ilustrativas.

por Equipo MemoryFirst

Índice del artículo
  1. La semana en que tres agentes implementaron tres reintentos distintos
  2. Cuánto cuesta, con números ilustrativos
  3. Cómo queda montado el equipo
  4. Un día después, en el escenario
  5. Qué es gratis y qué es Pro, y dónde entra Team
  6. Límites que conviene conocer
  7. Para quién es y para quién no

Escenario simulado. Taller Norte es una empresa ficticia de seis personas que construye una plataforma de logística B2B. Todo lo que sigue es un ejemplo ilustrativo: las personas, la empresa y las cifras son inventadas, y ninguna es un resultado medido ni un cliente real. Lo que sí es real es lo que hace el producto, y lo hemos comprobado contra nuestra documentación técnica.

La semana en que tres agentes implementaron tres reintentos distintos

Marta lleva el backend con Claude Code. Iván trabaja en el worker de envíos con Cursor. Lucía toca el cliente móvil, también con un agente. En marzo, el equipo decidió en una reunión de veinte minutos que los reintentos de las llamadas a transportistas serían idempotentes y con retroceso exponencial, y que no meterían un broker de colas: usarían tablas en Postgres.

En mayo, Iván pidió a su agente que añadiera reintentos al worker. El agente no sabía nada de marzo. Propuso un broker de mensajes, la opción más razonable si no conoces el contexto. Iván aceptó. Una semana después, Lucía arregló un fallo de red en el cliente con su propio bucle de reintentos, sin retroceso. Y Marta, al revisar, tardó una tarde entera en reconstruir por qué convivían tres criterios.

Nadie hizo nada mal. La decisión existía en la cabeza de dos personas y en un hilo de chat de hace dos meses. Los agentes de programación empiezan cada sesión en frío, y un equipo de seis multiplica ese problema por seis.

Dos desarrolladores revisando un fallo mientras uno de ellos intenta recordar por qué se decidió algo

Cuánto cuesta, con números ilustrativos

Para el escenario suponemos lo siguiente, todo inventado pero verosímil:

ConceptoAntesDespués
Minutos por sesión reexplicando contexto a un agente82
Sesiones con agente por persona y día44
Decisiones de arquitectura reabiertas por error en un trimestre51
Horas de revisión por decisiones contradictorias en un trimestre226

Con seis personas, 4 sesiones al día y 6 minutos ahorrados por sesión, salen unas 2,4 horas diarias de equipo que antes se gastaban reexplicando. Es un cálculo de servilleta sobre datos supuestos: tu equipo puede tener la mitad o el triple. Lo útil del ejercicio es que obliga a medir lo tuyo durante dos semanas antes de decidir nada.

Cómo queda montado el equipo

La configuración es corta y usa piezas que existen hoy.

  1. Una memoria compartida por MCP. Cada persona conecta su cliente (Claude Code, Cursor, VS Code o ChatGPT) al servidor MCP remoto de MemoryFirst. Todas escriben en la misma memoria y cada evento queda firmado con quién lo escribió y con qué IA. En el panel, el espacio de trabajo del equipo muestra quién ha escrito hoy y cuántos eventos tiene cada persona.
  2. Hooks en Claude Code. Al arrancar una sesión, el hook pide a la memoria un resumen del proyecto (hasta unos 2.500 tokens) y lo inyecta como contexto. Al cerrarla, la transcripción se ingiere en segundo plano. El proyecto se identifica por el nombre de la carpeta.
  3. Reglas en Cursor. Cursor no tiene esos hooks: conecta por MCP y el agente usa las herramientas mf_recall, mf_query y mf_record cuando se lo indican las instrucciones del proyecto. Es menos automático, y conviene decirlo.
  4. Una norma de equipo para escribir. Un evento por decisión, no por paso. Se registra en el momento: una decisión no obvia, un bloqueo real, un despliegue importante. Con importancia 3 para negocio, clientes o incidentes de producción, 2 para decisiones técnicas relevantes.

La decisión de marzo, registrada así, tendría este aspecto: tipo decisión, título «Reintentos idempotentes con retroceso exponencial, colas en Postgres, sin broker», importancia 2, y en el cuerpo el porqué. Cuando mayo la matiza, se registra una nueva que sustituye a la anterior: la vieja deja de alimentar la recuperación, pero no se borra.

Un equipo pequeño en una reunión de pie por la mañana

Un día después, en el escenario

Iván abre una sesión con su agente y pide reintentos para el worker. Antes de proponer nada, el agente consulta la memoria con mf_query («¿qué decidimos sobre reintentos y colas?») y recibe la decisión de marzo con su cita: quién la registró, cuándo y con qué IA. Propone tablas en Postgres con retroceso exponencial. Lucía, al día siguiente, ve el mismo contexto al abrir su sesión.

Además, el parte diario del equipo (el brief de la mañana) resume qué se movió desde la última vez: decisiones nuevas, bloqueos abiertos. Es la parte que más valoran los equipos pequeños, porque sustituye a media reunión de sincronización.

Qué es gratis y qué es Pro, y dónde entra Team

  • Free: un proyecto, memoria por MCP con hooks de Claude Code, retención de 30 días y un asiento. Sirve para que una persona pruebe el flujo completo.
  • Pro: 12 € al mes con pago anual (144 € al año), o 14,40 € si pagas mes a mes. Proyectos ilimitados, retención ilimitada y todos los conectores, pero un asiento.
  • Team: 39 € al mes con pago anual (468 € al año), cinco asientos, memoria compartida del equipo y cola de bibliotecario. Cada asiento por encima de cinco cuesta 9 € al mes con pago anual (108 € al año) o 10,80 € mes a mes; un equipo de seis, como el del escenario, suma uno.

Los precios llevan IVA incluido y salen de nuestra página de precios a 14-11-2026. Revisa los planes por si han cambiado.

Límites que conviene conocer

  • La memoria depende de que se escriba. Si el equipo no registra decisiones, no hay nada que recordar. Los hooks capturan transcripciones, pero una decisión clara en un evento propio se recupera mejor que enterrada en una conversación de dos horas.
  • El agente puede no consultar. En Cursor, sobre todo, depende de que las instrucciones se lo pidan y de que el modelo las siga.
  • Aislamiento entre espacios de trabajo. Los datos de cada espacio se separan con filtros por tenant y, de forma opcional, con seguridad a nivel de fila en la base de datos. No hay base de datos física por cliente. Para un equipo interno es razonable; si necesitas más, lee memoria que puedes auditar.
  • Dónde se procesa. La base de datos, los embeddings y los ficheros originales están en la UE. Por defecto, la pregunta y los pasajes recuperados se envían a un proveedor de inferencia en EE. UU. para redactar la respuesta; puedes traer tu propia clave. No hay edición autoalojada.

Para quién es y para quién no

Es para equipos de 3 a 15 personas con agentes de programación en uso diario, donde las decisiones se toman rápido y se documentan poco. No es para quien busca un gestor de documentación (humanos escriben en otro sitio, la IA lee aquí) ni un sustituto de los ADR del repositorio: los complementa.

Si quieres entender primero el mecanismo, empieza por memoria para Claude Code y agentes de programación, y por qué los agentes empiezan en frío en cada sesión. Para conectar tu cliente, conecta memoria a cualquier agente por MCP. Y si estás comparando opciones, el mapa del mercado en 2026 las ordena por categorías.

Una desarrolladora trabajando concentrada con un cuaderno abierto a su lado

Prueba la memoria compartida con tu equipo

Empieza gratis con un proyecto y pasa a Team cuando varias personas necesiten escribir en la misma memoria.

Empezar gratis

Sigue leyendo