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
Section titled “Requisitos”- Cualquier modelo de IA compatible con prompts Markdown (Claude, Gemini, Codex…).
- Git (opcional, solo si quieres versionar tu memoria).
1. Deployment
Section titled “1. Deployment”Desde la raiz de tu proyecto, dile a tu AI agent:
Despliega memsys3 en este proyecto: descarga con curl -sL el archivohttps://raw.githubusercontent.com/iv0nis/memsys3/master/memsys3_templates/prompts/deploy.mda un fichero temporal y ejecuta sus instrucciones literalmente.El workflow es:
- Clone temporal de memsys3 desde GitHub.
- Copia de estructura a
tu-proyecto/memsys3/. - Briefing sobre tu proyecto (naturaleza, objetivos, etc.).
- Personalizacion de archivos (
project-status.yaml,newSession.md). - Compilacion inicial de
memsys3/memory/context.yaml(~3K tokens de contexto sintetizado). - 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-memsys3hace 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
Section titled “2. Trabajar con sesiones”Empezar sesion — el agent carga el contexto:
Ejecuta memsys3/prompts/newSession.mdAcabar sesion — el agent documenta lo que se hizo:
Ejecuta memsys3/prompts/endSession.mdEn harnesses con auto-expansion de
@-mentions (Claude Code, Cursor, Cline) puedes usar@memsys3/prompts/newSession.md. La forma neutra funciona en todos los harnesses.
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
Section titled “Actualizar un proyecto existente”Si ya tienes memsys3 desplegado y quieres actualizar a una version mas reciente:
Ejecuta memsys3/prompts/actualizar.mdWorkflow 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
Section titled “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 excluyesmemsys3/de git en Claude Code, los@-mentions pueden no funcionar (limitacion conocida). Solucion: invocar con instrucciones directas ("Ejecuta memsys3/prompts/newSession.md").
Siguientes pasos
Section titled “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.