Ir al contenido
Arara Code

Guías y comparativas

Prompts para programar con IA: reglas y ejemplos

Un buen prompt para programar con IA indica el objetivo, señala los archivos y explica cómo verificar el resultado, como una prueba que debe pasar. En tareas grandes o vagas, pide primero que la IA explore el código, te haga preguntas y proponga un plan antes de editar. Las reglas que valen para todo pedido, como los comandos de build y pruebas, van en AGENTS.md o CLAUDE.md.

Arara Code

Publicado por el proyecto Arara Code con base en la documentación oficial citada.

Sé específico: objetivo, archivos y cómo verificar

La guía de buenas prácticas de Claude Code, de Anthropic, recomienda prompts específicos: nombra el archivo, describe el síntoma y di de entrada cómo se ve el resultado corregido. Eso suele ahorrar una ronda de correcciones. La guía da un ejemplo. En lugar de “corrige el bug del login”, escribe “los usuarios dicen que el login falla tras expirar la sesión; revisa la renovación del token en src/auth/, escribe una prueba que falle y lo reproduzca y luego corrígelo”.

Di también cómo verificar el resultado. Según la misma guía, Claude termina cuando el trabajo parece listo, y sin una verificación que ejecutar, parecer listo es todo lo que tiene. Dale algo que responda si pasó o falló, como un archivo de prueba, el código de salida del build o un linter. Luego pide evidencia: el comando que ejecutó y su salida. Un “todas las pruebas pasan”, por sí solo, dice poco.

Anthropic: buenas prácticas de Claude Code

Explora, planifica y después programa

La guía de buenas prácticas de Codex, de OpenAI, sugiere cuatro elementos en cada prompt: el objetivo, el contexto (archivos, documentos, ejemplos o errores), las restricciones y cuándo la tarea está terminada. Si la tarea es compleja, ambigua o difícil de describir, la guía recomienda pedir un plan antes del código. En Codex, el modo Plan, que se activa con “/plan” o Shift+Tab, permite al agente reunir contexto, hacer preguntas aclaratorias y armar un plan antes de implementar.

Si todavía no sabes bien lo que quieres, pide a la IA que te entreviste antes de editar. Las dos guías lo sugieren, y la de OpenAI agrega que debe cuestionar tus suposiciones. La de Anthropic muestra un pedido para limitar solicitudes en una API pública que termina con “entrevístame hasta que puedas escribir la especificación y luego guárdala en SPEC.md”. Después, la guía recomienda una sesión nueva para implementar a partir de ese archivo, con el contexto limpio.

OpenAI: buenas prácticas de Codex

AGENTS.md y CLAUDE.md: instrucciones que el agente lee por su cuenta

Las reglas que valen para todo pedido no van en cada prompt. AGENTS.md es un formato abierto que su sitio oficial describe como un README para agentes, usado por más de 60 mil proyectos de código abierto. Crea el archivo en la raíz del repositorio con lo que un agente necesita: un resumen del proyecto, comandos de build y pruebas, estilo de código, instrucciones de prueba y aspectos de seguridad. En un monorepo, manda el archivo más cercano.

Claude Code lee CLAUDE.md al inicio de cada sesión y, según su documentación, también puede leer el AGENTS.md del repositorio cuando no hay CLAUDE.md. Pon ahí los comandos de build y pruebas y las convenciones del proyecto. Escribe instrucciones que se puedan verificar: “ejecuta npm test antes de cada commit” en lugar de “prueba tus cambios”. La documentación recomienda menos de 200 líneas por archivo y, tanto en Claude Code como en Codex CLI, “/init” genera una primera versión.

AGENTS.md: formato abierto para agentes

Cómo aplicar estas reglas de prompt en Arara Code

En el chat lateral de Arara Code, entrega el contexto en lugar de describirlo. Selecciona el código y presiona Ctrl+L, o haz clic derecho en un archivo del explorador y elige “Añadir al chat”. El menú “@” agrega imágenes, como la captura de un error, y el “Mapa del código” del proyecto. Si la IA hace preguntas, como pediste en el plan, respóndelas en el chat. Mientras trabaja, sigue la lista de tareas y aprueba o rechaza cada edición y comando.

Para tareas simples, como renombrar algo en pocos archivos, elige un esfuerzo menor en el selector plataforma · modelo · esfuerzo; la guía de Anthropic dice que más esfuerzo gasta más tiempo y tokens. Antes de enviar, revisa que el pedido indique el objetivo, señale los archivos y explique cómo verificar el resultado, que las tareas grandes empiecen con un plan y preguntas y que las reglas fijas estén en AGENTS.md o CLAUDE.md. Después, ejecuta las pruebas y revisa el diff antes del commit.

Arara Code: repositorio público de la IDE

Fuentes y lecturas adicionales

Leer en Markdown

Sigue explorando

Haz espacio para tu próxima idea.

Conoce Arara Code en tu propio proyecto. Empieza con el instalador y revisa los cambios que haga tu asistente.