Persistia: actualiza el contexto del proyecto con Git

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/bernardohcrocha/persistia-for-claude-code (licencia MIT)
• Guía completa: https://lab.wisd.ai/hub/persistia-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: comprueba los requisitos

Comprueba que Claude Code puede abrir un proyecto desechable, sin datos sensibles ni CLAUDE.md, que Git, curl, Bash y Node.js ≥18 están disponibles y que tu sistema usa launchd (macOS) o systemd (Linux). Lee setup.sh y revisa qué instrucciones y tareas programadas añadirá antes de ejecutarlo.

Si tu proyecto ya tiene CLAUDE.md, el instalador lo omite: no descarga ni fusiona el protocolo. Compara la plantilla oficial e integra conscientemente los protocolos de sesión y Bootstrap, manteniendo las reglas del proyecto. No repitas el instalador para intentar fusionarlos. Si no puedes integrarlos sin conflictos, detente y explica qué falta antes de probar la memoria.

Paso 2: instalación según el README

Desde Claude Code abierto en la raíz del proyecto de prueba, usa el comando del README:

curl -fsSL https://raw.githubusercontent.com/bernardohcrocha/persistia-for-claude-code/main/setup.sh | bash

Comprobación

Revisa que CLAUDE.md contiene el protocolo que lee _brain/index.md al iniciar cada sesión y el Bootstrap que se activa con SETUP_STATUS: incomplete. Un índice descargado todavía no acredita memoria activa.

Abre una sesión nueva de Claude Code en la raíz, confirma que carga esas instrucciones, completa la exploración y la entrevista inicial, y comprueba que _brain/index.md pasa a SETUP_STATUS: complete con enlaces a archivos reales del proyecto. Si no arranca el protocolo, detente y revisa su integración.

En un documento de prueba ya indexado, anota «La entrega de ensayo es el martes». Comprueba que el índice permite llegar al archivo de memoria que recoge esa decisión. Después cambia el documento a «La entrega de ensayo es el jueves», guarda el cambio en Git y cierra la sesión. Inicia otra desde la misma raíz y pide la fecha de entrega de ensayo sin dársela en el mensaje. Revisa que consulta las diferencias de Git y actualiza el archivo de memoria correspondiente; debe responder jueves y citar la fuente. Si responde martes o no actualiza la memoria, la prueba falla aunque exista el índice. Distingue esa actualización interactiva de una que haya ejecutado el programador de tareas.

Si algo falla

Consulta ARCHITECTURE.md si el respaldo o las diferencias de Git no corresponden al proyecto. Revisa también las tareas programadas antes de atribuir una actualización a la sesión interactiva.

Procedimiento oficial.