Everything Claude Code (ECC): Claude Code için Açık Kaynak Ajan Çerçevesi

Kodlayan ajanlar yaygınlaştığından beri, her oturumun başında yığınınızı, kurallarınızı, tercihlerinizi ve inceleme standartlarınızı kaç kez yeniden anlattınız?

Sorun şu ki her yeni sohbet sıfırdan başlıyor. Claude Code gibi araçlar kod yazmayı biliyor, ama ekibinizin nasıl kod yazdığını bilmiyor. Zamandan tasarruf olarak başlayan şey, her seferinde aynı proje bağlamını yapıştırmak, model sapınca düzeltmek, talimatları optimize etmek ve aynı jenerik önerileri yeniden gözden geçirmek gibi manuel işe dönüşüyor.

Everything Claude Code (ECC), bunu düzeltmeyi amaçlayan açık kaynaklı bir çerçeve. Adına rağmen Anthropic ile ilişkili değil. Claude Code'un üzerine oturan (bir model değil, bir IDE de değil) bir ajan sistemi ve iş akışı katmanı; genel amaçlı bir kodlama ajanını, standartlarınızı zaten bilen uzmanlaşmış bir mühendislik platformuna dönüştürüyor.

Bu yazıda ECC'nin ne olduğunu, parçalarının nasıl bir araya geldiğini, nasıl kurulacağını ve kimin gerçekten kullanması gerektiğini anlatacağım.

Peki Claude Code tam olarak nedir? Günlük geliştirme iş akışlarınızda nasıl kullanacağınızı öğrenmek için Claude Code 101 kursumuza kaydolun.

Everything Claude Code Nedir?

ECC, Claude Code'u mühendislik çalışmaları için önceden oluşturulmuş bir işletim katmanıyla saran açık kaynaklı bir depodur.

Projeyi affaan-m/ECC on GitHub adresinde bulabilirsiniz. MIT lisanslıdır, Affaan Mustafa tarafından sürdürülmektedir ve gerçek ürünlerde 10+ aylık günlük Claude Code kullanımına dayanmaktadır. Adına rağmen Anthropic ile ilişkisi yoktur.

Depo dört şeyi tek bir kurulumda paketler:

• Bir ajan kuşamı: Claude Code'un her şeyi tek bir bağlam penceresinde yapmaya çalışmak yerine görevleri devrettiği uzman alt ajanlar kümesi (planlayıcı, mimar, kod inceleyici, güvenlik inceleyicisi, derleme hatası çözücü ve daha bir düzine).
• Bir beceri ekosistemi: TDD, güvenlik incelemesi, çerçeve kalıpları (Django, Spring Boot, Next.js ve diğerleri), dile özgü kodlama standartları ve ML mühendisliği görevlerini kapsayan birkaç yüz küçük iş akışı tanımı.
• Bir iş akışı çerçevesi: araç olaylarında çalışan kancalar, her zaman geçerli olan kurallar, MCP sunucu yapılandırmaları ve oturumlar arasında yaşayan oturum belleği.
• Bir komut katmanı: yaygın iş akışlarını çalıştırmak için sürdürülen eğik çizgi girdileri ve eski komut adları için geriye dönük uyum katmanı klasörü.

Claude Code'un hâlâ motor olduğunu belirtmek önemlidir. Kodu okur ve araçları çalıştırır.

ECC'nin işi bunun etrafındaki her şeydir: Bu görevi hangi alt ajanın ele alacağını, hangi iş akışı adımlarının izleneceğini, yığınınızın hangi gelenekleri kullandığını ve dünün oturumundan hangi bağlamın devralınacağını Claude Code'a söylemek.

Pratikte bu, her proje için Claude Code'u baştan yapılandırmanız gerekmediği anlamına gelir. ECC'yi bir kez kurar, yığınıza uygun kural paketlerini kopyalar ve oradan nasıl ilerleyeceğini zaten bilen uzman bir mühendislik platformuna sahip olursunuz.

Everything Claude Code Neden Bu Kadar Popüler Oldu

Büyüme tek bir X gönderisiyle başladı.

2026'nın başlarında, Mustafa Everything Claude Code için Kısa Rehber paylaşımını yaptı. Günler içinde 10 binin üzerinde yer imine ulaştı. Ardından depoyu açık kaynak yaptı ve ECC şimdi 200 bin yıldızı ve 34+ çatallanmayı geçti.

Bunun nedeni şu:

• Ajan temelli kodlama deneyden günlük kullanıma geçti: Daha fazla geliştirici Claude Code kullanmaya başladıkça, stok sistemin sınırlamalarını fark ettiler. Geliştiricilerin ihtiyacı olan, soğuk başlangıç bağlamını, tutarsız kod inceleme çıktılarını ve benzerlerini ortadan kaldıran önceden oluşturulmuş bir yapılandırma katmanıydı.
• İyi ajan istemleri yazmak göründüğünden zordur: Sağlam bir TDD iş akışı veya güvene göre filtreleyen bir kod inceleyici istemi, doğru noktaya gelmek için yineleme ister. Pek çok ekip, modeller değiştikçe bunu sıfırdan inşa edip sürdürmek istemez; başkalarının test edilmiş sürümünü yeniden kullanmak daha kolaydır.
• Katkılar birikti: 270+ katkıcı dil kural paketleri (Java, Kotlin, Rust, Perl, PHP), çerçeve desteği (Quarkus, Laravel), çeviriler, Claude Code dışındaki IDE entegrasyonları (Cursor, OpenCode, Zed) ve beceriler ekledi.
• ECC, ince ayar olmadan uzmanlaşma sağlar: Bir modeli ekip gelenekleriyle ince ayarlamak çoğu ekip için pratik değildir. Çalışma zamanında yapılandırılmış bir beceri ve ajan seti benzer bir etkiye yaklaşır ve ECC bunu paketlemeye yönelik daha eksiksiz girişimlerden biridir.

Yani X gönderisiyle başladı, ama oradan kartopu etkisine dönüştü.

Everything Claude Code Nasıl Çalışır

ECC katmanlı bir sistemdir.

Sizinle kod tabanınız arasında beş bileşen vardır. Çalışma zamanı Claude Code'dur. Beceriler, ajanlar, MCP ve bir bellek katmanı onu sarar. Her parça tek bir iş yapar ve bir oturum sırasında işi birbirine devreder.

Claude Code

Claude Code alttaki model arayüzüdür.

Anthropic'in Claude'u bir kodlama ajanı olarak çalıştırmak için resmi CLI aracıdır. Dosyaları okur, diff yazar, kabuk komutları çalıştırır, araçları çağırır ve sohbeti tutar. ECC bunların hiçbirinin yerine geçmez. ECC'nin eklediği her şey oturum başında Claude Code içine yüklenir ve mevcut eklenti, kanca ve komut sistemi üzerinden çalışır.

Beceriler

Beceriler, Markdown dosyaları olarak saklanan yeniden kullanılabilir iş akışı talimatlarıdır.

Her beceri, Claude Code'a belirli bir tür görevi nasıl ele alacağını söyleyen bir SKILL.md içeren küçük bir klasördür. Beceri açıklamayı, adımları, beklenen çıktıyı ve kısıtları adlandırır. ECC'de dil kalıpları, test iş akışları, çerçeve gelenekleri, ML mühendisliği ve operasyonel görevleri kapsayan yaklaşık 260 beceri vardır.

Unutmayın: Becerileri elle çalıştırmazsınız. Claude Code, yaptıklarınıza göre onları seçer veya siz istemde referans verirsiniz.

Ajanlar

Ajanlar, Claude Code'un görev devrettiği uzman alt ajanlardır.

Her biri bir ad, açıklama, araç izin listesi ve davranışını sınırlayan bir sistem istemiyle Markdown'da tanımlanır. code-reviewer ajanı yalnızca dosyaları okur ve bulguları raporlar. planner, herhangi bir koda dokunulmadan önce uygulama taslaklarını yazar. Fikir bu.

Bu ayrımın amacı bağlam yalıtımıdır. Her alt ajan kendi görevi için temiz bir bağlam penceresi alır, böylece ana oturum dolmaz. Ana ajan koordine eder, alt ajanlar icra eder.

MCP entegrasyonları

MCP (Model Context Protocol), Claude Code'un harici araçlar ve veri kaynaklarıyla konuşma yoludur.

ECC, MCP sunucuları üzerinden GitHub, Supabase, Vercel, Railway ve diğerlerine bağlanmak için yapılandırmalar içerir. Her sunucu, Claude Code'un oturum ortasında çağırabileceği araçları açığa çıkarır. ECC sadece çalışan yapılandırmaları ve güvenlik kurallarını paketler.

Varsayılan olarak ECC bir bağlayıcıyı etkinleştirir (chrome-devtools). Diğer her şey tercihe bağlıdır; bu da araç adı çakışmalarını önler ve saldırı yüzeyini küçük tutar.

Bellek katmanı

Bellek katmanı, ECC'yi oturumlar arasında durumlu hâle getirir.

Kancalar, her sohbetin Stop olayında çalışır ve ~/.claude/sessions/ dizinine bir oturum özeti yazar. Sonraki oturum, başlangıçta ilgili bağlamı SessionStart kancasıyla yükler. Modelin kalıplarınızdan "öğrendiği" beceriler, Continuous Learning v2 sistemine çıkarılır; burada güven puanlarıyla içgüdüler olarak saklanır ve daha sonra yeniden kullanılabilir.

Oturum takma adları, öğrenilen beceriler ve metrikler tek bir ajan veri kökü altında yaşar (varsayılan ~/.claude; ECC'yi hem Claude Code hem Cursor'da çalıştırırsanız her kuşam için yapılandırılabilir).

Parçalar birlikte nasıl çalışır

Tipik bir oturum şöyle görünür:

1. Oturum başlangıcı: Bir kanca, önceki oturumdan bağlamı ve mevcut proje için ilgili beceri ve kuralları yükler.
2. Bir şey istersiniz: Örneğin, "OAuth girişi ekle."
3. Planlayıcı ajan önce çalışır: Bir taslak yazar, henüz kod yoktur.
4. TDD becerisi devreye girer: Claude Code; başarısız test, asgari uygulama ve yeniden düzenleme iş akışını izler.
5. MCP araçları çağrılır: Belki GitHub MCP ilgili PR'ları çeker veya Supabase MCP şemayı kontrol eder.
6. Kod inceleyici ajan sonda çalışır: Diff'i kendi bağlam penceresinde denetler ve geri raporlar.
7. Oturum biter: Bir Stop kancası özet yazar, yeni kalıpları içgüdülere çıkarır ve bir sonraki sefer için saklar.

Model hâlâ Claude Code'dur. ECC sadece her adımda hangi becerinin, hangi ajanın ve hangi aracın kullanılacağını orkestre eder.

Everything Claude Code'daki Beceriler

Beceriler, ECC'nin Claude Code'a ne yapacağını söylemesinin birincil yoludur.

Bir beceri, bir SKILL.md dosyası içeren bir klasördür. Markdown; açıklamayı, adımları, kısıtları, beklenen çıktıyı ve geçerli olduğu bağlamları tanımlar. Modelin çalışma zamanında okuduğu basit bir metin dosyasıdır.

Ve bu bilinçli bir tercihtir. ECC herhangi bir şeyi “yeniden eğitmiyor”, Claude'un o anda okuyup takip ettiği talimatları yüklüyor.

Beceriler, depo kökünde skills/ dizininde yer alır. Kurulumdan sonra ~/.claude/skills/ konumuna kopyalanırlar. Claude Code bunları o klasörün doğrudan alt öğeleri olarak yükler.

Her beceri klasörünün aynı temel düzeni vardır:

• SKILL.md - iş akışı tanımı
• İsteğe bağlı destekleyici dosyalar (şablonlar, betikler, örnekler)
• Keşif ve etiketleme için isteğe bağlı metadata.yaml

Beceriler ajan davranışını iki şekilde etkiler. Birincisi, Claude Code onları oturum başında okur ve referans için hazır tutar. İkincisi, model sizin isteğinize göre ilgili beceriyi seçer. "Önce başarısız bir test yaz" derseniz TDD becerisi etkinleşir. "Bunu SQL enjeksiyonu için incele" derseniz güvenlik inceleme becerisi devreye girer.

ECC yaklaşık 260 beceriyle birlikte gelir. Yelpazeyi göstermek için birkaç örnek:

• frontend-patterns: React ve Next.js gelenekleri. Bileşen yapısı, kanca kullanımı, sunucu vs. istemci bileşen kararları, durum yönetimi kalıpları.

• django-patterns, django-tdd, django-security, django-verification: Dört beceriye bölünmüş tam bir Django yığını. Biri mimari için, biri test döngüsü için, biri OWASP tarzı denetimler için, biri de gönderim öncesi doğrulama döngüsü için.

• architect (architect ajanıyla eşleşik): Sistem tasarım incelemeleri. Beceri, bir mimari incelemenin neleri kapsadığını, hangi çıktıları ürettiğini ve hangi ödünleşimlerin öne çıkarılacağını tanımlar.

• tdd-workflow: Kırmızı-yeşil-yeniden düzenle döngüsü. Başarısız testi yaz, geçmesi için asgari kodu yaz, yeniden düzenle, kapsama alanını doğrula. Beceri sıralamayı zorunlu kılar.

• security-review: OWASP Top 10 kontrol listesi, gömülü kimlik bilgisi tespiti, girdi doğrulama incelemesi ve bağımlılık zafiyeti kontrolleri. Beceri neyin taranacağını ve neyin işaretleneceğini tanımlar.

Everything Claude Code'daki Ajanlar

Ajanlar, kendi bağlam pencereleri olan uzmanlaşmış kişiliklerdir.

Her biri agents/ klasöründe bir ad, açıklama, araç izin listesi ve bir sistem istemi ile yer alan bir Markdown dosyasıdır. Sistem istemi ajanın işini tanımlar. Araç izin listesi ne yapabileceğini kontrol eder (dosya okuma, bash çalıştırma, MCP sunucularını çağırma, kod yazma). Claude Code, bir görevi sizin için otomatik olarak bir ajana devreder.

ECC'de 66 ajan vardır. Birkaç kategoriye gruplanırlar.

Planlama ajanları herhangi bir kod yazılmadan önce çalışır.

planner ajanı, bir özellik isteğini uygulama taslağına böler: değişecek dosyalar, tanımlanacak arayüzler, yazılacak testler ve ele alınacak kenar durumları. architect ajanı daha üst seviyeye çıkar: sistem tasarımı, veri modeli kararları, servis sınırları. Bu ajanlar yalnızca kod okur ve plan yazar.

Kodlama ajanları uygulama işini yapar.

tdd-guide test-önce döngüsünü zorlar. go-build-resolver, pytorch-build-resolver ve kotlin-build-resolver gibi dile özgü çözücüler kendi ekosistemlerindeki derleme hatalarını giderir. refactor-cleaner kullanılmayan kodu kaldırır.

Mimari ajanlar yapısal kararları inceler.

architect tasarımı, database-reviewer sorgu kalıpları ve şema tercihlerini, mle-reviewer ise üretim ML hatlarını (veri sözleşmeleri, değerlendirme kapsamı, sunum, izleme) denetler.

QA ajanları oluşturulanı doğrular.

code-reviewer, kalite ve güvenlik için güven eşiğiyle diff'leri denetler. security-reviewer OWASP tarzı bir geçiş yapar. e2e-runner Playwright uçtan uca testlerini yürütür. Dil inceleyicileri (typescript-reviewer, python-reviewer, go-reviewer, rust-reviewer ve diğerleri) dile özgü kontrolleri üstlenir.

Tüm bunların ayrı ajanlara bölünmesinin nedeni bağlam yalıtımıdır.

code-reviewer çalıştığında, yalnızca diff ve inceleme becerisinin yüklü olduğu taze bir bağlam penceresi alır. Planlama notlarını veya sohbet geçmişini görmez. Sadece inceler. Bu odak, tek bir genel ajandan aynı bağlamda planlamasını, kod yazmasını, test etmesini ve incelemesini istemekten (çoğu ad hoc Claude Code kurulumunun yaptığı) daha iyi çıktı üretir.

ECC'de Bağlam ve Bellek Yönetimi

ECC, Claude Code gibi oturumlar arasında her şeyi unutmaz.

ECC'deki bellek, doğru anlarda dosyalar yazan ve doğru anlarda onları geri yükleyen kanca sistemidir. Diskteki düz Markdown ve JSON dosyalarıdır.

Üç şey kalıcıdır:

1. Oturum özetleri, oturum bittiğinde yazılır: Son mesajdan sonra bir Stop kancası çalışır, tam dökümü alır ve ~/.claude/sessions/ dizinine bir özet yazar. Özet; neler üzerinde çalışıldığını, nelerin kararlaştırıldığını, nelerin açık kaldığını kapsar. Sonraki oturum, SessionStart kancası sırasında bunu okuyarak Claude'un nerede kalındığını bilmesini sağlar.
2. İçgüdüler, oturumlarınızdaki çıkarılmış kalıplardır: Continuous Learning v2 sistemi ne yaptığınızı ve neyin işe yaradığını izler, ardından güven puanı, eylem, destekleyici kanıt ve örneklerle bireysel içgüdüler yazar. Öğrenilenleri görmek için /instinct-status çalıştırın. İlgili içgüdüleri yeni bir beceriye kümelemek için /evolve çalıştırın.
3. Günlük dosyaları operasyon katmanını izler: Kanca yürütmeleri, beceri çalışmaları, MCP çağrıları, maliyetler, hatalar gibi. Bunlar ~/.claude/metrics/ ve ~/.claude/session-data/ altında yaşar. Hata ayıklama ve depoyla gelen pano GUI'si için kullanışlıdır.

Bunun büyük bir mesele olmadığını düşünüyorsanız, fikrinizi değiştirecek birkaç neden:

• Uzun soluklu projeler: Altı aylık bir yeniden düzenleme her pazartesi sıfırlanmaz. Geçen haftanın kararları, ödünleşimleri ve bilinen sorunları, oturum başında yüklenen özetten gelir.
• Tekrarlayan açıklamalar yok: Her seferinde yığınızı, kurallarınızı veya "Postgres kullanmaya karar verdiğimizi unutmayın, Oracle değil" gibi notları yeniden yapıştırmazsınız.
• Bağlam penceresi sınırlarını aşmak: Bir milyon belirteçlik pencere bile altı aylık bir proje geçmişini sığdıramaz. Özetler önemli olanı sıkıştırır. Tam geçmiş disk üzerinde kalır, modele ilgili kısım verilir.

Yüklenen bağlamı ortam değişkenleriyle ayarlayabilirsiniz. ECC_SESSION_START_MAX_CHARS başlangıçta yüklenen özet miktarını sınırlar (varsayılan 8.000 karakter). ECC_SESSION_START_CONTEXT=off düşük bağlamlı kurulumlar için devre dışı bırakır. ECC_SESSION_RETENTION_DAYS oturumların budamadan önce ne kadar süre saklanacağını kontrol eder.

ECC'yi aynı makinede hem Claude Code hem Cursor'da çalıştırırsanız, belleklerini ayırmak için ECC_AGENT_DATA_HOME değişkenini ayarlayın. Aksi hâlde birbirlerinin oturum dosyalarını üzerine yazarlar.

Everything Claude Code'da MCP Desteği

MCP, Claude Code'un dosya veya kabuk komutu olmayan her şeyi çağırma yoludur.

Model Context Protocol, dil modellerini harici araçlara bağlamak için Anthropic'in standardıdır. Bir MCP sunucusu ayrı bir işlem olarak çalışır ve yazılı bir işlem kümesi sunar: "Şu Notion sayfasını oku" veya "GitHub'da bir PR aç" gibi. Claude Code bu işlemleri işlev çağrıları gibi çağırır.

ECC, yaygın hizmetler için mcp-configs/mcp-servers.json içinde MCP yapılandırmalarıyla birlikte gelir: GitHub, Supabase, Vercel, Railway, Linear ve diğerleri. Her giriş, sunucuyu başlatma komutunu, gerekli ortam değişkenlerini ve ECC'nin ona uyguladığı güvenlik kurallarını içerir.

ECC'nin bunları otomatik olarak etkinleştirmediğini bilmekte fayda var.

Haziran 2026 MCP bağlayıcı politikası, varsayılan etkin sunucuları bire düşürdü (chrome-devtools). Diğer her şey tercihli. Girişi projenizin .mcp.json dosyasına kopyalarsınız veya Claude Code'un /mcp komutuyla etkinleştirirsiniz. Bunun nedeni kısmen pratiktir (uzun MCP araç adları bazı ağ geçitlerini bozar) ve kısmen güvenlik tercihidir (her MCP sunucusu potansiyel bir saldırı yüzeyidir).

Bu desteğin pratikteki karşılığı:

• Harici entegrasyonlar: GitHub girişini .mcp.json içine bırakın, bir belirteç verin ve Claude Code siz kopyala-yapıştır yapmadan sorunları okuyabilir, PR açabilir ve CI durumunu kontrol edebilir.
• Araç çağırma: Beceriler ve ajanlar MCP araçlarına adlarıyla referans verir. Örneğin, bir dağıtım becerisi Vercel MCP'yi çağırabilir ve bir veritabanı inceleme ajanı Supabase MCP'yi çağırabilir.
• Proje otomasyonu: MCP sunucularını kancalarla birleştirerek oturumlar arasında kalıcı otomasyon elde edebilirsiniz. PR-açıldı kancası, diff'i almak için GitHub MCP'yi ve bileti güncellemek için Linear MCP'yi kullanan bir inceleme ajanını başlatabilir.

ECC'nin paketlediği MCP'lerin kendi kopyalarınızı zaten çalıştırıyorsanız, ECC_DISABLED_MCPS değişkenini virgülle ayrılmış bir listeye ayarlayın. ECC kurulum ve eşitleme sırasında bunları atlar, böylece aynı sunucu adı için yarışan yinelenenler olmaz.

AgentShield ve Güvenlik Özellikleri

Güvenlik, ECC'yi rakiplerinden ayıran şeydir.

AgentShield, ECC ile gelen bağımsız bir güvenlik denetleyicisidir. Claude Code yapılandırmalarını güvenlik açıkları, yanlış yapılandırmalar, hatalar ve enjeksiyon riskleri için tarar. Ayrı bir npm paketi (ecc-agentshield) olarak çalışır, ancak /security-scan becerisi aracılığıyla ECC ile bağlıdır; böylece onu bir Claude Code oturumu içinden çalıştırabilirsiniz.

Tarama beş kategoriyi kapsar:

• Sırlar tespiti: Gömülü kimlik bilgileri, API anahtarları, belirteçler için 14 kalıp.
• İzin denetimi: her ajan ve becerinin hangi araçlara ve yollara erişebildiği ve bu yetkilerin fazla geniş olup olmadığı.
• Kanca enjeksiyonu analizi: kancaların keyfî komut çalıştırmak için istismar edilip edilemeyeceği.
• MCP sunucu risk profillemesi: her bağlı MCP sunucusunun neyi okuyabildiği, yazabildiği veya çağırabildiği ve bunun nerede riske yol açtığı.
• Ajan yapılandırması incelemesi: istem enjeksiyonu vektörleri, araç izin listesinde aşırı yetkilendirme, eksik kısıtlar.

Şu komutla çalıştırabilirsiniz, kurulum gerekmez:

npx ecc-agentshield scan

Çıktı, bir harf notu (A'dan F'ye) artı şiddete göre sıralanmış bulgular listesidir. Kritik bulgular 2 koduyla çıkar.

Bilmeniz gereken birkaç bayrak:

• -fix güvenli sorunlar için otomatik düzeltmeler uygular (açığa çıkmış sırları kaldırma, aşırı geniş izinleri daraltma…)
• -opus taramayı üç Claude Opus 4.X ajanı üzerinden kırmızı takım / mavi takım / denetçi hattında çalıştırır. Saldırgan istismar zincirleri bulmaya çalışır. Savunan korumaları değerlendirir. Denetçi her ikisini önceliklendirilmiş bir risk raporunda sentezler.
• -stream analizi canlı olarak akar; yavaş yapılandırmalarda kullanışlıdır.

Opus-hattı yaklaşımı, AgentShield'i genel bir linter'dan ayıran kısımdır. Düşmanca ajanlar, çoğu gerçek ajan saldırısının geldiği yer olan, bilinen-iyi bileşenleri birleştirerek istismar edilebilir yollar bulmaya çalışır.

Depoya göre AgentShield; %98 kapsamda 102 statik analiz kuralı ve 1.282 dahili test bildirir. Rakamların en son sürüme göre doğrulanmaya değer olduğunu, ancak bunun 50 satırlık bir betik olmadığının açıkça görülebildiğini unutmayın.

Çıktı biçimleri terminal (renk dereceli), JSON (CI için), Markdown ve HTML'dir. PR'larda AgentShield'i çalıştıran bir GitHub Action ve ayrı bir ECC Tools GitHub Uygulaması da vardır.

Claude Code'u üretimde kullanan çoğu ekip için, AgentShield; çerçevenin geri kalanını kullanmasanız bile ECC'yi kurmanın en somut nedenidir.

Everything Claude Code'un Kurulumu

ECC'nin iki kurulum yolu vardır.

En yaygın bozuk kurulum, eklenti kurulumunu manuel kurulumun üzerine yığmaktır. İkisi de aynı dosyaları aynı yerlere kopyalar ve yinelenenlerle karşılaşırsınız. Bu nedenle her şeyden önce: yalnızca bir yolu seçin.

Kurulumdan önce, Claude Code'un v2.1.0 veya sonrası kurulu olduğundan emin olun:

claude --version

Claude sürümü

Eklenti yöneticisi ile kurulum

Çoğu kullanıcı için önerilen yol budur.

Claude Code içinden şunları çalıştırın:

/plugin marketplace add https://github.com/affaan-m/ECC
/plugin install ecc@ecc

Eklenti kurulumu

İlk komut, ECC deposunu bir pazar yeri olarak kaydeder. İkincisi eklentiyi kurar.

Tek bir uyarı: eklenti sistemi kuralları dağıtmaz. Kurallar; her zaman uyulacak yönergelerdir (kodlama stili, git iş akışı, test standartları, dile özgü kalıplar) ve Claude Code'un eklenti özellikleri bunlarla gelmez. Eklenti kurulumundan sonra bunları elle kopyalarsınız.

git clone https://github.com/affaan-m/ECC.git
cd ECC
mkdir -p ~/.claude/rules/ecc
cp -r rules/common ~/.claude/rules/ecc/
cp -r rules/python ~/.claude/rules/ecc/

rules/common ile gerçekten kullandığınız bir dil paketini kopyalayın. Yukarıdaki örnekte Python kurallarını kopyaladım. Her şeyi kopyalamayın; daha fazla kural, her oturuma daha fazla bağlamın yüklenmesi demektir ve çoğu projenize uygulanmayacaktır.

Yapılandırma dosyaları ile kurulum

Tam kontrol istiyorsanız veya eklenti kurulumu ortamınızda çalışmıyorsa bu yaklaşımı kullanın.

git clone https://github.com/affaan-m/ECC.git
cd ECC
npm install
./install.sh --profile full

Windows üzerinde:

.\install.ps1 --profile full
# or
npx ecc-install --profile full

Bu, ajanları, becerileri, komutları, kancaları ve kuralları ~/.claude/ dizininize kopyalar. Eklenti katmanı yoktur. Her şey Claude Code'un oturum başında okuduğu disk üzerindeki dosyalar olarak yaşar.

Bilmeniz gereken birkaç profil seçeneği:

• -profile minimal: Yalnızca kurallar, ajanlar, komutlar ve çekirdek beceriler, kancalar olmadan.

• -profile core: Varsayılan çalışma seti. Kancalar dahildir.

• -profile full: Depodaki her şey.

Ayrıca belirli bileşenleri --modules veya --with ile kurabilirsiniz:

./install.sh --target claude --modules hooks-runtime
npx ecc install --profile minimal --target claude --with capability:machine-learning

Hangi bileşenlerin işinize uyduğundan emin değilseniz, paketlenmiş danışmana sorun:

npx ecc consult "security reviews" --target claude

Eşleşen bileşenleri ve tam kurulum komutlarını döndürür.

Kurulumu doğrulama

Nelerin kurulduğunu kontrol edin:

/plugin list ecc@ecc

Eklenti kurulumunun doğrulanması

Bu, eklentiden kullanılabilir ajanları, komutları ve becerileri gösterir. Manuel kurulumlar için yaşam döngüsü sarmalayıcısını kullanın:

node scripts/ecc.js list-installed
node scripts/ecc.js doctor

doctor eksik dosyaları, bozuk kancaları ve sürüm uyumsuzluklarını kontrol eder. Bir şey işaretlerse şunu çalıştırın:

node scripts/ecc.js repair

Claude Code'un yeni eklentiyi gördüğünü doğrulamak için bir oturum açın ve bir eğik çizgi komutunu deneyin:

/ecc:plan "Add user authentication"

ECC plan çıktısı

Eklenti kurulumu için ad alanlı /ecc: öneki zorunludur. Manuel kurulum için kısa biçim (/plan) çalışır.

Bir şey yinelenmiş veya bozuk görünüyorsa, üstüne yeniden kurmayın. Önce node scripts/uninstall.js --dry-run çalıştırarak nelerin kaldırılacağını görün, ardından temizlemek için node scripts/uninstall.js çalıştırın. ECC yalnızca kendi kurduğu dosyaları kaldırır, ilgisiz yapılandırmalar değişmeden kalır.

Beceriler, Komutlar ve İş Akışlarıyla Çalışmak

ECC'de yaptıklarınızın çoğu komutlar yerine beceriler üzerinden yürür.

Bunun nedeni, commands/ klasörünün geriye dönük uyumluluk için hâlâ sürdürülmesi, ancak yeni iş akışı geliştirmesinin öncelikle skills/ içinde yer almasıdır.

Günlük işinizin çoğunu kapsayacak birkaç kullanım deseni:

Beceri çağırımı çoğunlukla örtüktür

Genelde bir beceriyi adıyla çağırmazsınız. İstediğinizi tarif edersiniz ve Claude Code uygun beceriyi seçer. "Önce başarısız bir test yaz" derseniz tdd-workflow becerisi etkinleşir. Yüklenen becerileri yanıtta görürsünüz.

Açık olmak istediğinizde istemde beceriye referans verin: "Yeni uç noktayı eklemek için django-tdd becerisini kullan." Ya da onu saran bir komut çalıştırın:

/code-review
/security-scan

/ecc:plan "Add OAuth login"

/ecc: öneki eklenti kurulumlarında zorunludur. Manuel kurulumlar kısa biçimi kullanır (/plan, /code-review).

ECC planlama aşaması çıktısı

Dosya hedefleme iş akışının bir parçasıdır

Çoğu ajan ve beceri belirli bir kapsamda çalışır: bir dosya, bir dizin, bir diff, bir PR. İstemde dosyadan bahsederek, çağırmadan önce düzenleyicinizde açarak veya ajana bir yola işaret ederek kapsam belirlersiniz:

/code-review src/auth/
/python-review services/billing/payment.py

Ajan kapsamı alır, yalnızca ihtiyaç duyduğu dosyaları yükler ve kendi bağlam penceresinde çalışır.

Kabuk entegrasyonu Claude Code'un bash aracı üzerinden çalışır

Beceriler, testleri çalıştırma, derleme, lint etme veya bir CLI çağırma gibi gerçek yürütme gerektiren her şey için kabuk komutları çalıştırabilir. TDD becerisi pytest veya go test çalıştırır. Derleme-düzeltme ajanı, gerçek hataları görmek için gerçek derlemeyi çalıştırır. Güvenlik taraması becerisi npx ecc-agentshield scan komutunu çalıştırır ve çıktıyı ayrıştırır.

Beceri, hangi kabuk komutlarının ne zaman çalışacağını tanımlar. Kancalar da araç olaylarında kabuk komutları çalıştırabilir (her düzenlemeden sonra bir tür kontrolü çalıştırmak, kaydetmeden önce console.log konusunda uyarmak gibi).

MCP yönetimi çoğunlukla tercihe bağlıdır

Kurulumdan sonra ECC varsayılan olarak tam bir MCP sunucusu etkinleştirir (chrome-devtools). Daha fazlasını eklemek için mcp-configs/mcp-servers.json içinden girdileri projenizin .mcp.json dosyasına kopyalayın, sonra Claude Code'un /mcp komutuyla etkinleştirin. /mcp arayüzü etkinleştirme, devre dışı bırakma ve yeniden kimlik doğrulamayı yönetir.

ECC'nin paketlediği MCP sunucularının kendi kopyalarını çalıştırıyorsanız şunu ayarlayın:

export ECC_DISABLED_MCPS="github,supabase"

ECC'nin yükleyici ve eşitleme akışları bunları atlar; böylece aynı araç adları için yarışan iki aynı sunucuya sahip olmazsınız.

İş akışları birbirine zincirlenir

Becerileri tek tek çalıştırmazsınız. Tipik bir özellik iş akışı şöyle görünür:

/ecc:plan "Add OAuth login with Google"
# planner agent writes a blueprint

# tdd-workflow skill activates as you implement
# tests fail, code gets written, tests pass

/code-review
# code-reviewer agent audits the diff

/security-scan
# AgentShield checks the new code and config

Her adım, taze bir bağlam penceresinde farklı bir ajan kullanır. Ana oturum koordine eder ve oturum özeti, zinciri sonunda yakalar, bir sonraki oturuma hazırlar.

Everything Claude Code vs Rakip Yapılandırma Çerçeveleri

ECC, Claude Code için tek yapılandırma katmanı değildir. Diğerleri benzer görevleri farklı ödünlerle yapar.

Önce kategoriyi netleştirmekte fayda var. ECC, Claude Code'un üzerinde oturan diğer yapılandırma çerçeveleriyle rekabet eder. Yanında çalıştığı kuşamlarla (Cursor, Codex, OpenCode, Zed) veya bağımsız ajan platformlarıyla (OpenHands, LangGraph, CrewAI) rekabet etmez; bunlar farklı araç kategorileridir.

En sık üç rakip gündeme gelir.

BMAD-Method, uzman rol tabanlı ajanlara (Analist, PM, Mimar, Scrum Master, Geliştirici, QA) sahip çevik SDLC çerçevesidir. npx bmad-method install ile Claude Code, Cursor ve Windsurf'te çalışır. Belirsiz bir fikri koda başlamadan önce PRD'ye, mimari dökümana ve parçalanmış hikâyelere dönüştürdüğü için başlangıç planlama aşamasında parıldar. Yürütme araç seti ECC'ninkinden daha hafiftir. Güvenlik tarayıcısı ve MCP kataloğu yoktur. Dile özgü kalıplar daha azdır.

SuperClaude hafif bir Markdown tabanlı yapılandırma çerçevesidir. Yaklaşık 30 eğik çizgi komutu, 20 ajan ve birkaçı davranış modu. pip install SuperClaude ile kurulur. Tasarım gereği ECC'den daha basittir; güvenlik taraması ve orkestrasyon çalışma zamanı yoktur. Ancak Claude Code'un sunduğu dışında yerleşik bir bellek katmanı da yoktur. Çalışan bir CLAUDE.md ile iyi test edilmiş bir istem seti istiyorsanız, SuperClaude iyi bir seçimdir.

claude-flow / Ruflo (2026 başında Claude Flow'dan yeniden adlandırıldı) çok ajanlı sürü orkestratörüdür. SPARC metodolojisini (spesifikasyon, sözde kod, mimari, iyileştirme, tamamlama) kullanır ve paralel olarak 60-100+ uzman ajanlı kraliçe liderli hiyerarşiler çalıştırır. AgentDB ile kalıcı belleğe sahiptir ve Claude, GPT, Gemini ve Ollama üzerinde çalışır. Altyapısı ECC'ye göre daha ağırdır ve tek oturum verimliliğinden ziyade paralel ajan çalışması için inşa edilmiştir.

Karar vermeden önce daha fazla seçeneği incelemek isterseniz, awesome-claude-code, Claude Code kaynaklarının (ajanlar, beceriler, eklentiler, MCP sunucuları, yapılandırmalar) küratörlüğünü yapan bir dizindir. Topluluk keşiflerinin çoğu burada gerçekleşir.

Özetle, çevik tarz planlama istiyorsanız BMAD'i, hafif bir yapılandırma katmanı istiyorsanız SuperClaude'u, paralel çok ajanlı çalışma gerekiyorsa Ruflo'yu ve yerleşik güvenlik araçları ve bellek kalıcılığıyla eksiksiz bir mühendislik platformu istiyorsanız ECC'yi seçin.

Everything Claude Code'u Kimler Kullanmalı?

ECC herkes için değildir. Claude Code'u haftada birkaç kez küçük görevler için kullanıyorsanız, çerçeve çok az getirisi olan fazla bir yük gibi hissettirecektir. Tek bir 100 satırlık CLAUDE.md, gerçekten ihtiyaç duyduğunuzun çoğunu karşılar.

ECC, bu noktayı aştığınızda karşılığını verir.

İşte sade Claude Code'dan daha iyi uyduğu senaryolar:

• Ajan sistemleri geliştiren yapay zekâ mühendisleri: Ajan iş akışları tasarlıyor veya dağıtıyorsanız, ECC çalışan bir referanstır. Ajan istemlerini, beceri tanımlarını, kanca yapılandırmalarını okuyun ve işe yarayanı ödünç alın.
• Geliştirici üretkenliği meraklıları: Araçlarınıza, dotfile'larınıza, düzenleyici kurulumunuza, kabuğunuza zaman harcıyorsanız, ECC Claude Code için aynı türden bir yatırımdır. Çok kullanırsanız en fazla verimi alırsınız.
• Claude Code'u günlük altyapı olarak kullanan ekipler: Ekibiniz her gün kod inceleme, planlama, yeniden düzenleme veya özellik gönderimi için Claude Code kullanıyorsa, tutarlılık ve işe alıştırmadaki zaman tasarrufu birikir. Yeni ekip üyeleri aynı ajanları ve aynı iş akışlarını alır.
• Karmaşık ajan iş akışları oluşturan herkes: Çok adımlı hatlar, alt ajan orkestrasyonu, MCP zincirleme, kalıcı bağlam gibi. ECC bunların çoğunu zaten çözdü ve kalıplar, tamamını kurmasanız bile yeniden kullanılabilir.

ECC'yi seçmemesi gerekenler:

• Gündelik Claude Code kullanıcıları: Haftada birkaç oturumluk "şu betiği hata ayıklamama yardım et" için 60+ ajan, 260+ beceri ve bir bellek katmanı gerekmez. Kurulum yükü değmez.
• Basit, tek seferlik kodlama görevleri: Hızlı betikler, küçük düzeltmeler, demo uygulamalar, atılacak prototipler. Sade Claude Code bunları iyi idare eder; ECC eklemek çok az değerle sürtünme katar.
• Zaten çalışan bir kuruluma sahip ekipler: CLAUDE.md dosyanız ayarlı ve iş akışınız istikrarlıysa, ECC'ye geçmek geçiş zamanı gerektirir. Beğendiğiniz parçaları ödünç alın, gerisini bırakın.

Nerede durduğunuzdan emin değilseniz, güvenli hamle depoyu okumak, ilginç bulduğunuz iki veya üç ajan ve beceriyi kopyalamak ve şimdilik tam kurulumu atlamaktır.

ECC'nin Avantajları ve Sınırlamaları

Şimdi ECC'nin birkaç güçlü ve zayıf yönünü anlatacağım. Karar vermeden önce ikisini de bilmeye değer.

Avantajlar

• Büyük beceri kütüphanesi: TDD, güvenlik denetimleri, çerçeve kalıpları, dil deyimleri, ML mühendisliği, dağıtım ve daha fazlasını kapsayan yaklaşık 260 beceri. Hiçbir şey kurmasanız bile depo, iyi beceri tanımları yazmanın çalışan bir referansıdır.
• İş akışı yeniden kullanımı: Kod inceleme, planlama, yeniden düzenleme ve test için test edilmiş istemler elde edersiniz. Özellikle kod inceleyici ajan, ECC kullanmayan ama istemi ödünç alan kişilerce sıkça anılır.
• Kalıcı bellek: Oturum özetleri ve oturumlar arası bağlam gibi şeyler kutudan çıkar çıkmaz çalışır. Diğer çoğu Claude Code yapılandırması belleği hiç ele almaz.
• Güçlü MCP desteği: GitHub, Supabase, Vercel, Railway ve diğerleri için önceden oluşturulmuş yapılandırmalar.
• AgentShield: Yalnız başına güvenlik tarayıcısı, başka hiçbir şey kullanmasanız bile ECC'yi kurmak için bir neden. Diğer çok az Claude Code yapılandırmasında buna yakın bir şey var.
• MIT altında açık kaynak: Çekirdekte ücret duvarı yok. Barındırılan GitHub Uygulaması ve ECC Pro katmanı ayrıdır.
• Çapraz platform: Claude Code, Cursor, Codex, OpenCode, Zed, Gemini ve diğerleriyle çalışır. Değiştirir veya birkaçını birden kullanırsanız, yine aynı ajan ve becerileri kullanabilirsiniz.

Sınırlamalar

• Öğrenme eğrisi: 60+ ajan, 260+ beceri, üç kurulum yolu, dört profil türü ve bir dizi ortam değişkeni. İlk hafta çoğunlukla neyin yüklendiğini ve her bileşenin ne yaptığını çözmekle geçer.
• Kurulum karmaşıklığı: Eklenti vs. manuel kurulum, eklentiyle kuralların dağıtılmaması, eski Claude Code sürümlerinde yinelenen kancalar sorunu, MCP etkinleştirme/devre dışı bırakma akışları, çoklu kuşam kullanımı için ajan veri kökü değişkeni. Çoğu belgelenmiştir ama yine de epey iş.
• Bakım yükü: Depo düzenli güncellenir. Katalog sayıları sürümler arasında değişir ve beceri adları güncellenir.
• Claude Code ekosistemine bağımlılık: ECC, Claude Code'un eklenti özelliklerine, kanca sistemine ve MCP desteğine dayanır. Claude Code bunları değiştirdiğinde ECC de uyum sağlamak zorundadır.
• Birçok kullanım durumu için aşırı mühendislik: Çoğu ekip için, iyi yazılmış 60-200 satırlık bir CLAUDE.md, ECC'nin sunduğunun %80'ini kapsar. Kalan %20 değerlidir, ama ancak kullanırsanız.

Çerçeve, şu anda mevcut en eksiksiz Claude Code yapılandırma katmanıdır. Ancak "en eksiksiz" ve "herkes için gerekli" aynı şey değildir.

Sonuç

Claude Code'u her gün kullanıyorsanız, ECC'ye göz atmaya değer. Kullanmasanız bile, pratikte dağılan değil çalışan ajan iş akışlarının nasıl kurulacağına dair çalışan bir referans olarak depo okumaya değerdir.

Her iki durumda da ECC, yazılım geliştirmenin tek atımlık sohbet oturumları yerine programlanabilir ajan hatlarına doğru ilerlediğinin açık bir göstergesidir. Bunu iyi yapmanın çerçeveleri hâlâ yenidir ve ECC bugüne kadarki en eksiksiz girişimlerden biridir. Sonuncusu olmayacak ve asıl mesele de budur.

Jeneratif yapay zekâya ve ajan temelli kodlamaya yeniyseniz, Generative AI Concepts kursumuza kaydolun. Gelecek için güçlü bir temel sağlar.