README.md

Everything Claude Code

50K+ yıldız | 6K+ fork | 30 katkıda bulunan | 6 dil desteği | Anthropic Hackathon Kazananı

---

🌐 Dil / Language / 语言 / 語言

English | 简体中文 | 繁體中文 | 日本語 | 한국어 | Türkçe

---

AI agent harness'ları için performans optimizasyon sistemi. Anthropic hackathon kazananından.

Sadece konfigürasyon dosyaları değil. Tam bir sistem: skill'ler, instinct'ler, memory optimizasyonu, sürekli öğrenme, güvenlik taraması ve araştırma odaklı geliştirme. 10+ ay boyunca gerçek ürünler inşa ederken yoğun günlük kullanımla evrimleşmiş production-ready agent'lar, hook'lar, command'lar, rule'lar ve MCP konfigürasyonları.

Claude Code, Codex, Cowork ve diğer AI agent harness'larında çalışır.

---

Rehberler

Bu repository yalnızca ham kodu içerir. Rehberler her şeyi açıklıyor.

Kısa Rehber Kurulum, temeller, felsefe. İlk önce bunu okuyun.	Uzun Rehber Token optimizasyonu, memory kalıcılığı, eval'ler, paralelleştirme.	Güvenlik Rehberi Saldırı vektörleri, sandboxing, sanitizasyon, CVE'ler, AgentShield.

Konu	Öğrenecekleriniz
Token Optimizasyonu	Model seçimi, system prompt daraltma, background process'ler
Memory Kalıcılığı	Oturumlar arası bağlamı otomatik kaydet/yükle hook'ları
Sürekli Öğrenme	Oturumlardan otomatik pattern çıkarma ve yeniden kullanılabilir skill'lere dönüştürme
Verification Loop'ları	Checkpoint vs sürekli eval'ler, grader tipleri, pass@k metrikleri
Paralelleştirme	Git worktree'ler, cascade metodu, instance'ları ne zaman ölçeklendirmeli
Subagent Orkestrasyonu	Context problemi, iterative retrieval pattern

---

Yenilikler

v1.9.0 — Seçici Kurulum & Dil Genişlemesi (Mar 2026)

• Seçici kurulum mimarisi — install-plan.js ve install-apply.js ile manifest-tabanlı kurulum pipeline'ı, hedefli component kurulumu için. State store neyin kurulu olduğunu takip eder ve artımlı güncellemelere olanak sağlar.
• 6 yeni agent — typescript-reviewer, pytorch-build-resolver, java-build-resolver, java-reviewer, kotlin-reviewer, kotlin-build-resolver dil desteğini 10 dile çıkarıyor.
• Yeni skill'ler — Deep learning iş akışları için pytorch-patterns, API referans araştırması için documentation-lookup, modern JS toolchain'leri için bun-runtime ve nextjs-turbopack, artı 8 operasyonel domain skill ve mcp-server-patterns.
• Session & state altyapısı — Query CLI ile SQLite state store, yapılandırılmış kayıt için session adapter'ları, kendini geliştiren skill'ler için skill evolution foundation.
• Orkestrasyon iyileştirmesi — Harness audit skorlaması deterministik hale getirildi, orkestrasyon durumu ve launcher uyumluluğu sağlamlaştırıldı, 5 katmanlı koruma ile observer loop önleme.
• Observer güvenilirliği — Throttling ve tail sampling ile memory patlaması düzeltmesi, sandbox erişim düzeltmesi, lazy-start mantığı ve re-entrancy koruması.
• 12 dil ekosistemi — Mevcut TypeScript, Python, Go ve genel rule'lara Java, PHP, Perl, Kotlin/Android/KMP, C++ ve Rust için yeni rule'lar eklendi.
• Topluluk katkıları — Korece ve Çince çeviriler, security hook, biome hook optimizasyonu, video işleme skill'leri, operasyonel skill'ler, PowerShell installer, Antigravity IDE desteği.
• CI sağlamlaştırma — 19 test hatası düzeltmesi, katalog sayısı zorunluluğu, kurulum manifest validasyonu ve tam test suite yeşil.

v1.8.0 — Harness Performans Sistemi (Mar 2026)

• Harness-first release — ECC artık açıkça bir agent harness performans sistemi olarak çerçevelendi, sadece bir config paketi değil.
• Hook güvenilirlik iyileştirmesi — SessionStart root fallback, Stop-phase session özetleri ve kırılgan inline one-liner'lar yerine script-tabanlı hook'lar.
• Hook runtime kontrolleri — ECC_HOOK_PROFILE=minimal|standard|strict ve ECC_DISABLED_HOOKS=... hook dosyalarını düzenlemeden runtime gating için.
• Yeni harness command'ları — /harness-audit, /loop-start, /loop-status, /quality-gate, /model-route.
• NanoClaw v2 — Model routing, skill hot-load, session branch/search/export/compact/metrics.
• Çapraz harness paritesi — Claude Code, Cursor, OpenCode ve Codex app/CLI arasında davranış sıkılaştırıldı.
• 997 internal test geçiyor — Hook/runtime refactor ve uyumluluk güncellemelerinden sonra tam suite yeşil.

Tam değişiklik günlüğü için Releases bölümüne bakın.

---

🚀 Hızlı Başlangıç

2 dakikadan kısa sürede başlayın:

Adım 1: Plugin'i Kurun

# Marketplace ekle
/plugin marketplace add affaan-m/everything-claude-code

# Plugin'i kur
/plugin install everything-claude-code@everything-claude-code

Adım 2: Rule'ları Kurun (Gerekli)

⚠️ Önemli: Claude Code plugin'leri rule'ları otomatik olarak dağıtamaz. Manuel olarak kurmalısınız:

# Önce repo'yu klonlayın
git clone https://github.com/affaan-m/everything-claude-code.git
cd everything-claude-code

# Bağımlılıkları kurun (paket yöneticinizi seçin)
npm install        # veya: pnpm install | yarn install | bun install

# macOS/Linux
./install.sh typescript    # veya python veya golang veya swift veya php
# ./install.sh typescript python golang swift php
# ./install.sh --target cursor typescript
# ./install.sh --target antigravity typescript

# Windows PowerShell
.\install.ps1 typescript   # veya python veya golang veya swift veya php
# .\install.ps1 typescript python golang swift php
# .\install.ps1 --target cursor typescript
# .\install.ps1 --target antigravity typescript

# npm-installed uyumluluk entry point'i de çapraz platform çalışır
npx ecc-install typescript

Manuel kurulum talimatları için rules/ klasöründeki README'ye bakın.

Adım 3: Kullanmaya Başlayın

# Bir command deneyin (plugin kurulumu namespace'li form kullanır)
/everything-claude-code:plan "Kullanıcı kimlik doğrulaması ekle"

# Manuel kurulum (Seçenek 2) daha kısa formu kullanır:
# /plan "Kullanıcı kimlik doğrulaması ekle"

# Mevcut command'ları kontrol edin
/plugin list everything-claude-code@everything-claude-code

✨ Bu kadar! Artık 28 agent, 116 skill ve 59 command'a erişiminiz var.

---

🌐 Çapraz Platform Desteği

Bu plugin artık Windows, macOS ve Linux'u tam olarak destekliyor, ana IDE'ler (Cursor, OpenCode, Antigravity) ve CLI harness'lar arasında sıkı entegrasyon ile birlikte. Tüm hook'lar ve script'ler maksimum uyumluluk için Node.js ile yeniden yazıldı.

Paket Yöneticisi Algılama

Plugin, tercih ettiğiniz paket yöneticisini (npm, pnpm, yarn veya bun) otomatik olarak algılar, aşağıdaki öncelik sırasıyla:

1. Ortam değişkeni: CLAUDE_PACKAGE_MANAGER
2. Proje config: .claude/package-manager.json
3. package.json: packageManager alanı
4. Lock dosyası: package-lock.json, yarn.lock, pnpm-lock.yaml veya bun.lockb'den algılama
5. Global config: ~/.claude/package-manager.json
6. Fallback: İlk mevcut paket yöneticisi

Tercih ettiğiniz paket yöneticisini ayarlamak için:

# Ortam değişkeni ile
export CLAUDE_PACKAGE_MANAGER=pnpm

# Global config ile
node scripts/setup-package-manager.js --global pnpm

# Proje config ile
node scripts/setup-package-manager.js --project bun

# Mevcut ayarı algıla
node scripts/setup-package-manager.js --detect

Veya Claude Code'da /setup-pm command'ını kullanın.

Hook Runtime Kontrolleri

Sıkılığı ayarlamak veya belirli hook'ları geçici olarak devre dışı bırakmak için runtime flag'lerini kullanın:

# Hook sıkılık profili (varsayılan: standard)
export ECC_HOOK_PROFILE=standard

# Devre dışı bırakılacak hook ID'leri (virgülle ayrılmış)
export ECC_DISABLED_HOOKS="pre:bash:tmux-reminder,post:edit:typecheck"

---

📦 İçindekiler

Bu repo bir Claude Code plugin'i - doğrudan kurun veya component'leri manuel olarak kopyalayın.

everything-claude-code/
|-- .claude-plugin/   # Plugin ve marketplace manifest'leri
|   |-- plugin.json         # Plugin metadata ve component path'leri
|   |-- marketplace.json    # /plugin marketplace add için marketplace kataloğu
|
|-- agents/           # Delegation için 28 özel subagent
|   |-- planner.md           # Feature implementasyon planlama
|   |-- architect.md         # Sistem tasarım kararları
|   |-- tdd-guide.md         # Test-driven development
|   |-- code-reviewer.md     # Kalite ve güvenlik incelemesi
|   |-- security-reviewer.md # Güvenlik açığı analizi
|   |-- build-error-resolver.md
|   |-- e2e-runner.md        # Playwright E2E testing
|   |-- refactor-cleaner.md  # Ölü kod temizleme
|   |-- doc-updater.md       # Dokümantasyon senkronizasyonu
|   |-- docs-lookup.md       # Dokümantasyon/API arama
|   |-- chief-of-staff.md    # İletişim triajı ve taslaklar
|   |-- loop-operator.md     # Otonom loop çalıştırma
|   |-- harness-optimizer.md # Harness config ayarlama
|   |-- ve daha fazlası...
|
|-- skills/           # İş akışı tanımları ve domain bilgisi
|   |-- coding-standards/           # Dil en iyi uygulamaları
|   |-- backend-patterns/           # API, veritabanı, caching pattern'leri
|   |-- frontend-patterns/          # React, Next.js pattern'leri
|   |-- security-review/            # Güvenlik kontrol listesi
|   |-- tdd-workflow/               # TDD metodolojisi
|   |-- continuous-learning/        # Oturumlardan otomatik pattern çıkarma
|   |-- django-patterns/            # Django pattern'leri
|   |-- golang-patterns/            # Go deyimleri ve en iyi uygulamalar
|   |-- ve 100+ daha fazla skill...
|
|-- commands/         # Hızlı çalıştırma için slash command'lar
|   |-- tdd.md              # /tdd - Test-driven development
|   |-- plan.md             # /plan - Implementasyon planlama
|   |-- e2e.md              # /e2e - E2E test oluşturma
|   |-- code-review.md      # /code-review - Kalite incelemesi
|   |-- build-fix.md        # /build-fix - Build hatalarını düzelt
|   |-- ve 50+ daha fazla command...
|
|-- rules/            # Her zaman uyulması gereken kurallar (~/.claude/rules/ içine kopyalayın)
|   |-- README.md            # Yapı genel bakışı ve kurulum rehberi
|   |-- common/              # Dilden bağımsız prensipler
|   |   |-- coding-style.md    # Immutability, dosya organizasyonu
|   |   |-- git-workflow.md    # Commit formatı, PR süreci
|   |   |-- testing.md         # TDD, %80 coverage gereksinimi
|   |   |-- performance.md     # Model seçimi, context yönetimi
|   |   |-- patterns.md        # Tasarım pattern'leri
|   |   |-- hooks.md           # Hook mimarisi
|   |   |-- agents.md          # Ne zaman subagent'lara delege edilmeli
|   |   |-- security.md        # Zorunlu güvenlik kontrolleri
|   |-- typescript/          # TypeScript/JavaScript özel
|   |-- python/              # Python özel
|   |-- golang/              # Go özel
|   |-- swift/               # Swift özel
|   |-- php/                 # PHP özel
|
|-- hooks/            # Trigger-tabanlı otomasyonlar
|   |-- hooks.json                # Tüm hook'ların config'i
|   |-- memory-persistence/       # Session lifecycle hook'ları
|   |-- strategic-compact/        # Compaction önerileri
|
|-- scripts/          # Çapraz platform Node.js script'leri
|   |-- lib/                     # Paylaşılan yardımcılar
|   |-- hooks/                   # Hook implementasyonları
|   |-- setup-package-manager.js # Interaktif PM kurulumu
|
|-- mcp-configs/      # MCP server konfigürasyonları
|   |-- mcp-servers.json    # GitHub, Supabase, Vercel, Railway, vb.

---

🗺️ Hangi Agent'ı Kullanmalıyım?

Nereden başlayacağınızdan emin değil misiniz? Bu hızlı referansı kullanın:

Yapmak istediğim...	Bu command'ı kullan	Kullanılan agent
Yeni bir feature planla	/everything-claude-code:plan "Auth ekle"	planner
Sistem mimarisi tasarla	/everything-claude-code:plan + architect agent	architect
Önce testlerle kod yaz	/tdd	tdd-guide
Yazdığım kodu incele	/code-review	code-reviewer
Başarısız bir build'i düzelt	/build-fix	build-error-resolver
End-to-end testler çalıştır	/e2e	e2e-runner
Güvenlik açıklarını bul	/security-scan	security-reviewer
Ölü kodu kaldır	/refactor-clean	refactor-cleaner
Dokümantasyonu güncelle	/update-docs	doc-updater
Go kodu incele	/go-review	go-reviewer
Python kodu incele	/python-review	python-reviewer

Yaygın İş Akışları

Yeni bir feature başlatma:

/everything-claude-code:plan "OAuth ile kullanıcı kimlik doğrulaması ekle"
                                              → planner implementasyon planı oluşturur
/tdd                                          → tdd-guide önce-test-yaz'ı zorunlu kılar
/code-review                                  → code-reviewer çalışmanızı kontrol eder

Bir hatayı düzeltme:

/tdd                                          → tdd-guide: hatayı yeniden üreten başarısız bir test yaz
                                              → düzeltmeyi uygula, testin geçtiğini doğrula
/code-review                                  → code-reviewer: regresyonları yakala

Production'a hazırlanma:

/security-scan                                → security-reviewer: OWASP Top 10 denetimi
/e2e                                          → e2e-runner: kritik kullanıcı akışı testleri
/test-coverage                                → %80+ coverage doğrula

---

❓ SSS

Hangi agent/command'ların kurulu olduğunu nasıl kontrol ederim?

/plugin list everything-claude-code@everything-claude-code

Bu, plugin'den mevcut tüm agent'ları, command'ları ve skill'leri gösterir.

Hook'larım çalışmıyor / "Duplicate hooks file" hatası alıyorum

Bu en yaygın sorundur. .claude-plugin/plugin.json'a bir "hooks" alanı EKLEMEYİN. Claude Code v2.1+ kurulu plugin'lerden hooks/hooks.json'ı otomatik olarak yükler. Açıkça belirtmek duplicate algılama hatalarına neden olur. Bkz. #29, #52, #103.

Context window'um küçülüyor / Claude context'ten tükeniyor

Çok fazla MCP server context'inizi tüketiyor. Her MCP tool açıklaması 200k window'unuzdan token tüketir, potansiyel olarak ~70k'ya düşürür.

Düzeltme: Kullanılmayan MCP'leri proje başına devre dışı bırakın:

// Projenizin .claude/settings.json dosyasında
{
  "disabledMcpServers": ["supabase", "railway", "vercel"]
}

10'dan az MCP etkin ve 80'den az aktif tool tutun.

Sadece bazı component'leri kullanabilir miyim (örn. sadece agent'lar)?

Evet. Seçenek 2'yi (manuel kurulum) kullanın ve yalnızca ihtiyacınız olanı kopyalayın:

# Sadece agent'lar
cp everything-claude-code/agents/*.md ~/.claude/agents/

# Sadece rule'lar
cp -r everything-claude-code/rules/common/* ~/.claude/rules/

Her component tamamen bağımsızdır.

Bu Cursor / OpenCode / Codex / Antigravity ile çalışır mı?

Evet. ECC çapraz platformdur:

• Cursor: .cursor/ içinde önceden çevrilmiş config'ler. Cursor IDE Desteği bölümüne bakın.
• OpenCode: .opencode/ içinde tam plugin desteği. OpenCode Desteği bölümüne bakın.
• Codex: macOS app ve CLI için birinci sınıf destek. PR #257'ye bakın.
• Antigravity: İş akışları, skill'ler ve .agent/ içinde düzleştirilmiş rule'lar için sıkı entegre kurulum.
• Claude Code: Native — bu birincil hedeftir.

Yeni bir skill veya agent'a nasıl katkıda bulunurum?

CONTRIBUTING.md'ye bakın. Kısa versiyon:

1. Repo'yu fork'layın
2. skills/your-skill-name/SKILL.md içinde skill'inizi oluşturun (YAML frontmatter ile)
3. Veya agents/your-agent.md içinde bir agent oluşturun
4. Ne yaptığını ve ne zaman kullanılacağını açıklayan net bir açıklamayla PR gönderin

---

🧪 Testleri Çalıştırma

Plugin kapsamlı bir test suite içerir:

# Tüm testleri çalıştır
node tests/run-all.js

# Bireysel test dosyalarını çalıştır
node tests/lib/utils.test.js
node tests/lib/package-manager.test.js
node tests/hooks/hooks.test.js

---

🤝 Katkıda Bulunma

Katkılar beklenir ve teşvik edilir.

Bu repo bir topluluk kaynağı olmayı amaçlar. Eğer şunlara sahipseniz:

• Yararlı agent'lar veya skill'ler
• Akıllı hook'lar
• Daha iyi MCP konfigürasyonları
• İyileştirilmiş rule'lar

Lütfen katkıda bulunun! Rehber için CONTRIBUTING.md'ye bakın.

Katkı Fikirleri

• Dile özel skill'ler (Rust, C#, Kotlin, Java) — Go, Python, Perl, Swift ve TypeScript zaten dahil
• Framework'e özel config'ler (Rails, FastAPI, NestJS) — Django, Spring Boot, Laravel zaten dahil
• DevOps agent'ları (Kubernetes, Terraform, AWS, Docker)
• Test stratejileri (farklı framework'ler, görsel regresyon)
• Domain'e özel bilgi (ML, data engineering, mobile)

---

📄 Lisans

MIT - Özgürce kullanın, ihtiyaç duyduğunuz gibi değiştirin, yapabiliyorsanız geri katkıda bulunun.

---

Bu repo size yardımcı olduysa yıldızlayın. Her iki rehberi de okuyun. Harika bir şey yapın.