- Inicio
- Plantillas
- CODEOWNERS inicial para repositorios con agentes de programación con IA
CODEOWNERS inicial para repositorios con agentes de programación con IA
Última actualización
Un CODEOWNERS inicial comentado que pone responsables en las rutas que los agentes no deberían cambiar solos: CI, infraestructura, autenticación, migraciones, dependencias.
Sustituye los equipos
@your-org/...por equipos o usuarios reales con acceso de escritura al repositorio. Borra las rutas que no tengas, y esta nota.
Un archivo CODEOWNERS indica quién tiene que revisar los cambios en qué rutas. Con agentes de programación que abren pull requests, es la forma más sencilla de asegurarte de que los archivos que más daño pueden hacer siempre reciben la revisión de alguien que los conoce. Este archivo inicial usa la sintaxis de GitHub, que GitLab también lee.
# CODEOWNERS starter: owners for the paths an AI agent should not change alone.
# Order matters: for each file, the LAST matching line decides its owners.
# Keep the catch-all first and the most specific paths last.
# Everything: the team that owns the repository.
* @your-org/maintainers
# Pipelines and automation. A changed workflow can leak secrets or skip checks.
/.github/workflows/ @your-org/platform
/.gitlab-ci.yml @your-org/platform
/.forgejo/workflows/ @your-org/platform
# Infrastructure as code and deployment.
/infra/ @your-org/platform
/deploy/ @your-org/platform
*.tf @your-org/platform
/Dockerfile @your-org/platform
# Authentication, sessions and permissions.
/src/auth/ @your-org/security
/src/**/permissions* @your-org/security
# Database schema and migrations. An applied migration should never be edited.
/migrations/ @your-org/data
/src/**/schema/ @your-org/data
# Dependencies and lockfiles. New packages are supply-chain decisions.
package.json @your-org/platform
bun.lock @your-org/platform
package-lock.json @your-org/platform
pnpm-lock.yaml @your-org/platform
requirements*.txt @your-org/platform
pyproject.toml @your-org/platform
go.mod @your-org/platform
Cargo.toml @your-org/platform
# Agent configuration: prompts, rules and tool settings that steer coding agents.
/AGENTS.md @your-org/maintainers
/CLAUDE.md @your-org/maintainers
/.cursor/ @your-org/maintainers
# This file. Without an owner, anyone could remove the rules above.
/.github/CODEOWNERS @your-org/maintainers
Cómo adoptarlo
- Parte de rutas reales. Enumera los directorios donde un cambio equivocado costaría más: pipelines, infraestructura, autenticación, migraciones, manifiestos de dependencias. Borra las líneas del archivo inicial para las rutas que no tengas.
- Usa equipos, no personas. Un equipo sobrevive a las vacaciones y a las bajas. En GitHub, los responsables tienen que tener acceso de escritura al repositorio, y un equipo tiene que ser visible.
- Haz que se cumpla. El archivo solo solicita revisiones hasta que exiges la aprobación de los code owners en la rama protegida. En GitHub, la aprobación de cualquiera de los responsables listados cumple la regla.
- Pon un responsable al propio archivo. La última línea impide que un pull request, de una persona o de un agente, quite discretamente a sus propios revisores.
- Comprueba que se interpreta bien. En GitHub, las líneas no válidas se omiten, y un usuario o equipo sin el acceso adecuado no se asigna. Abre un pull request de prueba que toque cada ruta protegida y comprueba que se pidió revisión a los responsables correctos.
Sintaxis que conviene evitar
El CODEOWNERS de GitHub sigue la mayoría de las reglas de .gitignore, con excepciones que confunden a la gente:
!para negar un patrón no funciona.- Los rangos de caracteres
[ ]no funcionan. - Escapar con
\un patrón que empieza por#no funciona. - Las rutas distinguen mayúsculas de minúsculas.
Los code owners de GitLab necesitan el nivel Premium o Ultimate. GitLab añade secciones, como [Database][2] @your-org/data, donde el número es cuántas aprobaciones necesita la sección. Dentro de cada sección gana la última línea que coincide. Consulta la documentación de code owners de GitHub y la documentación de code owners de GitLab para ver las reglas completas.
Preguntas frecuentes
¿Dónde va el archivo CODEOWNERS?
En GitHub, en .github/, en la raíz del repositorio o en docs/, y GitHub usa el primero que encuentra en ese orden. En GitLab, en la raíz, en docs/ o en .gitlab/, comprobados en ese orden.
¿Un archivo CODEOWNERS bloquea las fusiones por sí solo?
No. Solo solicita revisiones. Para exigir la aprobación de un responsable, activa «Require review from Code Owners» en una regla de protección de ramas o un ruleset de GitHub, o «Require approval from code owners» en una rama protegida de GitLab.
¿Por qué importa el orden de las líneas?
Para un archivo dado, en GitHub gana el último patrón que coincide, y en GitLab gana la última coincidencia dentro de cada sección. Pon primero la línea que lo cubre todo y al final las rutas más específicas.
Cómo citar
AI CodeOps (2026). CODEOWNERS inicial para repositorios con agentes de programación con IA. https://aicodeops.dev/templates/codeowners-starter
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.
Relacionado
- ¿Qué son los controles de calidad?
- Referencia de las reglas de política
- Revisión de código con IA que bloquea las malas fusiones
- Plantilla de política de programación con IA para equipos de ingeniería
- Cambio de autenticación: análisis de riesgos antes del código, auditoría después
- Especificación de funcionalidad: requisitos y un plan de entrega por fases
- Todas las plantillas