Gobernanza

Una plantilla de política de IA para equipos de ingeniería

La mayoría de empresas que adoptan agentes de código IA lo hacen sin una política escrita. Luego algo sale mal, un secreto se filtra en un prompt, un junior entrega código que nadie revisó, y la política se escribe bajo presión, y mal. Aquí tienes una política corta que puedes adaptar hoy, y una forma de que se cumpla de verdad.

Por qué una política escrita gana a las buenas intenciones

"Usa el criterio" no es una política. Es lo que dices cuando no tienes una. Tus ingenieros van a usar agentes de código IA tengas o no una política, a menudo con cuentas personales y sin ninguna supervisión. Una política corta y escrita hace dos cosas: dice qué se espera antes de que la gente lo adivine, y te da algo a lo que apuntar cuando hay que justificar una decisión, ante un cliente, un auditor o un board.

Los seis puntos que necesita toda política

Mantenla lo bastante corta como para que de verdad se lea. Estos seis puntos cubren las decisiones que importan:

  • Quién puede usar qué herramientas: nombra los agentes de código IA aprobados y quién puede usarlos, con cuentas de empresa, nunca personales.
  • Qué datos nunca entran en un prompt: datos de clientes, secretos, credenciales y cualquier cosa cubierta por un acuerdo de confidencialidad.
  • Qué se revisa siempre una persona: todo cambio que llega a producción, sin excepciones porque "lo generó la IA".
  • Cómo se declara el trabajo asistido por IA: una marca simple en el commit o el pull request, no una confesión, solo un hecho para auditorías futuras.
  • Qué nivel de calidad aplica: los mismos tests, linting y estándar de revisión que el código escrito por personas, nunca uno más bajo.
  • Quién responde: quien dirige al agente y hace el merge del resultado. La política debe decirlo con estas palabras.

Convertir la política en comprobaciones

Una política que solo vive en un documento se olvida en un mes. Las partes que importan deben aplicarse con herramientas, no con la memoria:

  • Escaneo de secretos en pre-commit y CI, para que una clave filtrada rompa el build, no la auditoría.
  • Comprobación de licencias en las dependencias que sugiere un agente, porque un agente propondrá con gusto un paquete con términos que no puedes usar.
  • Un paso de revisión obligatorio en tu plantilla de pull request que no se pueda saltar, con una casilla de "asistido por IA, revisado línea a línea".
  • Aplicar las herramientas aprobadas a nivel de red o SSO donde puedas, en lugar de confiar en que todos lo recuerden.

Desplegarla sin generar rechazo

Una política que se lee como una lista de prohibiciones se acaba esquivando. Preséntala como quitar riesgo a algo que el equipo ya quiere hacer, no como bloquearlo. Involucra a dos o tres ingenieros senior en el primer borrador, pilótala en un equipo durante dos semanas y corrige lo poco práctico antes de desplegarla en toda la empresa. Publica el razonamiento, no solo las reglas: los ingenieros siguen una política que entienden.

Una plantilla lista para copiar

Adáptala a tu contexto, mantén los seis puntos y ponla donde vive el manual de tu equipo de ingeniería:

  • Herramientas aprobadas: [nombra tus agentes de código IA aprobados]. Solo con cuentas de empresa.
  • Nunca en un prompt: datos de clientes, credenciales, secretos, nada cubierto por un NDA.
  • Siempre se revisa: todo cambio a código de producción, por una persona que lo entienda.
  • Siempre se declara: marca los commits o pull requests asistidos por IA para que el registro sea honesto.
  • Mismo nivel: tests, linting y revisión aplican exactamente igual que al código escrito por personas.
  • Quién responde: quien dirige al agente y hace el merge del cambio es dueño del resultado.

Mantenerla viva

Revisa la política cada trimestre, o cuando aparezca un tipo de herramienta nuevo. Nombra a un responsable, normalmente un ingeniero senior o el CTO, que la actualice y responda preguntas. Una política sin dueño queda obsoleta el mismo día que se publica.

Preguntas frecuentes

¿Esta política aplica a herramientas de autocomplete como GitHub Copilot, o solo a agentes completos? ⌄

Sí. El límite de datos y la obligación de revisión aplican a cualquier herramienta que vea tu código o sugiera cambios, autocomplete incluido. El punto de responsabilidad pesa menos para una sola línea sugerida, pero la regla de datos no cambia.

¿Qué hacemos con los ingenieros que usan una cuenta personal de ChatGPT o Claude? ⌄

Trátala como una herramienta no aprobada según la política. El riesgo no es el modelo, es que código o datos de la empresa salgan por una cuenta que no controlas ni puedes auditar. Aprueba una cuenta de empresa para esa misma herramienta en lugar de intentar prohibir el comportamiento sin más.

¿Cómo gestionamos el riesgo de licencias del código open source que sugiere la IA? ⌄

Aplica el mismo escaneo de dependencias y licencias que ya usas para paquetes añadidos por personas, y asegúrate de que también corre sobre el código sugerido por IA antes del merge. Los agentes no comprueban la compatibilidad de licencias salvo que se lo pidas, y sugerirán lo que resuelva el problema más rápido.

¿La política necesita decir algo distinto para los juniors? ⌄

Sí, una línea: los ingenieros junior deben poder explicar, con sus propias palabras, cualquier código generado por IA que entreguen, antes de que se revise. No cuesta nada exigirlo y es la mejor protección única contra la ilusión de competencia.

Consigue una política que tu equipo siga de verdad

Una política vale lo que valen su despliegue y sus comprobaciones. Si quieres ayuda para adaptarla a tu contexto, integrarla en CI y conseguir que el equipo la adopte, es justo lo que hago en advisory.