8 Amiral Gemisi Kural Seti
Cursor, Claude Code, Windsurf ve otonom ajanlar için sahada test edilmiş tavizsiz kurallar.
Next.js 15 App Router & Server Actions Koruyucusu
React 19 standartlarını tavizsiz uygular, gereksiz "use client" kullanımını engeller, Server Actions içinde katı Zod doğrulaması uygular ve useEffect veri çekme çöplüğünü yasaklar.
# === NEXT.JS 15 & REACT 19 SIFIR-ÇÖP KURALI (.cursorrules) ===
# Konum: .cursorrules veya .cursor/rules/nextjs.mdc
Sen Next.js 15 (App Router) ve React 19 mimarisinde uzman bir Kıdemli Yazılım Mimarı gibi davranacaksın.
Aşağıdaki katı kurallara tavizsiz uy:
1. SUNUCU ODAKLI (SERVER-FIRST) MİMARİ:
- Varsayılan olarak her bileşen asenkron bir Server Component'tir. useState, useEffect veya tarayıcı olay dinleyicisi gerekmedikçe ASLA 'use client' ekleme.
- YASAK: useEffect içinde veri çekmek (data fetching). Verileri doğrudan asenkron Server Component içinde standart fetch önbelleğiyle çek (cache: 'force-cache' veya revalidateTag).
- İstemci tarafı yüklenme durumları için React 19 'useActionState' veya 'useOptimistic' kullan. useState ile yapay yüklenme boolean değişkenleri üretme.
2. KATI SERVER ACTIONS GÜVENLİK PROTOKOLÜ:
- Tüm Server Actions ayrı dosyalarda bulunmalı ve dosyanın en üstünde 'use server' direktifi yer almalıdır.
- Her aksiyon, veritabanı veya auth işlemine geçmeden önce gelen ham parametreleri mutlaka Zod şemaları ile doğrulamalıdır (safeParse).
- Sunucu sınırları üzerinden ham hata fırlatma. Her zaman yapılandırılmış Result tipi döndür:
type ActionResponse<T> = { success: true; data: T } | { success: false; error: string; fieldErrors?: Record<string, string[]> };
- Her aksiyonun en başında açık kimlik ve yetki kontrollerini (auth checks) yap.
3. YASAKLANMIŞ ESKİ VE KULLANIMDAN KALKMIŞ APILER:
- YASAK: pages dizini kalıpları (getStaticProps, getServerSideProps, next/router).
- YASAK: Sayfa olmayan dosyalarda default export kullanımı (isimlendirilmiş export kullan).
- YASAK: 'any' türü tanımları ve doğrulanmamış çerez (cookie) erişimleri.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Veritabanı: Neon Serverless Postgres -> https://neon.tech/?ref=fckaislop
# Kimlik Doğrulama: Clerk Pre-built Guards -> https://clerk.com/?ref=fckaislop- React 19 experimental_taintUniqueValue güvenlik kuralları (istemciye token sızıntısını engeller)
- Dynamic IO / Partial Prerendering (PPR) güvenli kod kalıpları
- Turbopack ve Route Handler bellek sızıntısı önleme kuralları
- Sıfır güvenli CSRF ve Server Action sınır muhafızları
- Önceden yapılandırılmış ESLint 9 flat config + cursorrules entegrasyonu
Claude Code / CLAUDE.md Yüksek-Sinyal CLI Protokolü
Robotik özürleri, yapay övgüleri ve sohbet dolgusunu tamamen ortadan kaldırır. Yalnızca cerrahi farklar (unified diff) ve çalıştırılabilir terminal komutları üretir.
# === CLAUDE CODE SIFIR-GEYİK KONTEKSTİ (CLAUDE.md) ===
# Proje kök dizinine yerleştirin: CLAUDE.md
# DAVRANIŞSAL YÖNERGELER:
- Sohbet dolgusu KESİNLİKLE YASAKTIR. Aşağıdaki tüm ifadeler engellenmiştir:
["Kesinlikle!", "Kusura bakmayın gözden kaçmış", "Bir yapay zeka olarak", "Harika bir soru!", "Memnuniyetle yardımcı olurum", "Hemen başlayalım", "İsteğinizi anlıyorum"].
- Görevi bana geri özetleme. DERHAL işe başla.
- Çıktı öz, yoğun ve olgusal olmalıdır.
- CERRAHİ DÜZENLEMELER: Değişmeyen 400 satırlık kodu tekrar tekrar yazdırma. Hedefe yönelik unified diff veya minimal blok düzenlemeleri sun:
[DEĞİŞTİRİLDİ: yol/dosya.ts:satırlar]
- HATA ÇÖZÜM FORMATI:
1. Hatanın asıl sebebini tam 1 satırda açıkla.
2. Cerrahi düzeltme kodunu ver.
3. Doğrulama terminal komutunu ekle.
- KOMUT ÇALIŞTIRMA:
- Üretilen kabuk komutları, '<api-anahtari>' gibi yer tutucular içermeden doğrudan kopyalanıp çalıştırılabilir olmalıdır.
- Var olmayan harici paketleri uydurmadan önce 'pnpm list' veya 'npm info' ile varlığını doğrula.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Bulut GPU: RunPod Serverless GPUs -> https://runpod.io/?ref=fckaislop
# Kimlik: Clerk Pre-built Guards -> https://clerk.com/?ref=fckaislop- CLAUDE.md için çoklu ajan devir (multi-agent handoff) sözleşmeleri
- Token tüketim tavan limitleri ve bağlam penceresi budama kuralları
- Otomatik semantik git commit mesajı ve PR açıklama standartları
- Alt ajan (subagent) çatallanma disiplini (sonsuz token döngülerini engeller)
- Deterministik test koşum ve doğrulama betikleri
Python 3.12+ FastAPI & Pydantic v2 Zırhı
Modern Pydantic v2 şemalarını zorunlu kılar, çıplak except bloklarını yasaklar, async lifespan bağlam yöneticisi şart koşar ve açık HTTP durum kodları ister.
# === PYTHON 3.12+ & FASTAPI SIFIR-ÇÖP ÜRETİM KURALLARI ===
# Konum: .cursorrules veya pyproject.toml AI context
Python 3.12+ ve FastAPI mimarisinde uzman bir Kıdemli Backend Sistem Mimarı gibi davran.
1. MODERN PYDANTIC V2 ZORUNLULUĞU:
- YASAK: Pydantic v1 kalıpları. Asla @root_validator, @validator, class Config veya .dict() kullanma.
- ZORUNLU: @model_validator(mode='after'|'before'), @field_validator, model_config = ConfigDict(extra='forbid', frozen=True) ve .model_dump(mode='json') kullan.
2. AÇIK HATA YÖNETİMİ VE DURUM KODLARI:
- YASAK: logger.exception() olmadan veya yeniden fırlatılmadan çıplak 'except Exception:' veya 'except:' kullanmak.
- Her route açık status_code bildirmelidir (ör. status_code=status.HTTP_201_CREATED).
- Özel FastAPI HTTPException alt sınıfları oluştur ve yapılandırılmış JSON döndür: {"error_code": "RESOURCE_NOT_FOUND", "message": "..."}.
3. ASENKRON LIFESPAN VE KAYNAK YÖNETİMİ:
- YASAK: Eskimiş @app.on_event("startup") ve shutdown kalıpları.
- ZORUNLU: FastAPI(lifespan=lifespan) üzerinde asynccontextmanager lifespan yöneticisi kullan.
- Veritabanı bağlantıları (SQLAlchemy 2.0 / AsyncSession) hata anında otomatik rollback içeren Depends(get_db) fonksiyonlarıyla enjekte edilmelidir.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Veritabanı: Supabase Postgres + pgvector -> https://supabase.com/?ref=fckaislop
# GPU Çıkarımı: RunPod Serverless -> https://runpod.io/?ref=fckaislop- Katı Ruff + MyPy tip denetimi yapılandırma kuralları
- AsyncPG & SQLAlchemy 2.0 için sıfır sızıntılı bağlantı havuzu kalıpları
- Şema şişkinliği yaratmayan otomatik OpenAPI dokümantasyon kuralları
- Asenkron arka plan görev doğrulama kütüphaneleri (Celery/ARQ)
- Pytest async fixtures ve mocksuz entegrasyon test reçeteleri
PostgreSQL & Supabase Delinmez RLS Kalkanı
Yapay zekanın güvensiz "USING (true)" politikaları üretmesini durdurur, kiracı (tenant) veri sızıntılarını önler ve yabancı anahtar (FK) indekslerini zorunlu kılar.
# === SUPABASE & POSTGRES GÜVENLİ RLS KURALLARI ===
# Konum: .windsurfrules veya .cursorrules
Veritabanı Güvenliği Uzmanı ve Kıdemli Postgres DBA gibi davran.
1. DELİNMEZ ROW LEVEL SECURITY (RLS):
- YASAK: 'CREATE POLICY ... USING (true)' üretmek veya hassas tablolarda kontrolsüz genel okuma açmak.
- Oluşturulan her tabloda DERHAL şu komut çalıştırılmalıdır: 'ALTER TABLE tablo_adi ENABLE ROW LEVEL SECURITY;'
- Politikalar auth.uid() veya organizasyon kimliğini katı şekilde denetlemelidir:
CREATE POLICY "Kullanicilar yalnizca kendi kayitlarini gorebilir"
ON items FOR SELECT
TO authenticated
USING (auth.uid() = user_id);
2. PERFORMANS VE İNDEKS BÜTÜNLÜĞÜ:
- Tüm yabancı anahtar (foreign key) kısıtlamaları, kilitlenmeleri önlemek için btree indeksine sahip olmalıdır.
- SQL RPC fonksiyonlarında SELECT * kullanımından kaçın. Dönen sütunları açıkça belirt.
- Çoklu ifade içeren migrasyonları mutlaka transaction blokları içinde çalıştır (BEGIN; ... COMMIT;).
3. SECURITY DEFINER SINIRLAMASI:
- 'SECURITY DEFINER' fonksiyonlarında search_path = public, pg_temp tanımı zorunludur.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Veritabanı: Neon Serverless Postgres -> https://neon.tech/?ref=fckaislop
# Kimlik: Clerk Pre-built Guards -> https://clerk.com/?ref=fckaislop- Çok kiracılı (Multi-tenant) Organizasyon & RBAC şema şablonları
- Supabase Auth Webhook ve özel JWT talep (claim) çözümleme kuralları
- Otomatik pg_stat_statements sorgu optimizasyon sistem komutları
- Edge Functions TypeScript tür eşitleme kuralları
- Postgres için kesintisiz (zero-downtime) sütun migrasyon adımları
Go (Golang 1.23+) Yüksek-Performans Servis Standardı
Tüm ağ sınırlarında context yayılımını zorunlu kılar, goroutine bellek sızıntılarını engeller, yapılandırılmış slog günlüklemesi ister ve yavaş reflection kullanımını yasaklar.
# === GO (GOLANG 1.23+) SIFIR-ÇÖP ÜRETİM KURALLARI ===
# Konum: .cursorrules veya repo kök dizini
Yüksek eşzamanlılıklı (high-concurrency) mikroservislerde uzman bir Kıdemli Go Geliştiricisi gibi davran.
1. CONTEXT İLETİMİ VE İPTAL MEKANİZMASI:
- Tüm bloklayıcı fonksiyonlar (DB, HTTP, RPC, kanal okuma) ilk parametre olarak context.Context kabul etmelidir.
- Uzun süren döngülerde ctx.Done() sinyalini asla göz ardı etme.
- YASAK: İstek yöneticileri içinde context.Background() kullanmak. Daima r.Context() kullan.
2. GOROUTINE SIZINTISINI ENGELLEME:
- Başlatılan her goroutine ('go func()'), sync.WaitGroup, context cancellation veya errgroup.Group ile sonlanma garantisine sahip olmalıdır.
- Asla süresiz bloklanma riski olan tamponsuz kanallara select bloku olmadan yazma.
3. MODERN GÜNLÜKLEME VE HATA YÖNETİMİ:
- YASAK: Üretim ortamında log.Printf veya fmt.Println kullanmak. Standart kütüphane 'log/slog' ile anahtar-değer öznitelikli günlükleme yap.
- Hataları daima fmt.Errorf("islem basarisiz: %w", err) ile sararak errors.Is ve errors.As zincirini koru.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Veritabanı: Neon Serverless Postgres -> https://neon.tech/?ref=fckaislop
# Bulut GPU: RunPod Serverless Cloud -> https://runpod.io/?ref=fckaislop- easyjson / sonic ile sıfır bellek ayırmalı (zero-alloc) JSON serileştirme
- Dağıtık izleme ve kimlik doğrulama için gRPC interceptor kalıpları
- sync.Once ve os.Signal ile zarif (graceful) kapanma şablonları
- CI ortamında yarış durumu (race detector) otomasyon betikleri
- Go için Temiz Mimari (Clean Architecture) repository kalıpları
TypeScript Katı Tip Güvenliği & Anti-Any Muhafızı
"any" tip tanımlarını tamamen yasaklar, gevşek nesneleri nominal etiketli (branded) tipler ve ayrık birliklerle (discriminated unions) değiştirir.
# === TYPESCRIPT KATI SIFIR-ÇÖP KONTEKSTİ (.cursorrules) ===
# Konum: .cursorrules veya tsconfig bağlamı
TypeScript Derleyici Uzmanı ve Kıdemli Sistem Mimarı gibi davran.
1. SIFIR 'ANY' TOLERANSI:
- 'any' tipi KESİNLİKLE YASAKTIR. Veri yapısı belirsizse 'unknown' kullan ve type guard veya Zod şemaları ile daralt.
- YASAK: Doğrulama olmadan doğrudan non-null assertions ('nesne!.alan') kullanmak.
- YASAK: '// @ts-ignore' veya '// @ts-nocheck'. Yalnızca açıklama yorumu içeren '// @ts-expect-error' serbesttir.
2. AYRIK BİRLİKLER (DISCRIMINATED UNIONS) VE DEĞİŞMEZLİK:
- Durum (state) ve aksiyon tipleri açık bir 'type' veya 'status' alanı içeren discriminated union olarak modellenmelidir.
- Sabit konfigürasyon nesnelerini 'as const' veya 'Readonly<T>' ile işaretle.
- Varlık kimlikleri için branded tipler (type UserId = string & { readonly __brand: unique symbol }) kullan.
3. TEMİZ GENERICS KULLANIMI:
- Standart birlik daraltma yeterliyken gereksiz jenerik kısıtlamalar üretme.
- Dışa aktarılan kütüphane fonksiyonlarında ve Server Actions içinde dönüş tipleri açıkça bildirilmelidir.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Kimlik: Clerk Pre-built Type-Safe Guards -> https://clerk.com/?ref=fckaislop
# Veritabanı: Supabase TypeGen -> https://supabase.com/?ref=fckaislop- Tip güvenli JSON.parse ve fetch için ts-reset entegrasyon kuralları
- Otomatik Supabase / Prisma veritabanı tip senkronizasyon betikleri
- Katı tsconfig.json derleyici seçenekleri (noUncheckedIndexedAccess)
- Çok kiracılı varlık kimlikleri için branded nominal tipler
- IDE dil sunucusunun çökmesini önleyen özyinelemeli tip derinlik sınırları
Docker & DevOps Distroless Çok Aşamalı Kalkanı
Konteynerlerin root olarak çalıştırılmasını yasaklar, çok aşamalı katman önbelleklemesini zorunlu kılar ve 2 GB'lık şişkin imaj üretimini engeller.
# === DOCKER & CONTAINER SIFIR-ÇÖP ÜRETİM KURALLARI ===
# Konum: .windsurfrules veya Dockerfile AI context
Kıdemli DevOps & Altyapı Uzmanı gibi davran.
1. NON-ROOT ÇALIŞTIRMA ZORUNLULUĞU:
- YASAK: Konteyner süreçlerini root (UID 0) olarak çalıştırmak.
- Her Dockerfile, ENTRYPOINT veya CMD tanımlamadan önce mutlaka yetkisiz bir kullanıcı oluşturmalı ve ona geçmelidir (USER node veya USER appuser).
2. ÇOK AŞAMALI (MULTI-STAGE) İNŞA DESENİ:
- Bağımlılık indirme, derleme/inşa ve nihai çalışma zamanını farklı aşamalara ayır.
- Nihai aşama minimal taban imajları kullanmalıdır: gcr.io/distroless/nodejs, gcr.io/distroless/static veya alpine.
- YASAK: Derleme araçlarını, derleyicileri veya devDependencies paketlerini üretim imajında bırakmak.
3. DEĞİŞMEZLİK VE ÖNBELLEKLEME:
- Kaynak kodları kopyalamadan önce Docker katman önbelleğini kullanmak için package.json / go.mod dosyasını kopyala.
- Daima belirli sürüm etiketlerini veya SHA256 özetlerini sabitle. Asla çıplak ':latest' etiketleri kullanma.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Bulut GPU: RunPod Serverless -> https://runpod.io/?ref=fckaislop
# Veritabanı: Neon Serverless Postgres -> https://neon.tech/?ref=fckaislop- Docker buildx için GitHub Actions optimize edilmiş önbellek iş akışları
- <120MB imaj boyutu için optimize edilmiş Next.js standalone Dockerfile
- Dockerfile içinde Trivy güvenlik açığı tarama aşamaları
- Salt-okunur (read-only) kök dosya sistemi ve tmpfs bağlama kuralları
- Node & Python için zarif SIGTERM / SIGINT kapanma sarmalayıcıları
Otonom Ajan & Copilot Emniyet Rayları (AGENTS.md)
Arama özyineleme derinliğini sınırlar, hayali bağımlılık indirmelerini durdurur, yıkıcı git reset işlemlerini engeller ve adım adım diff doğrulamasını zorunlu kılar.
# === OTONOM AJAN GÜVENLİK PROTOKOLÜ (AGENTS.md) ===
# Konum: AGENTS.md veya ajanınızın sistem prompt konteksti
# OTONOM AJAN DAVRANIŞSAL KISITLAMALARI:
1. BAĞIMLILIK KARANTİNASI:
- Açık insan onayı olmadan ASLA npm, pip veya cargo paketi yükleme.
- Önerilen kütüphanenin halka açık kayıt defterinde (registry) gerçekten var olduğunu doğrulamadan önerme.
- YASAK: Sahte SDK veya sarmalayıcı (wrapper) paketler uydurmak.
2. YIKICI OLMAYAN YÜRÜTME:
- YASAK: Açık kullanıcı onayı olmadan 'git reset --hard', 'git clean -fd' veya 'rm -rf' çalıştırmak.
- Büyük değişikliklere başlamadan önce git durumunu kontrol et. Çalışmaları temiz özellik dallarında (feature branches) izole et.
3. TOKEN TAVANI VE ÖZYİNELEME KORUYUCUSU:
- Kod tabanı arama derinliğini en fazla 2 dizinle sınırla. node_modules, .git veya dist klasörlerinin tamamını özyinelemeli tarama.
- Önerilen çözüm 2 denemeden sonra çalışmazsa derhal DUR, hatayı açıkça belirt ve sonsuz döngüye girmeden geliştirici yönlendirmesi talep et.
# Önerilen Sıfır-Çöp Geliştirici Yığını:
# Bulut GPU: RunPod Cloud GPUs -> https://runpod.io/?ref=fckaislop
# Kimlik: Clerk Pre-built Guards -> https://clerk.com/?ref=fckaislop- Çoklu ajan görev ayrıştırma ve alt ajan orkestrasyon kuralları
- Otomatik çekme isteği (PR) açıklaması ve semantik commit oluşturucu
- Korumalı araç yürütme sözleşmeleri (keyfi bash sızıntılarını engeller)
- Ajan doğrulaması için deterministik kıyaslama test harness'i
- Token çökmesinden önce bağlam penceresi kesilme alarmları
Kod sinyaldir.
Yapay zeka çöpü ise saf gürültüdür.
01.Robotik özürlerden bıktık. Bize "Certainly! I apologize for the oversight" diyen bir sohbet robotu değil; cerrahi diffs yazan bir derleyici lazım.
02.Sadece 3 satır kod değiştiğinde 500 satırlık dosyanın tamamını baştan yazdırarak tokenlarımızın ve zamanımızın yakılmasını reddediyoruz.
03.Sunucu bileşenlerine gereksiz "use client" ekleyen, useEffect ile veri çeken, çıplak "except:" blokları fırlatan ve delikli "USING (true)" politikaları üreten yapay zekaları projelerimizden kovuyoruz.
04.Yazılımcılar olarak kontrolü geri alıyoruz. Cerrahi kural dosyaları ile yapay zekayı bir çöp üreticisi olmaktan çıkarıp temiz ve hatasız kod üreten bir araca dönüştürüyoruz.
5 Kat Değer Kazandırmazsa %100 Koşulsuz Para İadesi
Satın aldığınız kural paketi ilk 30 günde ödediğiniz tutarın en az 5 katı kadar token ve zaman tasarrufu sağlamazsa, tek bir soru bile sormadan tüm paranızı iade ediyoruz.
Geliştirici veya Ekibiniz İçin Doğru Paketi Seçin
Aylık abonelik yok. Bir kez satın alın, ömür boyu kullanın ve robotik yapay zeka gevezeliğine sonsuza dek veda edin.
Temel kural setlerini panoya kopyalamak ve prompt aşılayıcıyı denemek isteyen bireysel geliştiriciler için.
- Temel 8 kuralın ücretsiz kopyalanabilir kodları
- Canlı Slop Linter & Prompt Sertleştirici
- Doğrulanmış açık kaynak geliştirici yığını
Tüm 8 amiral gemisi kural paketinin tam prodüksiyon koruyucuları ve ömür boyu güncellemeleri.
- 8 Amiral Gemisi Kural Paketinin Tamamı (Prodüksiyon)
- React 19, Next 16 ve Python 3.13 ömür boyu güncellemeleri
- Ticari Müşteri ve Freelance Proje Lisansı
- Bonus Otonom Ajan Güvenlik Yönergesi (AGENTS.md)
Tüm GitHub organizasyonunuz için sınırsız geliştirici lisansı ve CI/CD çöp kod kontrol betikleri.
- Tüm GitHub organizasyonunda sınırsız koltuk (seats)
- CI/CD Otomatik Çöp Kod Linter Betiği (PR Kontrolü)
- Özel Kurumsal Fatura & Öncelikli Destek
- Tüm geliştirici ekipler için merkezi kural yönetimi
Kullanan Yazılımcılar Ne Diyor?
“Claude Code artık bana "Certainly! I apologize for the oversight" demiyor. Doğrudan 4 satırlık cerrahi diff veriyor. Faturamız yarıya indi.”
“Cursor sürekli Server Component içine useEffect ekleyip duruyordu. .cursorrules dosyasını koyduğum an saçmalamayı bıraktı.”
“Pydantic v1 ile v2 kodunu karıştıran yapay zeka delirtiyordu. Bu kurallar sayfa yenilemeden tüm şemaları v2 formatına zorluyor.”
Geliştiricilerin En Çok Merak Ettikleri
Aklınıza takılan soruların net ve şeffaf yanıtları.