Vibe coding günümüzde oldukça popüler hale gelen trend oldu. Fakat hala istenen noktaya gelmiş durumda değil. Bu repo, LLM’lerin en büyük zayıflığı olan halüsinasyon sorununu yapılandırılmış bir mühendislik disipliniyle çözüyor
Anthropic’in Hackathon birincisinden çıkan Everything Claude Code ile kodlama AI’larına adeta bir orkestra şefliği yaparak, beyin görevini görüyor.
Neyi Çözüyor?
ECC (Everything Claude Code) temelde 4 soruna odaklanıyor:
- Context Loss (Bağlam Kaybı): Uzun ve büyük projelerde AI’ların, proje başındaki kararları unutması veya saçmalaması.
- Yüksek Maliyet ve Yavaşlık: Bağlamsallığı unutan AI agentlar, tekrara düşerek gereksiz token gönderimi yapar ve bu yüzden artan API harcamaları.
- Güvenlik Riskleri: AI’ların bazen proje içerisinde güvensiz ve eski kütüphaneleri önermesi ve bu yüzden güvenlik açıklarının oluşması.
- Tekrarlanan Hatalar: Bağlamsallığı unutan AI’lara sürekli hatırlatma yapma zorunluluğu.
Nasıl Yapar?
Elimizde stajyer bir AI aracı var. Bu repo ile ajanımızın yanına bir nevi “Test Mühendisi“, “Kıdemli Yazılım Mimarı“, “Güvenlik Uzmanı” gibi 28 adet farklı sub-agentlar ekleyebiliyoruz. Projeyi de bu sub-agentlara bölerek aynı anda kod yazdırırken, yazdırdığımız kodunda güvenlik açıklarını taratabilirsiniz. Buna uzmanlaşmış ajanlar diyebiliriz.
Proje için verdiğiniz direktifleri de instinct (iç görü) olarak kaydediyor ve sizin projeye yaklaşımınızı, hedeflerinizi ve proje kurallarınızı öğreniyor. Böylece her seferinde AI’ın hatalarını düzeltmek zorunda kalmıyorsunuz. Buna da akıllı hafıza diyebiliriz.
Uzmanlaşmış ajanlar ve bu ajanlardaki akıllı hafıza sayesinde API maliyetlerinizi düşürerek; performans kazancının yanı sıra, kodlarınızın otomatik kontrolünü sağlayabiliyorsunuz.
Teknik Mimari ve Mekanizmalar
Teknik olarak Everything Claude Code; LLM tabanlı vibe coding araçları için bir Harness Performance Optimization System yani bir Donanım Performans Optimizasyon Sistemi olarak çalışıyor:
- Multi Agent Orchestration (Çoklu Ajan Orkestrasyonu): ECC ile beraber, yukarıda bahsettiğim gibi 28’den fazla spesifik sistem promptunu barındırıyor. Bunlar planner.md, architect.md, security-reviewer.md gibi dosyalarla tanımlıyor. Böylece karmaşık görevleri de sub-agentlara bölerek, sistemin halüsinasyon görmesini de engelliyor.
- Token Management & Token Optimization: system prompt sliming ve background process yöntemleri ile context window verimini artıyor. Bu da gereksiz komutların modellere gönderilmesini engelleyen bir filtreleme mekanizması sunuyor.
- Even-Driven Hooks: Git veya IDE (Cursor, OpenCode vb.) olaylarına bağlı çalışan hooks sayesinde; her kayıt veya commit öncesinde AgentShield üzerinden statik analiz ve güvenlik taraması gerçekleştirilir.
- Instinct Based Learning: Kullanıcı etkileşimlerinden elde edilen başarımlar, birer skill veya instinct dosyasına dönüştürülür ve kalıcı hale gelir. Böylece projeler zero shot yerine fine tuned context olarak çalışmasını sağlar.
- Cross Harness Parity: Yazılan kural setleri ve komutlar; Claude Code, Antigravity, Cursor ve Codex gibi farklı AI geliştirme ortamlarının aynı anda çalışabilecek şekilde optimize eder.
Node.js tabanlı hooklar sayesinde Linux, Powershell ve macOS üzerinde tutarlı bir performans gösteren ECC; npm, pnpm, bun gibi paket yöneticilerini de otomatik olarak tespit ediyor.
Kullanım Şekli
Bir özellik eklemek istediğinizde /plan komutunu sisteme verdiğinizde sistem önce architect ajanını çağırır, proje planı oluşturulduktan sonra planner ile proje planı çıkartılır. Sonrasında tdd-guide ile test ortamlarını oluşturur ve en son code-reviewer ile kalite kontrolünü gerçekleştirir. Böylece süreç otomatikleşir.
Temel Komutlar
Planlama
- plan: Yeni bir özellik veya hata düzenlemesi için kapsamlı bir uygulama planı oluşturur.
- execute: Oluşturulan planı adım adım uygular ve kod değişikliklerini yapar.
- tdd: Test odaklı geliştirme sürecini başlatır. Önce testleri yazar, sonra kod geliştirmeye başlar.
- refactor: Mevcut kodları temizler. Ölü kodları temizleyerek performans artışı sağlar.
- docs: Kod tabanına göre dokümantasyon oluşturur veya var olanı günceller.
Güvenlik ve Kalite Kontrol
- security-scan: Kod tabanını CVE’ler ve aygın güvenlik zafiyetlerini AgentShield entegrasyonu sayesinde tarar.
- review: Değişiklikleri kalite, performans ve best practice açısından inceler.
- harness-audit: Mevcut AI konfigürasyonunuzu ve kurallarınızın performansını denetler.
- quality-gate: Belirlenen kalite standartları karşılanmadan kodun ilerlemesine izin vermez.
Çoklu Ajan ve Otomasyon
- loop-start: Belirli bir görev için otonom çalışma döngüsünü başlatır.
- loop-status: Devam eden otonom süreçlerin durumunu listeler.
- pm2: Arkaplanda çalışan servisleri ve süreçleri yönetir.
- multi-plan: Birden fazla servis veya mikroservis içeren karmaşık süreçleri yönetir.
Hafıza ve Öğrenme
- instinct-import: Başarılı kod kalıplarını ve kurallarını AI’ın içgüdü dosyasına ekler.
- sessions: Geçmiş çalışma ortamlarınızı listeleme ve geri yüklemenizi sağlar.
- setup-pm: Proje için tercih edilen paket yöneticinizin seçmenizi sağlar.
- codex-setup: OpenAI’ın Codex CLI ile ilgili uyumluluk dosyasını oluşturur.
Kurulum ve Yapılandırma
- configure-ecc: ECC’nin kurulum sihirbazını başlatır. Dilleri ve kuralları oluşturur.
- plugin install: ECC eklentisini Claude Code üzerine kurar.
- model-route: Görev zorluğuna göre AI modelini otomatik olarak seçmenizi sağlar.
İlgili repo: https://github.com/affaan-m/everything-claude-code
