cmp-standards 2.7.0 → 2.8.0

package/standards/general/memory-usage.md

@@ -1,205 +1,205 @@
-# Uso de Memory
-
-## Filosofía
-
-El sistema de memoria captura **conocimiento que persiste** entre sesiones:
-
-- Tareas que estamos haciendo
-- Aprendizajes del trabajo
-- Patrones detectados
-- Decisiones tomadas
-
-## Cuándo Registrar
-
-### Al Empezar Tarea
-
-```typescript
-// Registrar tarea nueva
-await taskTracker.startTask({
-  title: "Implementar feature X",
-  description: "Agregar funcionalidad para...",
-  userRequest: "mensaje original del usuario"
-})
-```
-
-### Durante el Trabajo
-
-```typescript
-// Capturar idea que surge
-await ideaCollector.capture({
-  title: "Optimización posible",
-  description: "Podríamos cachear este query...",
-  category: "performance",
-  priority: "medium"
-})
-```
-
-### Al Completar
-
-```typescript
-// Registrar resultado
-await taskTracker.completeTask(taskId, {
-  result: "Implementado con éxito",
-  lessonsLearned: ["Pattern X funcionó mejor que Y"]
-})
-```
-
-### Al Aprender Algo Nuevo
-
-```typescript
-// Crear memoria de conocimiento
-await memoryClient.create({
-  type: 'memory',
-  title: "Pattern: Lazy loading de mapas",
-  body: "Para evitar errores de SSR...",
-  domain: "architecture",
-  tags: ["performance", "ssr", "maps"]
-})
-```
-
-## Qué NO Registrar
-
-- Información trivial
-- Datos temporales de sesión
-- Detalles de implementación obvios
-- Código completo (solo referencias)
-
-## Tipos de Memoria
-
-### 1. Tasks
-
-Trabajo en progreso:
-
-```typescript
-{
-  type: 'task',
-  status: 'pending' | 'in_progress' | 'completed',
-  title: string,
-  description: string,
-  context: { /* datos relevantes */ }
-}
-```
-
-### 2. Ideas
-
-Insights capturados:
-
-```typescript
-{
-  type: 'idea',
-  title: string,
-  description: string,
-  category: 'feature' | 'optimization' | 'fix' | 'research',
-  priority: 'low' | 'medium' | 'high'
-}
-```
-
-### 3. Memories
-
-Conocimiento persistente:
-
-```typescript
-{
-  type: 'memory',
-  title: string,
-  body: string,        // Markdown
-  domain: string,      // 'architecture', 'performance', etc.
-  tags: string[],
-  importance: 'low' | 'normal' | 'critical'
-}
-```
-
-### 4. Patterns
-
-Patrones detectados:
-
-```typescript
-{
-  type: 'pattern',
-  name: string,
-  description: string,
-  occurrences: number,
-  autoImprove: boolean  // true si >= 3 ocurrencias
-}
-```
-
-## Auto-Improvement
-
-Cuando un patrón se detecta 3+ veces:
-
-1. Sistema genera regla ESLint
-2. Crea entrada en memoria (gotcha)
-3. Actualiza estándares locales
-
-```
-Pattern detectado 3x: "await en loop"
-  ↓
-ESLint rule: no-await-in-loop
-  ↓
-Memory: "Usar Promise.all en lugar de await secuencial"
-  ↓
-Próxima sesión: IDE muestra warning
-```
-
-## Búsqueda de Conocimiento
-
-Antes de empezar tarea, buscar conocimiento previo:
-
-```typescript
-// Buscar memorias relevantes
-const relevant = await memoryClient.search({
-  query: "lazy loading components",
-  domain: "architecture",
-  limit: 5
-})
-
-// Aplicar conocimiento encontrado
-for (const memory of relevant) {
-  console.log(`Conocimiento previo: ${memory.title}`)
-}
-```
-
-## Integración con Workflow
-
-```
-1. EMPEZAR TAREA
-   └→ taskTracker.startTask()
-
-2. BUSCAR CONTEXTO
-   └→ memoryClient.search()
-
-3. TRABAJAR
-   └→ ideaCollector.capture() (si surge idea)
-
-4. COMPLETAR
-   └→ taskTracker.completeTask()
-   └→ memoryClient.create() (si aprendí algo)
-
-5. DETECTAR PATRONES
-   └→ patternDetector.scan()
-   └→ autoImprover.improve() (si 3+ ocurrencias)
-```
-
-## Comandos
-
-```bash
-# Ver estado de memoria
-claude-memory status
-
-# Buscar en memoria
-claude-memory search "query"
-
-# Ver patrones detectados
-claude-memory patterns
-
-# Ejecutar auto-mejora
-claude-memory improve
-```
-
-## Best Practices
-
-1. **Ser selectivo** - Solo registrar lo valioso
-2. **Títulos descriptivos** - Facilita búsqueda futura
-3. **Tags consistentes** - Usar vocabulario común
-4. **Actualizar, no duplicar** - Si existe, actualizar
-5. **Dominio correcto** - Clasificar apropiadamente
+# Uso de Memory
+
+## Filosofía
+
+El sistema de memoria captura **conocimiento que persiste** entre sesiones:
+
+- Tareas que estamos haciendo
+- Aprendizajes del trabajo
+- Patrones detectados
+- Decisiones tomadas
+
+## Cuándo Registrar
+
+### Al Empezar Tarea
+
+```typescript
+// Registrar tarea nueva
+await taskTracker.startTask({
+  title: "Implementar feature X",
+  description: "Agregar funcionalidad para...",
+  userRequest: "mensaje original del usuario"
+})
+```
+
+### Durante el Trabajo
+
+```typescript
+// Capturar idea que surge
+await ideaCollector.capture({
+  title: "Optimización posible",
+  description: "Podríamos cachear este query...",
+  category: "performance",
+  priority: "medium"
+})
+```
+
+### Al Completar
+
+```typescript
+// Registrar resultado
+await taskTracker.completeTask(taskId, {
+  result: "Implementado con éxito",
+  lessonsLearned: ["Pattern X funcionó mejor que Y"]
+})
+```
+
+### Al Aprender Algo Nuevo
+
+```typescript
+// Crear memoria de conocimiento
+await memoryClient.create({
+  type: 'memory',
+  title: "Pattern: Lazy loading de mapas",
+  body: "Para evitar errores de SSR...",
+  domain: "architecture",
+  tags: ["performance", "ssr", "maps"]
+})
+```
+
+## Qué NO Registrar
+
+- Información trivial
+- Datos temporales de sesión
+- Detalles de implementación obvios
+- Código completo (solo referencias)
+
+## Tipos de Memoria
+
+### 1. Tasks
+
+Trabajo en progreso:
+
+```typescript
+{
+  type: 'task',
+  status: 'pending' | 'in_progress' | 'completed',
+  title: string,
+  description: string,
+  context: { /* datos relevantes */ }
+}
+```
+
+### 2. Ideas
+
+Insights capturados:
+
+```typescript
+{
+  type: 'idea',
+  title: string,
+  description: string,
+  category: 'feature' | 'optimization' | 'fix' | 'research',
+  priority: 'low' | 'medium' | 'high'
+}
+```
+
+### 3. Memories
+
+Conocimiento persistente:
+
+```typescript
+{
+  type: 'memory',
+  title: string,
+  body: string,        // Markdown
+  domain: string,      // 'architecture', 'performance', etc.
+  tags: string[],
+  importance: 'low' | 'normal' | 'critical'
+}
+```
+
+### 4. Patterns
+
+Patrones detectados:
+
+```typescript
+{
+  type: 'pattern',
+  name: string,
+  description: string,
+  occurrences: number,
+  autoImprove: boolean  // true si >= 3 ocurrencias
+}
+```
+
+## Auto-Improvement
+
+Cuando un patrón se detecta 3+ veces:
+
+1. Sistema genera regla ESLint
+2. Crea entrada en memoria (gotcha)
+3. Actualiza estándares locales
+
+```
+Pattern detectado 3x: "await en loop"
+  ↓
+ESLint rule: no-await-in-loop
+  ↓
+Memory: "Usar Promise.all en lugar de await secuencial"
+  ↓
+Próxima sesión: IDE muestra warning
+```
+
+## Búsqueda de Conocimiento
+
+Antes de empezar tarea, buscar conocimiento previo:
+
+```typescript
+// Buscar memorias relevantes
+const relevant = await memoryClient.search({
+  query: "lazy loading components",
+  domain: "architecture",
+  limit: 5
+})
+
+// Aplicar conocimiento encontrado
+for (const memory of relevant) {
+  console.log(`Conocimiento previo: ${memory.title}`)
+}
+```
+
+## Integración con Workflow
+
+```
+1. EMPEZAR TAREA
+   └→ taskTracker.startTask()
+
+2. BUSCAR CONTEXTO
+   └→ memoryClient.search()
+
+3. TRABAJAR
+   └→ ideaCollector.capture() (si surge idea)
+
+4. COMPLETAR
+   └→ taskTracker.completeTask()
+   └→ memoryClient.create() (si aprendí algo)
+
+5. DETECTAR PATRONES
+   └→ patternDetector.scan()
+   └→ autoImprover.improve() (si 3+ ocurrencias)
+```
+
+## Comandos
+
+```bash
+# Ver estado de memoria
+claude-memory status
+
+# Buscar en memoria
+claude-memory search "query"
+
+# Ver patrones detectados
+claude-memory patterns
+
+# Ejecutar auto-mejora
+claude-memory improve
+```
+
+## Best Practices
+
+1. **Ser selectivo** - Solo registrar lo valioso
+2. **Títulos descriptivos** - Facilita búsqueda futura
+3. **Tags consistentes** - Usar vocabulario común
+4. **Actualizar, no duplicar** - Si existe, actualizar
+5. **Dominio correcto** - Clasificar apropiadamente