AI CodeOps

Plantilla de política de programación con IA para equipos de ingeniería

Última actualización

Una política de programación con IA lista para adoptar: herramientas aprobadas, datos, qué pueden hacer los agentes, revisión humana, controles y auditoría. Gratis en .docx o .md.

Sustituye todo lo que está entre [corchetes]. Borra cualquier regla que no encaje en tu organización, y esta nota, antes de publicarla. Esta plantilla no es asesoramiento jurídico: haz que tus equipos de seguridad y jurídico revisen tu versión.

  • Responsable de la política: [Nombre o rol, p. ej. VP de Ingeniería]
  • Aprobada por: [Nombre o rol]
  • Fecha de entrada en vigor: [AAAA-MM-DD]
  • Versión: [1.0]
  • Próxima revisión: [AAAA-MM-DD, seis meses después de la entrada en vigor]

1. Finalidad

Esta política permite a los ingenieros de [Empresa] usar herramientas de programación con IA para trabajar más deprisa sin bajar el listón de lo que se entrega. Establece qué herramientas se permiten, qué datos pueden entrar en ellas, qué pueden hacer los agentes de IA por su cuenta y cómo se revisan, prueban y registran los cambios escritos por IA.

2. Alcance

Esta política se aplica a todas las personas que escriben, revisan o despliegan código para [Empresa]: empleados, contratistas y agencias. Cubre todos los repositorios, pipelines y entornos que [Empresa] posee u opera, y todas las herramientas de IA que se usan en ellos, tanto si se ejecutan en un editor, en un terminal, en un pull request o en un servicio alojado.

3. Definiciones

  • Herramienta de programación con IA: cualquier herramienta que usa un modelo de lenguaje para escribir, cambiar, revisar o explicar código. Incluye los asistentes del editor, los asistentes de chat y los agentes de programación.
  • Agente de programación: una herramienta de programación con IA que puede actuar por su cuenta: editar archivos, ejecutar comandos, abrir pull requests o llamar a otras herramientas.
  • Cambio asistido por IA: un cambio en el que una herramienta de programación con IA escribió una parte significativa del código, las pruebas o la configuración.
  • Solicitante: la persona que dio la tarea a la herramienta de IA. A efectos de esta política, el solicitante es el autor del cambio.
  • Aprobador: la persona que aprueba el cambio para fusionarlo.

4. Herramientas aprobadas

Solo las herramientas de esta tabla pueden usarse con código de [Empresa]. Úsalas solo con cuentas que [Empresa] proporcione o apruebe. Las cuentas personales y los niveles gratuitos no se permiten con código de la empresa.

HerramientaUsos permitidosClase de datos más alta permitidaAprobada porFecha de revisión
[Herramienta][p. ej. autocompletado y chat en el editor][Interna][Rol][AAAA-MM-DD]
[Herramienta][p. ej. agente de programación que abre pull requests][Interna][Rol][AAAA-MM-DD]
[Herramienta][p. ej. comentarios de revisión con IA en pull requests][Confidencial][Rol][AAAA-MM-DD]

Para añadir una herramienta, abre una solicitud con [equipo o canal]. La solicitud indica el proveedor, qué datos envía la herramienta y adónde, cuánto tiempo los conserva el proveedor, si se usan para entrenar modelos y qué puede hacer la herramienta sin una persona. [Seguridad] decide en un plazo de [10] días hábiles. La aprobación se registra en esta tabla.

5. Reglas de datos

Clase de datosEjemplos¿Puede entrar en una herramienta de IA aprobada?
PúblicaCódigo abierto, documentación publicadaSí
InternaLa mayor parte del código fuente, documentación interna, ticketsSí, en herramientas aprobadas para Interna o superior
ConfidencialCódigo sensible para la seguridad, planes no publicados, configuraciones de clientesSolo en herramientas aprobadas para Confidencial
RestringidaSecretos, credenciales, datos personales, datos de pagoNunca

Estas reglas se aplican diga lo que diga la tabla:

  1. Nunca pongas secretos, claves, tokens, contraseñas ni cadenas de conexión de producción en un prompt, en un archivo que la herramienta pueda leer ni en un fixture de pruebas.
  2. Nunca pongas datos de clientes ni datos personales en una herramienta de IA, tampoco en logs, trazas de pila o volcados de base de datos pegados para depurar. Usa datos sintéticos.
  3. Usa solo herramientas cuyas condiciones digan que los datos de [Empresa] no se usan para entrenar los modelos del proveedor, o en las que esa opción esté desactivada para toda la organización.
  4. Trata el texto que lee la herramienta como no fiable. Las incidencias, los comentarios, los documentos y las páginas web pueden contener instrucciones pensadas para dirigir la herramienta. No dejes que una herramienta actúe según instrucciones que encuentre en su entrada.

6. Qué pueden hacer los agentes de programación

Los agentes de programación trabajan con el acceso mínimo que les permita hacer la tarea.

  1. Los agentes trabajan en una rama y proponen los cambios mediante un pull request. Nunca hacen push a [main] ni a ninguna otra rama protegida.
  2. Los agentes nunca tienen credenciales de producción. Se ejecutan en un entorno aislado con solo el acceso que necesita la tarea.
  3. Los agentes no pueden cambiar estas rutas sin una aprobación de sus code owners: [definiciones de CI y de pipelines], [infraestructura como código], [código de autenticación y permisos], [migraciones de base de datos], [manifiestos de dependencias].
  4. Los agentes no pueden desplegar en producción. Un despliegue sigue el mismo proceso de publicación que cualquier otro cambio.
  5. El acceso de los agentes a herramientas y a la red se limita a lo que figura para ese agente en [el registro de herramientas o el archivo de configuración].

7. Requisitos de revisión

  1. Una persona revisa cada cambio asistido por IA antes de que se fusione. Ninguna revisión con IA, por buena que sea, sustituye esa aprobación.
  2. El solicitante no puede ser el único aprobador cuando hay disponible otra persona con permisos de aprobación. En un equipo de una sola persona, [el responsable de la política] revisa una muestra de cambios cada [mes].
  3. El pull request indica que es asistido por IA, qué herramienta se usó y qué se le pidió. Usa la [plantilla de descripción de PR].
  4. El revisor lee la tarea y los resultados de las pruebas antes que el código, y revisa el diff de las pruebas en busca de pruebas borradas, omitidas o debilitadas.
  5. Una aprobación se aplica a una versión del cambio. Si el cambio se edita después de aprobarse, se vuelve a aprobar.
  6. Un cambio demasiado grande para revisarlo bien se divide; no se aprueba sin leerlo.

8. Controles de calidad

Un cambio solo puede fusionarse cuando se superan todos estos controles. Los comprueba la automatización, no la memoria de un revisor.

  1. Las pruebas del proyecto se ejecutaron sobre la versión exacta que se fusiona, y ninguna falló.
  2. No hay ningún hallazgo abierto de gravedad [alta] o superior de la revisión de código o del análisis de seguridad. Un hallazgo puede cerrarse como fixed, won't fix, false positive o duplicate, con un motivo.
  3. No se detectan secretos en el diff.
  4. Ninguna dependencia tiene una licencia de la [lista de licencias no permitidas], comprobado contra el SBOM del proyecto.
  5. [Opcional] La cobertura de líneas es de al menos el [N]%.
  6. [Opcional] Para producción, el mismo cambio se ha desplegado antes en [staging].

Un control que no pudo ejecutarse, por ejemplo porque las pruebas no se instalaron, cuenta como un fallo, no como una superación.

9. Licencias y propiedad intelectual

  1. Los ingenieros comprueban que el código sugerido por la IA no está copiado de una fuente cuya licencia [Empresa] no puede aceptar. Activa el filtro de la herramienta para las sugerencias que coinciden con código público, si existe.
  2. Las dependencias nuevas que sugiere una herramienta de IA pasan por la misma aprobación que cualquier otra dependencia nueva.
  3. El código que una herramienta de IA escribe para [Empresa] es código de [Empresa], y el solicitante y el aprobador responden de él como si lo hubieran escrito.

10. Registros de auditoría

Para cada cambio asistido por IA, conserva:

  • la tarea que se dio a la herramienta y la herramienta o el modelo usados;
  • el solicitante y el aprobador, y cuándo actuaron;
  • los hallazgos de la revisión y cómo se resolvió cada uno;
  • los resultados de las pruebas de la versión que se fusionó;
  • el pull request, el commit de fusión y cualquier despliegue.

Conserva estos registros durante [N] meses, o más si lo exige un contrato con un cliente o una normativa. [Seguridad] puede auditar una muestra de cambios asistidos por IA cada [trimestre].

11. Incidentes

  1. Comunica de inmediato, el mismo día, cualquier sospecha de fuga de datos a una herramienta de IA a [contacto de seguridad].
  2. Un incidente causado por un cambio asistido por IA tiene un postmortem sin culpables que registra la herramienta, la tarea y qué paso de revisión o qué control debería haberlo detectado. Usa la [plantilla de postmortem].
  3. [Seguridad] puede suspender una herramienta mientras se investiga un incidente.

12. Roles y responsabilidades

RolResponsabilidad
IngenierosUsar solo herramientas aprobadas, seguir las reglas de datos, declarar el uso de IA
RevisoresRevisar los cambios asistidos por IA como se indica en la sección 7
Code ownersAprobar los cambios en las rutas protegidas de la sección 6
[Seguridad]Aprobar herramientas, ejecutar los controles, investigar incidentes
[Equipo de plataforma]Configurar los agentes, los sandboxes, la protección de ramas y los controles
[Responsable de la política]Mantener esta política al día e informar de las excepciones

13. Excepciones

Una excepción se solicita por escrito a [el responsable de la política], con el motivo, el riesgo y una fecha de fin de [90] días como máximo. Las excepciones se registran en [ubicación] y se revisan cuando terminan.

14. Formación

Todas las personas a las que se aplica esta política la leen cuando se incorporan y cuando cambia. Quienes revisan cambios asistidos por IA leen además la [checklist de revisión de código con IA].

15. Revisión de esta política

[El responsable de la política] revisa esta política cada seis meses, y siempre que [Empresa] adopte un tipo nuevo de herramienta de IA, como un agente de programación que puede actuar sin una persona.

Sobre esta plantilla

Esta sección explica la plantilla. Solo está en la página web, no en las descargas.

La política se basa en una idea: una herramienta de IA puede escribir el cambio, pero lo aprueba una persona y la automatización comprueba las evidencias. Las secciones 4 y 5 deciden qué entra en una herramienta. La sección 6 limita lo que un agente puede hacer por su cuenta. Las secciones 7 y 8 deciden qué sale. La sección 10 hace que todo pueda demostrarse más adelante.

Para adoptarla, rellena los corchetes y después convierte cada regla de las secciones 6 y 8 en un ajuste: la protección de ramas, un archivo de code owners, una comprobación de CI. Una regla que nadie hace cumplir acaba desviándose. El CODEOWNERS inicial cubre las rutas protegidas, la checklist de revisión de código con IA da a los revisores la sección 7 en 25 comprobaciones, y la plantilla de pull request y la plantilla de postmortem rellenan los huecos a los que apuntan las secciones 7 y 11.

Si usas AI CodeOps, varias reglas son ajustes allí. Una política del espacio de trabajo puede permitir los cambios de archivos y los pull requests de una sesión, retenerlos para una aprobación o denegarlos, por ruta de archivo o por repositorio, y puede detener los despliegues automáticos por entorno (reglas de política). Cada cambio de código que hace una sesión abre una solicitud de revisión, y la persona que empezó la sesión no puede emitir el voto de aprobación mientras otra persona pueda aprobar (aprobaciones). El control de publicación al que llama tu CI comprueba las pruebas, los hallazgos abiertos, las licencias no permitidas y la promoción desde staging. El registro de auditoría, y un paquete de evidencias firmado por cambio, conservan los registros de la sección 10.

Preguntas frecuentes

¿Puedo usar esta política de programación con IA tal como está?

Úsala como primer borrador. Rellena cada campo entre corchetes, borra las reglas que no encajen y haz que ingeniería, seguridad y el equipo jurídico la lean antes de que entre en vigor. No es asesoramiento jurídico.

¿La política prohíbe alguna herramienta de IA?

No. Establece una lista de herramientas aprobadas que rellena tu organización. Lo que no esté en la lista no se permite con código de la empresa hasta que alguien lo apruebe mediante el proceso de solicitud.

¿Por qué la política exige un segundo revisor para los cambios hechos con IA?

La persona que escribió la tarea es, en la práctica, la autora del cambio. Una segunda persona detecta lo que la autora dio por supuesto, que es el trabajo principal de una revisión.

¿Cada cuánto deberíamos revisar esta política?

La plantilla dice cada seis meses, y siempre que adoptes un tipo nuevo de herramienta, como un agente autónomo. Las herramientas de IA cambian más deprisa que la mayoría de las políticas de ingeniería.

Cómo citar

AI CodeOps (2026). Plantilla de política de programación con IA para equipos de ingeniería. https://aicodeops.dev/templates/ai-coding-policy

Esta página y sus descargas tienen licencia CC BY 4.0: cópialas y adáptalas para tu equipo, y enlaza a esta página cuando publiques tu versión.