# 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.

Canonical: https://bmad-plus.rochetta.fr/es/docs/reference/cli-memory/
Language: es
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT

Documentación de BMAD+ › [Referencia](https://bmad-plus.rochetta.fr/es/docs/reference/) › bmad-plus memory

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.

<a id="synopsis"></a>
## Sinopsis

**En la terminal de tu proyecto**

```sh
npx bmad-plus memory [status] [-d <path>] [-l <code>]
npx bmad-plus memory export [-d <path>] [-l <code>]
```

**Argumentos y opciones de memory**

| Opción | Argumento | Por defecto | Qué hace |
| --- | --- | --- | --- |
| `[subcommand]` | `status` o `export` | `status` | `status` 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>` | ruta | carpeta actual | Carpeta 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, it | ninguno | Se acepta por coherencia con los demás comandos. El informe siempre se imprime en inglés. |

<a id="reads-writes"></a>
## Qué lee y qué escribe

**Acceso a archivos de memory**

| Subcomando | Lee | Escribe |
| --- | --- | --- |
| `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. |
| `export` | El 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.

<a id="exit-codes"></a>
## Códigos de salida

**Códigos de salida de memory**

| Código | Significado |
| --- | --- |
| 0 | El 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. |

<a id="real-output"></a>
## 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)

```text
$ 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)

```text
$ 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.

<a id="errors"></a>
## Errores y qué hacer

**Mensajes que imprime memory**

| Mensaje | Causa | Qué 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    ✗ missing` | Un 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. |

<a id="examples"></a>
## Ejemplos

<a id="example-cli-memory-status"></a>
### 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**

```text
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.

<a id="example-cli-memory-export"></a>
### 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**

```text
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**

- [mem: recuerdo y diario](https://bmad-plus.rochetta.fr/es/docs/reference/cli-mem/)
- [scan: indexar tus proyectos en el cerebro](https://bmad-plus.rochetta.fr/es/docs/reference/cli-scan/)
- [install: añadir el pack Memory](https://bmad-plus.rochetta.fr/es/docs/reference/cli-install/)
- [Estructura del proyecto](https://bmad-plus.rochetta.fr/es/docs/reference/project-layout/)
- [Solución de problemas](https://bmad-plus.rochetta.fr/es/docs/faq/troubleshooting/)

[Documentación de BMAD+](https://bmad-plus.rochetta.fr/es/docs/) · [Referencia](https://bmad-plus.rochetta.fr/es/docs/reference/)

[Código en GitHub](https://github.com/lrochetta/BMAD-PLUS)