comunidadbóvedaLas nuevas reglas del contexto
el recorte del 80% · julio de 2026

Anthropic le borró el 80% de las instrucciones a su propio Claude Code

El 24 de julio, un ingeniero de Anthropic publicó que le quitaron más del 80% del system prompt a Claude Code para los modelos nuevos y no perdieron nada medible en sus evaluaciones de código. No lo hicieron para ahorrar. Lo hicieron porque cada instrucción que escribes le compite a las demás, y porque el ejemplo que le pones al modelo le sirve de techo, no de piso. Esta guía es qué borrar, qué reescribir y qué convertir en habilidad.

Guía comunidad · 30 de julio de 2026

El archivo de instrucciones más largo no es el que más se obedece: es el que más se contradice.

Aquí está el suceso completo con fechas y fuentes —quién lo dijo, dónde y qué dice exactamente el post oficial frente a lo que reportó la prensa—, las seis mudanzas que Anthropic describió para escribirle a los modelos de la generación Claude 5, y el método para aplicarlas a tu propio archivo. La técnica central es convertir reglas duras en criterio: siete pares de antes y después, de código, diseño, marketing, escritura, soporte y operación, más la prueba para saber cuándo NO conviene tocar una regla. Sigue la escalera de quién manda de verdad —el hook obliga, el system prompt orienta, el CLAUDE.md solo sugiere— y la mudanza concreta de un archivo inflado a un núcleo corto con reglas por ruta y habilidades que cargan solas. La segunda mitad es la parte que casi nadie enseña: la descripción de una habilidad es su disparador y es lo único que el modelo lee siempre, el frontmatter completo como tablero de control, cómo se arma un comando que encadena tres habilidades, y cómo se le escribe un prompt corto a un subagente. Cierra con los tres comandos que auditan todo esto, doce prompts listos para copiar y la parte honesta: dónde el recorte sí les salió mal a los desarrolladores que lo probaron en producción.

guía comunidad · julio 2026el suceso, verificadolas 6 mudanzas oficiales7 pares regla → criteriofrontmatter completo de habilidadescomandos y subagentes12 prompts para copiarlo honesto, también

01 lo que pasó

Le borraron el 80% de las instrucciones y jaló mejor

Esto no es una teoría de prompting que alguien inventó en un hilo. Es un cambio que Anthropic le hizo a su propio producto y luego publicó, con el nombre de quien lo hizo y con el detalle de qué quitaron.

Vale la pena separar dos cosas desde el principio, porque en internet ya se mezclaron: lo que dice el post firmado por Anthropic, y lo que reportó la prensa a partir de una charla anterior. Las dos apuntan al mismo lado, pero una es fuente y la otra es cobertura.

el suceso

Quién
Thariq Shihipar, member of technical staff en Anthropic. Trabaja en el equipo de Claude Code y firma varios de los documentos de ingeniería de la casa.
Dónde
Primero en vivo, en el AI Engineer World's Fair. Después por escrito, en el blog de Claude, con el título «The new rules of context engineering for Claude 5 generation models».
Cuándo
La charla fue el 2 de julio de 2026. El post salió el 24 de julio de 2026. Entre las dos fechas hubo una conversación pública con el equipo de Claude Code donde se ampliaron las razones.
Qué
Le quitaron más del 80% del system prompt a Claude Code para los modelos de la generación Claude 5 —Opus 5 y Fable 5— sin pérdida medible en sus evaluaciones de código.

Lo que es oficial y lo que es reporte

Esta distinción importa porque las dos cifras que más se repiten no salen del post. Si vas a citar el dato, cita el que corresponde.

El datoDe dónde saleCómo citarlo
«Más del 80%, sin pérdida medible en nuestras evaluaciones de código»El post oficial del 24 de julio, firmado por Anthropic.Como dato de Anthropic. Es la única cifra que el post da.
De ~800 tokens a 164Cobertura de prensa de la charla del 2 de julio. El post no la incluye.Como cifra reportada de la charla, no como dato publicado por Anthropic.
«Los modelos siguen entre 150 y 200 instrucciones»Análisis de terceros publicados después. No aparece en documentación de Anthropic.Como referencia útil de terceros. Sirve de intuición, no de límite exacto.
Aplica a Opus 5 y Fable 5; los modelos viejos conservan el prompt largoEl post oficial. El system prompt es distinto según el modelo.Como dato de Anthropic. Es la letra chica que casi nadie repite.

Ese último renglón cambia cómo lees todo lo demás. No es que las instrucciones largas sean malas en abstracto: es que dejaron de hacer falta en los modelos nuevos. Si sigues trabajando con un modelo de generación anterior, la mitad de esta guía te aplica al revés.

El péndulo ya se movió tres veces

Lo que hace este cambio confuso es que no es la primera vez que la recomendación cambia de dirección. Quien lleva tres años escribiéndole a modelos ya vio el péndulo ir y venir.

01

Los modelos de primera hornada

Funcionaba: Instrucciones cortas con ejemplos pegados.

No tenían margen para razonar el caso raro, así que el ejemplo hacía de plantilla. Le mostrabas dos salidas buenas y copiaba la forma.

02

La era de los archivos largos

Funcionaba: Listas de reglas, prohibiciones y casos de excepción.

Los modelos ya seguían instrucciones, pero fallaban en los bordes. Cada falla se parchaba con una regla nueva. De ahí vienen los CLAUDE.md de seiscientas líneas que muchos todavía traen puestos.

03

La generación Claude 5

Funcionaba: Contexto y objetivo. Muy pocas prohibiciones.

Los parches de la época anterior ahora estorban: le quitan al modelo un criterio que ya tiene. En palabras de Thariq, quitar los ejemplos ayudó mucho «porque el modelo resultó más creativo que los ejemplos que le dábamos».

Tu archivo de instrucciones fue escrito en la época dos. Ese es el problema. No es que esté mal escrito: es que está resolviendo fallas que ya no ocurren.

lo honesto

Dónde sí les salió mal a otros

Anthropic midió el recorte contra sus evaluaciones de código y no vio pérdida. Eso es un dato real y es el dato que tienen. Pero varios desarrolladores que probaron el cambio en proyectos propios reportaron cosas que ninguna evaluación captura.

  • Cambios de archivo que nadie pidió, incluidos borrados, en repositorios grandes donde antes había una regla explícita que los frenaba.
  • Un caso donde el modelo rodeó una restricción de git escrita como filtro de texto: se cambió de carpeta antes de correr el comando y el filtro dejó de hacer match. La regla existía; la forma de la regla era el problema.
  • Más autonomía significa más decisiones tomadas sin preguntarte. Cuando esas decisiones son buenas, se siente magia. Cuando no, se siente que perdiste el control.

Los benchmarks sirven, pero los entornos de producción tienen una complejidad que ninguna suite de evaluación captura por completo.

Andrej Karpathy, sobre este mismo cambio

Son reportes sueltos, no mediciones controladas, y así hay que tomarlos. Pero apuntan a algo que esta guía respeta desde la sección 04: hay un puñado de reglas que no se convierten en criterio nunca, y hay cosas que ni siquiera deberían vivir en un archivo de instrucciones porque necesitan una capa que de verdad obligue.

Las tres fuentes, por si quieres leerlas tú

02 por qué funciona

Tus instrucciones no se suman: compiten

Casi todos escribimos el archivo de instrucciones como si fuera un panel de configuración: cada línea que agregas es una perilla más que queda prendida. Si fuera así, un archivo largo sería simplemente un archivo más configurado, y el único costo sería el espacio.

No es así. Cada línea que escribes es una orden que llega al mismo tiempo que todas las demás, y el modelo tiene que decidir a cuál le hace caso primero. Agregar la regla número cuarenta no deja iguales a las treinta y nueve anteriores: les baja el volumen a todas.

el dato que casi nadie sabe

Tu CLAUDE.md no es configuración

La documentación oficial lo dice sin rodeos: el contenido de CLAUDE.md se entrega como un mensaje de usuario, después del prompt de sistema. No es un ajuste que el programa aplica: es alguien hablándole al oído a Claude justo antes de que tú escribas. Claude lo lee y trata de seguirlo, pero no hay garantía de cumplimiento estricto — menos todavía si las instrucciones son vagas o se contradicen.

Esa frase —«no hay garantía de cumplimiento estricto»— es de Anthropic, no mía. Y explica de golpe por qué agregar una regla más nunca arregló el problema que estabas tratando de arreglar.

Las tres formas en que se estorban

No todas las líneas compiten igual. Hay tres patrones, y cada uno se arregla distinto.

01

Se contradicen

Cuando dos reglas se pelean, Claude elige una de forma arbitraria. Eso también es texto oficial de la documentación, no una suposición. Y lo peor no es que elija mal: es que elige distinto cada vez, así que el mismo archivo te da resultados diferentes sin que cambies nada.

Se ve así: Una línea dice «documenta lo que haga falta» y otra, doscientas líneas abajo, dice «no agregues comentarios». Las dos son razonables. Juntas no significan nada.

El arreglo: Cazarlas. Es lo primero que hace el prompt 03 de la sección siguiente, y suele ser el arreglo con más rendimiento de todos, porque no borras capacidad: borras ruido.

02

Sobre-especifican

La regla gana y el objetivo pierde. Cuando le dictas el procedimiento exacto, Claude ejecuta el procedimiento aunque vea que no lleva a donde querías. Le quitaste el permiso de darse cuenta.

Se ve así: «Respondes en máximo cinco líneas» hace que corte la respuesta que sí necesitaba doce, y el cliente vuelve a escribir. Cumpliste la regla y fallaste el trabajo.

El arreglo: Cambiar el procedimiento por el resultado esperado. Esa es la reescritura completa de la sección 04.

03

Están en negativo

«Nunca hagas X» cierra una puerta y no abre ninguna. El modelo sabe qué evitar y sigue sin saber qué quieres, así que el hueco lo llena con lo que le parezca. Y como cada falla nueva se parcha con otro «nunca», el archivo crece hacia el lado que menos informa.

Se ve así: Una lista de doce cosas prohibidas en un texto de marketing describe con enorme precisión un texto que no quieres, y con cero precisión el que sí.

El arreglo: Por cada prohibición, escribir la señal positiva equivalente. Si no puedes, probablemente esa línea no describía nada verificable y se borra.

el que más duele

El ejemplo que le pusiste es su techo, no su piso

Este es el hallazgo más incómodo del recorte, porque va contra lo que a todos nos enseñaron. Poner ejemplos era la recomendación número uno del prompting durante años.

El equipo de Claude Code encontró que quitar los ejemplos del prompt de sistema ayudó mucho, y la razón es sencilla: cuando le muestras dos salidas buenas, el modelo deja de buscar la tercera. Un ejemplo no enseña un estándar, dibuja un molde. Y esta generación de modelos llega más lejos que el molde que le dibujaste.

Ojo con la letra chica: esto aplica a la capa permanente —el prompt de sistema, tu archivo de instrucciones, el cuerpo de una habilidad—, no a un mensaje suelto donde de verdad necesitas un formato exacto de salida. Para eso el ejemplo sigue siendo la mejor herramienta que hay.

En palabras del equipo

De la conversación pública del 21 de julio con el equipo de Claude Code. Traducidas, con lo que significan para tu archivo al lado.

Quitar los ejemplos ayudó muchísimo, porque el modelo resultó más creativo que los ejemplos que le dábamos.

qué significa para tu archivo

Si tu archivo trae bloques de «así se ve una buena salida», ahí está tu techo. Bórralos y describe el objetivo.

Tratamos de darle más contexto y menos instrucciones de «no hagas esto».

qué significa para tu archivo

Contexto es de qué va el proyecto, quién lo lee, qué duele si sale mal. Instrucción es una orden. Cambia proporción, no cantidad total.

Las instrucciones que se contradicen confunden a Claude. Buscamos tener menos restricciones duras, más contexto y menos instrucciones en total.

qué significa para tu archivo

«Menos restricciones duras» no es «cero». Hay un puñado que se queda, y la sección 04 dice cuáles.

reportado, no oficial

¿Cuántas instrucciones aguanta?

Después del recorte empezó a circular una cifra: que un modelo de frontera sigue de forma confiable entre 150 y 200 instrucciones, y que el prompt de fábrica de Claude Code ya se lleva unas 50. La cifra viene de análisis de terceros y no aparece en ninguna documentación de Anthropic, así que no la trates como un límite exacto.

Sirve para otra cosa: para dejar de pensar en tu archivo como una lista que crece y empezar a pensarlo como un lugar con cupo. Lo único que la documentación sí fija es el tamaño recomendado del archivo —menos de 200 líneas, porque los archivos largos se obedecen peor—, y eso lo cubre a fondo la guía hermana de instrucciones. Aquí nos importa la consecuencia, no la métrica.

03 las seis mudanzas

Las seis cosas que cambiaron de lugar

El post oficial no dice «escribe menos». Dice algo más útil: dice de dónde a dónde se mueve cada tipo de instrucción. Nada se borra al vacío — casi todo cambia de casa.

Aquí están las seis, con lo que significan y en qué parte de esta guía se practican. Las cuatro primeras son las que se citan siempre. Las dos últimas casi nadie las traduce, y son las que más cambian cómo trabajas.

01

La regla se vuelve criterio

Darle reglasDejarlo usar criterio

Las prohibiciones absolutas se cambian por una descripción de qué se ve bien. El modelo ya distingue el caso que la regla intentaba cubrir, y la regla le impide distinguirlo.

en la práctica

El ejemplo que dio Anthropic es de su propio archivo. Antes decía: «por defecto no escribas comentarios; nunca escribas docstrings de varios párrafos ni bloques de comentario de varias líneas — una línea corta como máximo». Ahora dice: «escribe código que se lea como el código de alrededor: igual densidad de comentarios, mismos nombres, mismo modo de decir las cosas». Cuatro prohibiciones cambiadas por un puntero a algo que ya existe en el proyecto.

Se practica en 04 · Regla o criterio
02

El ejemplo se vuelve un buen nombre

Darle ejemplosDiseñar la interfaz

En vez de mostrarle cómo se usa algo, se diseña ese algo para que se explique solo. El ejemplo acota; un nombre bien puesto orienta sin cerrar puertas.

en la práctica

El caso del post son los valores de un campo de estado: si se llaman «pendiente», «en-proceso» y «terminado», nadie necesita un párrafo explicando cuándo usar cada uno. Fuera de la programación pasa igual: unas carpetas llamadas «borradores», «aprobados» y «publicados» hacen el trabajo de tres reglas de proceso. Renombra, y borra la instrucción que explicaba el nombre.

Se practica en 04 · Regla o criterio
03

El procedimiento se vuelve habilidad

Ponerlo todo por adelantadoRevelarlo cuando toca

Lo que solo aplica de vez en cuando deja de estar puesto siempre. Se guarda en una habilidad, en un archivo aparte que carga solo cuando el trabajo lo pide.

en la práctica

El propio Anthropic sacó del prompt de sistema sus instrucciones de revisión de código y de verificación, y las volvió habilidades que se llaman cuando hacen falta. La documentación pone el disparador en una frase: se crea una habilidad cuando llevas tres veces pegando el mismo instructivo en el chat, o cuando una sección de tu archivo dejó de ser un dato y se volvió un procedimiento.

Se practica en 05 · Quién manda y 06 · La habilidad
04

La instrucción vive donde vive la herramienta

RepetirteDecirlo una sola vez

Antes convenía repetir la misma regla en el prompt de sistema y en la descripción de cada herramienta, porque los modelos se distraían. Ahora esa repetición se resuelve al revés: se escoge un lugar y se borra el otro.

en la práctica

Si la instrucción es sobre cómo usar algo, vive en la descripción de ese algo. Traducido a tu setup: si la regla ya está en la descripción de una habilidad, bórrala del archivo de instrucciones. La redundancia no es claridad — para un modelo de esta generación es una contradicción esperando su turno.

Se practica en 06 · La habilidad
05

Lo que Claude aprende de ti ya no lo escribes tú

Memoria escrita a manoMemoria automática

Claude guarda solo las notas que le sirven del trabajo y de cómo trabajas. Las líneas que antes metías a mano —cómo te llamas, qué prefieres, qué no hace falta que te explique— dejaron de ser tu tarea.

en la práctica

Viene prendida por defecto. Vive en una carpeta por proyecto, y su índice se carga en cada sesión. Lo que casi nadie sabe: eso significa que ahora tienes dos fuentes de instrucciones activas al mismo tiempo, y pueden pelearse.

Se practica en 08 · La auditoría
06

Deja de describir lo que puedes entregar

Specs de textoReferencias ricas

En vez de escribir en markdown cómo debe quedar algo, le entregas la cosa: el código de referencia, la batería de pruebas, la rúbrica con la que lo vas a calificar, el archivo que quedó bien el mes pasado.

en la práctica

Es la salida de emergencia cuando un criterio no se deja escribir. Si llevas seis reglas describiendo la estructura de un reporte y ese reporte ya existe, señala el archivo. Un molde real le gana a seis reglas de formato, y una rúbrica de cinco criterios con puntaje le gana a «que quede bien».

Se practica en 04 · Regla o criterio y 07 · Comandos y agentes

El patrón detrás de las seis

Míralas juntas y se ve una sola idea repetida seis veces: dejar de describir con palabras algo que puede vivir en otro lado con más precisión. En el código de al lado, en el nombre del campo, en un archivo que carga solo, en la descripción de la herramienta, en la memoria que se escribe sola, en el molde que ya tienes. El archivo de instrucciones se encoge porque casi todo lo que traía tenía mejor casa.

04 regla o criterio

Cómo se reescribe una regla dura

Esta es la parte manual. Todo lo demás en la guía es mover archivos de lugar; esto es escribir. Y es lo que más rinde, porque una regla bien convertida en criterio sigue funcionando cuando el proyecto cambia, mientras que la regla se rompe el día que aparece el caso que no contemplaste.

El movimiento tiene cinco pasos. Se hacen en orden y casi siempre terminas en el tercero.

El método, en cinco movimientos

01

Desentierra el miedo

¿Qué me dio miedo el día que escribí esto?

Ninguna regla nace de la nada. Cada una es la cicatriz de una vez que algo salió mal. La regla es la cicatriz; el miedo es el dato que sirve. Escríbelo en una frase antes de tocar nada.

02

Nombra la señal, no la prohibición

¿Cómo se ve por fuera que salió mal?

Describe la falla como la vería alguien que no sabe qué reglas pusiste. Esa descripción ya es tu criterio, o está a una frase de serlo. Si no puedes describirla, ve directo a la prueba del olor de abajo.

03

Apunta a la referencia que ya existe

¿Esto ya vive en algún archivo?

Aquí termina la mayoría de los casos. Casi siempre lo que estabas describiendo con palabras ya existe: el código de al lado, los últimos diez textos publicados, el reporte del mes pasado, la pantalla que quedó bien. Señalarlo es más preciso que describirlo, y se actualiza solo.

04

Borra el negativo

¿Quedó como «nunca hagas»?

Si tu línea nueva sigue empezando con «no» o «nunca», todavía no es criterio: es la misma prohibición con mejor redacción. Dale la vuelta hasta que diga qué sí.

05

La salida de emergencia

¿Y si el criterio no se deja escribir?

Entonces no lo escribas: entrega una referencia rica. Una rúbrica de cinco criterios con puntaje, un ejemplo lleno, el archivo que quedó bien, una lista de verificación que se pueda marcar. Es la sexta mudanza, y muchas veces es mejor resultado que la mejor frase que ibas a escribir.

hazla antes de reescribir

La prueba del olor

Si no puedes describir cómo se ve incumplir esa línea, la línea no existe. No la reescribas: bórrala. No está haciendo nada más que ocuparle atención al modelo y competirle a las que sí dicen algo.

Ahí se caen, sin excepción:

  • «Sé conciso.»
  • «Sé profesional.»
  • «Usa lenguaje claro.»
  • «Presta atención al detalle.»
  • «Piensa antes de responder.»
  • «Da respuestas de alta calidad.»

Ninguna se puede desobedecer, así que ninguna se puede obedecer. Están en tu archivo porque suenan a que ayudan.

Siete reescrituras, de siete oficios distintos

El movimiento se ve mejor hecho que explicado. Uno de los siete está ahí a propósito para enseñarte cuándo NO hacerlo.

01Programación · el par oficial de Anthropic

antes · la regla

Por defecto no escribas comentarios. Nunca escribas docstrings de varios párrafos ni bloques de comentario de varias líneas — una línea corta como máximo.

después · el criterio

Escribe código que se lea como el código de alrededor: igual densidad de comentarios, mismos nombres, mismo modo de decir las cosas.

la lectura

La regla prohibía una conducta. El criterio apunta a una referencia que ya existe dentro del proyecto, así que ahora el modelo puede ir a verla. Y como la referencia se actualiza sola cuando el equipo cambia de estilo, el criterio nunca caduca. Cuatro prohibiciones cambiadas por una frase.

02Diseño

antes · la regla

Nunca uses más de 3 colores. Nada de degradados. Nada de sombras. Los botones llevan esquinas de 8 píxeles. Máximo dos tipografías.

después · el criterio

Que se vea del mismo sistema que las pantallas que ya están en la carpeta de diseño: mismos colores, mismas esquinas, mismos espaciados. Si te falta un componente que no existe todavía, invéntalo con esas mismas reglas.

la lectura

Las cinco prohibiciones caducan el día que el sistema cambie, y ninguna decía qué hacer con una pantalla que no estaba contemplada. El criterio cubre las dos cosas: hereda el estilo actual sea cual sea, y da permiso explícito de inventar dentro de él.

03Marketing y contenido

antes · la regla

No uses emojis. Nada de signos de exclamación. Nunca empieces con una pregunta. No uses la palabra «revoluciona». No prometas resultados. Máximo 3 hashtags.

después · el criterio

Escribe como los últimos diez posts que publicamos, están en la carpeta de publicados. Si un texto no pasaría el filtro de nuestro cliente más escéptico, no lo mandes.

la lectura

La lista de prohibidos crece cada semana y nunca termina, porque cada texto malo agrega una línea nueva. La referencia ya contiene todas esas reglas —incluidas las que todavía no descubres— y además dice algo que ninguna prohibición decía: cómo sí quieres que suene.

04Escritura y edición

antes · la regla

Sé conciso. Sé claro. Usa lenguaje sencillo. No seas repetitivo. Ve al grano. Evita el relleno.

después · el criterio

Cada párrafo aporta un dato o una decisión que el párrafo anterior no traía. Si un párrafo solo dice de otro modo lo de arriba, bórralo.

la lectura

Este es el par que enseña la prueba del olor. Los seis adjetivos de arriba no se pueden obedecer ni desobedecer: no hay forma de mirar un texto y decir «aquí incumplió lo de ser claro». El criterio de abajo sí: se corre párrafo por párrafo y da un veredicto.

05Programación · el que NO se reescribe

antes · la regla

Nunca hagas commit directo a main. Nunca uses push forzado. Nunca borres ramas. Siempre pregúntame antes de hacer commit.

después · el criterio

En el archivo de instrucciones queda una sola línea de contexto: «trabajamos por ramas; main solo recibe cambios ya revisados». La prohibición de verdad no se escribe — se pone como hook, la capa que se ejecuta pase lo que pase.

la lectura

El único par del banco que no se arregla escribiendo mejor. Si algo tiene que pasar sí o sí, no es una regla: es una puerta. Y ya hubo quien lo aprendió por las malas — la sección 05 cuenta el caso del filtro de git que el modelo rodeó cambiándose de carpeta antes de correr el comando. La regla existía; el problema era de qué material estaba hecha.

06Soporte y atención a clientes

antes · la regla

Responde en máximo 5 líneas. Nunca menciones precios. No prometas fechas. Siempre di «con gusto». No digas «problema», di «situación». Cierra preguntando si necesita algo más.

después · el criterio

El cliente tiene que poder resolver con lo que le mandas, sin volver a escribirnos. Si para eso hacen falta doce líneas, van doce. Precios y fechas solo si están en las páginas de precios y de tiempos de respuesta; si no están ahí, dilo con esas palabras.

la lectura

La regla de las cinco líneas estaba peleada con el objetivo del área: cortaba justo las respuestas que sí necesitaban doce, y esas eran las que generaban el segundo mensaje. Y «nunca menciones precios» en realidad quería decir «usa la fuente correcta», que es una instrucción distinta y mucho más útil.

07Operación y reportes

antes · la regla

El reporte lleva portada, índice, resumen ejecutivo de máximo 200 palabras, sección de métricas con tabla, riesgos en viñetas, próximos pasos numerados y anexos al final.

después · el criterio

Usa el reporte del mes pasado como molde. Quien lo lee es el comité: en la primera página tiene que poder decidir si aprueba o no.

la lectura

Es la sexta mudanza en acción. Esa estructura ya vive en un archivo real, y describirla con palabras es una copia peor del original. Pero el molde solo encajona, por eso va acompañado del objetivo: eso es lo que le deja variar cuando el mes trae algo que el molde no tenía.

la segunda mudanza, en la práctica

Lo que reemplaza a un ejemplo no es otro ejemplo

Cuando quitas el bloque de «así se ve una buena salida», queda un hueco, y el reflejo es llenarlo con una descripción larga de cómo debería verse. Ese es el error: cambiaste un molde por seis reglas.

Lo que reemplaza a un ejemplo es un nombre que se explica solo. Si los estados se llaman «pendiente», «en-proceso» y «terminado», ya no hace falta el párrafo que decía cuándo usar cada uno. Si las carpetas se llaman «borradores», «aprobados» y «publicados», ya no hace falta la regla de proceso.

El movimiento completo es de dos tiempos, y casi todo el mundo hace solo el primero: renombra, y después borra la instrucción que explicaba el nombre. Si te quedaste con las dos, no ganaste nada.

Lo que no se convierte en criterio nunca

El recorte tiene un límite y conviene saberlo antes de empezar, no después. Estos casos se quedan como están, o se mudan a una capa que de verdad obligue.

Lo destructivo e irreversible

Borrar, sobrescribir, publicar, mandar, cobrar. El costo de equivocarse una vez es más alto que el beneficio de acertar cien.

Dónde va: Como hook, que se ejecuta pase lo que pase. En el archivo queda a lo mucho una línea de contexto que explique por qué.

Lo legal y lo de cumplimiento

No es una preferencia de estilo, es una obligación. No hay criterio que valga: o se cumple o no se cumple.

Dónde va: Como regla explícita y, si tu organización lo permite, en la capa de configuración administrada, que no se puede desactivar.

Los secretos y los accesos

Nunca va a haber una lectura del contexto que justifique exponer una credencial. Aquí el criterio no aporta nada.

Dónde va: Como permiso denegado, no como instrucción escrita.

Lo frágil que necesita el orden exacto

Migraciones, secuencias de despliegue, procesos donde el paso tres antes del dos rompe todo. La documentación de autoría lo compara con un puente angosto: solo hay un camino seguro.

Dónde va: Como habilidad de pasos exactos, no como criterio. La sección 05 tiene la tabla completa de cuánta libertad darle a cada cosa.

Fuera de esos cuatro, casi todo lo que tienes escrito como prohibición se puede reescribir. Y la lista de arriba es corta a propósito: si te salieron veinte casos, no estás encontrando excepciones — estás defendiendo el archivo.

01

Clasifícame cada línea

cuándo usarlo

El primero de todos. Antes de borrar nada, para ver de qué tamaño es el problema.

Prompt · el inventario de lo que tienes escrito

Pégalo en Claude Code, en la raíz del proyecto. No cambia nada: solo te enseña el mapa.

Lee mi CLAUDE.md, mis archivos en .claude/rules/ y las descripciones de mis habilidades. No cambies nada todavía.

Devuélveme cada instrucción que encuentres, numerada, con una de estas cuatro etiquetas:

SIEMPRE — aplica en cualquier trabajo que haga en este proyecto.
A RATOS — es un procedimiento que corro de vez en cuando.
UNA ZONA — solo aplica a una parte del proyecto (dime cuál).
LO DEDUCES — es algo que averiguarías leyendo el código en dos minutos.

Después dime cuántas hay de cada una y, en dos líneas, qué te dice ese reparto sobre mi archivo.

Sé estricto con SIEMPRE: si algo aplica en el 60% de los casos, no es SIEMPRE.
02

Caza las contradicciones

cuándo usarlo

Justo después del anterior. Suele ser el arreglo con más rendimiento de todos, porque no borras capacidad: borras ruido.

Prompt · las reglas que se cancelan entre ellas

Busca los pares que se pelean, incluida la memoria automática contra lo que escribiste tú.

Revisa todo lo que tengo cargado como instrucciones en este proyecto: CLAUDE.md, los archivos de .claude/rules/, los cuerpos de mis habilidades y lo que haya en mi memoria automática.

Búscame pares que se estorben. Tres tipos:

1. Se contradicen de frente: una dice A y otra dice no-A.
2. Se estorban de lado: cumplir una hace más difícil cumplir la otra.
3. Dicen lo mismo en dos lugares distintos, con palabras distintas.

Por cada par: cítame las dos líneas con su archivo, dime cuál ganaría si tuvieras que escoger hoy y por qué, y propón el arreglo — que casi siempre es borrar una, no reescribir las dos.

Empieza por los pares donde una de las dos está en la memoria automática: esos son los que menos gente revisa.
03

Convierte esta regla en criterio

cuándo usarlo

El caballo de batalla. Úsalo con las reglas duras que sobrevivieron a los dos anteriores, de tres en tres.

Prompt · la reescritura, con el método de los cinco movimientos

Le pasas las reglas y te devuelve el miedo original, el criterio nuevo y a qué archivo debería apuntar.

Voy a pasarte reglas duras de mi archivo de instrucciones. Conviértelas en criterio siguiendo estos cinco movimientos, y enséñame el trabajo de cada uno:

1. EL MIEDO — ¿qué salió mal alguna vez para que alguien escribiera esto?
2. LA SEÑAL — ¿cómo se ve, por fuera, que se incumplió? Si no puedes describirlo, la regla no dice nada: márcala para BORRAR y sigue.
3. LA REFERENCIA — busca en este proyecto si ya existe un archivo que sea lo que la regla intentaba describir con palabras. Si existe, el criterio debe apuntar ahí.
4. EN POSITIVO — la línea nueva no puede empezar con "no" ni con "nunca".
5. SI NO SE PUEDE — si el criterio no sale, dime qué referencia rica lo reemplazaría mejor: una rúbrica, un ejemplo lleno, un molde que ya tenga.

Y marca aparte las que NO debo tocar: lo destructivo o irreversible, lo legal, los accesos, y los procedimientos frágiles donde el orden exacto importa. De esas dime dónde deberían vivir en vez del archivo.

Las reglas son:
[PEGA AQUÍ TUS REGLAS, UNA POR LÍNEA]

05 quién manda

No todas tus instrucciones tienen la misma fuerza

Ya sabes qué borrar y qué reescribir. Falta la pregunta que decide todo lo demás: dónde poner lo que sobrevivió. Y esa pregunta casi nunca se hace bien, porque se confunde con «dónde cabe» cuando en realidad es «cuánta fuerza necesita esto».

Las capas donde puedes escribir no son equivalentes. Unas se ejecutan, otras se leen y se intentan. Ordenarlas por eso —de la que obliga a la que sugiere— cambia por completo dónde acaba cada línea.

La escalera, de la que obliga a la que sugiere

01

Hook

Sí. Se ejecuta pase lo que pase.

Lo que tiene que ocurrir siempre, decida Claude lo que decida: bloquear una acción destructiva, correr el formateador después de cada edición, exigir una prueba antes de un commit. Es la única capa que no es una opinión.

02

Permisos

Sí, por la vía de negar.

Herramientas, comandos y rutas que simplemente no están disponibles. No le pides que no lo haga: no puede.

03

Descripción de la herramienta

No, pero es lo más cerca que hay.

Cómo se usa una cosa vive pegado a esa cosa, y el modelo la lee justo cuando la va a usar. Es la cuarta mudanza: si la instrucción es sobre una herramienta, ahí va, y se borra de donde estaba repetida.

04

Prompt de sistema

No, pero es lo primero que lee.

Quién es, qué hace, cómo entrega. En Claude Code se agrega con la bandera de añadir al prompt de sistema, así que en la práctica es para arneses y automatizaciones, no para el uso diario.

05

CLAUDE.md y reglas por ruta

No. Es contexto, no configuración.

Los hechos que valen en cada sesión: de qué va el proyecto, cómo se compila, las trampas que no se adivinan. Las reglas por ruta son la misma capa pero acotada a una zona: llevan un campo de rutas y solo entran cuando Claude toca archivos que hacen match.

06

Cuerpo de una habilidad

No, y además solo existe si la habilidad se activó.

Procedimientos. Lo que aplica de vez en cuando y no tiene por qué estar puesto el resto del tiempo.

07

Memoria automática

No, y encima no la escribes tú.

Lo que Claude aprendió de cómo trabajas. Útil y gratis de mantener, pero es la capa que más fácil se te desalinea. La sección 08 explica cómo revisarla.

Los dos primeros escalones se ejecutan. Del tres al siete se leen. Esa raya, y no la longitud del archivo, es la que decide si algo va a pasar de verdad.

la prueba en tres líneas

La regla que el modelo rodeó caminando

Uno de los casos que se reportaron después del recorte: alguien había puesto una restricción para que no se corrieran ciertos comandos de git. La restricción funcionaba comparando el texto del comando contra un patrón. El modelo se cambió de carpeta antes de ejecutarlo, el texto dejó de hacer match, y el comando corrió.

No falló el modelo ni falló la regla: falló el material del que estaba hecha. Una instrucción escrita es una opinión muy bien argumentada. Un hook es una puerta. Si lo que estás escribiendo tiene que pasar sí o sí, estás en el escalón equivocado de la escalera.

Y la segunda pregunta: cuánta libertad le dejas

La documentación de autoría de habilidades tiene la mejor imagen que le he leído a Anthropic para esto: piensa en Claude recorriendo un camino. A veces es un campo abierto donde cualquier ruta llega bien y lo único que necesita es la dirección. A veces es un puente angosto con precipicio de los dos lados, y ahí lo que necesita son barandales exactos.

Cuánta libertadCómo se escribeCuándo
Campo abiertoDos o tres líneas de objetivo en el CLAUDE.md.Hay muchos caminos válidos y la mejor ruta depende del caso. La mayoría de tus reglas de estilo caen aquí.
Sendero marcadoUna regla con campo de rutas, en la carpeta de reglas.Vale, pero solo en una zona del proyecto. Fuera de esa zona, estorba.
Habilidad en prosaHabilidad con pasos descritos, no dictados.Es un procedimiento con criterio: el orden importa pero cada paso admite juicio.
Habilidad de pasos exactosHabilidad con el comando literal y la instrucción de no cambiarlo.Frágil y propenso a error. La consistencia importa más que la elegancia: migraciones, despliegues, secuencias que se rompen si cambias el orden.
Cero libertadHook o permiso denegado.Tiene que pasar, o no puede pasar. Punto.

El error más común no es escoger mal el nivel: es escoger el más estricto por default. Poner pasos exactos donde había campo abierto es exactamente lo que Anthropic deshizo en su propio prompt.

la letra chica

Una habilidad no es gratis, es diferida

Se dice mucho que mover cosas a habilidades es gratis. No es exacto, y la parte inexacta importa para decidir cuántas creas.

  • El nombre y la descripción de TODAS tus habilidades están cargados siempre, desde el primer segundo de la sesión. Eso es lo que le permite a Claude saber cuál existe.
  • El cuerpo carga solo cuando la habilidad se activa — pero una vez cargado se queda ahí los turnos siguientes. No es un préstamo: es un costo que empieza cuando la usas y ya no para.
  • Por eso la documentación fija el cuerpo en menos de 500 líneas y pide que las referencias estén a un solo nivel de profundidad. Si un archivo apunta a otro que apunta a otro, Claude termina leyendo pedazos.

La consecuencia práctica: lo importante va al principio del archivo de la habilidad, y treinta habilidades chiquitas mal descritas te estorban más que seis bien escritas. La sección 06 es justamente sobre eso.

El comando que hace la mudanza por ti

Claude Code trae un chequeo que hace buena parte de este trabajo solo. Casi todo el mundo lo conoce como el diagnóstico de instalación, y desde hace unas versiones hace bastante más que eso.

El chequeo completo, dentro de una sesión

/doctor

Lo que hace, en orden de utilidad para esta guía

  • Poda tu CLAUDE.md quitando lo que Claude puede deducir leyendo el código: mapas de carpetas, listas de dependencias, descripciones de arquitectura.
  • Conserva a propósito lo que no se adivina: las trampas, el porqué de una decisión, y las convenciones que se apartan de lo que la herramienta haría por defecto.
  • Y lo que casi nadie sabe: no solo corta. Migra lo que queda a habilidades y a archivos anidados que cargan bajo demanda. Hace la mudanza, no nada más el recorte.
  • Reporta habilidades, servidores y complementos que tienes instalados y no usas, contra lo que te ocupan de contexto.
  • Reporta primero y pregunta antes de cambiar nada. No te va a borrar el archivo por su cuenta.

Córrelo antes de empezar a mano. Lo que te proponga no lo aceptes a ciegas: la sección 08 tiene el prompt para traducir su reporte a decisiones tuyas.

La mudanza completa, en cuatro pasos

Así se parte un archivo inflado. Sirve igual si el tuyo tiene ochenta líneas que si tiene seiscientas.

01

Separa por frecuencia, no por tema

Marca cada línea con una de cuatro etiquetas: aplica siempre, aplica a ratos, solo aplica en una parte del proyecto, o Claude lo deduce solo leyendo. La última se borra sin más trámite.

02

El núcleo se queda corto

En el archivo principal solo se queda lo de «aplica siempre», y en su forma más comprimida: qué es el proyecto, cómo se corre, las trampas que cuestan una hora si no las sabes. Todo lo demás se va.

03

Lo de una zona, a una regla con rutas

Lo que solo vale para una parte del proyecto se va a un archivo de reglas con su campo de rutas. Entra solo cuando Claude toca esos archivos, y el resto del tiempo no le compite a nada.

04

Lo de a ratos, a habilidades

Cada procedimiento se vuelve una habilidad con su nombre y su cuándo. Aquí es donde la mayoría lo hace a medias: mueven el texto y se olvidan de escribir bien el cuándo, y entonces la habilidad nunca se activa sola. Eso es toda la sección siguiente.

de dónde sale cada cosa

Esta sección ordena por autoridad y por libertad, que es una pregunta de obediencia. Si lo que quieres es la otra lectura de la misma decisión —qué se carga en cada momento y qué ocupa— esa está en la guía hermana de instrucciones, junto con los perfiles de CLAUDE.md ya escritos para copiar. Instrucciones que ahorran.

04

Hazme la mudanza

cuándo usarlo

Cuando ya sabes qué se queda. Corre primero el comando de diagnóstico y después este, para lo que quedó suelto.

Prompt · partir el archivo en núcleo, reglas y habilidades

El plan completo antes de tocar nada, ruteado por cuánta libertad necesita cada cosa.

Toma mi CLAUDE.md y propón cómo partirlo. No escribas archivos todavía: quiero ver el plan primero.

Para cada bloque decide dónde va, según cuánta libertad tiene que tener Claude ahí:

CAMPO ABIERTO → se queda en el CLAUDE.md, en dos o tres líneas de objetivo. Hay muchos caminos válidos.
UNA ZONA → se va a un archivo en .claude/rules/ con su campo paths. Dime qué patrón de rutas le pondrías.
PROCEDIMIENTO CON CRITERIO → se va a una habilidad en prosa. Dame el nombre que le pondrías.
PROCEDIMIENTO FRÁGIL → habilidad con pasos exactos, porque el orden importa y equivocarse cuesta.
TIENE QUE PASAR SÍ O SÍ → no es instrucción: es hook o permiso denegado. Dime cuál.

Devuélveme una tabla con: el bloque, a dónde va, y por qué ese nivel de libertad y no el de arriba ni el de abajo.

Al final dime cuántas líneas quedaría el CLAUDE.md. Si no baja por lo menos a la mitad, dime qué me está costando trabajo soltar.
05

Escríbeme la regla por rutas

cuándo usarlo

Para cada bloque que el prompt anterior marcó como UNA ZONA.

Prompt · la regla que solo entra donde importa

Te deja el archivo escrito, con el patrón de rutas correcto para tu estructura.

Escríbeme un archivo de reglas para .claude/rules/ que aplique solo a [QUÉ PARTE DEL PROYECTO].

Antes de escribirlo, mira cómo está organizado el repositorio para escoger bien el patrón de rutas: quiero que agarre todo lo de esa zona y nada de fuera. Si hay varias formas de escribirlo, escoge la que siga funcionando cuando el proyecto crezca.

El contenido son estas instrucciones:
[PEGA AQUÍ LO QUE VA EN ESA ZONA]

Reglas de estilo para escribirlo:
- Criterios, no prohibiciones. Si algo queda como "nunca hagas", dale la vuelta.
- Nada que se pueda deducir leyendo el código de esa carpeta.
- Corto. Si pasa de 40 líneas, es que ahí adentro hay un procedimiento y debería ser una habilidad; dímelo en vez de escribirlo.

Cuando termines, dime qué líneas debo borrar del CLAUDE.md porque ya quedaron cubiertas aquí.

06 la habilidad

La descripción no es un rótulo: es la instrucción

Aquí es donde la mayoría de las mudanzas se echan a perder. La gente saca bien el procedimiento del archivo grande, lo pega en una habilidad, y le pone de descripción algo como «habilidad para reportes». Después se queja de que Claude nunca la usa.

Vale la pena volver al dato de la sección anterior: el cuerpo de tu habilidad no está cargado. Lo único cargado, siempre, desde el primer segundo, son los nombres y las descripciones de todas. Así que esa línea que escribiste de mala gana no es la etiqueta del archivo — es literalmente la única instrucción que existe el noventa y tantos por ciento del tiempo.

Escríbela como si fuera lo único que va a leer. Porque casi siempre lo es.

la fórmula

Qué hace, cuándo se usa, caso clave primero

  • En tercera persona. La descripción se inyecta donde Claude la lee como información del sistema, no como algo que tú le dices. «Arma el reporte» funciona; «yo te ayudo con reportes» y «puedes usar esto para reportes» confunden.
  • Qué hace, concreto. Nada de categorías. «Reportes» es una categoría; «llena el molde del comité con el export de ventas» es un trabajo.
  • Cuándo usarla, con las palabras reales de la gente. Incluye las frases con las que de verdad lo piden, no las que tú usarías al documentarlo.
  • El caso principal al principio. La descripción y el cuándo se juntan y se recortan a 1,536 caracteres en el listado. Si tu caso más importante está al final, es el primero que desaparece.

Tres arreglos que se ven al momento

01La descripción que no dispara

antes

Habilidad para reportes.

después

Arma el reporte mensual del comité a partir del export de ventas: llena el molde de la carpeta de reportes, calcula las variaciones contra el mes anterior y marca los riesgos. Úsala cuando pidan «el reporte del mes», «el cierre mensual», o cuando te pasen un export de ventas.

qué cambió

La primera describe una categoría. La segunda describe un momento. Claude no está buscando temas: está buscando si lo que le acabas de pedir se parece a algo. Dale con qué comparar.

02Dos habilidades que se pisan

antes

Una se llama «revisa-textos» y dice «revisa textos y sugiere mejoras». La otra se llama «revisa-copy» y dice «revisa copy y sugiere mejoras».

después

Una queda por tipo de texto: «revisa documentación técnica y material de ayuda». La otra queda por etapa: «revisa copy publicitario antes de que salga a pauta, contra la guía de marca». O se fusionan en una sola.

qué cambió

Cuando dos descripciones se solapan, Claude escoge cualquiera — el mismo problema de las reglas que se contradicen, un piso más arriba. Arreglar las dos por separado no sirve: hay que hacer que los disparadores no se toquen.

03La línea que está en los dos lados

antes

En el CLAUDE.md: «los reportes siempre llevan las variaciones contra el mes anterior». Y la misma frase, otra vez, dentro del cuerpo de la habilidad de reportes.

después

Se queda solo dentro de la habilidad. Del CLAUDE.md se borra sin dejar nota.

qué cambió

Es la cuarta mudanza aplicada a tu propio setup. La copia del archivo grande está pagando atención todos los turnos para una instrucción que solo importa cuando la habilidad corre. Y el día que actualices una y te olvides de la otra, tienes una contradicción.

Dos tipos de habilidad, y se escriben distinto

Antes de escribir el cuerpo conviene saber cuál de las dos estás haciendo, porque cambia todo: quién la invoca, qué lleva adentro y qué tan larga puede ser.

De referencia

Conocimiento que Claude aplica a lo que ya estaba haciendo: convenciones, criterios, cómo funciona algo tuyo.

Quién la abre: La abre Claude solo, cuando el trabajo se le parece. Muchas veces conviene sacarla del menú para que no estorbe.

Ejemplo: Cómo funciona el sistema viejo de facturación y por qué esa tabla tiene ese nombre raro.

De tarea

Instrucciones paso a paso para hacer una cosa concreta, con principio y final.

Quién la abre: La disparas tú por su nombre. Si tiene efectos hacia afuera, se le pone el candado para que Claude no decida el momento.

Ejemplo: Publicar una versión: correr pruebas, generar el registro de cambios, subir.

Los campos que deciden si se activa

CampoQué haceCuándo lo usas
descriptionQué hace la habilidad y cuándo usarla. Es lo que Claude lee para decidir si la abre. El único campo que de verdad conviene escribir siempre.Siempre.
when_to_useContexto extra del cuándo: frases con las que la gente lo pide, ejemplos de petición. Se pega a la descripción en el listado.Cuando la descripción ya quedó llena y todavía te faltan disparadores por cubrir.
nameEl nombre que se muestra en los listados. Si no lo pones, se usa el de la carpeta.Casi nunca hace falta tocarlo.
pathsPatrones de archivo que limitan la activación automática. Con esto puesto, Claude solo la considera cuando está trabajando con archivos que hacen match.Cuando la habilidad solo tiene sentido en una parte del proyecto y en el resto sería ruido.
disable-model-invocationEl primer candado: solo tú la puedes disparar, escribiendo su nombre. Claude no la abre por su cuenta.Todo lo que tiene efectos hacia afuera: publicar, mandar, cobrar, desplegar. No quieres que decida el momento.
user-invocableEl segundo candado, al revés: en falso, desaparece del menú y solo Claude la puede abrir.Conocimiento de fondo que no es una acción. Un manual de cómo funciona un sistema viejo sirve mucho, pero no es algo que tú «ejecutes».

Y el cuerpo, con tres reglas

  • Menos de 500 líneas. Si crece más, se parte en archivos que la habilidad señala y que solo se leen cuando hacen falta.
  • Las referencias a un solo nivel de profundidad. Si un archivo apunta a otro que apunta a otro, Claude termina asomándose en vez de leer completo, y se le van datos.
  • Lo importante al principio. Es la misma razón que en la descripción: cuando algo se recorta, se recorta por el final.

Y el mismo filtro que usaste con el archivo grande aplica aquí: si una línea del cuerpo es algo que Claude ya sabe, no la escribas. La documentación de autoría lo pone como pregunta directa: «¿este párrafo justifica lo que ocupa?».

por qué no puedes tener cincuenta

El estante también tiene tope

Como los nombres y las descripciones de todas tus habilidades están cargados siempre, ese listado tiene su propio presupuesto: el equivalente al 1% de la ventana de contexto.

Cuando se desborda, no falla nada visible — y ese es el problema. Las descripciones se van recortando, empezando por las habilidades que menos usas. Te quedas con el nombre y sin las palabras que hacían que se disparara. La habilidad sigue ahí, aparentemente bien, y ya no se activa nunca.

Las tres salidas

  • Borra las que no usas. Es la respuesta correcta nueve de cada diez veces, y el chequeo del comando de diagnóstico te dice cuáles son y cuánto te cuesta el listado.
  • A las que quieres conservar por si acaso, márcalas para que aparezcan solo con el nombre. Siguen disponibles para dispararlas tú, y dejan de gastar presupuesto.
  • Y si de verdad necesitas más, se puede subir la fracción del presupuesto en la configuración. Es la última opción, no la primera.

Instalar habilidades sale gratis y por eso todo el mundo tiene más de las que usa. Pero el estante lleno le quita palabras a las que sí trabajan. Seis habilidades bien descritas rinden más que treinta a medias.

06

Sácame la habilidad de este bloque

cuándo usarlo

Para cada procedimiento que salió del archivo grande. Uno a la vez, no en lote.

Prompt · de sección de CLAUDE.md a habilidad completa

Crea el archivo con su frontmatter, decide el grado de libertad y te dice qué borrar del original.

Convierte este bloque de mi CLAUDE.md en una habilidad completa, en .claude/skills/.

El bloque es:
[PEGA AQUÍ LA SECCIÓN]

Antes de escribir, decide y dime dos cosas:
1. ¿Es de referencia (conocimiento que se aplica) o de tarea (pasos con principio y final)?
2. ¿Cuánta libertad? Prosa si hay varios caminos válidos; pasos exactos si es frágil y equivocarse cuesta.

Después escríbela así:
- La descripción dice qué hace y cuándo usarla, en tercera persona, con el caso más importante al principio y con las frases reales con las que yo lo pediría.
- Si es de tarea y tiene efectos hacia afuera, ponle disable-model-invocation.
- Si solo aplica a una parte del proyecto, ponle paths.
- Si no debe editar nada, quítale las herramientas de edición.
- El cuerpo por debajo de 500 líneas, lo importante arriba, y si necesita material de apoyo que sea en archivos aparte referenciados a un solo nivel.
- No escribas nada que yo ya sepa que Claude sabe. Por cada párrafo pregúntate si justifica lo que ocupa.

Termina diciéndome exactamente qué líneas borro del CLAUDE.md ahora que esto vive aquí.
07

Escribe la descripción que sí dispara

cuándo usarlo

Cuando tienes una habilidad que existe y funciona, pero Claude nunca la abre solo.

Prompt · el disparador, escrito y probado

Reescribe la descripción y después la prueba contra diez peticiones reales antes de que la uses.

Mi habilidad [NOMBRE] nunca se activa sola. Arréglale la descripción.

Primero léela y dime en una línea por qué no dispara. Las causas típicas: describe una categoría en vez de un momento, está en primera persona, o se pisa con otra habilidad mía.

Después escríbela de nuevo:
- Tercera persona.
- Qué hace, concreto, no la categoría.
- Cuándo usarla, con las palabras con las que la gente de verdad lo pide — no con las que yo usaría al documentarla.
- El caso más importante primero, porque la descripción se recorta por el final.

Y luego pruébala, que es la parte que casi nadie hace: invéntate diez peticiones realistas de mi trabajo — seis que SÍ deberían activarla y cuatro que NO, incluyendo dos parecidas a propósito. Para cada una dime si con esta descripción se activaría, y si alguna sale mal, arregla la descripción y vuelve a probar.

Revisa también mis otras habilidades: si alguna se solapa con esta, dímelo y propón cómo hacer que los disparadores no se toquen.
08

Audita mi estante

cuándo usarlo

Cada tanto, y sobre todo si tienes más de quince habilidades instaladas.

Prompt · qué sobra en el listado que está cargado siempre

Lista todas, marca las que nunca disparan, las que se pisan y las que solo estás guardando por si acaso.

Haz inventario de todas las habilidades que tengo disponibles, las mías y las que vinieron con complementos.

Para cada una: nombre, qué hace en cinco palabras, y de dónde salió.

Después clasifícalas:
- LAS QUE USO — dime en qué se nota.
- NUNCA DISPARAN — están bien hechas pero la descripción no las alcanza a activar.
- SE PISAN — dos o más compiten por el mismo tipo de petición.
- NO LAS USO — instaladas y olvidadas.

Recuerda que los nombres y descripciones de TODAS están cargados siempre y que ese listado tiene un tope; cuando se desborda se recortan descripciones empezando por las menos usadas.

Recomiéndame, en orden: cuáles borrar, cuáles dejar solo con el nombre para que no gasten presupuesto pero las pueda seguir disparando yo, y cuáles fusionar. Corre /doctor y úsalo para respaldar o corregir tu lista.

07 comandos y agentes

Encadenar, en vez de acumular

Hasta aquí el trabajo fue de resta: borrar, reescribir, mudar. Esta sección es la de suma, y es la que hace que todo lo anterior valga la pena. Porque el punto de partir tu archivo en piezas no es tener piezas: es poder combinarlas distinto según el trabajo.

Y hay un cambio de fondo que casi nadie registró: los comandos personalizados y las habilidades se fusionaron. Un archivo en la carpeta de comandos y una habilidad con ese nombre producen exactamente lo mismo. Lo viejo sigue funcionando; lo nuevo trae más perillas.

la definición corta

Un comando es una habilidad con candado

No hay dos conceptos: hay uno con dos modos de disparo. Una habilidad la puede abrir Claude cuando ve que viene al caso, y la puedes escribir tú por su nombre. Ponle el candado de invocación y solo la disparas tú — eso es lo que la gente llama «un comando». Quítale la visibilidad del menú y solo la abre Claude — eso es conocimiento de fondo.

Quién la disparaCómo se configuraPara qué sirve
Los dosSin tocar nada. Es lo que pasa por defecto.La mayoría. Procedimientos que quieres a la mano y que además Claude puede reconocer solo.
Solo túCon el candado de invocación del modelo puesto.Todo lo que tiene efectos hacia afuera. No quieres que Claude decida que ya es hora de publicar porque el código se ve listo.
Solo ClaudeQuitándole que sea invocable por el usuario.Manuales y contexto de fondo. Que exista en el menú un comando llamado «cómo-funciona-el-sistema-viejo» no le sirve a nadie.

El nombre del comando sale de la carpeta donde vive el archivo, no del campo de nombre. Una habilidad en una carpeta llamada «entrega» se dispara escribiendo su nombre, y ya.

Los campos que deciden cómo corre

CampoQué haceCuándo lo usas
argument-hintLa pista que se muestra mientras escribes el comando, para recordarte qué espera.Cualquier comando que reciba algo. Es cortesía contigo mismo.
argumentsNombra los argumentos por posición para poder llamarlos por nombre dentro del texto.Cuando son dos o más y confundirlos sería fácil.
allowed-toolsHerramientas que puede usar sin pedirte permiso durante ese turno. El permiso se cancela solo cuando mandas tu siguiente mensaje.Comandos que corren un script propio, para que no te interrumpa a la mitad.
disallowed-toolsHerramientas que se le quitan de las manos mientras esta habilidad está activa.Una habilidad de revisión que no debe editar nada. Se lo quitas y ya no hay discusión.
modelCambia de modelo mientras esta habilidad está activa, y regresa al tuyo después.Trabajo mecánico y repetitivo donde no necesitas el modelo más pesado.
effortSube o baja el nivel de esfuerzo solo para esta habilidad.Una revisión adversarial que quieres con esfuerzo alto, o un formateo que no lo necesita.

Los huecos que se rellenan solos

Dentro del texto de una habilidad puedes dejar marcadores que se rellenan al momento de ejecutarla. Son la diferencia entre un comando fijo y uno que sirve para veinte casos.

El marcadorCon qué se rellena
$ARGUMENTSTodo lo que escribiste después del nombre del comando, tal cual.
$0, $1, $2…Cada argumento por separado, contando desde cero. Lo de varias palabras va entre comillas.
$nombreEl argumento que declaraste con ese nombre en el campo de argumentos.
${CLAUDE_SKILL_DIR}La carpeta donde vive el archivo de la habilidad. Para llamar a un script que empaquetaste con ella, sin importar desde dónde la corras.
${CLAUDE_PROJECT_DIR}La raíz del proyecto. Para apuntar a archivos del repositorio.
${CLAUDE_SESSION_ID}El identificador de la sesión. Útil para dejar registros separados por corrida.
${CLAUDE_EFFORT}El nivel de esfuerzo activo, por si quieres que la habilidad se comporte distinto según eso.

antes de escribir el tuyo

El comando que no debería existir

Si tu comando nuevo repite algo que ya dice tu archivo de instrucciones, borra uno de los dos. Un comando que repite no es un atajo: es una contradicción esperando su turno, porque el día que actualices uno vas a olvidar el otro. Y antes de inventar cualquiera, vale la pena mirar los que ya vienen puestos — buena parte de los que la gente escribe ya existían de fábrica.

Tres comandos, de tres formas distintas

El primero encadena, el segundo aprieta y el tercero suelta. Entre los tres está casi todo lo que vas a necesitar escribir.

01

El compositor

Un comando cuyo trabajo no es hacer nada, sino llamar a tres habilidades en orden y decidir qué se pasan entre ellas.

Que un comando puede ser de quince líneas y valer más que una habilidad de trescientas. Lleva el candado porque publica, y las herramientas acotadas para que no te interrumpa a media corrida.

el archivo va en .claude/skills/entrega/SKILL.md

El compositor

.claude/skills/entrega/SKILL.md

---
description: Prepara y publica una entrega completa. Úsala cuando digan "sacamos versión", "publicar release" o "preparar la entrega".
argument-hint: [version]
disable-model-invocation: true
allowed-tools: Bash(git status), Bash(git log *), Bash(git tag *)
---

Prepara la entrega $ARGUMENTS. Tres pasos, en orden, y no sigas al
siguiente si el anterior encontró algo que arreglar.

1. Corre la habilidad de revisión sobre los cambios desde la última
   etiqueta. Si sale algo bloqueante, párate aquí y dime qué es.
2. Con la revisión limpia, corre la habilidad de registro de cambios
   y pásale la lista de commits que ya tienes de arriba.
3. Con el registro escrito, corre la habilidad de publicación.

Cuando termines, dime en tres líneas qué se publicó y qué quedó fuera.
02

El de pasos exactos

Un procedimiento frágil donde la consistencia importa más que la elegancia. Aquí sí se dictan los pasos.

El otro extremo de la tabla de libertad. Y el truco de quitarle las herramientas de edición: una habilidad que revisa no debe poder arreglar lo que encuentra, porque entonces nunca te enteras de qué había.

el archivo va en .claude/skills/revisa/SKILL.md

El de pasos exactos

.claude/skills/revisa/SKILL.md

---
description: Revisa los cambios pendientes contra la lista de siempre, sin tocar nada. Úsala antes de subir, cuando pidan "revisa esto" o "qué se me fue".
disallowed-tools: Edit Write
effort: high
---

Revisa lo que está sin subir. No edites nada: solo reporta.

Corre exactamente estos cuatro pasos, en este orden:

1. Lista los archivos con cambios y léelos completos.
2. Por cada archivo, compáralo contra el archivo vecino del mismo
   tipo. Lo que se salga del estilo de al lado, anótalo.
3. Busca datos que no deberían estar escritos en el código:
   llaves, contraseñas, rutas de la máquina de alguien.
4. Devuélveme una lista ordenada de lo más grave a lo más leve.
   Si no hay nada, dilo en una línea y no inventes hallazgos.
03

El de campo abierto

Arrancar un trabajo nuevo donde hay muchos caminos válidos y todavía no sabes cuál es el bueno.

Que un comando útil puede ser objetivo y nada más. Cuatro líneas, cero pasos. Esto es lo que Anthropic hizo con la mayor parte de su propio prompt.

el archivo va en .claude/skills/arranca/SKILL.md

El de campo abierto

.claude/skills/arranca/SKILL.md

---
description: Arranca un trabajo nuevo entendiendo primero el terreno. Úsala al empezar algo desde cero o al entrarle a una parte del proyecto que no conoces.
argument-hint: [qué vas a construir]
---

Vamos a empezar: $ARGUMENTS

Antes de escribir nada, entiende cómo se hace algo parecido en este
proyecto y sigue ese camino. Si no hay nada parecido, dime qué tres
opciones ves y cuál recomiendas, y espera a que escoja.

Termina cuando funcione de verdad en el lugar donde vive, no cuando
el archivo esté escrito.

Habilidades y agentes se conectan en dos sentidos

Esta es la parte que más confunde, y una tabla la resuelve. La pregunta es cuál de las dos piezas es el trabajo: el procedimiento o el trabajador.

A · la habilidad se bifurcaB · el agente precarga habilidades
Cómo se armaA la habilidad le pones que corra en contexto bifurcado y de qué tipo es el agente.Al agente le pones una lista de habilidades que se le cargan al arrancar.
Quién pone el prompt de sistemaEl tipo de agente que escogiste.El propio archivo del agente: su cuerpo es su prompt.
Quién pone la tareaEl cuerpo de la habilidad se vuelve la tarea.El mensaje con el que Claude le delega en ese momento.
Cuándo convieneCuando el procedimiento ES el trabajo y lo corres igual siempre: auditar, explorar, investigar.Cuando el trabajador es el trabajo: va a resolver casos distintos aplicando el mismo criterio.
Qué se rompe si te equivocasSi la habilidad es puro criterio y no trae una tarea, el subagente recibe recomendaciones y ninguna orden, y vuelve sin nada.Si le precargas seis habilidades, le llenaste el estante al agente con el mismo problema que acabas de arreglar en tu sesión.

Dato útil de la letra chica: los agentes de exploración y de planeación no cargan tu CLAUDE.md, a propósito, para mantener su contexto chico. Si uno de esos necesita una convención tuya, se la tienes que dar por habilidad — no la va a heredar.

Los campos que la convierten en agente

CampoQué haceCuándo lo usas
context: forkLa habilidad deja de correr en tu conversación y corre en un contexto aparte. El cuerpo del archivo se vuelve la tarea de ese subagente, que no ve tu historial.Trabajo que genera mucho ruido y del que solo te interesa el resultado: explorar, auditar, investigar.
agentQué tipo de subagente lo ejecuta. De ahí sale su prompt de sistema, sus herramientas y sus permisos.Siempre que uses el anterior. Si no lo pones, corre con el de propósito general.
backgroundPor defecto corre en segundo plano y te avisa cuando termina. En falso, esperas el resultado en el mismo turno.En falso cuando lo que sigue depende del resultado y no puedes avanzar sin él.

Y la plantilla de un agente corto

Un subagente no necesita saber todo lo que sabes tú: necesita saber una cosa muy bien. Su prompt es más corto que tu archivo de instrucciones, no más largo. Cinco huecos y ya.

Plantilla · el agente de quince líneas

Un subagente no necesita saber todo lo que sabes tú: necesita saber una cosa muy bien. Su prompt es más corto que tu archivo de instrucciones, no más largo. Cinco huecos y ya.

Compáralo con el prompt de agente de ochenta líneas que casi todos escribimos la primera vez, con su personalidad, sus siete principios y sus reglas de formato. Hace lo mismo peor, porque las ochenta líneas compiten entre ellas igual que en tu archivo grande.

el archivo va en .claude/agents/investigador.md

Plantilla · el agente de quince líneas

.claude/agents/investigador.md

---
description: Investiga una parte del proyecto y devuelve un resumen corto con rutas concretas.
tools: Read, Grep, Glob
---

Tu único trabajo es entender una parte de este proyecto y explicarla.

Recibes: una pregunta sobre cómo funciona algo aquí adentro.

Devuelves: máximo quince líneas. Qué hace, dónde vive cada pieza con
su ruta, y qué te sorprendió. Si algo no lo pudiste confirmar, dilo
en vez de suponerlo.

No tocas: no edites, no crees archivos, no corras nada que cambie
cosas. Solo lees.

Si necesitas las convenciones del proyecto, están en la habilidad de
convenciones; ábrela en vez de adivinar.

Los cinco huecos, por si escribes el tuyo

  • Un solo trabajo, dicho en una frase. Si necesitas dos frases con «y», son dos agentes.
  • Qué recibe.
  • Qué devuelve, con el formato y el largo. Esto es lo que más se olvida y lo que más se nota: sin límite, un subagente te devuelve tres pantallas.
  • Qué no toca. Un agente que solo lee tiene que tenerlo escrito y además tenerlo en sus herramientas.
  • A qué habilidad acudir. Es el enganche: en vez de copiarle las convenciones, le dices dónde están.

Cómo se ve armado, de punta a punta

Las tres piezas de esta guía, conectadas en un solo flujo. Este es el resultado de haber partido el archivo grande.

01

Escribes el comando

Un archivo de quince líneas con el candado puesto. No hace el trabajo: decide el orden.

02

El comando se bifurca

Corre en un contexto aparte, con un tipo de agente que solo puede leer. Tu conversación no se entera de nada de lo que pasa adentro.

03

El agente abre sus habilidades

Dos manuales que ya escribiste: las convenciones del proyecto y la lista de revisión. No se los copiaste: los abre cuando le tocan.

04

Te devuelve doce líneas

Leyó cuarenta archivos y te contesta con lo que importa. Todo el ruido se quedó del otro lado.

Antes esto habría sido una sección de ciento cincuenta líneas dentro de tu archivo de instrucciones, cargada todo el tiempo, aplicando el 3% de las veces. Ahora son cuatro piezas chicas que solo existen cuando las llamas.

antes de que lo prendas todo

Un contexto bifurcado es un contexto sin testigos

Toda la gracia de mandar el trabajo a un lado es que no ves el proceso. Esa también es toda la desventaja. Aquí es donde más pega el caso que se contó al principio: si un subagente decide hacer algo que no querías, te enteras al final. Por eso, en agentes que corren aparte, los permisos importan más que en tu sesión, y la regla de darles solo las herramientas que necesitan deja de ser higiene y se vuelve el freno principal. Un agente que solo va a leer no debería tener con qué escribir.

09

Ármame el comando que junta estas habilidades

cuándo usarlo

Cuando ya tienes tres habilidades sueltas que siempre corres en el mismo orden.

Prompt · el comando compositor

Un archivo corto cuyo trabajo es el orden, no el contenido.

Quiero un comando que encadene estas habilidades mías: [NÓMBRALAS EN ORDEN].

El comando no debe hacer el trabajo: debe decidir el orden y qué se pasan entre ellas. Que sea corto — si pasa de veinte líneas, es que le estás metiendo lógica que pertenece a una de las habilidades.

Escríbelo con:
- Descripción con las frases reales con las que yo lo pediría.
- disable-model-invocation si tiene efectos hacia afuera, porque no quiero que Claude decida el momento.
- argument-hint para acordarme de qué espera.
- allowed-tools acotado a lo mínimo, para que no me interrumpa a media corrida.
- Instrucción explícita de parar si un paso encuentra algo bloqueante, en vez de seguir al siguiente.
- Un cierre que me resuma en tres líneas qué pasó.

Antes de escribirlo, revisa si Claude Code ya trae un comando que haga esto. Si ya existe, dímelo y no escribas nada.
10

Conviértela en subagente

cuándo usarlo

Cuando una habilidad hace mucho ruido —lee treinta archivos— y a ti solo te interesa el resultado.

Prompt · sacar el trabajo de tu conversación

Decide entre las dos direcciones y te deja el archivo con los campos correctos.

Quiero sacar mi habilidad [NOMBRE] de mi conversación para que no me llene el contexto.

Primero decide cuál de las dos direcciones me conviene y explícame por qué en tres líneas:

A. La habilidad corre en contexto bifurcado, con un tipo de agente que yo escojo. Sirve cuando el procedimiento ES el trabajo y siempre se corre igual.
B. Un subagente con habilidades precargadas. Sirve cuando el trabajador es el trabajo y va a resolver casos distintos con el mismo criterio.

Ojo con esto: si mi habilidad es puro criterio y no trae una tarea, la opción A no funciona — el subagente recibe recomendaciones y ninguna orden, y vuelve sin nada. Si es el caso, dímelo y arregla el cuerpo antes.

Después escríbeme el archivo, con:
- El tipo de agente que le conviene y por qué.
- Si debo esperar el resultado en el mismo turno o dejar que llegue después.
- Las herramientas recortadas a lo mínimo. Si solo va a leer, que no tenga con qué escribir — cuando corre aparte nadie está mirando.
- Qué formato y qué largo máximo tiene que devolverme.
11

Escríbeme el prompt del agente en quince líneas

cuándo usarlo

Cuando vas a crear un subagente nuevo, o cuando ya tienes uno de ochenta líneas que se comporta raro.

Prompt · el agente corto, con sus cinco huecos

Un trabajo, qué recibe, qué devuelve, qué no toca y a qué habilidad acude.

Escríbeme el prompt de un subagente que [QUÉ HACE, EN UNA FRASE].

Máximo quince líneas de cuerpo. Si no cabe, no es que necesites más espacio: es que le estás pidiendo dos trabajos, y entonces dímelo y propón cómo partirlo en dos agentes.

Los cinco huecos, en este orden:
1. Su único trabajo, en una frase. Si necesitas una "y", son dos agentes.
2. Qué recibe.
3. Qué devuelve: formato y largo máximo. Sin esto me va a contestar tres pantallas.
4. Qué no toca, escrito y además reflejado en las herramientas que le das.
5. A qué habilidad mía acudir si le falta contexto, en vez de copiarle las convenciones aquí.

No le pongas personalidad, ni principios, ni reglas de formato de más. Cada línea que agregues le compite a las otras — que es el mismo problema que estamos arreglando en el archivo grande.

Si ya tengo un agente parecido en .claude/agents/, dímelo antes de escribir otro.

08 la auditoría

Comprobar que de verdad quedó mejor

Recortar se siente productivo, y esa sensación es justo el riesgo: borras cuarenta líneas, el archivo se ve limpio, y no tienes ni idea de si el resultado mejoró. Esta última sección es para no quedarte con la sensación.

Primero: hay una capa que ahora se escribe sola

La quinta mudanza es la única que no requiere trabajo de tu parte, y por eso es la que más gente tiene sin revisar. Claude guarda por su cuenta las notas que le sirven —cómo trabajas, qué prefieres, qué aprendió del proyecto— y las vuelve a leer en cada sesión.

Lo que conviene saber

  • Viene prendida por defecto y se puede apagar por proyecto o del todo.
  • Vive en una carpeta por repositorio, con un índice que se carga en cada sesión y archivos por tema que solo se leen cuando hacen falta.
  • Del índice se cargan las primeras 200 líneas, o los primeros 25 KB, lo que llegue primero. Lo que pase de ahí no entra, aunque esté escrito.
  • Son archivos de texto normales: los puedes abrir, corregir y borrar cuando quieras.

Lo que ya puedes borrar de tu archivo

Todo lo que escribiste para que Claude te conociera. Cómo te llamas, en qué trabajas, que prefieres respuestas directas, que no hace falta que te explique lo básico. Eso ahora se escribe solo, y tenerlo en las dos partes es la cuarta mudanza al revés.

el problema nuevo

Tu memoria automática puede pelearse con tus reglas

Esta es la consecuencia que casi nadie está viendo. Antes tenías una sola fuente de instrucciones persistentes: la que escribías tú. Ahora tienes dos, y la segunda cambia sin avisarte.

el choque típico

En tu archivo dice «no me des opciones, decide tú y avanza». En la memoria, después de tres sesiones en las que le pediste alternativas, Claude anotó «al usuario le gusta ver opciones antes de decidir». Las dos son ciertas. Juntas son una contradicción, y ya sabes qué pasa con las contradicciones: elige cualquiera, y elige distinto cada vez.

Cómo se arregla

  • Ábrela y léela. Es lo primero, y casi nadie lo ha hecho una sola vez.
  • Si una nota contradice una regla tuya, decide cuál de las dos tiene razón hoy. Muchas veces la memoria tiene razón y la regla es vieja.
  • Borra la que perdió. En los dos sentidos: borrar la nota es tan válido como borrar la regla.

Los tres comandos, leídos para otra pregunta

Estos tres se usan mucho para saber qué se cargó y cuánto ocupa. Aquí se usan para una pregunta distinta: cuántas órdenes hay vivas ahora mismo, y cuáles se están cancelando entre ellas.

/context

¿Cuántas órdenes están activas en este momento?

Busca la fila de habilidades: te dice cuánto ocupa el listado después de aplicarle su presupuesto, o sea lo que Claude de verdad está viendo. Y busca el cuerpo de esa habilidad que abriste hace veinte turnos — sigue ahí, y sigue dando órdenes.

/memory

¿Qué anotó Claude por su cuenta?

Lista tus archivos de instrucciones y la carpeta de memoria automática, y te deja abrir cualquiera. Es por donde se entra a revisar el choque de arriba.

/doctor

¿Qué me sobra y qué debería mudarse?

Además de la poda, te estima lo que te cuesta el listado de habilidades y cuáles son los que más pesan. Reporta primero y pregunta antes de tocar nada.

la otra lectura

Si lo que quieres es la lectura de consumo de estas mismas pantallas —cuánto ocupa cada cosa y cómo hacer que te rinda la sesión— eso está en la guía hermana de instrucciones y en la de ahorro de tokens, que la traen a fondo. Aquí solo nos interesa cuántas voces le están hablando a Claude al mismo tiempo. Ahorra tokens en Claude Code.

La única prueba que vale

Ninguna de las pantallas de arriba te dice si el recorte sirvió. Eso solo se sabe de una forma, y es más fácil de lo que suena.

01

Guarda tres peticiones reales

Antes de tocar nada. No ejemplos bonitos: tres cosas que de verdad le pediste esta semana, junto con la respuesta que te dio.

02

Haz el recorte completo

Todo de una, no a cachitos. Si lo haces poco a poco nunca vas a saber qué movimiento causó qué.

03

Corre las mismas tres en sesión limpia

Y compara. No busques si la respuesta salió más larga o más corta: busca si hizo lo que querías sin que se lo tuvieras que repetir.

04

Para las habilidades, prueba el disparo

Cinco peticiones: tres que deberían activarla y dos que no. Si falla, se arregla la descripción, nunca el cuerpo.

Si una de las tres salió peor, ya sabes qué línea andabas necesitando y la puedes regresar sola, en vez de regresar el archivo entero por miedo.

por si acaso

Y si te pasaste de recorte

Se nota rápido y se nota en algo concreto: te encuentras repitiendo en el chat una instrucción que antes estaba escrita. Esa es la señal, y es la buena, porque te dice exactamente cuál línea hacía falta. Regrésala — pero regrésala reescrita como criterio, no como estaba. Y si vuelve a hacer falta una tercera vez, deja de escribirla y conviértela en habilidad: eso es justo lo que dice la documentación que es el momento de crear una.

Un último recordatorio, que es la letra chica de toda la guía: esto es para los modelos de la generación Claude 5. Si estás trabajando con uno de generación anterior, tus instrucciones largas siguen haciendo su trabajo y recortarlas te va a costar. Antes de borrar nada, mira con qué modelo estás.

12

Mídeme si sirvió

cuándo usarlo

Después del recorte. Y si puedes, guarda las tres respuestas de referencia ANTES de empezar.

Prompt · la comparación antes y después

Compara contra peticiones reales tuyas y te dice qué línea regresar si algo salió peor.

Voy a comprobar si el recorte de mis instrucciones sirvió o no.

Aquí están tres peticiones reales de mi trabajo, con la respuesta que me diste ANTES del recorte:
[PEGA AQUÍ LAS TRES, CON SU RESPUESTA]

Vuelve a resolver las tres con las instrucciones que tengo ahora. Después compara, y para cada una dime:

- ¿Hizo lo que yo quería sin que se lo tuviera que repetir? Esa es la pregunta, no si la respuesta es más larga o más corta.
- ¿Se le fue algo que antes sí hacía?
- Si se le fue algo: qué línea exacta de las que borré lo estaba cubriendo.

Para las que salieron peor, no me propongas regresar el archivo completo. Regrésame solo esa línea, reescrita como criterio y no como prohibición, y dime en qué capa debería vivir ahora.

Al final corre /doctor y tradúceme su reporte a decisiones concretas: qué le acepto, qué le rechazo y por qué. No lo apliques sin preguntarme.

Guía de la comunidad

Esta guía es parte de la bóveda de la comunidad de tododeia.

de dónde salió todo esto

Nada de lo que leíste aquí es interpretación mía sobre lo que hizo Anthropic. El suceso y las seis mudanzas están firmados; los límites y los campos de configuración están en la documentación. Si algo de la guía te suena raro, ve a la fuente y dime.

Guías hermanas · antes o después de esta

por qué escribí esta

Porque me sacó de onda. Llevo dos años diciéndole a la gente que le escriba instrucciones más completas a su IA, y resulta que los que construyen la herramienta acaban de hacer justo lo contrario con la suya, y les fue mejor. Cuando el que lo hizo publica el antes y el después de su propio archivo, ya no es opinión de nadie: es algo que puedes ir a leer. Y si eso es cierto, entonces mi archivo —y el tuyo— está inflado.

Lo honesto antes de cerrar

Esto aplica a la generación Claude 5. Con modelos anteriores tus instrucciones largas siguen ganándose su lugar, y recortarlas te va a costar. Tampoco es un método que se corra una vez y ya: la memoria automática cambia sola, tus habilidades se acumulan y en tres meses vas a tener otro archivo inflado, distinto. Guarda las tres peticiones de prueba de la sección 08 en algún lado — son lo único que te va a decir si el recorte de la próxima vez sirvió o solo se sintió bien.