AI CodeOps

Yapay zekâ kodlama ajanlarıyla çalışan repolar için CODEOWNERS başlangıç dosyası

Son güncelleme

Kodlama ajanlarının tek başına değiştirmemesi gereken yollara adı belirli sahipler atayan, yorumlu bir CODEOWNERS başlangıç dosyası: CI, altyapı, kimlik doğrulama, migration'lar, bağımlılıklar.

@your-org/... ekiplerini, repoya yazma erişimi olan gerçek ekipler veya kullanıcılarla değiştirin. Sizde olmayan yolları ve bu notu silin.

Bir CODEOWNERS dosyası, hangi yollardaki değişiklikleri kimin incelemesi gerektiğini belirtir. Pull request'leri kodlama ajanları açarken bu, en çok zarar verebilecek dosyaların her zaman onları bilen birinden inceleme almasını sağlamanın en basit yoludur. Bu başlangıç dosyası, GitLab'in de okuduğu GitHub söz dizimini kullanır.

# 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

Nasıl kullanmaya başlanır

  1. Gerçek yollardan başlayın. Yanlış bir değişikliğin en pahalıya mal olacağı dizinleri listeleyin: pipeline'lar, altyapı, kimlik doğrulama, migration'lar, bağımlılık manifest'leri. Başlangıç dosyasında sizde olmayan yollara ait satırları silin.
  2. Kişileri değil, ekipleri kullanın. Bir ekip tatillerden ve işten ayrılanlardan etkilenmez. GitHub'da sahiplerin repoya yazma erişimi olmalıdır ve ekip görünür (visible) olmalıdır.
  3. Zorunlu kılmayı açın. Korumalı branch'te kod sahibi onayını zorunlu kılana kadar dosya yalnızca inceleme ister. GitHub'da listelenen sahiplerden herhangi birinin onayı kuralı karşılar.
  4. Dosyanın kendisine de sahip atayın. Son satır, ister bir kişiden ister bir ajandan gelsin, bir pull request'in kendi inceleyicilerini sessizce kaldırmasını engeller.
  5. Dosyanın doğru ayrıştırıldığını kontrol edin. GitHub'da geçersiz satırlar atlanır ve doğru erişime sahip olmayan bir kullanıcı veya ekip atanmaz. Korumalı her yola dokunan bir deneme pull request'i açın ve doğru sahiplerden inceleme istendiğini kontrol edin.

Kaçınılması gereken söz dizimi

GitHub CODEOWNERS, .gitignore kurallarının çoğuna uyar; ancak insanların takıldığı istisnalar vardır:

  • Bir deseni olumsuzlamak için ! kullanmak işe yaramaz.
  • [ ] karakter aralıkları işe yaramaz.
  • # ile başlayan bir deseni \ ile kaçış karakteri ekleyerek yazmak işe yaramaz.
  • Yollar büyük/küçük harfe duyarlıdır.

GitLab'de kod sahipleri özelliği Premium veya Ultimate kademesini gerektirir. GitLab, [Database][2] @your-org/data gibi bölümler ekler; buradaki sayı, bölümün kaç onaya ihtiyaç duyduğunu belirtir. Her bölüm içinde eşleşen son satır geçerli olur. Kuralların tamamı için GitHub kod sahipleri dokümantasyonuna ve GitLab kod sahipleri dokümantasyonuna bakın.

Sık sorulan sorular

CODEOWNERS dosyası nereye konur?

GitHub'da .github/ içine, repo köküne veya docs/ içine; GitHub bu sırayla bulduğu ilk dosyayı kullanır. GitLab'de köke, docs/ veya .gitlab/ içine; dosyalar bu sırayla kontrol edilir.

Bir CODEOWNERS dosyası merge'leri tek başına engeller mi?

Hayır. Yalnızca inceleme ister. Bir sahibin onayını zorunlu kılmak için GitHub'da bir branch koruma kuralında veya ruleset'te "Require review from Code Owners" seçeneğini, GitLab'de ise korumalı bir branch'te "Require approval from code owners" seçeneğini açın.

Satırların sırası neden önemlidir?

Belirli bir dosya için GitHub'da eşleşen son desen, GitLab'de ise her bölüm içinde eşleşen son satır geçerli olur. Her şeyi kapsayan satırı başa, en belirli yolları sona koyun.

Atıf yapın

AI CodeOps (2026). Yapay zekâ kodlama ajanlarıyla çalışan repolar için CODEOWNERS başlangıç dosyası. https://aicodeops.dev/templates/codeowners-starter

Bu sayfa ve indirilebilir dosyaları CC BY 4.0 lisansıyla sunulur: ekibiniz için kopyalayıp uyarlayın ve kendi sürümünüzü yayımladığınızda bu sayfaya bağlantı verin.