Anteriormente he escrito sobre la mejor manera de promptear la nueva generación de modelos Claude 5 y trabajar con ellos de forma iterativa para descubrir lo que quieres construir.
Pero cuando envías un mensaje a Claude, el prompt es solo una pequeña parte del contexto que recibe. Gran parte de tu contexto se ensambla a partir de tu system prompt, Skills, archivos CLAUDE.md, memoria y otras fuentes. A esto lo llamamos ingeniería de contexto y tiene un gran impacto en los resultados que generas al usar Claude Code o al construir tus propios agentes.
A diferencia de un prompt, el contexto se usa de manera general en muchas solicitudes, por lo que no puede ser tan específico. ¿Cómo se construyen estos prompts y guías generales para Claude, especialmente cuando no sabes cuál podría ser el prompt de un usuario?
Esto puede ser sorprendentemente difícil a medida que las propias capacidades de Claude evolucionan. Recientemente, notamos un gran salto en la forma en que prompteamos a la nueva generación de modelos Claude. Eliminamos más del 80 % del system prompt de Claude Code para modelos como Claude Opus 5 y Claude Fable 5 sin una pérdida medible en nuestras evaluaciones de codificación.
Esto es lo que hemos aprendido sobre cómo promptear esta nueva clase de modelos y cómo puedes utilizarlo para actualizar tu ingeniería de contexto. Hemos incorporado estas mejores prácticas en claude doctor; usa el comando /doctor en Claude Code para ajustar tus Skills y archivos CLAUDE.md.
Liberando a Claude
En general, descubrimos que estábamos sobre-restringiendo a Claude Code, tanto a través de nuestro system prompt como en nuestros archivos CLAUDE.md y Skills.
Por ejemplo, cuando leemos transcripciones de nuestro propio uso interno de Claude Code, vemos varios mensajes contradictorios en una sola solicitud, como “deja documentación según corresponda” o “NO agregues comentarios”, mientras nuestro system prompt, skills y solicitudes de usuario chocan entre sí.
Generalmente, Claude puede interpretar la intención del usuario para llegar a la respuesta correcta, pero debe pensar con más cuidado en estos mensajes superpuestos y contradictorios antes de decidir qué hacer.
Y aunque estas restricciones alguna vez fueron necesarias para evitar los peores escenarios, desde entonces hemos descubierto que podemos eliminar muchas de ellas y dejar que el modelo use el contexto circundante y su propio juicio en su lugar.
Además, Claude Code ahora tiene muchas más herramientas. Claude solía depender de CLAUDE.md como fuente de memoria, información y guía. Ahora tenemos memoria, artifacts y skills, que Claude puede usar para crear nuevas formas de cargar y compartir contexto entre sesiones.
Antes y ahora
Hubo una serie de prácticas recomendadas anteriores de ingeniería de contexto que se habían convertido en mitos. Incluyendo:
Antes: Darle reglas a Claude
Ahora: Dejar que Claude use su juicio
Cuando lanzamos Claude Code por primera vez, necesitábamos asegurarnos de que Claude evitara los peores escenarios, como eliminar archivos. Esto significaba que dábamos instrucciones particularmente estrictas que no siempre eran ciertas. Por ejemplo, en el system prompt solíamos decir:
En el código: por defecto, no escribas comentarios. Nunca escribas docstrings de varios párrafos o bloques de comentarios de varias líneas — máximo una línea corta. No crees documentos de planificación, decisión o análisis a menos que el usuario los solicite — trabaja a partir del contexto de la conversación, no de archivos intermedios.
Pero para un cierto subconjunto de prompts, esta guía sería incorrecta. En el caso de la documentación, el usuario puede tener sus propias preferencias, o partes específicas de código muy complejo podrían necesitar bloques de comentarios de varias líneas.
Aún así, sin estas barreras de protección para modelos antiguos, los comentarios que Claude escribía serían incorrectos en muchos casos y teníamos que aceptar esta compensación. Pero los modelos más nuevos tienen mejor juicio y pueden manejar estas decisiones bien sin reglas explícitas.
En el nuevo system prompt decimos: Escribe código que se lea como el código circundante: iguala su densidad de comentarios, nomenclatura e idioma.
Antes: Darle ejemplos a Claude
Ahora: Diseñar interfaces
La regla número uno para el uso de herramientas era darle ejemplos a Claude sobre cómo usarlas. Con nuestros modelos más nuevos, descubrimos que dar ejemplos en realidad los limita a un cierto espacio de exploración.
En lugar de usar ejemplos, piensa más en el diseño de tus herramientas, scripts y archivos: ¿qué parámetros tiene Claude y cómo pueden ser más expresivos?
Por ejemplo, en el ejemplo de la herramienta Todo, solo listar el estado como una enumeración entre pending, in_progress y completed, le da pistas a Claude sobre cómo usarla. La instrucción de mantener un elemento en in_progress ayuda a definir el comportamiento solicitado.
Antes: Ponerlo todo por adelantado
Ahora: Usar divulgación progresiva
Debido a que Claude Code se centraba en la codificación, nuestro system prompt incluía información detallada sobre cómo hacer revisión y verificación de código. Esto no siempre era necesario, pero cuando lo era, era información crucial.
Desde entonces, Claude Code se ha vuelto muy competente en usar divulgación progresiva: cargar el contexto adecuado en el momento adecuado. Por ejemplo, movimos la verificación y la revisión de código a sus propios skills que Claude Code podía llamar selectivamente.
Pero la divulgación progresiva no es solo para skills, también la usamos para herramientas. Algunas de nuestras herramientas son de ‘carga diferida’, lo que significa que el agente debe buscar sus definiciones completas usando ToolSearch antes de usarlas. Esto nos permite tener más herramientas (como nuestras herramientas de Task) que no ocupan contexto hasta que se necesitan.
Lo mismo se puede aplicar a tus propios archivos CLAUDE.md y Skill.md. Un mito común es que quieres convertirlos en un repositorio central de cada práctica conocida que podrías encontrar, porque de lo contrario Claude no la encontraría. En su lugar, considera tener un árbol de archivos que se puedan cargar en el momento adecuado.
Antes: Repetirte
Ahora: Descripciones de herramientas simples
Los modelos anteriores de Claude a veces necesitaban instrucciones repetidas o era más probable que escucharan las instrucciones al final de su ventana de contexto que al principio. Esto significaba que nuestro system prompt a veces tenía referencias a herramientas en el system prompt principal, así como instrucciones en la descripción de la herramienta.
Descubrimos que podíamos eliminar estos ejemplos repetidos y poner instrucciones sobre cómo usar las herramientas en las descripciones de las herramientas en lugar de en el system prompt.
Antes: Memoria en archivos CLAUDE.md
Ahora: Memoria automática
Solíamos alentar a los usuarios a guardar cosas en la memoria de Claude, usando el atajo # para escribir automáticamente en su CLAUDE.md. En cambio, ahora Claude guarda automáticamente recuerdos que son relevantes para el trabajo y para ti.
Antes: Especificaciones simples
Ahora: Referencias enriquecidas
En el modo plan, Claude Code ha dependido en gran medida de archivos markdown con planes. Almacenar estos archivos como planes ayudaba a Claude a consultarlos cuando era necesario. Otra práctica recomendada similar era almacenar especificaciones en el código base para que Claude las consultara mientras trabajaba en proyectos más largos.
Pero hemos descubierto que Claude puede manejar referencias cada vez más complejas. En lugar de archivos markdown simples, Claude puede hacer referencia a artifacts HTML creados por nuestra nueva función de artifacts.
También puedes darle a Claude referencias en forma de código. Una especificación también puede ser un conjunto de pruebas detallado, o una función en un código base diferente que Claude podría portar.
Las rúbricas son otra forma de referencias. Las rúbricas permiten a Claude intentar verificar tu gusto en un campo particular (por ejemplo, ¿cómo es un buen diseño de API?) usando workflows dinámicos y poniendo en marcha agentes verificadores con esas rúbricas.
Aplicando esto a tu contexto
Resumiendo, ¿cómo se ve esto cuando ensamblas tu contexto?
System Prompt
Un system prompt está fuertemente ligado al contexto del producto. Le dice a Claude en qué producto está operando y qué está haciendo. Para Claude Code, es probable que nunca modifiques esto, pero si estás construyendo tu propio harness de agente, aquí es donde deberías invertir mucho tiempo.
CLAUDE.md
Mantén tu CLAUDE.md ligero y describe brevemente para qué sirve tu repositorio, pero gasta la mayoría de los tokens en gotchas dentro del código base. Por ejemplo, puedes organizar tu código para mantener los tipos en un archivo monolítico y en ningún otro lugar. Evita afirmar cosas ‘obvias’ que Claude debería saber con solo mirar tu sistema de archivos o tu repositorio.
Usa divulgación progresiva para más detalles; por ejemplo, si tienes varias instrucciones únicas sobre cómo verificar tu trabajo, crea un skill de verificación y haz referencia a él desde tu CLAUDE.md.
Skills
Piensa en los skills como guías ligeras para que Claude encuentre información cuando sea necesario. Evita sobre-restrictirlos, excepto en áreas de suma importancia.
Para skills largos, trata de usar divulgación progresiva tanto como sea posible: divídelos en muchos archivos y sepáralos.
Es mejor cuando los skills codifican opiniones, conocimientos o mejores prácticas particulares para ti, tu equipo o tu producto.
Referencias
Puedes mencionar archivos con @ para incluirlos como referencias. Las referencias permiten a Claude consultar información detallada sobre el plan actual.
Esto puede ser en archivos de especificaciones, maquetas o incluso bases de código completas. Generalmente, debes preferir archivos que estén en código, ya que proporcionan instrucciones claras y de alta fidelidad a Claude en un lenguaje que conoce muy bien. Por ejemplo, una maqueta HTML de un diseño generalmente producirá mejores resultados que una descripción del diseño o una captura de pantalla.
Intenta simplificar
En tu system prompt, skills y archivos CLAUDE.md, puede que necesites simplificar tal como lo hicimos nosotros. Lanzamos un nuevo comando llamado claude doctor, que te ayudará a hacer esto automáticamente. Para más detalles sobre cómo promptear modelos más avanzados específicamente, consulta nuestra guía de campo de Fable.
