CODEOWNERS de départ pour les dépôts avec des agents de codage IA
Mis à jour le
Un fichier CODEOWNERS commenté qui désigne des propriétaires pour les chemins que les agents de codage ne devraient pas modifier seuls : CI, infrastructure, auth, migrations, dépendances.
Remplacez les équipes
@your-org/...par de vraies équipes ou de vrais utilisateurs qui ont un accès en écriture au dépôt. Supprimez les chemins que vous n'avez pas, ainsi que cette note.
Un fichier CODEOWNERS désigne qui doit relire les changements apportés à quels chemins. Lorsque des agents de codage ouvrent des pull requests, c'est le moyen le plus simple de s'assurer que les fichiers capables de faire le plus de dégâts sont toujours relus par quelqu'un qui les connaît. Ce fichier de départ utilise la syntaxe de GitHub, que GitLab lit également.
# 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
Comment l'adopter
- Partez de chemins réels. Listez les répertoires où un mauvais changement coûterait le plus cher : pipelines, infrastructure, authentification, migrations, manifestes de dépendances. Supprimez les lignes du fichier de départ qui concernent des chemins que vous n'avez pas.
- Utilisez des équipes, pas des personnes. Une équipe survit aux congés et aux départs. Sur GitHub, les propriétaires doivent avoir un accès en écriture au dépôt, et une équipe doit être visible.
- Activez l'application de la règle. Le fichier ne fait que demander des revues tant que vous n'exigez pas l'approbation des propriétaires de code sur la branche protégée. Sur GitHub, l'approbation d'un seul des propriétaires listés suffit à satisfaire la règle.
- Donnez un propriétaire au fichier lui-même. La dernière ligne empêche une pull request, qu'elle vienne d'une personne ou d'un agent, de retirer discrètement ses propres relecteurs.
- Vérifiez qu'il est bien analysé. Sur GitHub, les lignes invalides sont ignorées, et un utilisateur ou une équipe sans les droits d'accès nécessaires n'est pas désigné. Ouvrez une pull request de test qui touche chaque chemin protégé et vérifiez que les bons propriétaires ont été sollicités.
Syntaxe à éviter
Le CODEOWNERS de GitHub suit la plupart des règles de .gitignore, avec des exceptions qui piègent souvent :
!pour inverser un motif ne fonctionne pas.- Les plages de caractères
[ ]ne fonctionnent pas. - Échapper avec
\un motif qui commence par#ne fonctionne pas. - Les chemins sont sensibles à la casse.
Les propriétaires de code de GitLab nécessitent l'offre Premium ou Ultimate. GitLab ajoute des sections, comme [Database][2] @your-org/data, où le nombre indique combien d'approbations la section exige. Dans chaque section, c'est la dernière ligne correspondante qui l'emporte. Consultez la documentation de GitHub sur les propriétaires de code et la documentation de GitLab sur les propriétaires de code pour l'ensemble des règles.
Questions fréquentes
Où placer le fichier CODEOWNERS ?
Sur GitHub, dans .github/, à la racine du dépôt ou dans docs/, et GitHub utilise le premier qu'il trouve dans cet ordre. Sur GitLab, à la racine, dans docs/ ou dans .gitlab/, vérifiés dans cet ordre.
Un fichier CODEOWNERS bloque-t-il les fusions à lui seul ?
Non. Il ne fait que demander des revues. Pour exiger l'approbation d'un propriétaire, activez « Require review from Code Owners » dans une règle de protection de branche ou un ruleset GitHub, ou « Require approval from code owners » sur une branche protégée dans GitLab.
Pourquoi l'ordre des lignes compte-t-il ?
Pour un fichier donné, c'est le dernier motif correspondant qui l'emporte sur GitHub, et la dernière correspondance dans chaque section qui l'emporte sur GitLab. Placez la ligne générale en premier et les chemins les plus précis en dernier.
Citer cette page
AI CodeOps (2026). CODEOWNERS de départ pour les dépôts avec des agents de codage IA. https://aicodeops.dev/templates/codeowners-starter
Cette page et ses téléchargements sont sous licence CC BY 4.0 : copiez-les et adaptez-les pour votre équipe, et faites un lien vers cette page lorsque vous publiez votre version.
Voir aussi
- Qu'est-ce qu'une barrière qualité ?
- Référence des règles de politique
- Une revue de code par IA qui bloque les mauvaises fusions
- Template de politique de codage par IA pour les équipes d'ingénierie
- Changement d'authentification : analyse de risques avant, audit après
- Spécifier une fonctionnalité : exigences et livraison par phases
- Tous les templates