Tek Komutla 13 Farklı AI Kod Asistanına Proje Tanıtımı

AI destekli kodlama araçlarıyla çalışırken en sık karşılaşılan sorunlardan biri, her araç için farklı isim ve formatlarda proje bağlam dosyaları hazırlamak zorunda kalmaktır. Bu durum, hem zaman kaybına yol açar hem de proje yapısında değişiklik olduğunda dosyaların güncel kalmasını sağlamak adeta bir kâbusa dönüşür.

Ancak artık bu soruna basit bir çözüm var: `claude-init` aracı sayesinde projenizin tüm bağlam dosyalarını otomatik olarak oluşturabilir, güncel tutabilir ve hatta entegrasyon testlerine dahil edebilirsiniz. Peki bu araç nasıl çalışıyor ve hangi avantajları sunuyor?

Proje Bağlam Dosyalarınızı Sıfırdan Oluşturun

AI kodlama asistanları, projenizi anlamak için genellikle özel birer bağlam dosyası talep eder. Örneğin, Claude Code CLAUDE.md, Cursor .cursor/rules kullanırken, Gemini GEMINI.md dosyasını bekliyor. Diğer popüler araçlar olan Copilot, Aider, Windsurf, Cline, Continue, Kilo Code, Trae, Junie ve Warp için de farklı isim ve yapılandırmalarda dosyalar hazırlamanız gerekiyor.

Bu dosyaların her biri, projenizin dili, çerçevesi, paket yöneticisi, komut dosyaları, dosya ağacı, ortam değişkenleri ve diğer önemli ayrıntıları hakkında bilgi içeriyor. Ancak manuel olarak oluşturmak ve güncel tutmak, özellikle de geliştirme sürecinde sık sık değişiklikler yapıldığında neredeyse imkansıza yakın bir hal alıyor.

İşte tam bu noktada `claude-init` devreye giriyor. Bu araç, projenizin deposunu tek bir komutla tarayarak, desteklediği tüm AI kodlama araçları için uygun bağlam dosyalarını otomatik olarak oluşturuyor.

Kolay Kurulum ve Kullanım

Aracı kullanmak için sadece terminalinizde aşağıdaki komutu çalıştırmanız yeterli:

npx @horiastanxd/claude-init

Bu komut, projenizin dilini, kullandığınız çerçeveyi, paket yöneticisini, komut dosyalarını, dosya ağacını, .env.example dosyasından ortam değişkenlerini ve diğer önemli ayrıntıları otomatik olarak algılıyor. Ardından, desteklenen tüm AI kodlama araçları için gerekli bağlam dosyalarını oluşturuyor.

Dosyalarınızı Sürekli Güncel Tutun

Proje bağlam dosyalarının en büyük problemi, sürekli güncel kalma zorunluluğudur. Projenizde yapılan bir değişiklik, bu dosyaların da güncellenmesini gerektirir. Manuel olarak bu işlemi gerçekleştirmek hem zaman alıcı hem de hata yapmaya açık bir süreçtir.

`claude-init`, bu soruna da etkili bir çözüm sunuyor. check modunu kullanarak, projenizin mevcut bağlam dosyaları ile deposunu karşılaştırabilir ve herhangi bir uyumsuzluk durumunda sizi uyarabilirsiniz. Bu komutu aşağıdaki şekilde kullanabilirsiniz:

npx @horiastanxd/claude-init check

Bu komut, projenizin bağlam dosyalarını sanal ortamda yeniden oluşturur ve mevcut dosyalarla karşılaştırır. Eğer herhangi bir farklılık tespit edilirse, araç sıfırdan bir çıkış kodu ile sonlandırılır. Bu sayede, bağlam dosyalarınızın her zaman güncel kalmasını sağlayabilirsiniz.

CI/CD ve Pre-commit Entegrasyonu

check modunu, CI/CD pipeline'larınıza veya pre-commit hook'larına entegre ederek, otomatik olarak dosyalarınızın güncel kalmasını sağlayabilirsiniz. Örneğin, GitHub Actions kullanıyorsanız, iş akışınıza aşağıdaki adımları ekleyebilirsiniz:

- name: Proje bağlam dosyalarını kontrol et
  run: npx @horiastanxd/claude-init check

Bu sayede, her commit veya pull request sonrasında dosyalarınız otomatik olarak kontrol edilir ve herhangi bir uyumsuzluk durumunda süreç durdurulur.

MCP Sunucusu ile AI Asistanlarınızı Güçlendirin

claude-init, sadece yerel kullanımla sınırlı kalmıyor. Aynı zamanda bir MCP sunucusu olarak da çalışabiliyor. Bu sayede, AI ajanlarınızın doğrudan projenizi analiz ederek kendi bağlam dosyalarını oluşturmasını sağlayabilirsiniz.

MCP sunucusunu etkinleştirmek için aşağıdaki komutu kullanabilirsiniz:

claude mcp add claude-init -- npx @horiastanxd/claude-init --mcp

Bu özellik, özellikle otomatikleştirilmiş geliştirme süreçlerinde büyük kolaylık sağlıyor.

Desteklenen Diller ve Özellikler

claude-init, oldukça geniş bir dil ve çerçeve desteğine sahip. Aşağıdaki dillerde ve paket yöneticilerinde projelerinizi destekliyor:

• JavaScript/TypeScript: npm, pnpm, yarn, bun
• Python: pip, uv, poetry
• Rust
• Go
• Java: Maven, Gradle
• Ruby
• PHP

Ayrıca, monorepo projelerini desteklemek için --recurse komutunu kullanabilirsiniz. Bu özellik, npm/pnpm workspaces gibi yapıları olan projelerde de bağlam dosyalarını otomatik olarak oluşturmanıza olanak tanır.

Araç, MIT lisansı altında yayınlanmaktadır ve açık kaynaklıdır. GitHub deposuna aşağıdaki bağlantıdan ulaşabilirsiniz.

Geliştiriciler, aracın desteklediği dosya türlerini ve özellikleri genişletmek için önerilerde bulunabilirler. Gelecekte hangi yeni özelliklerin eklenebileceği konusunda topluluk görüşlerine açık olan proje, sürekli olarak gelişmeye devam ediyor.

AI destekli geliştirme araçlarının sayısı her geçen gün artarken, proje bağlam dosyalarını yönetmek artık karmaşık bir süreç olmaktan çıkıyor. claude-init sayesinde, bu dosyaların oluşturulması ve güncellenmesi artık sadece bir komut kadar basit hale geliyor.