# Instrucciones para el agente: Claude Soul: conserva decisiones y correcciones entre sesiones

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/DomDemetz/claude-soul (licencia MIT)
- Guía completa: https://lab.wisd.ai/hub/claude-soul-memory

---

## 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: inicializa

Comprueba que usas Node.js ≥18, npm/npx y Claude Code con plan Pro o Max. Si quieres búsqueda semántica (por significado, mediante representaciones numéricas llamadas embeddings), prepara Ollama y descarga primero el modelo; el proyecto lo detecta durante la inicialización:

```bash
ollama pull nomic-embed-text
```

```bash
npx claude-soul init --starter
```

### Paso 2: conecta el contexto

Añade al archivo de instrucciones la indicación del README de llamar `soul_context()` al comenzar y utilizar `soul_reflect` para reflexión.

## Comprobación

Guarda una decisión de prueba, abre otra sesión y comprueba que se recupera correctamente. Inspecciona el estado y las correcciones antes de asumir que una tendencia ha mejorado.

## Si algo falla

Si la búsqueda semántica no funciona, verifica Ollama y su modelo de embeddings. Sin esa dependencia debe seguir disponible la búsqueda por palabras descrita por el autor.