.cursorrules & AI Kodlama Ajanı Kural Oluşturucu

2026 AI Agentic Coding Standartları

AI Kodlama Ajanı Kural Oluşturucu

Cursor (.cursorrules), Claude Code (CLAUDE.md) ve Windsurf (.windsurfrules) için mükemmel mimari kurallarını saniyeler içinde üretin.

Hazır Popüler Şablonlar

1. Hedef Araç & Çıktı Dosyası

2. Framework & Dil

3. Mimari & Kalite Standartları

Strict TypeScript & Zero Any

Kesin tip güvenliği, generic yapılar ve no-any kuralı.

Tailwind CSS v4 & Modern UI

CSS first token yapısı, semantic responsive utility sınıfları.

Clean Code & SOLID

Tek sorumluluk prensibi, gevşek bağlılık ve modüler katmanlar.

TDD & Unit / E2E Test

Vitest/Jest ve Playwright odaklı test yazım disiplini.

Erişilebilirlik (A11y & ARIA)

Ekran okuyucu uyumluluğu, klavye navigasyonu ve semantik HTML.

Edge Runtime & Performans

Hafif bağımlılıklar, tree-shaking ve sub-millisecond yanıtlar.

Siber Güvenlik & OWASP

Girdi doğrulama (Zod/Pydantic), sanitize edilmiş SQL ve XSS koruması.

Hata Yönetimi & Telemetri

Yapılandırılmış loglar, graceful degradation ve custom error tipleri.

4. Projenize Özel Ek Kurallar (İsteğe Bağlı)

.cursorrules

# .cursorrules - Next.js 16 (App Router) Project Rules
# Generated by ismailhakkieren.com AI Tools

## 🧠 Persona & Role
You are a Senior Staff Software Engineer and Architecture Expert specializing in **Next.js 16 (App Router)** (TypeScript).
Your code must be clean, maintainable, secure, and production-ready. Always explain complex architectural decisions briefly before presenting code.

## ⚡ Core Tech Stack & Guidelines
- Primary Language: **TypeScript**
- Framework / Platform: **Next.js 16 (App Router)**
- Write idiomatic, modern code following current industry best practices (2026+).
- Prioritize simplicity and readability over clever one-liners.
- Keep components and functions focused on a single responsibility (SRP).

### Next.js & React Server Components Rules
- Default to React Server Components (RSC). Add `'use client'` directive ONLY when React state, effects, or browser event listeners are strictly required.
- Co-locate components, types, and server actions close to their feature directories.
- Use Server Actions for data mutations with progressive enhancement and Zod validation.
- Implement proper Suspense boundaries and `loading.tsx` / `error.tsx` states for async routes.
- Avoid unnecessary client-side `useEffect` fetch loops; utilize server-side caching and dynamic routes properly.

## 🛠️ Architecture & Quality Standards
- **TypeScript Strictness:** Enable strict mode. NEVER use `any`; use `unknown`, generic type arguments, or type guards with discriminant unions.
- **Tailwind CSS v4:** Use CSS variable-based semantic design tokens. Avoid hardcoded hex colors or arbitrary values unless mandatory. Maintain fluid responsive classes.
- **Clean Architecture:** Decouple business logic from framework/database adapters. Write modular services and domain entities.
- **Security First:** Sanitize all user inputs, prevent injection vulnerabilities (SQL, XSS, SSRF), and never log sensitive API keys or credentials.

## 📋 Code Generation Instructions
1. **Targeted Edits:** When modifying existing files, output only the relevant diffs or concise replacement blocks. Avoid rewriting hundreds of unchanged lines.
2. **No Placeholders:** Provide complete, runnable implementations. Do not leave TODOs or comment placeholders for critical logic.
3. **Self-Documenting:** Use clean, expressive naming for variables and functions. Avoid redundant comments that merely restate what code does.

## 🎯 Project-Specific Requirements
Server Component ve Client Component ayrımını kesin yap. "use client" yalnızca etkileşim gerektiğinde eklenmeli.

35 satır • 2575 karakter💡 Projenizin kök dizinine yerleştirin.

TL;DR / Doğrudan Tanım: .cursorrules & CLAUDE.md Nedir?

.cursorrules ve CLAUDE.md; Cursor IDE, Anthropic Claude Code ve Windsurf Cascade gibi otonom yapay zeka kodlama ajanlarının projenizin kod mimarisi, TypeScript standartları, dizin yapısı ve kütüphane versiyonlarına tam uyum sağlamasını garantileyen kural yapılandırma dosyalarıdır. Kök dizine eklendiğinde modelin halüsinasyon görmesini engeller, gereksiz kod silinmelerini önler ve token tüketimini %40'a kadar azaltır.

Teknoloji Seçin:Next.js, React, FastAPI veya Go çerçevenizi belirleyin.

Kuralları Özelleştirin:TypeScript, Tailwind ve TDD mimari kurallarını işaretleyin.

Kök Dizine Kaydedin:Üretilen dosyayı .cursorrules veya CLAUDE.md olarak kaydedin.

.cursorrules ve AI Kodlama Ajanı Kuralları Rehberi

AI Kodlama Ajanı Kural Oluşturucu; Cursor IDE (.cursorrules),Anthropic Claude Code (CLAUDE.md) veWindsurf Cascade (.windsurfrules) gibi modern otonom kodlama asistanları için projeye özel kurallar üreten interaktif bir geliştirici aracıdır. Doğru yapılandırılmış bir kural dosyası; modelin halüsinasyon görmesini engeller, gereksiz kod silmelerinin önüne geçer, projenizin mimari standartlarını korur ve token maliyetinizi %40'a varan oranda düşürür.

Detaylı Rehberi ve SSS Göster

Neden Projenize Bir Kural Dosyası (.cursorrules / CLAUDE.md) Eklemelisiniz?

Büyük Dil Modelleri (LLM'ler), projenizin geçmişini veya tercih ettiğiniz mimari kalıpları bilmeden genel internet eğitim verisine dayanarak kod üretir. Örneğin Next.js 16 kullanırken modelin eski Pages Router kalıplarını getirmesi, gereksiz client component 'use client' direktifleri eklemesi veya TypeScript 'any' tipleri kullanması en yaygın karşılaşılan verimsizliklerdendir. Bir .cursorrules veya CLAUDE.md dosyası; modele sistem seviyesinde öncelikli kurallar dayatarak projenize özgü rehberlik sunar.

Etkili Bir AI Kural Setinde Bulunması Gereken 5 Temel Bölüm

Rol ve Persona (Persona & Role): Modelin kıdem seviyesi ve uzmanlık alanı (örn: Senior Staff Next.js & TypeScript Architect).
Teknoloji Yığını ve Versiyon Kısıtları: Kullanılan paketler, framework sürümleri ve kaçınılması gereken deprecated kütüphaneler.
Dizin Düzeni ve İsimlendirme Kuralları: Dosya isimlendirmeleri (kebab-case, PascalCase), bileşenlerin ve testlerin konumu.
Güvenlik ve Hata Yönetimi: Girdi doğrulama (Zod, Pydantic), exception filtreleri ve çevre değişkeni (env) koruması.
Çıktı Biçimi: Tüm dosyayı yeniden yazmak yerine sadece değişen blokları diff olarak üretme ve eksik kod bırakmama kuralı.

Sıkça Sorulan Sorular (FAQ)

.cursorrules dosyası projenin neresine konulmalıdır?

.cursorrules dosyası projenizin ana kök dizinine (root directory) yerleştirilmelidir. Cursor IDE projeyi açtığında bu dosyayı otomatik olarak tespit eder ve ajanın sistem istemine enjekte eder.

CLAUDE.md ile .cursorrules arasındaki fark nedir?

CLAUDE.md, Anthropic tarafından geliştirilen Claude Code CLI aracı için tasarlanmış kural standardıdır. Terminal tabanlı ajan iş akışları, test komutları ve mimari kısıtlar için optimize edilmiştir.

Kural dosyası kullanmak token maliyetini düşürür mü?

Evet. Modelin hedeflenen mimariyi ilk denemede doğru üretmesini sağlayarak yanlış veya hatalı kod düzeltme döngülerini ve gereksiz context yükünü %40'a kadar azaltır.

İlgili Makaleler ve İpuçları

Yapay zeka ile kodlama ve otonom ajanların çalışma prensipleri hakkında daha fazla bilgi edinmek için Cursor 2.0 Yenilikleri, Claude Code Agent Rehberi, SpaceX Cursor Satın Alımı ve 2026 Vibe Coding ve Orkestrasyon Çağı yazılarına göz atabilirsiniz.