AI CodeOps

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

Matt · · Última actualización · 9 min de lectura · Guías

Una plantilla gratuita de política de programación con IA: las 8 secciones que importan, por qué existe cada regla y cómo aplicarlas e implantarla. Descárgala en .docx o .md.

Una política de programación con IA dice qué herramientas de IA pueden tocar el código de la empresa, qué datos pueden ver, quién revisa sus cambios y qué tiene que superarse antes de una fusión. Esta plantilla gratuita lo cubre en ocho secciones que hacen el trabajo, y este artículo explica cada regla y cómo convertirla en un ajuste, para que se cumpla el día en que nadie se acuerde de ella. Es una plantilla de partida, no asesoramiento jurídico.

Por qué necesitas una

La mayoría de los equipos de ingeniería ya usan herramientas de programación con IA. Menos son los que han puesto por escrito sus reglas. Lo habitual es una mezcla: unos usan el asistente de la empresa, otros una cuenta personal, un equipo configuró un agente de programación para un repositorio, y nadie sabe con seguridad si alguna vez se han pegado datos de clientes en una ventana de chat.

Una política lo arregla, pero solo si es lo bastante corta para leerla y lo bastante concreta para hacerla cumplir. La plantilla de política de programación con IA intenta ser las dos cosas. Tiene quince secciones breves: las ocho de abajo, más el marco que necesita toda política (finalidad, alcance, definiciones, roles, formación y cuándo revisarla). Una definición hace mucho trabajo: el solicitante, la persona que dio la tarea a la herramienta, es el autor del cambio. Así, «lo escribió la IA» nunca es una respuesta a «¿quién es responsable de esto?».

Las 8 secciones de la política

1. Herramientas aprobadas

La sección 4 de la plantilla es una tabla con las herramientas permitidas con código de la empresa, para qué puede usarse cada una y los datos más sensibles que puede ver cada una. No prohíbe ninguna herramienta. Lo que no está en la lista no se permite con código de la empresa hasta que alguien lo aprueba. Una lista de prohibidas se queda desfasada a la semana de escribirla; una lista de aprobadas falla del lado seguro.

El proceso de solicitud hace las preguntas que importan para una herramienta de IA: qué datos envía y adónde, cuánto tiempo los conserva el proveedor, si entrena modelos con ellos y qué puede hacer la herramienta sin una persona. Si necesitas más profundidad, la plantilla de cuestionario de seguridad para proveedores tiene treinta preguntas, con notas sobre cómo es una buena respuesta. Cada fila tiene un responsable, porque una regla sin responsable no se actualiza nunca.

2. Datos y secretos

La sección 5 define cuatro clases de datos, de pública a restringida, y cuáles pueden entrar en qué herramienta. Los secretos y los datos personales no entran en ninguna. Es la sección que la gente incumple sin querer, así que respáldala con un escaneo de secretos en CI y con los controles de datos de la propia herramienta.

3. Requisitos de revisión

La sección 7 dice que una persona revisa cada cambio asistido por IA, que el solicitante no es el único aprobador cuando otra persona puede revisar, y que una aprobación se aplica a una versión: una edición obliga a aprobar de nuevo. Con agentes, esa última regla importa más que antes, porque un «pequeño arreglo» de seguimiento puede ser más grande de lo que parece. La guía de aprobaciones humanas explica dónde tiene que seguir habiendo una persona en el bucle. En GitHub, las reglas de revisión se corresponden con la protección de ramas. En una regla de protección de ramas para main, activa:

AjusteRegla de la política
Require a pull request before merging6.1: los agentes nunca hacen push a main
Require approvals7.1: una persona revisa cada cambio
Dismiss stale pull request approvals when new commits are pushed7.5: una aprobación vale para una versión
Require approval of the most recent reviewable push7.2: aprueba otra persona
Require review from Code Owners6.3: las rutas protegidas necesitan un code owner
Require status checks to pass before merging8: los controles de calidad
Do not allow bypassing the above settingsLas excepciones pasan por la sección 13

La última importa más de lo que parece. Sin ella, la fusión de un administrador se salta todas las reglas anteriores, y los administradores suelen ser quienes configuran los agentes.

4. Controles

La sección 8 enumera lo que tiene que superarse antes de una fusión, comprobado por la automatización: pruebas sobre la versión exacta, ningún hallazgo abierto de gravedad alta o superior, ningún secreto, ninguna licencia no permitida y, opcionalmente, un mínimo de cobertura y un despliegue en staging. Termina con una frase que es fácil pasar por alto: un control que no pudo ejecutarse cuenta como un fallo, no como una superación. La alternativa es un pipeline que sale en verde justo cuando menos ha comprobado.

Si usas AI CodeOps, el control de publicación comprueba la mayor parte de la sección 8 en una sola llamada desde CI, y el paso falla salvo que la respuesta sea que se permite:

curl -sf -X POST "https://console.aicodeops.dev/api/release/check" \
  -H "Authorization: Bearer $WORKSPACE_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{
    \"pullRequestURL\": \"$PR_URL\",
    \"blockingSeverity\": \"high\",
    \"minCoveragePct\": 80,
    \"disallowedLicenses\": [\"AGPL-3.0\"],
    \"requireDeployedTo\": \"staging\"
  }" \
  | jq -e '.allowed == true'

Cada campo es una línea de la sección 8: blockingSeverity es la regla 2, disallowedLicenses es la regla 4, minCoveragePct es la regla opcional 5 y requireDeployedTo es la regla 6. Las pruebas fallidas bloquean por defecto, que es la regla 1. El 80 y la lista de licencias son ejemplos: usa los tuyos. El escaneo de secretos, la regla 3, sigue siendo un paso aparte de tu pipeline.

5. Licencias

La sección 9 pide a los ingenieros que comprueben que el código sugerido por la IA no está copiado de una fuente cuya licencia no puedes aceptar, y que activen el filtro de la herramienta para las sugerencias que coinciden con código público, si existe. Las dependencias nuevas que sugiere una herramienta de IA pasan por la misma aprobación que cualquier otra. El código que una herramienta de IA escribe para la empresa es código de la empresa, y el solicitante y el aprobador responden de él. La lista de licencias no permitidas de la sección 8 es donde esto se convierte en una comprobación.

6. Seguridad

La sección 6 limita lo que pueden hacer los agentes de programación. Trabajan en ramas y nunca hacen push a main, nunca tienen credenciales de producción, no pueden desplegar en producción y necesitan la aprobación de un code owner para cambiar las rutas que importan. La sección 11 cubre los incidentes: una sospecha de fuga de datos a una herramienta se comunica el mismo día, y un incidente causado por un cambio asistido por IA tiene un postmortem sin culpables.

La sección 6.3 enumera las rutas que los agentes no pueden cambiar sin la aprobación de sus responsables. El archivo CODEOWNERS correspondiente es así:

# Policy 6.3: paths a coding agent must not change alone.
*                        @your-org/maintainers
/.github/workflows/      @your-org/platform
/infra/                  @your-org/platform
/src/auth/               @your-org/security
/migrations/             @your-org/data
package.json             @your-org/platform
/.github/CODEOWNERS      @your-org/maintainers

El orden importa: la documentación de code owners de GitHub dice que «el último patrón que coincide tiene la mayor precedencia» (comprobado el 24 de octubre de 2026), así que la regla general va primero. La última línea protege el propio archivo, para que un pull request no pueda quitar a sus propios revisores. El CODEOWNERS inicial tiene una versión más larga y comentada.

En AI CodeOps, los mismos límites son una política del espacio de trabajo: reglas que permiten una acción, la retienen hasta la aprobación de una persona o la deniegan. Las secciones 6.3 y 6.4 quedan así:

[
  { "id": "policy-6-3-ci", "action": "diff.apply", "resource": ".github/workflows/**", "decision": "ask" },
  { "id": "policy-6-3-infra", "action": "diff.apply", "resource": "infra/**", "decision": "ask" },
  { "id": "policy-6-3-migrations", "action": "diff.apply", "resource": "migrations/**", "decision": "ask" },
  { "id": "policy-6-4-no-prod", "action": "release.deploy", "resource": "production", "decision": "deny" }
]

Gana la regla coincidente más estricta, así que añadir una regla nunca puede relajar otra. La referencia de reglas de política enumera cada acción y lo que abarca. Empieza en modo log-only: cada decisión se registra pero nada se bloquea, así que ves lo que las reglas habrían detenido antes de aplicarlas.

7. Auditoría

La sección 10 te pide conservar, para cada cambio, la tarea, la herramienta, el solicitante y el aprobador, los hallazgos, los resultados de las pruebas y el despliegue. La mayoría de los equipos tienen todo eso repartido en cinco sistemas. En AI CodeOps está en el registro de auditoría y, por cada cambio, en un paquete de evidencias firmado que cualquiera puede verificar sin cuenta. La página de auditoría y acceso cubre las dos cosas, y la página para equipos regulados explica cómo encajan para los equipos de sectores regulados.

8. Excepciones

La sección 13 dice que una excepción se solicita por escrito, con el motivo, el riesgo y una fecha de fin (la plantilla propone 90 días como máximo), y que se registra y se revisa cuando termina. «Do not allow bypassing the above settings», en la protección de ramas, es lo que hace real esta sección: sin ese ajuste, la fusión de un administrador es una excepción que no queda registrada.

Lo que la plantilla deja fuera

No nombra herramientas: qué asistente o agente es el adecuado depende de tu stack, tus contratos y tus datos. No fija una cifra de cobertura ni un umbral de gravedad, porque un mínimo que encaja en un servicio de pagos no sirve para un prototipo. No pretende ser un marco completo de gobernanza de la IA; el riesgo de los modelos y la IA dentro de tu producto son cuestiones aparte, con sus propios responsables. Y no es asesoramiento jurídico. Los contratos, la normativa y la propiedad intelectual corresponden a tu equipo jurídico, que debería leer tu versión antes de que entre en vigor.

Cómo implantarla

Una política que llega por sorpresa se ignora. Este orden funciona mejor:

  1. Rellena primero la tabla de herramientas. Enumera lo que la gente ya usa y aprueba lo que puedas. Partir de la realidad hace creíble todo lo demás.
  2. Comparte el borrador con los ingenieros que más usan las herramientas. Saben qué reglas bloquearían trabajo real y cuáles seguirían de buen grado.
  3. Activa los ajustes en modo log-only o de solo aviso donde puedas. Mira lo que se habría bloqueado. Corrige las reglas que estén mal.
  4. Publica la política y aplica los ajustes el mismo día. El documento explica el porqué; los ajustes lo hacen realidad.
  5. Pon la fecha de revisión en el calendario. La plantilla dice cada seis meses, y siempre que adoptes un tipo nuevo de herramienta.

Los revisores también tendrán que saber qué buscar una vez que la política diga que cada cambio pasa por una revisión humana. La checklist de revisión de código con IA reúne 25 comprobaciones para el código escrito por agentes, y la guía de controles de calidad explica el lado de los controles.

Descarga la plantilla

La plantilla de política de programación con IA es gratuita y tiene licencia CC BY 4.0: cópiala, cámbiala y úsala. Descárgala en .docx o .md desde la página. Haz que tu equipo de seguridad lea tu versión, además del jurídico. Es una plantilla de partida, no asesoramiento jurídico.

Puntos clave

  • Una política de programación con IA solo funciona si cada regla se convierte en un ajuste: protección de ramas, code owners, controles en CI y permisos de los agentes.
  • Aprueba las herramientas con una lista de permitidas, no con prohibiciones, para que una herramienta nueva empiece fuera de la política.
  • La persona que escribió la tarea es la autora del cambio, y no puede ser su única aprobadora.
  • Un control que no pudo ejecutarse es un fallo, y una aprobación vale para una versión.
  • Da a cada regla un responsable y una fecha de revisión, y empieza los ajustes en modo log-only antes de aplicarlos.

Preguntas frecuentes

¿Qué debe incluir una política de programación con IA?

Como mínimo, las herramientas aprobadas, las reglas sobre datos y secretos, los requisitos de revisión, los controles de calidad, las licencias, los límites de seguridad para los agentes de programación, los registros de auditoría y un proceso de excepciones. La plantilla cubre todo eso, además del alcance, los roles, los incidentes y la formación.

¿Una política de programación con IA debería prohibir herramientas?

Una lista de herramientas aprobadas funciona mejor que una lista de prohibidas. Lo que no está en la lista no se permite con código de la empresa hasta que alguien lo aprueba, así que una herramienta nueva empieza fuera de la política en lugar de colarse.

¿Esta plantilla de política de programación con IA es asesoramiento jurídico?

No. Es una plantilla de partida, no asesoramiento jurídico. Haz que tus equipos jurídico y de seguridad lean tu versión antes de que entre en vigor.