Skip to content
memsys3

Workflow

El uso real de memsys3 gira en torno a tres prompts ejecutados desde tu AI agent. No hay CLI ni dashboard: todo son @-mentions a archivos Markdown.

El ciclo basico

Section titled “El ciclo basico”
@memsys3/prompts/newSession.md   →   trabajas   →   @memsys3/prompts/endSession.md

1. Empezar sesion

Section titled “1. Empezar sesion”
@memsys3/prompts/newSession.md

El Main Agent:

  1. Lee README.md del proyecto.
  2. Lee memsys3/memory/project-status.yaml (estado actual).
  3. Lee memsys3/memory/context.yaml (memoria sintetizada).
  4. Lee memsys3/agents/main-agent.yaml (restricciones).
  5. Te resume el estado y pregunta por donde empezar.

2. Trabajar

Section titled “2. Trabajar”

Desarrollo normal. El agent ya tiene contexto completo: features operativas, decisiones tomadas, pendientes prioritarios, gotchas.

3. Acabar sesion

Section titled “3. Acabar sesion”
@memsys3/prompts/endSession.md

El Main Agent:

  1. Documenta lo hecho en sessions.yaml.
  2. Actualiza project-status.yaml.
  3. Canoniza gotchas y feedback aprendidos (defensa anti-CDC).
  4. Sugiere si conviene recompilar contexto.

Ciclos auxiliares

Section titled “Ciclos auxiliares”

Recompilar contexto

Section titled “Recompilar contexto”

Cuando sessions.yaml ha crecido o han pasado varias sesiones:

@memsys3/prompts/compile-context.md

El Context Agent regenera context.yaml desde cero aplicando criterio inteligente.

Gestionar decisiones (ADRs)

Section titled “Gestionar decisiones (ADRs)”
@memsys3/prompts/adr.md

Crear, consultar o actualizar Architecture Decision Records.

Gestionar trabajo futuro (Backlog)

Section titled “Gestionar trabajo futuro (Backlog)”
@memsys3/prompts/backlog.md

3 operaciones: consultar, crear y actualizar items (ISSUE-XXX, FEATURE-XXX, etc.).

Operaciones git

Section titled “Operaciones git”

Antes de cualquier commit/push/tag, el agent debe leer:

@memsys3/prompts/github.md

Define convenciones obligatorias (sin firma Co-Authored-By por defecto, confirmacion de tags via AskUserQuestion, verificacion post-commit).

Actualizar memsys3

Section titled “Actualizar memsys3”

Para actualizar memsys3 en un proyecto existente:

@memsys3/prompts/actualizar.md

Workflow seguro: backups, deteccion de estructura antigua, sustitucion diferencial de templates, preservacion total de datos.

Buenas practicas

Section titled “Buenas practicas”
  • Empieza cada sesion con newSession — evita que el agent pierda contexto.
  • Termina cada sesion con endSession — incluso si fue corta. La canonizacion anti-CDC vive aqui.
  • Recompila contexto cuando notes drift — si el agent olvida cosas que documentaste, compile-context es la solucion.
  • Confia en los archivos canonicos — si una decision no esta en adr.yaml, no existe para el sistema.

Mas informacion

Section titled “Mas informacion”