Quick Start

memsys3 se despliega ejecutando un prompt desde tu AI agent. No hay CLI, no hay instalador externo: el instalador ES tu agente — clona el repo, copia la estructura, personaliza el deployment y compila el contexto inicial.

Requisitos

• Cualquier modelo de IA compatible con prompts Markdown (Claude, Gemini, Codex…).
• Git (opcional, solo si quieres versionar tu memoria).

1. Deployment

Desde la raiz de tu proyecto, dile a tu AI agent:

Despliega memsys3 en este proyecto: descarga con curl -sL el archivo
https://raw.githubusercontent.com/iv0nis/memsys3/master/memsys3_templates/prompts/deploy.md
a un fichero temporal y ejecuta sus instrucciones literalmente.

El workflow es:

1. Clone temporal de memsys3 desde GitHub.
2. Copia de estructura a tu-proyecto/memsys3/.
3. Briefing sobre tu proyecto (naturaleza, objetivos, etc.).
4. Personalizacion de archivos (project-status.yaml, newSession.md).
5. Compilacion inicial de memsys3/memory/context.yaml (contexto sintetizado, compacto).
6. Limpieza del clone temporal.

Resultado: sistema memsys3 completamente funcional, personalizado y con el contexto inicial ya compilado. No hay pasos manuales posteriores.

Atajo (solo Claude Code, opcional): si tienes instalado el comando global, /deploy-memsys3 hace lo mismo. El @-mention (@memsys3/prompts/deploy.md) NO sirve para el primer deploy: referencia un archivo local que todavia no existe en un proyecto fresco.

2. Trabajar con sesiones

Empezar sesion — el agent carga el contexto:

Ejecuta memsys3/prompts/newSession.md

Acabar sesion — el agent documenta lo que se hizo:

Ejecuta memsys3/prompts/endSession.md

Como invocar un prompt segun tu harness

Los prompts de memsys3 son archivos Markdown dentro de memsys3/prompts/. “Ejecutar un prompt” es pedirle a tu agente que lea ese archivo y siga sus instrucciones. Cada harness tiene su forma de hacerlo:

Harness	Como invocar newSession.md
Claude Code, Cursor, Cline	@memsys3/prompts/newSession.md — escribe @ y el nombre; el harness autocompleta y pega el archivo en el prompt
Codex CLI, Gemini CLI, OpenCode, otros	Ejecuta memsys3/prompts/newSession.md — el agente lo lee con sus herramientas de archivos
Chat web sin acceso a archivos	Pega el contenido del .md en el mensaje

La forma neutra (Ejecuta memsys3/prompts/...) funciona en todos. Dos avisos:

• Justo despues del deploy, el autocompletado con @ puede no mostrar los archivos nuevos: reinicia la sesion del harness o escribe la ruta completa.
• Si tu harness admite comandos personalizados (por ejemplo .claude/commands/ en Claude Code), puedes crear atajos como /newSession. Es opcional y local a tu herramienta: ver memsys3/prompts/commands.md.

Eso es todo. A partir de aqui, cada sesion empieza con contexto completo del proyecto y termina dejando registro para la siguiente.

Actualizar un proyecto existente

Si ya tienes memsys3 desplegado y quieres actualizar a una version mas reciente:

Ejecuta memsys3/prompts/actualizar.md

Workflow seguro: backups automaticos, deteccion de estructura antigua, sustitucion diferencial de templates y preservacion total de tus datos (memory/full/, project-status.yaml, context.yaml).

Privacidad

Durante el deployment se te preguntara si quieres excluir memsys3/ del control de versiones. Recomendado si tu memoria contiene decisiones internas, gotchas o informacion sensible.

Workaround @-mentions: si excluyes memsys3/ de git en Claude Code, los @-mentions pueden no funcionar (limitacion conocida). Solucion: invocar con instrucciones directas ("Ejecuta memsys3/prompts/newSession.md").

Siguientes pasos

• Tutorial — el ciclo completo con las manos, en un terminal simulado.
• Principios — los 10 principios sistemicos, empezando por Anti-CDC.
• Conceptos — agentes, archivos y mecanismos de proteccion.
• Workflow — flujo dia a dia.
• Repositorio — codigo fuente y releases.