Saltar al contenido
Giordano Cabral

Ingeniería de software con agentes · 2025–

¿Qué cambia en la ingeniería de software cuando quien escribe el código es un agente?

Cuando un agente pasa a escribir el código, el trabajo de quien construye software se desplaza de producir a especificar, verificar y responder por el resultado. FAROL, fundado por Giordano Cabral con Filipe Calegário en el CIn/UFPE, organiza ese desplazamiento en quince preguntas que un equipo necesita saber responder: desde cómo gestionar el contexto y escribir una buena especificación hasta cómo protegerse contra la inyección de prompts, cómo lidiar con el no determinismo, cómo medir la productividad real y cómo preservar la habilidad humana. El instrumento que las aplica, FAROL Software, mide la empresa en cuatro familias —fundamentos técnicos, capa agéntica, calidad y riesgo, organización y personas— con 37 preguntas de mapeo y otras 77 opcionales de práctica, frente a un banco maestro de 264 ítems, en un tiempo de quince a sesenta minutos. Es abierto y gratuito.

Mural con una cuadrícula de tarjetas en blanco sujetas con alfileres, cuadrícula levemente imperfecta; una única tarjeta roja.
Póster en grabado negro y rojo: especificar, verificar y responder por lo que se entregó; un fichero con cinco de las quince preguntas; un cronómetro: 19 % más lentos con IA, creían estar 20 % más rápidos.
El argumento en una página.

01 · Crear programas con IA

¿Qué cambia cuando el agente escribe el código?

Producir código deja de ser el cuello de botella; pasan a serlo especificar con precisión lo que se quiere, verificar lo que el agente devolvió y responder por lo que se entregó.

Dos mediciones externas delimitan el problema. La encuesta de Stack Overflow de 2025 registra un 84 % de uso de IA entre desarrolladores, con un 46 % que dice desconfiar de la exactitud frente a un 33 % que confía, y un 66 % que informa soluciones "casi correctas, pero no del todo". Y el ensayo controlado de METR, de julio de 2025 midió a desarrolladores experimentados en proyectos maduros que se volvieron un 19 % más lentos con IA, mientras creían ser un 20 % más rápidos. Por eso el diagnóstico pregunta por práctica observable.

02 · Crear programas con IA

¿Cuáles son las quince preguntas que un equipo necesita responder?

Son la columna vertebral del diagnóstico de fluidez operativa de FAROL para empresas de software. Cada una corresponde a una decisión de ingeniería que, antes de los agentes, no existía o no tenía peso:

  • Cómo gestionar el contexto: qué entra y qué queda fuera de la ventana del modelo.
  • Cómo controlar el consumo de tokens, que es un costo variable.
  • Cómo escribir una buena especificación, que pasó a ser el artefacto de entrada.
  • Cómo diseñar el harness del agente: las herramientas, los límites y el entorno en que se ejecuta.
  • Cómo orquestar agentes en niveles, cuando uno coordina a otros.
  • Cómo garantizar la calidad de código que nadie escribió a mano.
  • Cómo lidiar con el no determinismo, ya que la misma entrada no devuelve la misma salida.
  • Cómo elegir entre hacer pareja en tiempo real y delegar en segundo plano: la persona en la sesión, viendo cada paso, o el agente ejecutándose solo hasta devolver el resultado.
  • Cómo protegerse contra la inyección de prompts, la nueva superficie de ataque.
  • Cómo medir la productividad real, y no la percibida.
  • Qué se ejecuta de forma local y qué sale de la máquina.
  • Cómo integrar IA en código heredado, que es donde está la mayor parte del trabajo.
  • Cómo organizar el ciclo de vida agéntico, del experimento a la producción.
  • Cómo preservar la habilidad humana cuando la generación se delega.
  • Cómo reorganizar el equipo en torno a esto.

La pregunta sobre la habilidad humana tiene una posición detrás. La hipótesis de trabajo del grupo es que delegar la generación de código cobra un precio en la formación de habilidad, con mayor efecto sobre quien está empezando. Rechazar la destilación de competencia se trata allí como un requisito de producto.

03 · Crear programas con IA

¿Cómo descubre una empresa de software dónde está?

Mediante FAROL Software, el diagnóstico de la vertical de ingeniería. Mide a la empresa en cuatro familias (fundamentos técnicos, capa agéntica, calidad y riesgo, organización y personas), contra el banco maestro de 264 ítems de FAROL.

  • Cómo funciona: autoaplicable, de quince a sesenta minutos. Son 37 preguntas de mapeo (vocabulario e inventario de conceptos) y, opcionalmente, 77 más de práctica, sobre cómo la empresa opera de hecho cada concepto. Una pregunta por pantalla, escala de 0 a 4, resultado en puntuación por familia, radar y próximos pasos.
  • De dónde viene: investigación del CIn-UFPE en colaboración con una plataforma de madurez organizacional, que sintetiza más de 60 fuentes, entre ellas Anthropic, OpenAI, Google, IEEE, ACM, Linux Foundation y casos brasileños.
  • En qué estado está: versión 0.1, declarada como MVP.
FAROL Software: cuatro familias, 264 ítems, versión 0.1
FAROL Software: cuatro familias, 264 ítems, versión 0.1

04 · Crear programas con IA

¿Cómo se observa lo que un agente realmente hizo?

Medir a un agente es distinto de medir a una persona, porque el rastro del trabajo está en la herramienta y cada herramienta registra algo diferente. El benchmark de telemetría de interacción con agentes es una curaduría abierta de las herramientas de observación (Claude Code, Codex, Cursor, Copilot y otras), que las compara por lo que cada una deja de ver, y no por la lista de funciones.

https://telemetria-interacao-agentes.vercel.app

Benchmark de telemetría para agentes de IA
Benchmark de telemetría para agentes de IA

La misma lógica se aplica en la enseñanza: en Hiper Deep Research, el sistema de la disciplina Tendências em Mídia e Interação (Tendencias en Medios e Interacción), impartida por Giordano Cabral, la telemetría registra el tiempo dedicado a cada ítem cribado, porque lo que se evalúa es el proceso, y la lectura de 500 ítems no aparece en el resultado final. El sistema está escrito sin build y sin framework, con módulos ES nativos y Supabase detrás, y la regla de unicidad (una herramienta pertenece a un alumno por unidad) es una clave primaria compuesta en la base de datos.

05 · Crear programas con IA

¿Dónde encontrar la herramienta adecuada cuando aparecen decenas por semana?

En Arsenal of Tools, catálogo abierto de herramientas, CLIs, servidores MCP, modelos, APIs y "perlas", el long tail que los asistentes genéricos tienden a omitir en favor de lo obvio. Nació para uso propio, de alumnos y de profesionales.

El 18/09/2026, la versión 3.7 reunía 320.483 ítems: 1.483 categorías, 174.869 etiquetas, 102 países, 23.197 CLIs, 8.554 servidores MCP, 80.506 modelos de Hugging Face, 24.919 APIs y 28.678 hallazgos de redes sociales, reunidos a partir de 632 listas abiertas, marketplaces, boletines y revistas.

La búsqueda se ejecuta en el navegador, sin llamada a un modelo por consulta; no hay anuncios ni rastreo.

Arsenal of Tools: catálogo abierto de herramientas
Arsenal of Tools: catálogo abierto de herramientas

06 · Crear programas con IA

¿Cómo registrar las decisiones cuando el trabajo lo hacen varias sesiones de IA?

Quien trabaja con muchas sesiones de asistente en paralelo pierde, en cada cambio de ventana, el porqué de lo ya decidido. El método adoptado por Cabral es un protocolo de decantación: cada decisión se convierte en un archivo con el motivo, las alternativas descartadas y cómo verificar si se está respetando. El protocolo se apoya en una base de conocimiento que la propia IA compila a partir de las fuentes de trabajo, organizada por conceptos, proyectos y personas, y no por conversaciones. En el relevamiento del 03/09/2026, esa base tenía 958 fuentes, 38 conceptos, 32 proyectos, 180 personas y 24 organizaciones, con ingesta cuatro veces al día.

La base es de trabajo y no es pública. El método y la herramienta sí lo son: mad (MultiAgent Decanting), plugin bajo licencia MIT que pone a un equipo de agentes a trabajar con registro de decisiones integrado, distribuido por un marketplace de plugins también abierto.

  • https://github.com/giordanorec/multiagents-decanting
  • https://github.com/giordanorec/ai-coding-tools

07 · Crear programas con IA

¿Cómo se convierte un método de trabajo en algo que la IA ejecuta?

Empaquetándolo como skill: un archivo en Markdown que cualquier asistente carga y que conduce el trabajo paso a paso, en lugar de describirlo. Son tres ejemplos en uso:

  • Projetão para a era da IA — la metodología de proyecto de innovación creada en el CIn/UFPE en 2002, reempaquetada en 10 quests, 13 hitos y 20 obras leídas, para ejecutarse dentro de Claude, ChatGPT, Cursor, Copilot, Codex o Gemini. Cada quest declara el modo de uso de la IA: sin asistencia (campo y entrevista, a propósito), con apoyo (ella critica y señala) y coproducción (ella genera, la persona verifica y responde); el color de la quest marca el modo más restrictivo.
  • Acervo de Teorias Acionáveis — teorías de administración en dos capas: material didáctico que explica y una skill portátil que ejecuta. Declara 3 teorías, 3 skills listas y 368 libros en la base; el módulo abierto más completo es Running Lean, en siete módulos, con el archivo .skill para descargar.
  • Las skills de los alumnos. En Tendências em Mídia e Interação, cada alumno construye su propia skill de prospección, con cuatro exigencias verificadas por script, y entrega junto con ella el registro de dónde la IA se equivocó y cómo lo percibió.
El Projetão empaquetado como diez quests para usar con IA
El Projetão empaquetado como diez quests para usar con IA

08 · Crear programas con IA

¿Qué experiencia previa sustenta esto?

Giordano Cabral desarrolla software desde antes de la IA generativa. En 2000, el sistema de su tesis de maestría en el CIn dio origen a Daccord Music Software, preincubada en el Recife BEAT, con productos vendidos en el mercado internacional. El currículo Lattes registra 93 programas de computadora.

La lista completa está en www.cin.ufpe.br/publicacoes/, y los sistemas que están en línea hoy, en www.cin.ufpe.br/projetos/.

Preguntas frecuentes

¿Qué cambia en la ingeniería de software con agentes de IA?

Cambia lo que es escaso: producir código deja de ser el cuello de botella, y especificar, verificar y responder por el resultado pasa a serlo. El FAROL (CIn/UFPE) organiza el cambio en quince preguntas que un equipo necesita saber responder: gestionar el contexto, controlar el consumo de tokens, escribir una buena especificación, diseñar el harness del agente, orquestar agentes por niveles, garantizar la calidad, lidiar con el no determinismo, elegir entre programar en pareja en tiempo real y delegar en segundo plano, proteger contra la inyección de prompt, medir la productividad real, decidir qué se ejecuta de forma local, integrar IA en código heredado, organizar el ciclo de vida agéntico, preservar la habilidad humana y reorganizar el equipo.

¿Programar con IA aumenta la productividad?

No automáticamente, y la percepción no sirve como medida. El ensayo controlado de METR, publicado en julio de 2025, midió a desarrolladores experimentados que trabajaban en proyectos maduros y quedaban un 19 % más lentos con IA, mientras creían ser un 20 % más rápidos. Por eso el diagnóstico del FAROL pregunta por práctica observable y no por sensación de ganancia, y por eso "cómo medir la productividad real" es una de las quince preguntas del instrumento.

¿Existe un diagnóstico gratuito de madurez en IA para empresas de software?

Sí. El FAROL Software, del FAROL (CIn/UFPE), es autoaplicable, abierto y gratuito: 37 preguntas de mapeo y otras 77 opcionales de práctica, de quince a sesenta minutos, en cuatro familias (fundamentos técnicos, capa agéntica, calidad y riesgo, organización y personas). Devuelve puntuación por familia, radar y próximos pasos. Está en la versión 0.1, declarada como MVP, y sintetiza más de 60 fuentes, entre ellas Anthropic, OpenAI, Google, IEEE, ACM y la Linux Foundation.

¿Qué es una skill de IA?

Es un archivo en Markdown que empaqueta un método de trabajo y que un asistente carga para conducir la ejecución paso a paso, en lugar de solo describir el método. Tres ejemplos públicos del CIn/UFPE: el Projetão para a era da IA, con diez quests y el modo de uso de la IA declarado en cada una; el módulo Running Lean del Acervo de Teorias Acionáveis, con el archivo para descargar; y las skills de prospección que cada alumno de la asignatura Tendências em Mídia e Interação construye y prueba.

¿Dónde encontrar herramientas de IA para desarrollo?

En el Arsenal of Tools, catálogo abierto mantenido en el ámbito del FAROL, que reúne CLIs, servidores MCP, modelos, APIs y hallazgos de redes sociales a partir de 632 listas abiertas, marketplaces y newsletters. El 18/09/2026 reunía 320.483 elementos en la versión 3.7, entre ellos 23.197 CLIs y 8.554 servidores MCP. La búsqueda se ejecuta en el navegador, sin anuncios y sin rastreo.

¿Usar IA para programar perjudica a quien está aprendiendo?

Es una hipótesis de trabajo del FAROL: la de que delegar la generación de código cobra un precio en la formación de habilidad, con mayor efecto sobre quien está empezando. La consecuencia práctica adoptada es tratar "cómo preservar la habilidad humana" como una de las quince preguntas del diagnóstico, y declarar el modo de uso de la IA en cada actividad de enseñanza, incluso prohibiéndola donde el objetivo es precisamente formar la competencia.