Agentes de código

Un agente de código es un agente cuyo entorno es un repositorio: lee archivos, busca, edita y ejecuta comandos hasta que la tarea está hecha y los tests lo confirman. El mecanismo es el mismo bucle agéntico que viste en el roadmap. Lo que cambia es el entorno: un repositorio tiene convenciones implícitas, efectos secundarios y una forma objetiva de comprobar el trabajo (compila o no, los tests pasan o no). Este curso va de aprovechar eso.

Para quién

Para desarrolladores que ya usan agentes de código a diario y quieren entender qué pasa por dentro, y para quien quiere construir uno propio para su equipo o su CI. Si nunca has escrito un bucle con tool use, empieza por Nivel 20 · Uso de herramientas y Nivel 40 · Tu primer agente.

Requisitos

• Haber completado Function calling: el ciclo tool_use → tool_result y El bucle agéntico.
• Python 3.10+ o Node 18+, git y un repositorio de prueba con tests (sirve cualquier proyecto pequeño tuyo).
• Recomendable: Depurar un agente leyendo sus trazas, porque vas a leer muchas trazas.

Temario

1. Cómo trabaja un agente de código. Las cuatro herramientas que importan (leer, buscar, editar, ejecutar), por qué editar por reemplazo exacto funciona mejor que reescribir archivos, y un agente mínimo de unas cien líneas.
2. El contexto del repositorio. El archivo de memoria del proyecto (un CLAUDE.md o AGENTS.md): qué poner, qué no y cómo mantenerlo. Precargar frente a descubrir bajo demanda.
3. Explorar, planificar, implementar, verificar. El flujo de trabajo que separa lo que el agente entiende de lo que toca. Herramientas distintas en cada fase y el plan como artefacto revisable.
4. Revisar y saber cuándo confiar. Cómo revisar lo que entrega, qué señales indican que no debes fiarte y cómo graduar la autonomía según lo reversible que sea cada acción.

Qué construyes

Un agente de código en Python (con equivalente en TypeScript) que:

• trabaja confinado a la carpeta del repositorio y con una lista de comandos permitidos;
• carga las convenciones del proyecto desde un archivo de memoria;
• separa exploración de solo lectura, plan aprobado e implementación;
• ejecuta los tests después de cada cambio y no da la tarea por terminada si fallan;
• entrega un diff pequeño junto a un informe de alarmas (tests tocados, archivos fuera de alcance, dependencias nuevas).

Es la base del sistema completo descrito en Agente de código.