TheElephantCoder/memory-sync

Sincronización de memoria

Mantiene las sesiones para que no comiencen en frío.

Estructura

memory/
  MEMORY.md        # curado, siempre cargado, mantener por debajo de 8k
  SOUL.md          # quién es el agente
  USER.md          # quién eres tú
  sessions/        # notas sin procesar por sesión, limpiadas después de ~30d
  decisions/       # ADR cortos
  tiers/
    hot.md         # siempre cargado
    warm.md        # cargado por palabra clave
    cold/          # solo lectura explícita

Ciclo de vida

Inicio: leer MEMORY.md y tiers/hot.md. Opcionalmente warm.md si la tarea coincide. No leer sessions/ a menos que estés investigando el historial. Debería tardar menos de 15s en total.

Fin: ejecutar harness memory sync o dejar que el hook de salida lo haga. Destila el registro de la sesión en MEMORY.md, poda lo antiguo y agrega un ADR si tomaste una decisión real.

Consejos

• MEMORY.md se cura, no es solo anexar. Mantenlo por debajo de 8k tokens, edita quirúrgicamente.
• Si consideraste 2 o más enfoques y elegiste uno, escribe un decisions/ADR-###.md corto.
• No hay secretos en la memoria, de todas formas se redactan.

Comandos:

harness memory show
harness memory edit
harness memory prune --dry-run
harness memory sync --auto