bmad+
Menú
ESElegir idioma
Empezar
Explorar la documentación

bmad-plus memory

Consultar la salud de la memoria del proyecto y del cerebro global, y exportar el cerebro global a un único archivo Markdown. Opciones, lecturas y escrituras, salida, códigos de salida y errores.

En esta página
  1. Sinopsis
  2. Qué lee y qué escribe
  3. Códigos de salida
  4. Leer la salida
  5. Errores y qué hacer
  6. Ejemplos

BMAD+ guarda dos tipos de memoria en archivos Markdown sencillos. La memoria del proyecto vive en .agents/memory/ dentro de tu proyecto (decisiones, lecciones, patrones, el contexto actual y una nota de traspaso por sesión). El cerebro global vive en ~/.bmad-plus/brain y lo comparten todos tus proyectos. bmad-plus memory responde a «¿está en buen estado mi memoria?» con un informe de solo lectura, y puede copiar el cerebro global a un archivo portátil. Es para quien instaló el pack Memory (el agente Zecher) y quiere comprobarlo o hacer una copia de lo que sabe el cerebro.

Sinopsis

En la terminal de tu proyecto
npx bmad-plus memory [status] [-d <path>] [-l <code>]
npx bmad-plus memory export [-d <path>] [-l <code>]

Argumentos y opciones de memory
OpciónArgumentoPor defectoQué hace
[subcommand]status o exportstatusstatus imprime el informe de salud; export escribe el cerebro global en un archivo de la carpeta del proyecto. Cualquier otro valor imprime un error.
-d, --directory <path>rutacarpeta actualCarpeta del proyecto: de donde se lee .agents/memory/ y donde se escribe el archivo de exportación.
-l, --lang <code>en, fr, es, de, pt-br, ru, zh, he, ja, itningunoSe acepta por coherencia con los demás comandos. El informe siempre se imprime en inglés.

Qué lee y qué escribe

Acceso a archivos de memory
SubcomandoLeeEscribe
status.agents/memory/decisions.md, lessons.md, patterns.md, context.md, sessions/*.md, .brain-link; en el cerebro global identity.yaml, decisions.md, lessons.md, patterns.md, projects/*.yaml, projects-index.md.Nada.
exportEl cerebro global: identity.yaml, decisions.md, lessons.md, patterns.md y cada projects/*.yaml.bmad-brain-export-<YYYY-MM-DD>.md en la carpeta del proyecto (se reemplaza si ya existe ese día).

Dos detalles importan. Primero, el informe siempre inspecciona el cerebro global en ~/.bmad-plus/brain, aunque tu proyecto esté enlazado a otro cerebro (una carpeta _brain/ en un directorio superior, la variable BMAD_PLUS_BRAIN); el enlace aparece en la línea «Linked brain». Segundo, export no toca la memoria del proyecto, solo el cerebro global. Una «entrada» en los recuentos es una línea que empieza por ### en el archivo Markdown.

Códigos de salida

Códigos de salida de memory
CódigoSignificado
0El comando llegó hasta el final. Incluye un subcomando desconocido y una exportación sin cerebro global: ambos imprimen una línea de error pero no fijan un código de fallo, así que no uses memory como puerta de CI.

Leer la salida

La puntuación de salud es la parte de comprobaciones superadas sobre diez como máximo. Para la memoria del proyecto las cinco comprobaciones son: existen decisions.md, lessons.md, patterns.md y context.md, y sessions/ contiene al menos un traspaso .md. Para el cerebro global: existen identity.yaml, decisions.md, lessons.md, patterns.md y la carpeta projects/. Una parte no instalada queda fuera de la puntuación en lugar de contar como cero. Verde desde el 80 %, amarillo desde el 50 %.

memory status (valores ilustrativos)Simulado
npx bmad-plus memory status
Project Memory (/home/ana/shop)
  decisions.md     ✓  3 entries  2026-10-12
  lessons.md       ✓  1 entries  2026-10-02
  patterns.md      ✓  0 entries  2026-09-30
  context.md       ✓  2026-10-17
  sessions/        ✓  2 handoff(s)
  Linked brain: /home/ana/.bmad-plus/brain
Global Brain (/home/ana/.bmad-plus/brain)
  identity.yaml    ✓
  decisions.md     ✓  0 entries
  lessons.md       ✓  0 entries
  patterns.md      ✓  0 entries
  projects/        ✓  1 project(s) indexed
  projects-index   ·
Health: 100% (10/10 checks)
Done!

Transcripción ilustrativa, no capturada de una ejecución real. Fuente: tools/cli/commands/memory.js (rama status, plantillas de mensajes); los números y las rutas son inventados

memory export (ruta ilustrativa)Simulado
npx bmad-plus memory export
Brain exported to: /home/ana/shop/bmad-brain-export-2026-10-18.md
Done!

Transcripción ilustrativa, no capturada de una ejecución real. Fuente: tools/cli/commands/memory.js (rama export, plantilla de mensaje); la ruta es inventada

Nota Revisa antes de compartir la exportación

La exportación copia tal cual tus decisiones y lecciones globales y tus fichas de proyecto, además de identity.yaml (tu nombre y tu idioma). Léela antes de enviarla a alguien o de hacer commit.

Errores y qué hacer

Mensajes que imprime memory
MensajeCausaQué hacer
Not installed. Run: npx bmad-plus install (select Memory pack)No hay carpeta .agents/memory/ en el proyecto.Instala el pack Memory: npx bmad-plus install --packs memory.
Not initialized. Run: npx bmad-plus install (select Memory pack)No hay carpeta ~/.bmad-plus/brain en esta máquina.Instala el pack Memory en cualquier proyecto; crea el cerebro global salvo que encuentre otro cerebro al que enlazar.
Global brain not found. Nothing to export.La exportación solo mira ~/.bmad-plus/brain.Haz la instalación anterior, o usa scan para empezar a llenar el cerebro.
Unknown subcommand: <name>Cualquier cosa distinta de status o export.Usa status o export. Para recordar y para el diario usa mem.
identity.yaml ✗ missingUn cerebro global sin su archivo de identidad (un «medio cerebro»).Vuelve a ejecutar la instalación del pack Memory; completa los archivos que faltan y nunca sobrescribe los existentes.

Ejemplos

Comprobar la salud de tu memoria

El pack Memory está instalado y quieres saber qué falta antes de fiarte de él.

En tu asistente de IA
Ejecuta `bmad-plus memory status` en este proyecto y dime qué archivos de memoria faltan o están vacíos.

Lo que deberías obtener El comando imprime un bloque para la memoria del proyecto y otro para el cerebro global. Cada archivo muestra una marca o una cruz, su número de entradas ### y su fecha de última modificación, sessions/ indica el número de traspasos, y la última línea da el porcentaje de salud con el número de comprobaciones superadas. No se cambia nada en el disco.

Hacer una copia del cerebro global

Vas a reinstalar tu máquina y quieres una copia legible de lo que contiene el cerebro.

En tu asistente de IA
Exporta mi cerebro global con `bmad-plus memory export` y dime dónde está el archivo.

Lo que deberías obtener Se escribe un archivo llamado bmad-brain-export-<date>.md en la carpeta del proyecto. Empieza por # BMAD+ Brain Export y la hora de exportación, luego una sección por archivo global (identity.yaml, decisions.md, lessons.md, patterns.md) dentro de un bloque de código, y después una sección Projects con una ficha YAML por proyecto indexado. El comando imprime la ruta completa.

Véase también