Desarrollo Agentico - De "Code Builders" a "Code Supervisors"

De "Code Builders" a "Code Supervisors"

Históricamente, nuestro valor como programadores se medía por cuánto dominábamos la sintaxis o qué tan rápido resolvíamos un algoritmo a mano. Hoy, el tablero cambió: el foco pasó de la ejecución a la intención y la validación.

- El Programador: Se quema la cabeza con el cómo (el bucle, el estado, el boilerplate).

- El Supervisor: Se enfoca en el qué y el para qué. El código se volvió un commodity; el diseño de sistemas y la lógica de negocio son el nuevo oro.

- La IA como Agente: Ya no es un autocompletado avanzado. Un agente tiene autonomía para razonar, usar la terminal, navegar y, lo más importante, corregirse a sí mismo.

Estrategias de Especificación: El arte de pedir

La gran ventaja acá es la velocidad de iteración, pero hay una trampa: para que el agente no delire, la especificación tiene que ser quirúrgica.

Especificaciones Declarativas: En lugar de dar órdenes paso a paso, definimos el estado final que queremos alcanzar.

Context-Driven Prompting: No basta con tirar una tarea. Hay que darle el "entorno": arquitectura, stack y convenciones de tipado.

Markdown como Lenguaje de Diseño: Usar archivos .md o reglas (como claude.md) para estandarizar el flujo. Es la forma de asegurar que el agente mantenga la consistencia en todo el repo.

Frameworks vs. Especificación Manual

Hoy tenemos dos caminos claros en el desarrollo agéntico:

Frameworks (LangChain, CrewAI): Ideales para armar apps que usan IA por detrás para procesos complejos de muchos pasos.

Especificaciones Manuales (Direct-to-Agent): Es nuestro día a día con el IDE. Acá la clave es el Prompt Engineering Arquitectural: saber romper un problema gigante en partes que la IA pueda digerir sin alucinar.

TDD: Nuestra red de seguridad

En este flujo, el Test-Driven Development es innegociable. Si nosotros no escribimos el código, ¿cómo dormimos tranquilos?

Red: Nosotros definimos el contrato y el test.

Green: El agente genera el código que lo hace pasar.

Refactor: Supervisamos y pedimos optimizaciones manteniendo todo en verde.

El cuello de botella: Memoria y Contexto

El límite real de los agentes es el Context Window.

RAG Local: Las herramientas indexan el código para que el agente solo "mire" lo que importa.

Gestión de Memoria: Un contexto sucio degrada el razonamiento. Saber cuándo purgar logs masivos o archivos viejos es una habilidad crítica de cualquier supervisor.

Equipos AI-First: Evitando el caos

Para que un equipo no termine con un Frankenstein de código generado al azar, hay que marcar la cancha:

Reglas Estándar: Un archivo compartido que diga "acá usamos funcional", "Typescript estricto" o "Clean Architecture".

AI-Enhanced Code Reviews: El humano ya no mira el estilo (de eso se encarga la IA), se enfoca en la arquitectura y la seguridad.

Documentación Viva: Un README actualizado no es solo para humanos; es el "alimento" que mejora las sugerencias de la IA.

El desarrollo agéntico no nos reemplaza, nos eleva. Dejamos de ser simples traductores de lenguaje humano a máquina para convertirnos en directores de orquesta. Nuestra capacidad de abstracción y el conocimiento del dominio valen hoy más que nunca. El código es efímero; la arquitectura es lo que queda.