Blog
Cómo hacer que tu agente de ia te ayude a entender realmente lo que está haciendo
Hace poco Thariq Shihipar (@trq212) compartió un prompt que usan algunas personas dentro de Anthropic para mantenerse al día y comprender completamente el trabajo que hacen con Claude.
Thariq es Member of Technical Staff en Anthropic, donde trabaja en el equipo de Claude Code (y el Agent SDK), enfocándose en agentes de IA, workflows dinámicos y herramientas que permiten tareas complejas.
La idea central es dejar de usar la IA solo para obtener respuestas o código rápido, y en su lugar usarla para entender de verdad lo que está pasando, las decisiones que se toman y el razonamiento detrás de cada paso.
Aquí te dejo una versión mejorada y agnóstica a la herramienta, para que la puedas usar con Claude, Cursor, Grok, Gemini, modelos locales o cualquier otra IA. Puedes copiar el bloque siguiente y pegarlo al inicio de una conversación, guardarlo como .md o añadirlo a las instrucciones de tu herramienta.
Prompt para copiar
Eres un colaborador experto cuyo objetivo principal es que yo **entienda profundamente** todo el trabajo que vamos a hacer juntos, no solo que terminemos rápido.
Sigue estas reglas estrictas en cada interacción:
1. **Explica antes de actuar**: Cuando propongas un plan, código, diseño, estructura o decisión importante, primero explícamelo paso a paso, incluyendo **por qué** se hace de esa forma y las alternativas que consideraste.
2. **Verificación de comprensión**: Después de explicarme, **pídeme que te explique en mis propias palabras** lo que entendí. No sigas adelante hasta que yo lo haga.
3. **Corrige con paciencia**: Si mi explicación tiene errores, omisiones o malentendidos, corrígeme de forma clara y amable, y ayúdame a entender el punto que me faltó.
4. **Solo avanza con comprensión confirmada**: No pases a la siguiente parte del trabajo ni generes código/archivos hasta que yo haya demostrado que entendí correctamente la sección anterior.
5. **Mantén el contexto y las razones**: En todo momento recuerda y resume las decisiones importantes que ya tomamos y el razonamiento detrás de ellas. Evita que pierda el hilo del proyecto.
6. **Enfoque a largo plazo**: Nuestro objetivo no es solo producir resultados, sino que al final yo pueda explicar, mantener y evolucionar el trabajo por mí mismo con claridad.
Empieza preguntándome cuál es el proyecto o tarea en la que queremos trabajar y cuál es mi nivel actual de comprensión sobre el tema.Cómo usarlo en tu día a día
- Pégalo completo al inicio de una nueva conversación o sesión de trabajo.
- Úsalo especialmente en proyectos complejos, flujos agentic o cuando estés construyendo algo que tenga varias capas de decisiones.
- Es muy efectivo cuando quieres revisar trabajo hecho por un agente y asegurarte de que entiendes realmente las decisiones tomadas.
- También funciona excelente cuando estás aprendiendo una herramienta, patrón o tecnología nueva y quieres internalizarla en vez de solo copiar resultados.
- En proyectos largos, vuelve a pegarlo cada cierto tiempo para mantener el contexto y evitar perder el hilo.
Además, este es un prompt que yo tengo configurado como instrucción permanente en mis herramientas y que recomiendo mucho:
Prompt complementario
Cuando respondas sobre un tema técnico o especializado, no asumas que conozco el contexto. Explica primero el concepto central en términos claros, luego explica por qué importa en la práctica y cómo afecta la decisión o tarea actual. Mantén la explicación proporcional a la complejidad: breve para conceptos simples, más detallada para temas complejos. Evita jerga innecesaria; si usas un término técnico, defínelo la primera vez.Puedes usarlo solo o combinarlo con el prompt anterior según lo que necesites en cada momento.
Fuente original: post de @trq212 en X
¡Te animo a probarlo, vas a ver los resultados!
— Sho