Quick Start

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

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, con tu AI agent abierto, ejecuta:

@memsys3/prompts/deploy.md

El workflow es:

1. Clone temporal de memsys3 desde GitHub.
2. Copia de estructura a tu-proyecto/memsys3/.
3. Briefing sobre tu proyecto (stack, objetivos, etc.).
4. Personalizacion de archivos (project-status.yaml, newSession.md).
5. Limpieza del clone temporal.

Resultado: sistema memsys3 completamente funcional y personalizado.

2. Primer contexto

Una vez desplegado, compila el contexto inicial:

@memsys3/prompts/compile-context.md

Esto genera memsys3/memory/context.yaml, un archivo compacto (~3K tokens) con la informacion sintetizada que cualquier AI agent necesita para trabajar en tu proyecto.

3. Trabajar con sesiones

Empezar sesion — el agent carga el contexto:

@memsys3/prompts/newSession.md

Acabar sesion — el agent documenta lo que se hizo:

@memsys3/prompts/endSession.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:

@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

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