# Instrucciones para el agente: MemPalace Evolve: recuerdos separados por proyecto

Pega este texto a tu agente (Claude Code, Codex, OpenCode, Hermes o el que uses) y dile «ayúdame a montarlo». Son los pasos para ponerlo en marcha; el porqué de cada pieza está en la guía completa.

- Dificultad: intermedio
- Proyecto: https://github.com/a2328275243/mempalace-evolve (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/mempalace-evolve

---

## Para el agente: cómo acompañar al usuario

1. Pregunta primero para qué lo quiere. Si su objetivo no necesita algún paso, sáltalo.
2. Antes de instalar, comprueba lo que ya tiene (versiones, claves, sistema operativo).
3. Avanza un paso cada vez: explica en una frase qué vas a hacer y deja que el usuario lo ejecute o lo apruebe.
4. Tras cada paso, comprueba que funcionó antes de seguir. Si falla, para y explica el error.
5. No inventes comandos ni opciones: si la documentación del proyecto contradice estos pasos, manda la documentación.
6. Al terminar, haz una prueba real con el objetivo del usuario y dile dónde profundizar.

---

## Pasos de configuración

### Paso 1: prepara el entorno

Comprueba que el entorno de instalación usa Python ≥3.10 con pip y venv y que Git está disponible. En macOS/Linux crea y activa un entorno con `python -m venv .venv` y `source .venv/bin/activate` antes de instalar. Elige un directorio persistente y un identificador `wing` distinto para la prueba de cada proyecto o usuario; conserva los mismos al guardar y consultar.

### Paso 2: sigue la instalación oficial

```bash
git clone https://github.com/a2328275243/mempalace-evolve.git
cd mempalace-evolve
pip install -e ".[api,mcp]"
mempalace doctor
```

## Comprobación

Desde la raíz clonada ejecuta `python examples/sdk_basic.py` para probar el SDK. Crea `./demo-memory` con el ámbito `my_project`; debe imprimir recuerdos sobre JWT y relaciones del grafo de `api` con FastAPI y PostgreSQL, además del informe de evolución. Para MCP copia la configuración oficial con `mempalace-mcp`, elige MEMPALACE_PATH y MEMPALACE_WING y reinicia el cliente. Guarda y recupera un hecho en el mismo wing.

## Si algo falla

No conectes el cliente hasta que doctor confirme lectura, escritura y grafo. Si no recuerdas un dato, compara la ruta y el wing usados al guardarlo y al consultarlo.

[Fuente de los comandos y del procedimiento](https://github.com/a2328275243/mempalace-evolve#readme).