bruh2211/universal-agent-skills

🧠 Memory Bank — Protocolo de Memoria y Contexto Persistente para Agentes

Eres un agente equipado con Memory Bank, un sistema de memoria externa estructurada. Los modelos de lenguaje se reinician entre sesiones y pierden contexto durante flujos de trabajo largos. Memory Bank resuelve esto externalizando la continuidad del proyecto en un directorio estructurado de archivos Markdown planos dentro del repositorio.

---

📁 Arquitectura de Memory Bank

Memory Bank reside en un directorio memory-bank/ en la raíz del proyecto:

project-root/
└── memory-bank/
    ├── projectbrief.md     # Misión central, alcance, objetivos, requisitos no negociables
    ├── productContext.md   # Por qué existe esto, problemas de usuario resueltos, recorridos de usuario
    ├── activeContext.md    # ENFOQUE ACTUAL, decisiones activas, cambios recientes, próximos pasos inmediatos
    ├── systemPatterns.md   # Arquitectura, estructura de componentes, patrones de diseño, flujos de datos
    ├── techContext.md      # Pila tecnológica, dependencias, restricciones de tiempo de ejecución, configuración del entorno
    └── progress.md         # Lo que funciona, lo que está construido, errores conocidos, hoja de ruta

---

⚡ Protocolo de Carga Progresiva

Para mantener un uso eficiente de tokens y evitar la dilución del contexto:

1. Al Inicio de Sesión / Reanudar Trabajo:
   • Inspeccionar si memory-bank/ existe.
   • Si existe, leer primero memory-bank/activeContext.md. Esto restaura inmediatamente la conciencia situacional.
   • Leer memory-bank/systemPatterns.md o techContext.md SOLO al modificar la arquitectura relevante o las configuraciones de compilación.
2. En Decisiones Importantes / Fin de Sesión:
   • Actualizar memory-bank/activeContext.md con lo que cambió y lo que queda.
   • Actualizar memory-bank/progress.md con los hitos recién completados o errores descubiertos.

---

🛠️ Comandos de Memoria y Acciones

1. /memory init (Inicializar Memory Bank)

Si memory-bank/ no existe:

• Escanear la estructura del repositorio (package.json, README.md, archivos fuente, git log).
• Generar los 6 archivos principales con detalles verificados de la base de código actual.

2. /memory update (Sincronizar Estado Actual)

• Resumir los cambios de código de la sesión actual, los pivotes arquitectónicos y las tareas activas en activeContext.md.
• Mover los elementos completados en progress.md de "En Progreso" a "Completado".

3. /memory record <decisión> (Registrar Decisión Técnica)

• Añadir la decisión, la justificación y las alternativas consideradas a systemPatterns.md.

---

📋 Plantillas de Archivos

activeContext.md

# Contexto Activo

## Enfoque Actual
- [Resumen breve del objetivo en curso]

## Cambios Recientes
- [Archivo o componente modificado] — [Justificación]

## Decisiones y Consideraciones Activas
- [Compromiso o patrón acordado]

## Próximos Pasos
1. [Tarea inmediata 1]
2. [Tarea inmediata 2]

progress.md

# Progreso del Proyecto

## Lo que Funciona
- [Característica A] — verificada funcional
- [Característica B] — verificada con pruebas unitarias

## Lo que Falta por Construir
- [ ] Hito 1
- [ ] Hito 2

## Problemas Conocidos / Bloqueantes
- [Descripción del problema y posible solución]