Descripción: Cómo crear instrucciones claras para Claude
Una vez que hayas decidido que una tarea merece ser delegada, la siguiente pregunta es cómo decirle a Claude lo que realmente necesitas.
Esa es la Descripción, la segunda de las cuatro prácticas en el Marco de Fluidez de IA de Anthropic Academy.
Es fácil subestimarla, porque una instrucción básica como "escribe un resumen" siempre producirá algo.
El problema es que algo plausible no es lo mismo que algo útil, y la brecha entre ambos es casi siempre una brecha de Descripción, no una limitación de Claude.
Esta página desglosa lo que contiene una descripción sólida y por qué cada pieza es importante.
Resumen
- Idea Central: La Descripción es la práctica de darle a Claude suficiente contexto, restricciones explícitas y una declaración clara del objetivo para que pueda actuar sobre tu intención real en lugar de adivinarla.
- Por qué Importa: Un prompt vago obliga a Claude a llenar los vacíos con suposiciones, y esas suposiciones frecuentemente son erróneas de maneras que solo salen a la luz después de que el resultado ya está escrito.
- Conceptos Clave: contexto, restricciones, el objetivo real, ejemplos y plantillas, conciencia de la ventana de contexto.
- Cuándo Usar: Cada vez que escribas un prompt, pero especialmente para cualquier cosa más allá de una solicitud trivial y de bajo riesgo.
- Limitaciones / Compensaciones: Más detalle no siempre es mejor; especificar en exceso una tarea simple desperdicia tiempo y puede limitar la capacidad de Claude para tomar decisiones razonables sobre detalles genuinamente menores.
- Temas Relacionados: Juicio de delegación que precede a la Descripción, límites de la ventana de contexto que dan forma a cuántos detalles caben, resúmenes de proyectos estructurados para tareas más grandes.
Fundamentos
Una descripción tiene tres componentes que importan más que cualquier otro.
El primero es el contexto: los hechos de fondo que Claude necesita pero que no puede saber por sí solo, como quién es la audiencia, qué sucedió antes de esta solicitud o en qué documento encaja esto.
El segundo son las restricciones: los límites explícitos para la salida, como la longitud, el tono, el formato, qué incluir y qué omitir.
El tercero es el objetivo real: no solo la tarea en sí, sino lo que el resultado necesita lograr una vez que exista, lo cual a menudo se deja sin decir porque parece obvio para la persona que pregunta.
Considera la diferencia entre "escribe un correo de seguimiento" y "escribe un correo de seguimiento para Priya, quien pidió una cotización revisada después de nuestra llamada del martes; mantenlo por debajo de 150 palabras y termina proponiendo una llamada esta semana".
La segunda versión proporciona los tres componentes en dos oraciones, y el borrador resultante necesita mucha menos corrección.
Una forma sencilla de pensarlo: una instrucción básica le dice a Claude qué hacer, mientras que una descripción completa le dice a Claude qué, para quién, dentro de qué límites y con qué fin.
La brecha entre esos es de donde provienen la mayoría de los primeros borradores decepcionantes.
Mecánicas e Interacciones
La calidad de la descripción tiene un efecto mecánico directo en la práctica que le sigue.
Un prompt vago no limita nada, por lo que Claude tiene que elegir entre muchas interpretaciones plausibles, y la que elige puede no coincidir con lo que tenías en mente.
Esa discrepancia generalmente no se parece a un error obvio, se parece a un borrador que suena razonable pero que silenciosamente no da en el clavo, que es exactamente el tipo de resultado que requiere un Discernimiento cuidadoso para detectar.
Una descripción precisa limita el espacio de resultados plausibles antes de que Claude comience a escribir, lo que significa que hay menos que detectar y corregir después.
Es por eso que invertir tiempo en la Descripción tiende a ahorrar más tiempo del que cuesta: treinta segundos adicionales dedicados a indicar la audiencia y el objetivo pueden ahorrar varias rondas de "no es exactamente eso, inténtalo de nuevo".
Los ejemplos y las plantillas son una de las adiciones de mayor apalancamiento a una descripción.
Mostrarle a Claude una versión anterior de un documento similar, o una breve muestra del tono que deseas, comunica el formato y la voz de manera mucho más precisa que describirlos con palabras.
Débil: "Escribe una actualización de estado."
Mejor: "Escribe una actualización de estado. Usa la actualización de la semana pasada [adjunta]
como plantilla. Marca la integración de la API con 2 días de retraso;
la causa raíz es un sandbox retrasado del lado del proveedor."Aquí es también donde la conciencia de la ventana de contexto se convierte en una habilidad práctica de Descripción en lugar de un detalle técnico: decidir qué antecedentes son genuinamente cruciales para esta solicitud específica, en lugar de lo que solo añadiría ruido, es parte de escribir una buena descripción, no una preocupación separada.
Consideraciones Avanzadas y Aplicaciones
La Descripción no escala linealmente con la complejidad de la tarea, escala con la ambigüedad.
Una tarea compleja pero bien entendida, como "formatea estas 50 filas en una tabla que coincida con este ejemplo", necesita muy poca descripción en prosa porque el ejemplo en sí mismo lleva la mayor parte de la especificación.
Una tarea de sonido simple pero ambigua, como "haz que esto suene mejor", necesita mucha más descripción, porque "mejor" podría significar más corto, más formal, más persuasivo, o una docena de otras cosas, y Claude no tiene forma de saber cuál quieres sin que se lo digan.
Es por eso que la habilidad de Descripción es realmente la habilidad de notar dónde reside realmente la ambigüedad en una solicitud, en lugar de agregar detalles en todas partes de manera uniforme.
La sobredescripción tiene costos reales.
Enterrar la única restricción que importa dentro de diez párrafos de antecedentes hace que sea fácil perderla, y exigir un control preciso sobre cada elección estilística menor puede producir resultados que suenen rígidos o sobre-diseñados en lugar de naturales.
La habilidad es especificidad proporcional: sé exacto sobre lo que realmente importa para esta tarea, y deja a Claude una latitud razonable sobre lo que no.
| Estilo de Descripción | Fortaleza | Debilidad | Mejor Ajuste |
|---|---|---|---|
| Instrucción básica | Rápido de escribir | Alta varianza, frecuentes repeticiones | Tareas triviales, de bajo riesgo, únicas |
| Contexto + restricciones | Salida predecible y acertada | Requiere más reflexión inicial | La mayoría de las tareas laborales reales |
| Contexto + restricciones + ejemplo/plantilla | Máxima fidelidad al formato y tono deseados | Requiere tener un buen ejemplo a mano | Documentos recurrentes, coincidencia con un estilo existente |
| Brief estructurado (objetivo, restricciones, antecedentes, criterios de éxito) | Maneja trabajo genuinamente complejo o ambiguo | Excesivo para tareas pequeñas | Proyectos de varios pasos, entregables de alto riesgo |
Para solicitudes genuinamente grandes o de varias partes, un brief estructurado que separa el objetivo, las restricciones, los antecedentes y los criterios de éxito en secciones distintas supera a un solo párrafo denso, ya que proporciona a Claude, y a un revisor humano, una lista de verificación clara para trabajar.
Conceptos Erróneos Comunes
- "Un prompt más largo es siempre un mejor prompt." La longitud no es el objetivo; un prompt corto que acierta con la audiencia y el objetivo real supera a uno largo que entierra la única restricción que importaba.
- "Claude debería poder inferir el objetivo de la tarea por sí solo." Claude solo puede trabajar con lo que se declara; un objetivo no declarado no es obvio para Claude como podría serlo para un colega que comparte tu contexto.
- "Los ejemplos son extras opcionales." Un ejemplo o plantilla es a menudo la forma más eficiente de comunicar el formato y el tono, más que párrafos de descripción.
- "Conseguir la descripción correcta es una habilidad de un solo intento." La mayoría de las buenas descripciones son el producto de una revisión después de ver que un primer intento no fue suficiente, no un primer intento perfecto.
- "La Descripción es solo escribir mejores prompts." La Descripción también incluye decidir qué contexto vale la pena incluir, lo cual es una decisión, no un ejercicio de escritura.
Preguntas Frecuentes
¿Qué es la Descripción en el Marco de Fluidez de IA?
La práctica de darle a Claude suficiente contexto, restricciones explícitas y una declaración clara del objetivo real, para que pueda actuar sobre lo que realmente necesitas en lugar de adivinarlo.
¿Cuáles son los tres componentes de una descripción sólida?
- Contexto: los antecedentes que Claude no puede saber por sí solo.
- Restricciones: límites explícitos como longitud, tono y formato, además de qué incluir o excluir.
- El objetivo real: lo que el resultado necesita lograr una vez que exista, no solo la tarea en sí.
¿Por qué una instrucción básica a menudo produce un resultado decepcionante?
Claude tiene que llenar los vacíos dejados por una solicitud vaga con suposiciones, y esas suposiciones frecuentemente no dan en el blanco de lo que la persona realmente quería, produciendo un borrador de apariencia plausible que silenciosamente no da en el clavo.
¿Cómo afecta la calidad de la Descripción al paso de revisión posterior?
Un prompt vago amplía el rango de resultados plausibles, por lo que se debe detectar y corregir más durante la revisión; una descripción precisa limita ese rango de antemano, lo que hace que la revisión sea más rápida y confiable.
¿Por qué los ejemplos o plantillas son tan efectivos en una descripción?
Un ejemplo comunica el formato, el tono y la estructura de manera más precisa que describirlos con palabras, a menudo ahorrando una ronda completa de revisión en comparación con una instrucción puramente basada en texto.
¿Puede una descripción ser demasiado detallada?
Sí. Enterrar la única restricción que importa dentro de un exceso de antecedentes puede hacer que sea fácil de pasar por alto, y especificar en exceso cada elección estilística menor puede producir resultados rígidos y sobre-diseñados; el objetivo es la especificidad proporcional, no la longitud máxima.
¿Cada tarea necesita la misma cantidad de descripción?
No. La Descripción escala con la ambigüedad, no con la complejidad; una tarea compleja pero bien entendida con un buen ejemplo necesita poca prosa, mientras que una solicitud simple pero ambigua necesita más explicación de lo que realmente quieres decir.
¿Qué es la conciencia de la ventana de contexto y cómo se relaciona con la Descripción?
Es el juicio sobre qué información de fondo es genuinamente crucial para una solicitud específica versus qué solo añadiría ruido; decidir eso es una parte práctica de escribir una buena descripción, no una preocupación técnica separada.
¿Cuándo debo usar un brief estructurado en lugar de un solo párrafo?
Para solicitudes genuinamente grandes o de varias partes, dividir el objetivo, las restricciones, los antecedentes y los criterios de éxito en secciones distintas proporciona a Claude y a un revisor humano una lista de verificación más clara que un solo párrafo denso.
¿Qué debo hacer si el primer borrador de Claude no da en el clavo?
Trátalo como una señal sobre la descripción, no sobre la herramienta; identifica cuál de contexto, restricciones u objetivo faltaba o no estaba claro, y añade exactamente eso en el siguiente intento.
¿Escribir una buena descripción es una habilidad para aprender una sola vez?
Está más cerca de ser un hábito continuo: la mayoría de las descripciones sólidas son el resultado de una rápida revisión después de ver dónde falló un primer intento, refinadas a través de un uso repetido en lugar de perfeccionadas en el primer intento.
¿Cómo se relaciona la Descripción con la Delegación?
La Delegación decide si y cuánto delegar; la Descripción solo importa una vez que se toma esa decisión, y una decisión de delegación bien definida generalmente necesita una descripción más corta y simple que una de alto riesgo o ambigua.
Relacionados
- Explicación del Marco de Fluidez de IA 4D - cómo la Descripción encaja con Delegación, Discernimiento y Diligencia.
- Delegación: Decidiendo Qué Delegar a Claude - la decisión que viene antes de escribir una descripción.
- Ventanas de Contexto y Por Qué la Calidad de la Descripción Importa - una mirada más profunda a qué incluir y qué omitir.
- Escribir un Brief de Proyecto en el Que Claude Pueda Actuar - convertir la Descripción en un brief estructurado para tareas más grandes.
Versiones de Stack: Escrito contra la línea de modelos de Claude actual a partir de ~junio de 2026 - Claude Fable 5, Claude Opus 4.8, Claude Sonnet 5 (el predeterminado) y Claude Haiku 4.5. Los nombres de los modelos, los precios y las características del producto cambian rápidamente; verifica los detalles actuales en platform.claude.com/docs antes de confiar en ellos.