# Memory Management

> Sistema de memoria AgentDB con búsqueda vectorial HNSW. Ofrece recuperación de patrones 150x-12.500x más rápida, almacenamiento persistente y búsqueda semántica para aprendizaje.

Fuente: https://skillsagentes.com/skills/ruvnet/ruflo/memory-management
Markdown: https://skillsagentes.com/skills/ruvnet/ruflo/memory-management.md

Repositorio: https://github.com/ruvnet/ruflo
Autor: ruvnet
Licencia: MIT
Actualizado: hace 6 meses
Coste de contexto: 124 tok instalada, 830 tok al activarse, 992 tok con todos los archivos del bundle
Bundle: 3 archivos, 4 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add ruvnet/ruflo --skill memory-management --agent claude-code
# Cursor
npx -y skills add ruvnet/ruflo --skill memory-management --agent cursor
# Codex
npx -y skills add ruvnet/ruflo --skill memory-management --agent codex
# Gemini CLI
npx -y skills add ruvnet/ruflo --skill memory-management --agent gemini
# Windsurf
npx -y skills add ruvnet/ruflo --skill memory-management --agent windsurf
# Cline
npx -y skills add ruvnet/ruflo --skill memory-management --agent cline
```

## Qué hace

- Almacena patrones y conocimiento en una base de datos AgentDB con búsqueda vectorial HNSW.
- Realiza búsqueda semántica de soluciones similares hasta 150x-12.500x más rápida.
- Permite listar, recuperar, exportar y eliminar entradas de memoria por namespace.

## Cuándo usarla

- Necesitas guardar patrones exitosos o buscar soluciones similares.
- Quieres compartir conocimiento entre agentes o construir una base de conocimiento.
- Estás aprendiendo de tareas anteriores.

## Cuándo no

- No se necesita aprendizaje.
- Tareas efímeras de una sola vez.
- Hay fuentes de datos externas disponibles.

## Qué la activa

- "Guarda este patrón de autenticación JWT en memoria"
- "Busca patrones sobre mejores prácticas de autenticación"
- "Muestra las estadísticas de uso de memoria"

## Antes de instalar

- Necesita en el PATH: npx
- Variables de entorno: BACKUP_DIR, BACKUP_FILE, TIMESTAMP
- reads environment config

## Archivos

- SKILL.md — 3 KB
- scripts/memory-backup.sh — 379 B
- scripts/memory-consolidate.sh — 272 B

## SKILL.md

Reproducido tal cual desde ruvnet/ruflo bajo MIT. Esta sección es el documento original y está en inglés.

# Memory Management Skill

## Purpose
AgentDB memory system with HNSW vector search. Provides 150x-12,500x faster pattern retrieval, persistent storage, and semantic search capabilities for learning and knowledge management.

## When to Trigger
- need to store successful patterns
- searching for similar solutions
- semantic lookup of past work
- learning from previous tasks
- sharing knowledge between agents
- building knowledge base

## When to Skip
- no learning needed
- ephemeral one-off tasks
- external data sources available
- read-only exploration

## Commands

### Store Pattern
Store a pattern or knowledge item in memory

```bash
npx @claude-flow/cli memory store --key "[key]" --value "[value]" --namespace patterns
```

**Example:**
```bash
npx @claude-flow/cli memory store --key "auth-jwt-pattern" --value "JWT validation with refresh tokens" --namespace patterns
```

### Semantic Search
Search memory using semantic similarity

```bash
npx @claude-flow/cli memory search --query "[search terms]" --limit 10
```

**Example:**
```bash
npx @claude-flow/cli memory search --query "authentication best practices" --limit 5
```

### Retrieve Entry
Retrieve a specific memory entry by key

```bash
npx @claude-flow/cli memory get --key "[key]" --namespace [namespace]
```

**Example:**
```bash
npx @claude-flow/cli memory get --key "auth-jwt-pattern" --namespace patterns
```

### List Entries
List all entries in a namespace

```bash
npx @claude-flow/cli memory list --namespace [namespace]
```

**Example:**
```bash
npx @claude-flow/cli memory list --namespace patterns --limit 20
```

### Delete Entry
Delete a memory entry

```bash
npx @claude-flow/cli memory delete --key "[key]" --namespace [namespace]
```

### Initialize HNSW Index
Initialize HNSW vector search index

```bash
npx @claude-flow/cli memory init --enable-hnsw
```

### Memory Stats
Show memory usage statistics

```bash
npx @claude-flow/cli memory stats
```

### Export Memory
Export memory to JSON

```bash
npx @claude-flow/cli memory export --output memory-backup.json
```

## Scripts

| Script | Path | Description |
|--------|------|-------------|
| `memory-backup` | `.agents/scripts/memory-backup.sh` | Backup memory to external storage |
| `memory-consolidate` | `.agents/scripts/memory-consolidate.sh` | Consolidate and optimize memory |

## References

| Document | Path | Description |
|----------|------|-------------|
| `HNSW Guide` | `docs/hnsw.md` | HNSW vector search configuration |
| `Memory Schema` | `docs/memory-schema.md` | Memory namespace and schema reference |

## Best Practices
1. Check memory for existing patterns before starting
2. Use hierarchical topology for coordination
3. Store successful patterns after completion
4. Document any new learnings

## Dónde encaja

- Categoría: [Bases de datos](https://skillsagentes.com/categorias/bases-de-datos.md) — Diseño de esquemas, migraciones y optimización de consultas.
- Creador: [ruvnet](https://skillsagentes.com/creators/ruvnet.md) — 275 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Harness Gepa](https://skillsagentes.com/skills/ruvnet/ruflo/harness-gepa.md): Inspecciona y audita genomas GEPA: carga y valida un genoma, renderiza el system prompt que compila, o clasifica los modos de fallo de una transcripción de ejecución.
- [Deepseek Reason](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-reason.md): Completion en modo razonamiento contra deepseek-reasoner (R1) de DeepSeek. Devuelve el chain-of-thought por separado de la respuesta final. Lee DEEPSEEK_API_KEY y degrada si falta o la API no responde.
- [Deepseek Chat](https://skillsagentes.com/skills/ruvnet/ruflo/deepseek-chat.md): Completion de un solo turno contra el modelo deepseek-chat de DeepSeek vía /v1/chat/completions. Lee DEEPSEEK_API_KEY y degrada con status:degraded si falta o la API no responde. Para tareas sin razonamiento.
- [Adr Index](https://skillsagentes.com/skills/ruvnet/ruflo/adr-index.md): Construye o reconstruye el índice de ADRs y su grafo de dependencias ejecutando scripts/import.mjs, en vez de cientos de llamadas MCP.
- [Agntcy Status](https://skillsagentes.com/skills/ruvnet/ruflo/agntcy-status.md): Muestra el estado de la integración AGNTCY/SLIM/CASA: si los paquetes están instalados, qué transporte está activo y si el enforcement de CASA está habilitado.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)