$ man how-to/rules-skills-context

Hay tres capas de configuracion que moldean como se comporta la AI en tu IDE. Cada capa se carga en un momento diferente y sirve un proposito distinto. Las reglas se cargan automaticamente segun los archivos que estas editando. Hacen cumplir patrones sin que tengas que pensar en ellos. Las habilidades se cargan cuando las invocas con un comando slash o una palabra clave. Ejecutan flujos de trabajo especificos paso a paso. Los archivos de contexto (como CLAUDE.md) se cargan al inicio de cada sesion y establecen la linea base para todo lo demas. Juntas, estas tres capas reemplazan la necesidad de re-explicar tus preferencias, flujos de trabajo y restricciones en cada sesion. Las configuras una vez. Funcionan cada vez.

PATTERN

Las reglas son archivos que se cargan basados en patrones glob. Cuando abres un archivo TypeScript, la regla de TypeScript se carga. Cuando editas un post de blog, la regla de formato de blog se carga. Nunca las invocas manualmente. Se activan segun lo que estes tocando. En Cursor, las reglas viven en .cursor/rules/ como archivos .mdc con frontmatter que especifica el patron glob. En Claude Code, viven en .claude/rules/ o se definen en el archivo CLAUDE.md. El formato difiere. El concepto es identico. Las buenas reglas son estrechas y especificas. "Al editar archivos en content/drafts/, aplica la convencion de nombre con prefijo de fecha y adherencia a la guia de voz." Las malas reglas son amplias y genericas. "Siempre escribe buen codigo." Las reglas estrechas producen comportamiento consistente. Las reglas amplias producen resultados inconsistentes porque la AI interpreta "bueno" de manera diferente en cada sesion.

PATTERN

Las habilidades son archivos markdown que definen flujos de trabajo paso a paso. Las invocas explicitamente. Escribe /deploy y la habilidad de despliegue se carga. Escribe /tracker y la habilidad del tracker se carga. Cada habilidad contiene todo lo que el agente necesita para ejecutar ese flujo de trabajo: que archivos leer, que comandos ejecutar, que salida producir y como manejar errores. El archivo de habilidad es el flujo de trabajo completo en ingles plano. No estas escribiendo codigo. Estas escribiendo instrucciones que un agente AI sigue. "Paso 1: Verifica cambios sin stage. Paso 2: Agrega todos los archivos modificados al stage. Paso 3: Genera un mensaje de commit a partir del diff." El agente lee estos pasos y los ejecuta. Las habilidades se acumulan. Cada vez que usas una habilidad y notas un caso borde, corriges la habilidad. Despues de 20 usos, la habilidad maneja escenarios que nunca planeaste. Ese es el patron de la sarten de hierro fundido. La habilidad se sazona mas con el uso.

PRO TIP

Los archivos de contexto como CLAUDE.md se cargan antes que cualquier otra cosa. Establecen los valores predeterminados para cada sesion. Informacion del entorno (OS, shell, preferencias de idioma), reglas de estilo de codigo y restricciones de comportamiento. Manten los archivos de contexto concisos. Solo pon cosas aqui que apliquen a CADA sesion. Si una regla solo aplica al editar posts de blog, pertenece a un archivo de regla, no a CLAUDE.md. Si un flujo de trabajo solo se ejecuta cuando escribes /deploy, pertenece a un archivo de habilidad, no a CLAUDE.md. La jerarquia: CLAUDE.md establece el piso. Las reglas ajustan por tipos de archivo. Las habilidades ejecutan flujos de trabajo especificos. Cada capa agrega contexto sin sobrecargar la ventana de contexto con informacion irrelevante. El agente obtiene exactamente lo que necesita para la tarea actual.

ANTI-PATTERN

Poner todo en CLAUDE.md. Tu CLAUDE.md se convierte en 500 lineas y el agente lee todo en cada sesion, incluso cuando el 90% es irrelevante. Mueve las instrucciones de flujo de trabajo a habilidades. Mueve los patrones especificos de archivos a reglas. Manten CLAUDE.md por debajo de 50 lineas. Escribir habilidades demasiado vagas. "Despliega el sitio web" no es una habilidad. Es un deseo. Escribe pasos especificos con comandos especificos y criterios de exito especificos. No usar reglas en absoluto. Si te encuentras repitiendo la misma instruccion entre sesiones ("usa TypeScript, no JavaScript"), eso deberia ser una regla. Las reglas automatizan las instrucciones repetidas para que nunca tengas que escribirlas de nuevo.