/si:promote — Graduar Aprendizajes a Reglas
Mueve un patrón probado desde la memoria automática de Claude al sistema de reglas del proyecto, donde se convierte en una instrucción aplicada en lugar de una nota de contexto.
Uso
/si:promote <descripción del patrón> # Auto-detectar mejor destino
/si:promote <patrón> --target claude.md # Promover a CLAUDE.md
/si:promote <patrón> --target rules/testing.md # Promover a regla con ámbito
/si:promote <patrón> --target rules/api.md --paths "src/api/**/*.ts" # Con ámbito y rutas
Flujo de Trabajo
Paso 1: Entender el patrón
Analiza la descripción del usuario. Si es vaga, haz una pregunta aclaratoria:
- "¿Qué comportamiento específico debe seguir Claude?"
- "¿Esto aplica a todos los archivos o a rutas específicas?"
Paso 2: Encontrar el patrón en la memoria automática
# Buscar en MEMORY.md entradas relacionadas
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<palabras clave>" "$MEMORY_DIR/MEMORY.md"
Muestra las entradas coincidentes y confirma que son lo que el usuario quiere.
Paso 3: Determinar el destino correcto
| Ámbito del patrón | Destino | Ejemplo |
|---|---|---|
| Aplica a todo el proyecto | ./CLAUDE.md | "Usar pnpm, no npm" |
| Aplica a tipos de archivo específicos | .claude/rules/<tema>.md | "Los manejadores API necesitan validación" |
| Aplica a todos tus proyectos | ~/.claude/CLAUDE.md | "Preferir manejo de errores explícito" |
Si el usuario no especificó un destino, recomienda uno basado en el ámbito.
Paso 4: Destilar en una regla concisa
Transforma el aprendizaje del formato de nota de la memoria automática al formato de instrucción de CLAUDE.md:
Antes (MEMORY.md — descriptivo):
El proyecto usa espacios de trabajo pnpm. Cuando intenté npm install falló. El archivo de bloqueo es pnpm-lock.yaml. Debe usarse pnpm install para las dependencias.
Después (CLAUDE.md — prescriptivo):
## Construcción y Dependencias
- Gestor de paquetes: pnpm (no npm). Usar `pnpm install`.
Reglas para la destilación:
- Una línea por regla cuando sea posible
- Voz imperativa ("Usar X", "Siempre Y", "Nunca Z")
- Incluir el comando o ejemplo, no solo el concepto
- Sin historia de fondo — solo la instrucción
Paso 5: Escribir en el destino
Para CLAUDE.md:
- Lee el CLAUDE.md existente
- Encuentra la sección adecuada (o crea una)
- Añade la nueva regla bajo el encabezado correcto
- Si el archivo excedería las 200 líneas, sugiere usar
.claude/rules/en su lugar
Para .claude/rules/:
- Crea el archivo si no existe
- Añade el frontmatter YAML con
pathssi tiene ámbito - Escribe el contenido de la regla
---
paths:
- "src/api/**/*.ts"
- "tests/api/**/*"
---
# Reglas de Desarrollo de API
- Todos los endpoints deben validar la entrada con esquemas Zod
- Usar la clase `ApiError` para respuestas de error (no Error sin formato)
- Incluir comentarios JSDoc de OpenAPI en las funciones manejadoras
Paso 6: Limpiar la memoria automática
Después de promover, elimina o marca la entrada original en MEMORY.md:
# Mostrar lo que se eliminará
grep -n "<patrón>" "$MEMORY_DIR/MEMORY.md"
Pide al usuario que confirme la eliminación. Luego edita MEMORY.md para eliminar la entrada promovida. Esto libera espacio para nuevos aprendizajes.
Paso 7: Confirmar
✅ Promovido a {{destino}}
Regla: "{{regla destilada}}"
Fuente: MEMORY.md línea {{n}} (eliminada)
MEMORY.md: {{líneas}}/200 líneas restantes
El patrón ahora es una instrucción aplicada. Claude lo seguirá en todas las sesiones futuras.
Guía de Decisión de Promoción
Promover cuando:
- El patrón apareció 3+ veces en la memoria automática
- Corregiste a Claude sobre esto más de una vez
- Es una convención del proyecto que cualquier colaborador debería conocer
- Previene un error recurrente
No promover cuando:
- Es una nota de depuración de una sola vez (dejar en memoria automática)
- Es contexto específico de la sesión (la memoria de sesión lo maneja)
- Podría cambiar pronto (por ejemplo, durante una migración)
- Ya está cubierto por reglas existentes
CLAUDE.md vs .claude/rules/
| Usar CLAUDE.md para | Usar .claude/rules/ para |
|---|---|
| Reglas globales del proyecto | Patrones específicos de tipo de archivo |
| Comandos de construcción | Convenciones de pruebas |
| Decisiones de arquitectura | Reglas de diseño de API |
| Convenciones del equipo | Particularidades del framework |
Consejos
- Mantén CLAUDE.md por debajo de 200 líneas — usa rules/ para el desbordamiento
- Una regla por línea es más fácil de mantener que párrafos
- Incluye el comando concreto, no solo el concepto
- Revisa las reglas promovidas trimestralmente — elimina lo que ya no sea relevante