Memoria
Un sistema de gestión del conocimiento basado en el sistema de archivos donde el código fuente ES la memoria. Almacena decisiones, patrones y contexto en archivos Markdown estructurados.
Cuándo usar
- Registrar decisiones arquitectónicas
- Documentar patrones descubiertos durante el desarrollo
- Guardar contexto sobre por qué algo se construyó de cierta manera
- Seguimiento de problemas conocidos y soluciones alternativas
- Almacenar documentación de API o notas de integración
Cuándo NO usar
- Notas de depuración temporales (usar comentarios)
- Seguimiento de tareas (usar issues de git o tablero de proyecto)
Principios fundamentales
- El código fuente es la única fuente de verdad
- Almacena el conocimiento cerca de donde se usa
- Usa Markdown estructurado para mantener consistencia
- Mantén archivos enfocados (un tema por archivo)
Ubicaciones de almacenamiento
| Tipo | Ubicación | Ejemplo |
|---|---|---|
| Documentación técnica | docs/technical/ | Decisiones arquitectónicas, patrones |
| Documentación de características | docs/features/ | Especificaciones de características, requisitos |
| Documentación de API | docs/api/ | Contratos de API, notas de integración |
Operaciones de memoria
Recordar (Escribir)
Almacena nuevo conocimiento:
# [Título del tema]
## Contexto
[Por qué existe, qué problema resuelve]
## Decisión
[Qué se decidió y por qué]
## Detalles
[Detalles técnicos, ejemplos de código]
## Referencias
- [Archivos relacionados o URLs]
---
*Creado: [fecha]*
*Última actualización: [fecha]*
Recuperar (Leer)
Recupera conocimiento:
- Revisa la estructura del directorio
docs/ - Lee los archivos relevantes
- Busca palabras clave en los documentos
Actualizar
Modifica conocimiento existente:
- Lee el archivo existente
- Actualiza la sección correspondiente
- Agrega al historial de evolución si es significativo
Habilidades relacionadas
| Habilidad | Cuándo encadenar |
|---|---|
| feature-dev | Almacenar decisiones arquitectónicas durante el desarrollo |
| planning | Documentar el plan para referencia futura |