Claude Code: que te hable en simple (el estándar de los aviones)

Son dos cosas que el vídeo junta:

• Un estilo de salida (output style): una forma de decirle a Claude Code, una sola vez, cómo quieres que te hable. No es una receta de trabajo: son instrucciones que se pegan al final de su «manual de instrucciones» y valen para todas las respuestas de la conversación. Claude Code trae cuatro de serie (el normal y tres más: Proactive, Explanatory y Learning), y puedes escribir el tuyo en un fichero de texto.
• El ASD-STE100: el estándar con el que se escriben los manuales de mantenimiento de los aviones, para que un mecánico cansado y con poco inglés no se equivoque. Es un lenguaje controlado: palabras comunes y aprobadas, un significado por palabra (nada de sinónimos: start, nunca begin ni commence), voz activa, sin formas en «-ing», y reglas de tamaño: 20 palabras por frase (25 en las explicaciones) y 6 frases por párrafo.

La gracia: esas reglas están escritas para que nadie tenga que releer. Es justo lo que quieres de un asistente al final del día.

Para que no te canses leyendo. Con el estilo puesto, Claude deja de soltarte bloques de texto y te contesta con lo que de verdad importa:

• Qué hizo, si funcionó y qué haces ahora.
• Palabras que entiendes; si usa una difícil, te la explica justo después.
• Comandos, rutas y nombres exactos, que es donde una respuesta «resumida» te puede fastidiar.
• Si tienes que decidir algo, dos opciones como mucho y cuál elegiría él.

Y lo mejor: se configura una vez. Nada de escribir «sé más conciso» en cada conversación.

• Abre Claude Code y escribe:

/config

Ahí verás Output style. Mira lo que hay de serie antes de tocar nada.

• Si te aparece uno llamado Concise (responder corto), pruébalo primero: igual te basta. Se activa en ese mismo menú.

• Si quieres el del vídeo, créate el tuyo. Haz un fichero nuevo:

~/.claude/output-styles/claro.md

con este contenido (esta es la parte que se copia):

---
name: Claro y corto
description: Palabras comunes y frases cortas, como un manual de aviación
keep-coding-instructions: true
---

Escribe también tu propio razonamiento siguiendo las reglas del ASD-STE100,
adaptadas al idioma en el que te escribo:

- Contéstame siempre en el idioma en el que te estoy escribiendo.
- Palabras comunes, y una palabra con un solo significado: no cambies de palabra para lo mismo.
- 20 palabras por frase como máximo (25 si es una explicación). Una idea por frase.
- 6 frases por párrafo como máximo.
- Voz activa y tiempos simples (hice, hago, haré). Nada de pasiva.
- Si usas una palabra difícil, explícala justo después.
- Cuéntame solo lo que hace falta: qué hiciste, si funcionó y qué hago ahora.
- Si tengo que decidir, dos opciones como mucho, qué necesito saber para elegir y cuál elegirías tú.
- Rutas, comandos y nombres: escríbelos exactos, sin cambiar nada.
- Sin relleno y sin repetirme lo que acabo de decir.

• Vuelve a /config, elige Claro y corto en la lista de estilos y listo.

• Si te pide hacer algo, es porque el estilo se lee al abrir la conversación: hazlo (o escribe /clear y vuelve a preguntar) y desde ahí todo va con ese estilo.

Si lo quieres solo para un proyecto (no para todo el ordenador), el mismo fichero en .claude/output-styles/ dentro de ese proyecto. Y si lo que quieres apuntar son cosas del proyecto (cómo se llama la carpeta, qué no tocar), eso va en CLAUDE.md, no aquí.

• El estándar es de inglés. Lo que le pides a Claude son sus principios (frases cortas, una idea por frase, voz activa) en tu idioma, no una traducción del estándar. El propio estándar dice que sus principios sirven fuera de la aeronáutica.
• No es hablar como a un niño. En su web oficial lo aclaran: no es una versión infantil del inglés, es un estándar estricto para describir cosas complicadas sin que nadie se equivoque.
• Los números vienen del estándar: 20 palabras por frase (25 en textos descriptivos) y 6 frases por párrafo (reglas 5.1, 6.3 y 6.6). Los he visto citados en varias webs que lo transcriben; el PDF oficial es gratis y se pide en su web.
• El comando /output-style ya no existe (se dejó de usar en la versión 2.1.73 y se quitó en la 2.1.91). Ahora se elige en /config o escribiendo "outputStyle" en los ajustes. Si ves un tutorial con /output-style, es viejo.
• Cambia cómo te habla, no lo que sabe. No le hace más listo: le quita paja. Y afecta a la conversación principal; los agentes que lanza por dentro llevan su propio manual.
• Si copias un estilo de internet, léelo antes. Es texto, y le estás dando el mando de cómo te responde.

1. He puesto el estilo y sigue igual. Se lee al empezar la conversación: escribe /clear o abre una conversación nueva.

2. No me sale en la lista. El fichero tiene que estar en ~/.claude/output-styles/ y empezar con el bloque de arriba entre ---. El nombre de la lista sale del nombre del fichero, salvo que pongas name:.

3. Al rato se le olvida. En conversaciones muy largas las reglas se van diluyendo: /clear y a seguir, o pídeselo en el momento («en simple, por favor»).

4. Ahora programa peor o se salta pasos que te gustaban. Es porque al hacer un estilo propio se quitan las instrucciones de programación que trae Claude Code. Se arregla poniendo keep-coding-instructions: true (como arriba).