/si:promote — Graduar Aprendizajes a Reglas
Mueve un patrón comprobado de la memoria automática de Claude al sistema de reglas del proyecto, donde se convierte en una instrucción vinculante en lugar de una nota de fondo.
Uso
/si:promote <descripción del patrón> # Detectar automáticamente el mejor destino
/si:promote <patrón> --target claude.md # Promocionar a CLAUDE.md
/si:promote <patrón> --target rules/testing.md # Promocionar 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 debería seguir Claude?"
- "¿Esto aplica a todos los archivos o solo a rutas específicas?"
Paso 2: Encontrar el patrón en la memoria automática
# Buscar entradas relacionadas en MEMORY.md
MEMORY_DIR="$HOME/.claude/projects/$(pwd | sed 's|/|%2F|g; s|%2F|/|; s|^/||')/memory"
grep -ni "<palabras_clave>" "$MEMORY_DIR/MEMORY.md"
Muestra las coincidencias y confirma que son las 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 handlers de API necesitan validación" |
| Aplica a todos tus proyectos | ~/.claude/CLAUDE.md | "Prefiere el manejo explícito de errores" |
Si el usuario no especificó un destino, recomienda uno según el ámbito.
Paso 4: Destilar en una regla concisa
Transforma el aprendizaje del formato de nota de MEMORY.md al formato de instrucción de CLAUDE.md:
Antes (MEMORY.md — descriptivo):
El proyecto usa pnpm workspaces. Cuando intenté npm install falló. El archivo de bloqueo es pnpm-lock.yaml. Debo usar pnpm install para las dependencias.
Después (CLAUDE.md — prescriptivo):
## Compilació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 ("Usa X", "Siempre Y", "Nunca Z")
- Incluye 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 superaría las 200 líneas, sugiere usar
.claude/rules/en su lugar
Para .claude/rules/:
- Crea el archivo si no existe
- Añade metadatos 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 las respuestas de error (no Error directamente)
- Incluir comentarios JSDoc con OpenAPI en las funciones handler
Paso 6: Limpiar la memoria automática
Después de promocionar, 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 promocionada. Esto libera espacio para nuevos aprendizajes.
Paso 7: Confirmar
✅ Promocionado 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 vinculante. Claude lo seguirá en todas las sesiones futuras.
Guía de Decisión de Promoción
Promocionar cuando:
- El patrón apareció 3+ veces en la memoria automática
- Corregiste a Claude al respecto más de una vez
- Es una convención del proyecto que cualquier colaborador debería conocer
- Previene un error recurrente
No promocionar cuando:
- Es una nota de depuración de una sola vez (déjala en la memoria automática)
- Es contexto específico de una 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/
| Usa CLAUDE.md para | Usa .claude/rules/ para |
|---|---|
| Reglas globales del proyecto | Patrones específicos de tipos de archivo |
| Comandos de compilación | Convenciones de pruebas |
| Decisiones arquitectónicas | Reglas de diseño de API |
| Convenciones del equipo | Particularidades de frameworks |
Consejos
- Mantén CLAUDE.md por debajo de 200 líneas — usa rules/ para desbordar
- 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 promocionadas trimestralmente — elimina lo que ya no sea relevante