Programar con agentes de IA sin romper tu proyecto
Los agentes de IA ya no solo autocompletan líneas: leen tu proyecto, editan archivos, ejecutan comandos y corren pruebas. Bien usados, multiplican tu productividad. Mal usados, llenan tu código de errores y riesgos de seguridad.
En resumen
- Un agente planifica y ejecuta tareas de varios pasos en tu proyecto; no es un simple autocompletado.
- La regla de oro: Git, tareas pequeñas, pruebas y revisión humana de cada cambio.
- Nunca le des al agente credenciales de producción ni permisos que no necesita.
¿Qué es un agente de IA para programar?
Un asistente de código clásico sugiere la siguiente línea. Un agente recibe un objetivo («añade un formulario de contacto con validación y pruebas»), explora el proyecto, propone un plan, modifica varios archivos, ejecuta comandos en la terminal y corrige sus propios errores hasta terminar.
Esto cambia el rol del desarrollador: pasas de escribir cada línea a definir bien la tarea, supervisar y revisar. Es una habilidad nueva, y quien la domina entrega más rápido sin sacrificar calidad.
Las herramientas más usadas
| Herramienta | Tipo | Ideal para |
|---|---|---|
| Claude Code (Anthropic) | Agente en terminal, IDE y web | Tareas largas en proyectos grandes, refactorizaciones, migraciones |
| Cursor | Editor de código con IA integrada | Desarrollo diario con autocompletado y modo agente en el editor |
| GitHub Copilot | Extensión de IDE y agente en GitHub | Equipos que ya trabajan en GitHub; tareas asignadas desde issues |
| Gemini CLI / Codex | Agentes en terminal | Alternativas de Google y OpenAI con flujos similares |
| Google Stitch | Generador de interfaces | Prototipos de diseño UI a partir de texto o bocetos, exportables a código |
No necesitas todas. Elige una para el código y, si diseñas interfaces, una para prototipos. Lo que marca la diferencia no es la herramienta, sino el método.
Un flujo de trabajo que no rompe nada
1. Git antes que nada
Trabaja siempre en una rama nueva y haz commits pequeños. Si el agente se equivoca, vuelves atrás en segundos. Sin control de versiones, usar un agente es apostar.
2. Dale contexto en un archivo
Crea en la raíz del proyecto un archivo de instrucciones (CLAUDE.md, AGENTS.md o las reglas de tu editor) con lo que un desarrollador nuevo necesitaría saber:
# AGENTS.md
## Proyecto
Tienda en Laravel 11 + Livewire. PHP 8.3, MySQL.
## Comandos
- Pruebas: php artisan test
- Estilo: ./vendor/bin/pint
## Reglas
- No modificar migraciones ya ejecutadas; crear nuevas.
- Textos de interfaz en español de Colombia.
- Nunca leer ni editar el archivo .env.3. Pide un plan antes del código
Para cualquier tarea no trivial, pide primero un plan: qué archivos va a tocar y por qué. Corregir un plan cuesta un minuto; corregir 400 líneas mal enfocadas cuesta una tarde.
4. Tareas pequeñas y verificables
«Haz la tienda» falla. «Añade el campo teléfono al formulario de registro, con validación de formato colombiano y una prueba» funciona. Cuanto más concreto el objetivo, mejor el resultado.
5. Las pruebas son el contrato
Pide al agente que escriba o ejecute las pruebas y que no dé la tarea por terminada hasta que pasen. Si tu proyecto no tiene pruebas, es un excelente primer trabajo para un agente.
6. Revisa cada diff
Lee los cambios como revisarías el trabajo de un compañero nuevo: ¿borró algo que no debía?, ¿desactivó una validación para que pasara una prueba?, ¿añadió una dependencia innecesaria? El agente es rápido, no infalible.
Seguridad: los riesgos que nadie te cuenta
Un agente con acceso a tu terminal puede hacer lo mismo que tú. Configura sus permisos con la misma prudencia con que darías acceso a un contratista.
- Secretos fuera del alcance. Las claves de API y contraseñas van en variables de entorno, nunca en el código ni en el chat. Usa credenciales de desarrollo, no de producción.
- Permisos mínimos. Revisa qué comandos puede ejecutar sin preguntarte. Comandos destructivos o de despliegue deberían requerir tu aprobación.
- Inyección de instrucciones. Si el agente lee páginas web, issues o archivos de terceros, ese contenido puede contener instrucciones maliciosas ocultas. Trátalo como datos, no como órdenes.
- Paquetes inventados. Los modelos a veces sugieren dependencias que no existen, y atacantes registran esos nombres con código malicioso. Verifica cada paquete nuevo en npm, Packagist o PyPI antes de instalarlo.
- Conectores (MCP) de confianza. Los servidores MCP amplían lo que puede hacer el agente (bases de datos, navegador, APIs). Instala solo los de fuentes confiables y revisa qué acceso piden.
Casos de uso que sí valen la pena
- Migraciones: pasar un sitio de WordPress a HTML estático o actualizar una versión mayor de Laravel o React.
- Pruebas: generar una suite de pruebas para código heredado antes de modificarlo.
- Prototipos: generar pantallas con Stitch, validarlas con el cliente y luego implementarlas con un agente.
- Mantenimiento: corregir avisos de accesibilidad, mejorar el SEO técnico o actualizar dependencias con sus cambios incompatibles.
- Documentación: explicar un proyecto que nadie entiende y dejarlo documentado para el siguiente desarrollador.
Preguntas frecuentes
¿Los agentes de IA reemplazan a los programadores?
No. Cambian el trabajo: menos tiempo escribiendo código repetitivo y más tiempo definiendo, revisando y probando. Sin alguien que entienda lo que se está construyendo, los errores se acumulan rápido.
¿Puedo usar un agente si no sé programar?
Para prototipos y herramientas internas, sí. Para algo que maneje pagos, datos personales o clientes reales, necesitas que alguien con experiencia revise el código y la seguridad antes de publicarlo.
¿Es seguro darle acceso a mi código a una IA?
Depende del plan y la herramienta. Revisa la política de datos y si tu código se usa para entrenar modelos, nunca compartas contraseñas ni claves de producción, y limita los permisos del agente a lo necesario.
Conclusión
Los agentes de IA son la mayor mejora de productividad que ha tenido el desarrollo web en años, pero no eliminan la responsabilidad. Usa Git, da contexto, pide planes, exige pruebas y revisa cada cambio. Con ese método, un desarrollador puede entregar en días lo que antes tomaba semanas.
