9.1 — Agente vs chatbot: un cambio de postura
Cuando usas ChatGPT o Claude en una interfaz web, interactúas con un chatbot. Tienes que proporcionarle todo el contexto — el código, los archivos, la arquitectura — porque no puede ir a buscar la información por sí mismo. Claude Code es un agente. Dispone de herramientas: Read, Grep, Glob, Bash, Edit. Explora tu codebase, lee tus archivos, ejecuta comandos, navega por el historial git. Esta diferencia cambia radicalmente la forma en que debes formular tus instrucciones.
Con un chatbot, das los pasos. Con un agente, das la dirección. En lugar de decir "abre el archivo X, encuentra la línea Y, reemplaza Z por W", dices "el ordenamiento por fecha no funciona en la página de pedidos, corrígelo". El agente va a encontrar el archivo, entender el bug, proponer la corrección. Tu energía debe invertirse en el "qué" y el "por qué", nunca en el "cómo".
En concreto:
- No copies y pegues código en tu prompt — el agente puede leerlo por sí mismo
- Describe el síntoma y el comportamiento esperado, no los pasos técnicos
- Piensa "product owner que redacta un ticket", no "desarrollador que dicta código"
- Confía en la exploración: el agente va a buscar los archivos, los patrones, la arquitectura
# Malo (estilo chatbot)
"En src/utils/sort.ts, línea 42, reemplaza a.date - b.date por b.date - a.date"
# Bueno (estilo agente)
"El ordenamiento por fecha en la lista de pedidos muestra los más antiguos primero.
Los quiero con los más recientes primero."
Puntos clave
Promptear a un agente es delegar en un desarrollador competente. Le das el problema, el contexto de negocio y las restricciones. No le dictas cada línea de código.