¿Qué es la programación agéntica?

Escribías un prompt, leías la respuesta, copiabas lo bueno en tu editor, corregías lo que el modelo había hecho mal y ejecutabas las pruebas tú mismo. Ese bucle te hacía escribir código más rápido, pero no cambiaba quién hacía el trabajo. Seguías siendo tú quien sostenía toda la tarea en la cabeza y la hacía avanzar pegando fragmentos, uno a uno.

La programación agéntica (agentic coding) es el punto en el que eso cambia. En lugar de pedir una respuesta para pegarla, asignas una unidad de trabajo y recibes un resultado que ya ha sido investigado, ejecutado, probado y reportado. El trabajo del desarrollador pasa de teclear cada línea a marcar la dirección, otorgar autoridad y aceptar o rechazar lo que vuelve. Esta guía define la programación agéntica para equipos de desarrollo en activo, recorre la escalera de madurez desde el asistente de chat hasta el Crew orquestado y traza la línea de la que depende todo el cambio: dónde se queda la persona.

A lo largo del artículo usaremos Sharkly como flujo de referencia, porque la parte difícil de la programación agéntica no es que el agente escriba código, sino coordinar muchas ejecuciones, mantener el contexto en un único lugar compartido y decidir qué llega realmente a producción. Sharkly es una plataforma todo en uno de gestión y control de Agentes: añade la capa de Tareas compartidas, Computers, contexto, control y revisión alrededor de las herramientas de programación que tu equipo ya utiliza. Esa capa es precisamente lo que convierte «un agente escribió algo de código» en programación agéntica en la que un equipo puede confiar.

TL;DR: ¿qué es la programación agéntica?

La programación agéntica es un flujo de desarrollo de software en el que asignas una unidad de trabajo acotada a un Agente de programación con IA que investiga el código, aplica el cambio, ejecuta las pruebas y reporta con evidencias, en lugar de limitarse a responder a un único prompt. El desarrollador pasa de autor a director: marcas la dirección, otorgas autoridad y aceptas el resultado. Madura en cuatro etapas: desde el asistente de chat que autocompleta hasta un único Agente operativo, pasando por Agentes en paralelo y llegando a un Crew orquestado coordinado por un Agente líder.

El techo del prompt y el copiar y pegar

La programación con IA basada en chat alcanzó un techo que la mayoría de los equipos nota, pero pocas veces nombra. Solo puedes hacer una pregunta a la vez. Cada respuesta cae de vuelta en tu regazo, y ahí tienes que leerla, juzgarla, integrarla en el código real y ejecutar las comprobaciones. El modelo teclea; tú piensas, integras y verificas. Multiplica eso a lo largo de un sprint y el asistente resulta rápido en el paso pequeño e inútil en el grande.

El problema aparece en tres lugares predecibles. Primero, el contexto vive en tu cabeza y en tu historial privado de chat, así que un compañero de equipo no puede ver por qué el agente tomó una decisión o qué había intentado antes. Segundo, el rendimiento está limitado por la atención de una sola persona: cinco terminales abiertas, cinco sesiones de agente a medio terminar y ningún registro compartido de cuál está realmente acabada. Tercero, nada es responsabilidad de nadie. El razonamiento del agente, su diff y la salida de sus pruebas quedan dispersos en una ventana de chat que nadie revisa antes de que el código se fusione.

La programación agéntica responde a los tres problemas cambiando la unidad de interacción. Dejas de intercambiar mensajes y empiezas a asignar trabajo. Y cuando el trabajo es la unidad, necesita un sitio donde vivir, alguien que se responsabilice de él y una puerta de control antes de salir. Ese es el flujo del que trata realmente este artículo, y es la razón por la que una definición que se queda en «el agente escribe código solo» no sirve para los equipos. Si te interesa la cara de orquestación de esta misma historia, nuestra guía sobre orquestación de agentes de IA es el artículo pilar que acompaña a este.

Una definición práctica de la programación agéntica

Esta es la versión de una sola frase que merece la pena citar: la programación agéntica es un flujo de desarrollo en el que una persona asigna una Tarea acotada a un Agente de programación con IA que investiga, ejecuta, prueba y reporta el resultado, mientras la persona conserva la dirección, la autoridad y la aceptación final.

Las dos mitades de esa frase sostienen toda la idea. La mitad del Agente es un bucle de verbos: investigar el código y el requisito, ejecutar el cambio, lanzar las pruebas y la compilación, y reportar después con un resumen y evidencias inspeccionables. La mitad de la persona es un bucle más corto: marcar la dirección, otorgar autoridad, aceptar o rechazar. Los Agentes investigan, ejecutan, prueban y reportan. Las personas marcan la dirección, otorgan autoridad y aceptan el resultado. La automatización se detiene donde se requiere el criterio del equipo.

Conviene aclarar lo que no es la programación agéntica. No es el modelo sustituyendo al desarrollador, ni tampoco «deja que la IA corra sin supervisión y ya veremos». Un Agente de programación sin una persona que defina el alcance y acepte el resultado no es programación agéntica; es un proceso sin dueño. El cambio no consiste en eliminar a la persona, sino en sacarla de en medio de cada pulsación de tecla y llevarla a los dos extremos que importan: qué construir y si el resultado es suficientemente bueno para publicarlo.

Esa distinción también separa la programación agéntica del «vibe coding», en el que aceptas el código generado sin leerlo. El vibe coding elimina a la persona del extremo de la aceptación. La programación agéntica mantiene ese extremo y automatiza el medio. Uno es un atajo; el otro es un flujo de trabajo sobre el que puedes hacer funcionar a todo un equipo.

La escalera de madurez: las cuatro etapas de la programación agéntica

Los equipos no saltan directamente a los Agentes autónomos. Van subiendo peldaños. Ponerles nombre deja claro dónde está tu equipo ahora y cómo es el siguiente paso honesto.

Etapa 1: el asistente de chat

El modelo completa líneas, responde preguntas y redacta funciones dentro de tu editor. Tú controlas cada paso. No hay una Tarea persistente, ni responsabilidad, ni informe; el valor está en teclear más rápido y resolver dudas puntuales. Aquí es donde empezó la mayoría de los desarrolladores, y para arreglar una sola línea sigue siendo la herramienta adecuada. Echar mano de un Agente en este punto es matar moscas a cañonazos.

Etapa 2: un único Agente

Le entregas una Tarea acotada a un solo Agente y lo dejas recorrer el bucle completo: leer los archivos relevantes, aplicar el cambio, ejecutar las comprobaciones y volver con un diff y un resumen. El Agente trabaja a partir del estado actual del código, no de un prompt en blanco. Este es el primer peldaño real de la programación agéntica, porque por primera vez la unidad es el trabajo y no el mensaje. Un buen punto de partida es un cambio pequeño y de bajo riesgo; nuestro tutorial sobre cómo asignar tu primera tarea a un Agente de programación con IA cubre exactamente este peldaño.

Etapa 3: Agentes en paralelo

Ahora ejecutas varios Agentes a la vez, cada uno con su propia Tarea y en un worktree aislado para que no choquen entre sí. El trabajo de frontend, un endpoint de backend, la corrección de un bug y un lote de cobertura de pruebas pueden avanzar al mismo tiempo. El rendimiento deja de estar limitado por la atención de una sola persona. El problema es la coordinación: cinco Agentes en cinco terminales es más rápido y también un caos, a menos que algo mantenga los objetivos, los diffs y los resultados en un mismo sitio. Este es el peldaño en el que los equipos dejan atrás tmux y los scripts improvisados; consulta cómo ejecutar varios Agentes de Claude Code en paralelo para ver la mecánica.

Etapa 4: el Crew orquestado

En el peldaño más alto, un Agente líder interpreta un objetivo más amplio, lo divide en Tareas, incorpora a otros Agentes miembros y devuelve su resultado combinado en una sola Tarea. Un Crew es un grupo reutilizable de Personas y Agentes coordinado por un Agente líder. Ya no asignas cambios individuales, sino resultados. Esto es potente y también es el peldaño donde más fuerte es la tentación de saltarse la aceptación humana, que es exactamente por lo que aquí la puerta de aceptación importa más que nunca.

Usa un solo Agente cuando el trabajo es pequeño y está bien definido. Usa un Crew cuando el líder necesita interpretar el objetivo, involucrar a otros Agentes miembros y reunir sus resultados en una sola Tarea. Subir un peldaño demasiado pronto, antes de tener la visibilidad necesaria para revisar lo que han hecho los Agentes, es la forma más habitual de que un equipo se queme.

El bucle del agente: investigar, ejecutar, probar, reportar

Merece la pena detenerse en este bucle de verbos, porque es lo que separa a un Agente de un autocompletado con ínfulas.

Investigar. Antes de tocar el código, un Agente competente lee el contexto de producto, el código, Tareas relacionadas anteriores y las reglas del equipo, y después completa el alcance y los criterios de aceptación. Este es el paso que el chat se salta por completo. Un prompt parte de la nada; un Agente parte de tu repositorio tal y como está hoy.

Ejecutar. El Agente aplica el cambio en un worktree aislado, de modo que una ejecución a medias nunca contamina la rama principal ni el trabajo de otro Agente. Los worktrees de Git son el mecanismo aburrido y probado que hay debajo; permiten que muchas ramas existan a la vez como directorios de trabajo independientes.

Probar. El Agente ejecuta el typecheck, la suite de pruebas y la compilación, y adjunta los resultados. Esa es la diferencia entre «aquí tienes algo de código» y «un cambio que pasa». Un informe sin evidencias no es más que una afirmación.

Reportar. La ejecución, los bloqueos, los resultados y las conversaciones de seguimiento vuelven a la línea de tiempo de la Tarea, no a una terminal privada. El resumen del cambio, los resultados de la verificación y los límites conocidos quedan en un único lugar que quien revisa puede leer. El trabajo siempre vuelve a la Tarea.

Ese último verbo es el centro silencioso de todo el flujo. Cuando los resultados vuelven a una Tarea compartida en lugar de desaparecer en una ventana de chat, la programación agéntica deja de ser un truco individual y se convierte en algo que un equipo puede ver, revisar y en lo que puede confiar.

Dónde se queda la persona: el contrato de aceptación

La frase más importante de la programación agéntica tiene que ver con las partes que no automatizas. Los Agentes investigan, ejecutan, prueban y reportan. Las personas marcan la dirección, otorgan autoridad y aceptan el resultado. Deja en manos de las personas la aceptación final y las decisiones de publicación.

Desglosémoslo en los tres puntos donde se queda la persona:

• Dirección. Una persona describe la necesidad y fija el objetivo. El Agente puede dar forma al alcance y redactar los criterios de aceptación, pero la intención parte de ti. Una dirección mala produce código seguro de sí mismo y bien probado que resuelve el problema equivocado.
• Autoridad. El Agente actúa dentro de los límites que le concedes: en qué repositorios puede tocar, en qué Computer se ejecuta, si puede abrir un pull request o debe detenerse antes de la fusión. La autoridad es explícita, no se da por supuesta.
• Aceptación. Una persona revisa el resumen del cambio y las evidencias, y después acepta, solicita cambios o decide el paso de fusión y publicación. Esta puerta nunca se traslada a la máquina, por muy bueno que llegue a ser el Agente.

Este es el contrato que hace que la programación agéntica sea segura de ejecutar a escala de equipo. La automatización se detiene donde se requiere el criterio del equipo y devuelve una entrega con contexto completo y evidencias inspeccionables. Fíjate en que el contrato no frena a los buenos Agentes: da a su resultado un lugar donde ser juzgado. Un Agente que produce un diff limpio, pruebas en verde y un resumen claro hace que la aceptación sea rápida. La puerta no es una fricción; es el punto donde la confianza se gana o se niega en función de las evidencias.

La programación agéntica como flujo de trabajo de equipo con Sharkly

Todo lo anterior funciona para un desarrollador y un Agente. Se desmorona en un equipo a menos que el trabajo, el contexto y la revisión vivan en algún sitio compartido. Ese hueco es el que cubre Sharkly.

Sharkly no sustituye a Claude Code, Codex ni a otras herramientas de ejecución. Añade la capa de Tareas compartidas, Computers, contexto, control y revisión alrededor de las herramientas que tu equipo ya usa. Claude Code, Codex y herramientas similares se encargan de la ejecución. Sharkly gestiona la asignación a nivel de equipo, los Computers conectados, el contexto de las Tareas, el progreso, los bloqueos, los resultados y la revisión humana en todas esas herramientas. Conservas las suscripciones a modelos y las claves de API que tu equipo ya tenía configuradas; Sharkly hace que las ejecuciones sean asignables y trazables.

Así se corresponde la escalera de cuatro etapas con el producto:

• Una Tarea es la unidad principal de trabajo en Sharkly, y es donde conviven la solicitud, el diff del Agente, los resultados de las pruebas y la revisión. Es el registro compartido que el chat nunca tuvo.
• Un Agente define cómo debe gestionarse el trabajo; un Computer aporta el host y los recursos locales; un Runtime ejecuta la sesión real del agente; la Tarea sigue siendo el registro compartido del equipo. Cada rol tiene una única función.
• Ejecutar Agentes en paralelo es seguro porque cada uno trabaja en un worktree aislado en un Computer conectado, así que las ejecuciones simultáneas no se pisan entre sí.
• Un Crew se encarga del peldaño orquestado: un grupo reutilizable de Personas y Agentes coordinado por un Agente líder, cuyo resultado combinado se devuelve en una sola Tarea.

El flujo oficial de desarrollo de producto se lee como cuatro etapas que reflejan exactamente el bucle del agente y el contrato de aceptación: una persona describe la necesidad y un Agente investiga y crea Tareas ejecutables; los Agentes toman las Tareas listas y desarrollan en paralelo; el Agente ejecuta el typecheck, las pruebas y la compilación, adjunta las evidencias, y una persona acepta o solicita cambios; el equipo hace seguimiento de la finalización, la propiedad, las dependencias y los bloqueos en el plan compartido. La ventaja de un equipo no viene de abrir más chats de IA, sino de compartir roles, reglas, contexto y flujos de trabajo para que una buena configuración se convierta en una capacidad de desarrollo que el equipo reutiliza.

El beneficio práctico es un sistema en el que el contexto, el progreso, los bloqueos, los resultados y la revisión humana permanecen visibles: solicítalo y asígnale una Tarea de bajo riesgo.

Errores habituales al adoptar la programación agéntica

Hay algunos patrones de fallo que aparecen una y otra vez. Evítalos y la curva de adopción será mucho más suave.

1. Subir a Crews antes de saber revisar un solo Agente. Si no puedes ver y aceptar limpiamente el trabajo de un Agente, cinco te van a enterrar. Domina la etapa 2 antes de la etapa 4.
2. Entregar una dirección vaga. «Mejora el flujo de pago» no es una Tarea. Acótala, o deja que el Agente redacte el alcance y los criterios de aceptación y confírmalos antes de que se ejecute.
3. Saltarse la puerta de aceptación por la presión de los plazos. En el momento en que fusionas el resultado de un agente sin leerlo porque las pruebas pasan, has cambiado la programación agéntica por vibe coding. Que las pruebas pasen es necesario, pero no suficiente.
4. Ejecutar Agentes en paralelo sin aislamiento. Los Agentes simultáneos que comparten un mismo directorio de trabajo corrompen los cambios unos de otros. Los worktrees aislados por Agente no son opcionales en la etapa 3.
5. Dejar que el contexto viva en chats privados. Si el razonamiento que hay detrás de un cambio no está en la Tarea, la siguiente persona no podrá revisarlo ni construir sobre él. Mantén el registro compartido.

La programación agéntica frente a términos relacionados

El vocabulario en torno a este ámbito es ruidoso. Así se sitúa la programación agéntica frente a los términos con los que se confunde.

La programación agéntica es el flujo de trabajo. La orquestación es lo que necesitas en cuanto tienes más de un Agente ejecutándolo. Son los dos pilares del mismo sistema, y por eso los equipos que adoptan uno suelen querer el otro poco después.

Casos de uso reales

Un endpoint de backend con el plazo ajustado. Un desarrollador describe un nuevo endpoint, sus entradas y sus criterios de aceptación como una Tarea. Un Agente investiga los patrones de rutas existentes, escribe el handler y las pruebas en un worktree aislado, ejecuta la suite y devuelve un diff con las comprobaciones en verde. El desarrollador revisa y fusiona. Tiempo de trabajo manual invertido: un mensaje para acotar el alcance y una revisión.

Una maratón de bugs en paralelo. Un tech lead registra seis Tareas de bugs no relacionados antes del standup. Seis Agentes las toman, cada uno en su propio worktree y su propio Computer. A media mañana, las Tareas contienen seis diffs con evidencias de pruebas, listos para revisión. La atención de una sola persona ya no limita el rendimiento de seis correcciones.

Un objetivo de mayor alcance con un Crew. Un objetivo más amplio, por ejemplo una página de ajustes con trabajo de backend, frontend y migración, va a un Crew. El Agente líder lo divide en Tareas, involucra a los Agentes miembros y devuelve el resultado combinado en una sola Tarea para una única decisión de aceptación. La persona responsable ve la propiedad, las dependencias y los bloqueos en el Sprint compartido en todo momento.

Conclusión

La programación agéntica no es un autocompletado más listo. Es un cambio en la unidad de trabajo, del prompt que pegas a la Tarea que asignas, y un cambio equivalente en tu rol, de autor a director. La definición que merece la pena recordar es sencilla:

• Los Agentes investigan, ejecutan, prueban y reportan; las personas marcan la dirección, otorgan autoridad y aceptan.
• Madura en cuatro peldaños: asistente de chat, un único Agente, Agentes en paralelo y Crew orquestado.
• La puerta de aceptación nunca se traslada a la máquina, por muy capaz que sea el Agente.
• El trabajo en paralelo necesita aislamiento; el trabajo en equipo necesita una Tarea compartida a la que vuelvan los resultados.
• La parte difícil es la coordinación y la revisión, que es la capa que Sharkly añade alrededor de las herramientas de programación que ya utilizas.

Empieza por el peldaño más bajo que te resulte útil. Descarga Sharkly, conecta un Computer, crea un Agente y asígnale algo pequeño y aburrido. Acepta tú mismo el resultado. Ese único bucle, ejecutado una vez, enseña más sobre programación agéntica que cualquier definición, incluida esta.

Preguntas frecuentes

¿Qué es la programación agéntica en términos sencillos? Es una forma de construir software en la que asignas una pieza de trabajo acotada a un Agente de programación con IA que investiga tu código, aplica el cambio, ejecuta las pruebas y reporta con evidencias, en lugar de intercambiar mensajes uno a uno en un chat. Tú sigues decidiendo qué construir y si el resultado es suficientemente bueno para publicarlo.

¿En qué se diferencia la programación agéntica de usar ChatGPT o Copilot para escribir código? Los asistentes de chat y el autocompletado responden a un prompt y te devuelven el resultado para que lo integres y lo verifiques. Un Agente lleva toda una Tarea a través de la investigación, la ejecución, las pruebas y un resultado reportado. La unidad cambia de un mensaje a una pieza de trabajo, y el Agente parte de tu repositorio real en lugar de una caja en blanco.

¿Es lo mismo la programación agéntica que el vibe coding? No. El vibe coding consiste en aceptar código generado sin leerlo, lo que saca a la persona del paso de aceptación. La programación agéntica mantiene la aceptación firmemente en manos de una persona y solo automatiza el medio: la investigación, la ejecución y las pruebas. Uno es un atajo; el otro es un flujo de trabajo revisable.

¿La programación agéntica sustituye a los desarrolladores? No. Mueve al desarrollador de teclear cada línea a marcar la dirección, otorgar autoridad y aceptar el resultado. Los Agentes investigan, ejecutan, prueban y reportan; las personas deciden qué construir y si se publica. La aceptación final y la publicación siguen en manos de las personas.

¿Qué herramientas necesito para empezar con la programación agéntica? Una herramienta de programación con IA capaz de ejecutar tareas (Claude Code, Codex y similares) y una capa para asignar trabajo, mantener el contexto compartido y revisar resultados en todo el equipo. Sharkly es esa capa; funciona sobre las herramientas de ejecución y las suscripciones que ya tienes. Consulta qué es Sharkly para ver la visión general.

¿Cómo hacen los equipos para ejecutar muchos Agentes de programación a la vez sin que sea un caos? Cada Agente trabaja en su propia Tarea dentro de un worktree aislado, y cada resultado vuelve a una Tarea compartida donde una persona puede revisarlo. Esa combinación —aislamiento para la ejecución y un registro compartido para la revisión— es lo que evita que las ejecuciones paralelas choquen. Nuestra guía sobre cómo ejecutar varios Agentes de Claude Code en paralelo cubre la configuración.

¿Dónde se queda la persona en un flujo de programación agéntica? En tres puntos: la dirección (qué construir), la autoridad (qué puede tocar el Agente) y la aceptación (si el resultado se publica). Todo lo que hay entre esos puntos puede automatizarse; esos tres se quedan en manos de las personas.