Zecher guarda decisiones, lecciones y traspasos de sesión en archivos simples entre sesiones y proyectos. Instalación, detección del cerebro, ocho ejemplos, salidas, comandos de la CLI y límites.
Un asistente de IA empieza cada sesión sin saber nada de ayer. El pack Memory lo resuelve con simples archivos Markdown: qué se decidió y por qué, qué salió mal, qué patrones funcionaron, en qué punto está el proyecto y una nota de traspaso al final de cada sesión. Zecher es el agente que mantiene esos archivos: los consolida, recorre tu máquina en busca de proyectos, reconstruye el contexto de una sesión en frío y comprueba la salud de la memoria. Hay dos niveles de memoria, uno por proyecto y otro compartido entre proyectos (un cerebro global).
El pack está empaquetado en .agents/skills/pack-memory/: el orquestador memory-orchestrator.md, el agente zecher-agent.md, dos documentos compartidos (shared/memory-protocol.md y shared/karpathy-guardrails.md) y plantillas para decisions.md, lessons.md, patterns.md, context.md, session-handoff.md e identity.yaml. Al instalar, también crea la memoria de tu proyecto y la enlaza a un cerebro; si no se encuentra ninguno, se crea un cerebro global nuevo en ~/.bmad-plus/brain/, fuera del proyecto. Si ese paso falla, la instalación continúa.
identity.yaml, decisiones, lecciones y patrones comunes a los proyectos, stack-preferences.md, projects/<hash>.yaml y projects-index.md
Cerebro de cartera
_brain/ en el proyecto o en una carpeta superior
Tu propia organización de notas; tiene prioridad sobre el cerebro global y conserva sus convenciones
La regla de oro: lo que afecta a un solo proyecto va a la memoria del proyecto; lo que afecta a dos o más proyectos es candidato al cerebro global, y solo con tu aprobación.
La variable de entorno BMAD_PLUS_BRAIN, si apunta a una carpeta, prevalece sobre las demás opciones.
Una carpeta _brain/ en el proyecto o en cualquier carpeta superior (un cerebro de cartera).
El cerebro global ~/.bmad-plus/brain/, solo si ya existe (se completan los archivos que faltan, no se sobrescribe nada).
La carpeta de memoria propia de Claude ~/.claude/memory/, solo si no está vacía; se enlaza, no se copia.
Si no se encuentra nada: se crea un cerebro global nuevo en ~/.bmad-plus/brain/ (con identity.yaml, los tres archivos de notas compartidos y projects/) y se enlaza.
.agents/memory/.brain-link registra qué cerebro se enlazó
brain_type vale portfolio (un _brain/ de espacio de trabajo o la variable de entorno), bmad-global (~/.bmad-plus/brain) o claude-memory (~/.claude/memory). Un cerebro de cartera conserva su propia organización: los agentes leen primero su punto de entrada y no crean identity.yaml ni projects/ dentro sin que se les pida.
Ejecútalo una vez tras instalar y de nuevo cuando añadas proyectos.
En tu asistente de IA
Zecher, escanea los proyectos de ~/dev
Lo que deberías obtener Zecher encuentra las raíces de proyecto por archivos marcadores (package.json, Cargo.toml, go.mod, .git y otros), omitiendo node_modules, vendor, dist y similares, y muestra una tabla de proyecto, stack, estado (activo bajo 30 días, en pausa de 30 a 180, archivado más allá), si BMAD+ está instalado y el último cambio. En cada fila eliges confirmar, editar, omitir o instalar BMAD+; solo los proyectos confirmados se escriben en ~/.bmad-plus/brain/projects/<hash>.yaml y en el legible projects-index.md.
Úsalo al comenzar una sesión, en un proyecto que llevas tiempo sin tocar.
En tu asistente de IA
Zecher, ¿dónde nos quedamos?
Lo que deberías obtener Zecher lee .agents/memory/context.md, el último traspaso en .agents/memory/sessions/, la entrada del proyecto en el cerebro global, los últimos diez commits de git y AGENTS.md o CLAUDE.md, y da un breve «estado del proyecto»: qué es, su stack, en qué se trabajó por última vez, las preguntas abiertas de la sesión anterior, los problemas conocidos y las lecciones.
Úsalo antes de parar. «Traspaso» no es una de las frases fijas de Zecher, así que describe qué quieres registrar y pide tú mismo la distinción entre lo hecho y lo planificado.
En tu asistente de IA
Zecher, actualiza la memoria de este proyecto con los cambios y comprobaciones realmente hechos. Separa lo implementado, probado, publicado y aún pendiente. Registra las decisiones y las evidencias útiles, archiva las notas reemplazadas sin borrarlas y escribe un prompt corto para la próxima sesión. Mantén la memoria en este proyecto y excluye los secretos.
Lo que deberías obtener Zecher actualiza context.md, escribe un archivo de traspaso fechado .agents/memory/sessions/YYYY-MM-DD-<topic>.md y un prompt de reanudación. La plantilla de traspaso (session-handoff.md) tiene los apartados What changed, Decisions made, Open questions, Next steps y Files modified; la separación entre implementado, probado, publicado y pendiente, y el prompt de reanudación que nombra la próxima tarea sin terminar, vienen de tu petición, no de la plantilla. Nunca se destruyen entradas: las reemplazadas se archivan.
Úsalo cuando las notas pueden haberse alejado del código.
En tu asistente de IA
Zecher, comprobación de salud
Lo que deberías obtener Un informe: si los archivos de memoria existen y están bien formados, las decisiones aún activas tras más de 90 días (a revisar), las lecciones que se repiten (y por tanto no se aprendieron) y estadísticas como entradas por archivo y fechas de última actualización.
No se cambia nada hasta que apruebes cada propuesta.
En tu asistente de IA
Zecher, consolida la memoria
Lo que deberías obtener Tres fases. Auditoría: Zecher lee cada archivo de memoria y nota de sesión. Propuesta: informa de cuántos duplicados, entradas obsoletas y candidatos a promoción encontró y te pide aprobar cada cambio. Ejecución: las fusiones aprobadas conservan la versión más rica, las entradas obsoletas pasan al final con el prefijo [ARCHIVED] y las promociones aprobadas van al cerebro global.
Úsalo antes de volver a decidir algo: contrasta decisiones, lecciones, patrones y notas de sesión.
En tu asistente de IA
Zecher, ¿qué decidimos sobre la estrategia de autenticación y qué salió mal la última vez?
Lo que deberías obtener Una respuesta extraída de los archivos de memoria contrastando decisiones, lecciones, patrones y notas de sesión. Las reglas de Zecher piden fechas ISO y enlaces entre una lección y la decisión a la que se refiere. Comprueba las entradas que cita: si las notas no dicen nada del tema, un asistente aún puede rellenar el hueco, así que pídele que nombre su fuente.
Úsalo cuando una lección se confirmó en un segundo proyecto. Zecher siempre pregunta antes de mover nada.
En tu asistente de IA
Zecher, promueve la lección «nunca ejecutar migraciones al arrancar» de este proyecto al cerebro global.
Lo que deberías obtener Zecher muestra la entrada y el archivo de destino y espera tu aprobación, y entonces la mueve al lessons.md global. Si tu cerebro es de cartera, el traslado sigue su propia gobernanza y convenciones en lugar de la organización global.
Avanzado: solo después de que una tarea de Nexus se verificó de forma independiente y se aceptó. Registra la procedencia; no prueba que la nota causara el éxito.
En tu asistente de IA
Zecher, registra que la lección bajo «Cache invalidation» en .agents/memory/lessons.md se aplicó a la tarea de Nexus aceptada cache-fix del run small-change. Escribe el archivo de observación, ejecuta bmad-plus mem observe con él y luego muestra bmad-plus mem outcomes.
Lo que deberías obtener El JSON de observación nombra el run, la tarea, una sección de memoria (archivo y encabezado), sus rutas de alcance y tu interpretación. mem observe escribe un recibo en .bmad/memory/outcomes.ndjson (no en el diario de eventos); mem outcomes lista los recibos aún elegibles, excluyendo los obsoletos, reemplazados o contradichos. Un mem recall --ranking evidence posterior da un impulso acotado a la evidencia elegible; la recuperación léxica por defecto no cambia.
En el proyecto: .agents/memory/ (los cuatro archivos Markdown, sessions/, .brain-link) y, para el diario de la CLI, .bmad/memory/journal.ndjson y .bmad/memory/pattern-scores.json, además de .bmad/memory/outcomes.ndjson para los recibos de resultado.
En tu carpeta personal, solo si se usa el cerebro global: ~/.bmad-plus/brain/ con identity.yaml, notas compartidas y el índice de proyectos.
Reinstalar o actualizar nunca sobrescribe decisions.md, lessons.md ni patterns.md y nunca borra sessions/.
Solo Node.js 20. La memoria son archivos locales: el pack no abre ninguna conexión de red y no tiene flujo propio fuera de la máquina. Un servicio de recuperación vectorial o RAG es un añadido opcional, local y desplegado por separado que no forma parte del paquete npm, y --provision-python no lo instala; la memoria en Markdown y el escáner funcionan sin él. Lo que tu asistente lee de la memoria va a su modelo como cualquier otro contexto, así que deja los secretos fuera de las notas.
El pack aporta instrucciones y archivos que tu asistente debe seguir. No se instala ningún gancho al inicio ni al final de una sesión, así que una sesión que termina sin turno de agente no tiene traspaso garantizado. Pide el traspaso antes de parar.
Nota· Profundidad del escaneo
El comando bmad-plus scan recorre 4 niveles por defecto (--depth <n> lo cambia). Cuando pidas un escaneo a Zecher en el chat, indica la profundidad que quieres para obtener el mismo resultado.
Nota· La memoria no es una prueba
Las notas son contexto que contrastar con el código actual, no hechos. Los registros de resultado vinculan una nota con una tarea aceptada; no muestran que la nota mejorara los resultados del asistente, y la mera persistencia tampoco.
Nota· Procedencia
La arquitectura de la memoria se inspira en el enfoque de notas de cartera del autor. Las cuatro barreras de comportamiento (pensar antes de programar, simplicidad primero, cambios quirúrgicos, ejecución guiada por objetivos) se adaptan de un proyecto comunitario de pautas inspiradas en Karpathy; véase THIRD-PARTY-LICENSES.md.