AI coding agent'lar için proje talimatları, proje profili, iOS/Android yayın checklist'leri ve release status şablonu

README.md

AI Coding Agent Project Template

AI coding agent'lar için proje talimatlarını, ürün kararlarını, yayın kontrol listesini ve mevcut durumu birbirinden ayıran sade bir şablon.

Önerilen proje yapısı

proje/
├── AGENTS.md
└── docs/
    ├── PROJECT_PROFILE.md
    ├── IOS_SHIP_CHECKLIST.md
    ├── ANDROID_SHIP_CHECKLIST.md
    └── RELEASE_STATUS.md

Kullanım

1. AGENTS.md dosyasını projenin kök dizinine kopyalayın.
2. Projede docs/ klasörü oluşturun.
3. Diğer dört Markdown dosyasını docs/ klasörüne kopyalayın.
4. Köşeli parantezli alanları projenize göre doldurun.
5. Yalnızca hedeflediğiniz platformların checklist'lerini kullanın.
6. Kullanmadığınız özellikleri checklist'te [-] ile uygulanamaz olarak işaretleyin.

Amaç, kullandığınız coding agent değişse bile proje bilgisini repoda tek ve güncel bir kaynak olarak tutmaktır.

AGENTS.md

Agent Instructions

Başlamadan önce

• Kod veya yapılandırma değişikliği yapmadan önce aşağıdaki dosyaları okuyun:
  • docs/PROJECT_PROFILE.md
  • Hedef iOS ise docs/IOS_SHIP_CHECKLIST.md
  • Hedef Android ise docs/ANDROID_SHIP_CHECKLIST.md
  • docs/RELEASE_STATUS.md
• Yalnızca PROJECT_PROFILE.md içinde bu proje için etkinleştirilen özellikleri uygulayın.
• Eksik veya çelişkili bir ürün kararı varsa varsayımınızı açıkça belirtin.

Çalışma kuralları

• Mevcut mimariyi ve proje kalıplarını koruyun.
• Gereksiz bağımlılık veya servis eklemeyin.
• Analitik, reklam, kimlik doğrulama, veritabanı ve abonelik özelliklerini açık bir proje kararı olmadan kurmayın.
• Secret, API anahtarı veya üretim kimlik bilgisini kaynak koduna ya da Git geçmişine yazmayın.
• Kullanıcıya ait mevcut ve ilgisiz değişiklikleri koruyun.
• Büyük veya geri döndürülmesi zor işlemlerden önce hedefi ve kapsamı doğrulayın.

Doğrulama

• Değişikliklerden sonra ilgili typecheck, lint ve test komutlarını çalıştırın.
• Native özellikleri gerektiğinde fiziksel cihazda veya development build üzerinde doğrulayın.
• Bir checklist maddesini yalnızca kod yazıldığı için tamamlanmış saymayın; davranışı doğrulayın.
• Tamamlanan işlerin kanıtını ve bloke olan maddeleri docs/RELEASE_STATUS.md içinde güncelleyin.

Teslim

• Ne değiştiğini kısa şekilde özetleyin.
• Çalıştırılan doğrulamaları ve sonuçlarını belirtin.
• Çalıştırılamayan kontrolleri ve kalan riskleri açıkça yazın.

ANDROID_SHIP_CHECKLIST.md

Android Ship Checklist

Google Play gereksinimleri zamanla değişir. Her yayın öncesinde Play Console uyarılarını ve güncel Google Play politikalarını ayrıca kontrol edin.

Durum işaretleri

• [ ] Başlanmadı
• [x] Doğrulandı
• [-] Bu proje için uygulanamaz
• [!] Bloke

1. Teknik kurulum

• Repository oluşturuldu ve branch stratejisi belirlendi
• Development build fiziksel Android cihazda çalışıyor
• Application ID ve build variant'lar belirlendi
• minSdk, compileSdk ve targetSdk değerleri doğrulandı
• Ortam değişkenleri ve secret yönetimi yapılandırıldı
• Bağımlılıklar ve native modüller belgelendi
• Release signing güvenli şekilde yapılandırıldı
• Google Play App Signing kararı tamamlandı
• Hata izleme test hatasıyla doğrulandı
• Analitik event planı belirlendi ve test edildi
• OTA update politikası belirlendi

2. Uygulama temeli

• Navigation ve sistem geri hareketi test edildi
• Edge-to-edge yerleşim ve sistem çubukları test edildi
• Klavye ve farklı ekran boyutları test edildi
• Loading, empty, error ve offline durumları tasarlandı
• Localization altyapısı kuruldu
• Erişilebilirlik etiketleri ve büyük yazı boyutları test edildi
• Light ve dark theme davranışı doğrulandı

3. Google Play yapılandırması

• Play Console uygulama kaydı oluşturuldu
• Developer hesabı ve iletişim bilgileri doğrulandı
• Package name ve uygulama kategorisi doğrulandı
• Güncel Google Play target API gereksinimi karşılandı
• Android App Bundle (.aab) release olarak oluşturuldu
• Play App Signing ve upload key yapılandırıldı
• Internal testing track'e ilk build yüklendi
• Pre-launch report sonuçları incelendi

4. Gizlilik ve politika

• Privacy Policy yayınlandı ve Play Console'a eklendi
• Data safety formu, üçüncü taraf SDK'lar dahil doğru şekilde dolduruldu
• İstenen permission'ların gerçekten gerekli olduğu doğrulandı
• Runtime permission reddetme senaryoları test edildi
• Reklam kullanılıyorsa Ads beyanı tamamlandı
• Content rating anketi tamamlandı
• Target audience ve çocuklara yönelik içerik kararları tamamlandı
• Uygulama erişimi kısıtlıysa inceleme talimatları ve demo hesabı eklendi
• Hesap oluşturulabiliyorsa uygulama içi hesap silme akışı tamamlandı
• Hesap oluşturulabiliyorsa web üzerinden silme talebi bağlantısı eklendi

5. Satın alma — uygulanıyorsa

• Ürünler ve abonelikler Play Console'da oluşturuldu
• Base plan ve offer yapılandırmaları tamamlandı
• Google Play Billing entegrasyonu güncel ve doğrulandı
• License tester hesapları eklendi
• Test satın alma akışı tamamlandı
• Restore ve entitlement yenileme davranışı test edildi
• Pending, cancelled, expired ve refunded durumları test edildi
• Satın alma doğrulama ve acknowledgement akışı tamamlandı

6. Store listing

• Uygulama adı, kısa açıklama ve tam açıklama tamamlandı
• App icon, feature graphic ve ekran görüntüleri hazırlandı
• Telefon ekran görüntüleri eklendi
• Destekleniyorsa tablet ekran görüntüleri eklendi
• Localizations tamamlandı
• Support e-postası ve varsa web sitesi eklendi
• Ülke, bölge, fiyatlandırma ve dağıtım ayarları kontrol edildi

7. Release doğrulaması

• Temiz kurulum test edildi
• Önceki sürümden güncelleme test edildi
• Sign in ve sign out test edildi
• Satın alma ve entitlement geri yükleme test edildi
• Push notification test edildi
• App link ve deep link akışları test edildi
• Offline ve zayıf bağlantı davranışı test edildi
• Farklı ekran boyutları ve yoğunlukları test edildi
• Desteklenen minimum ve güncel Android sürümleri test edildi
• Düşük bellek ve uygulamanın süreçten kaldırılması senaryoları test edildi
• Release build crash olmadan açılıyor
• Internal veya closed testing geri bildirimleri incelendi
• Version code ve version name doğrulandı
• Staged rollout ve rollback planı belirlendi

IOS_SHIP_CHECKLIST.md

iOS Ship Checklist

Durum işaretleri

• [ ] Başlanmadı
• [x] Doğrulandı
• [-] Bu proje için uygulanamaz
• [!] Bloke

1. Teknik kurulum

• Repository oluşturuldu ve branch stratejisi belirlendi
• Development build fiziksel cihazda çalışıyor
• Ortam değişkenleri ve secret yönetimi yapılandırıldı
• Bağımlılıklar ve native modüller belgelendi
• Hata izleme test hatasıyla doğrulandı
• Analitik event planı belirlendi ve test edildi
• OTA update politikası belirlendi

2. Uygulama temeli

• Navigation tamamlandı
• Safe area ve klavye davranışı test edildi
• Loading, empty, error ve offline durumları tasarlandı
• Localization altyapısı kuruldu
• Erişilebilirlik etiketleri ve Dynamic Type test edildi
• Dark mode davranışı doğrulandı

3. Apple yapılandırması

• Bundle Identifier oluşturuldu
• App Store Connect kaydı oluşturuldu
• Signing ve capabilities yapılandırıldı
• Privacy manifest ve kullanılan API'ler incelendi
• App Privacy cevapları hazırlandı
• Hesap varsa uygulama içinden hesap silme akışı tamamlandı

4. Onboarding ve izinler

• Launch screen doğrulandı
• Onboarding adımları tamamlandı
• İzinler ihtiyaç anında ve açıklayıcı bağlamla isteniyor
• Notification izin akışı test edildi
• Rating isteği uygun zamanda gösteriliyor
• Sign up ve sign in akışları test edildi

5. Satın alma — uygulanıyorsa

• Ürünler App Store Connect'te oluşturuldu
• Entitlement, offering ve package yapılandırıldı
• Satın alma akışı sandbox ortamında test edildi
• Restore Purchases test edildi
• Süresi dolmuş ve iptal edilmiş abonelik durumları test edildi
• Subscription guard doğrulandı
• Satın alma ekranında gerekli yasal bağlantılar bulunuyor

6. App Store içeriği

• Uygulama adı, subtitle ve keywords tamamlandı
• Açıklama ve promo text tamamlandı
• Gerekli cihaz boyutları için ekran görüntüleri hazırlandı
• App icon doğrulandı
• Privacy Policy ve Support URL eklendi
• Localizations tamamlandı
• Age rating ve diğer App Store alt sayfaları tamamlandı
• Review notes ve gerekiyorsa demo hesabı hazırlandı

7. Release doğrulaması

• Temiz kurulum test edildi
• Önceki sürümden güncelleme test edildi
• Sign in ve sign out test edildi
• Satın alma ve restore işlemleri test edildi
• Push notification test edildi
• Deep link ve universal link akışları test edildi
• Offline ve zayıf bağlantı davranışı test edildi
• Desteklenen iPhone boyutları test edildi
• Destekleniyorsa iPad test edildi
• Release build crash olmadan açılıyor
• TestFlight geri bildirimi incelendi
• Gönderilecek sürüm ve build numarası doğrulandı

PROJECT_PROFILE.md

Project Profile

Bu dosya, projenin ürün ve teknik kararları için tek doğruluk kaynağıdır.

Temel bilgiler

• Proje adı: [PROJE_ADI]
• Ürün özeti: [TEK_CÜMLELİK_ÖZET]
• Framework: [EXPO / REACT_NATIVE / SWIFT]
• Hedef platformlar: [IPHONE / IPAD / ANDROID_PHONE / ANDROID_TABLET]
• Minimum iOS sürümü: [SÜRÜM]
• Minimum Android sürümü: [API_LEVEL VEYA SÜRÜM]
• Android target SDK: [GÜNCEL_PLAY_GEREKSİNİMİNE_GÖRE]
• iOS Bundle Identifier: [IDENTIFIER]
• Android Application ID: [IDENTIFIER]
• Paket yöneticisi: [PNPM / NPM / YARN / BUN]

Özellikler

Her satırı Evet, Hayır veya Kararlaştırılmadı olarak doldurun.

• Kullanıcı hesabı: Kararlaştırılmadı
• Cloud veritabanı: Kararlaştırılmadı
• Cihazlar arası senkronizasyon: Kararlaştırılmadı
• Abonelik veya uygulama içi satın alma: Kararlaştırılmadı
• Push notification: Kararlaştırılmadı
• Reklam veya attribution: Kararlaştırılmadı
• Widget: Kararlaştırılmadı
• OTA update: Kararlaştırılmadı
• iPad desteği: Kararlaştırılmadı

Servisler

• Hata izleme: [YOK / SENTRY / DİĞER]
• Ürün analitiği: [YOK / MIXPANEL / POSTHOG / DİĞER]
• Backend: [YOK / SUPABASE / ÖZEL_BACKEND / DİĞER]
• Authentication: [YOK / APPLE / GOOGLE / EMAIL / DİĞER]
• Satın alma: [YOK / REVENUECAT / SUPERWALL / STOREKIT]
• Attribution: [YOK / APPSFLYER / DİĞER]

Gizlilik ve veri

• Toplanan kullanıcı verileri: [LİSTE]
• Verilerin saklandığı yer: [CİHAZ / SUNUCU / İKİSİ]
• Hesap silme yöntemi: [UYGULANAMAZ / AÇIKLAMA]
• Privacy Policy adresi: [URL]
• Support adresi: [URL VEYA E-POSTA]

Ürün kararları

• Onboarding sırası: [AÇIKLAMA]
• Paywall konumu: [AÇIKLAMA]
• Hesap oluşturma zamanı: [AÇIKLAMA]
• Desteklenen diller: [LİSTE]
• Offline davranışı: [AÇIKLAMA]

Doğrulama komutları

[TYPECHECK_KOMUTU]
[LINT_KOMUTU]
[TEST_KOMUTU]

RELEASE_STATUS.md

Release Status

• Mevcut milestone: [MILESTONE]
• Hedef sürüm: [SÜRÜM]
• Son güncelleme: [YYYY-AA-GG]
• Sorumlu: [İSİM_VEYA_EKİP]

Genel durum

[Planlama / Geliştirme / TestFlight / App Store Review / Yayında]

Doğrulanan işler

[İŞ_ADI]

• Doğrulayan: [İSİM]
• Tarih: [YYYY-AA-GG]
• Ortam ve cihaz: [ÖRNEK: TESTFLIGHT, IPHONE 15 PRO]
• Sonuç: [SONUÇ]
• Kanıt: [TEST ÇIKTISI, EKRAN GÖRÜNTÜSÜ VEYA EVENT BAĞLANTISI]

Devam eden işler

• [İŞ] — Sorumlu: [İSİM]

Bloke olan işler

[İŞ_ADI]

• Engel: [AÇIKLAMA]
• Gereken aksiyon: [AÇIKLAMA]
• Sorumlu: [İSİM]

Bilinen riskler

• [RİSK VE ETKİSİ]

Sıradaki işler

1. [SONRAKİ İŞ]
2. [SONRAKİ İŞ]
3. [SONRAKİ İŞ]

Release kararı

• Karar: [HAZIR / HAZIR DEĞİL]
• Karar tarihi: [YYYY-AA-GG]
• Not: [AÇIKLAMA]