by komunite
Claude Code için Türkçe profesyonel işletim sistemi — 10 uzman agent, 22 komut, 993 skill, 6 katmanlı hafıza
# Add to your Claude Code skills
git clone https://github.com/komunite/kalfaBu araç, Claude Code ile daha düzenli ve üretim kalitesinde çalışma yapmanıza yardımcı olur. Bunu hafıza katmanları, uzman agent'lar, tekrar kullanılabilir skill'ler, komut ritüelleri ve güvenlik hook'ları ile yapar; böylece farklı projelerde tutarlı çıktı alabilirsiniz.
Proje durumu: aktif olarak geliştiriliyor
| Bileşen | Sayı | Açıklama | |---------|------|----------| | Skill'ler | 994 | 16 kategoride yapılandırılmış operasyonel prosedürler | | Agent'lar | 10 | Kalıcı hafızaya sahip uzman alt-agent'lar | | Komutlar | 22 | İş akışı ritüelleri ve araçlar | | Hook'lar | 9 | Deterministik güvenlik kontrolleri | | Hafıza | 6 katman | Oturumlar arası bağlam koruma |
Kalfa; Claude Code kullanıcıları, bireysel üreticiler ve küçük ekipler için tasarlanmıştır. Amaç, kullanıcıların günlük çalışma akışını standartlaştırmak, kaliteyi korumak ve bağlam kaybını azaltmaktır.
Kalfa, .claude/commands içindeki komutlar, .claude/hooks içindeki otomasyon kontrolleri ve .claude/skills içindeki operasyonel skill kütüphanesi ile çalışır. memory.md, knowledge-base.md ve görev dosyalarını okuyarak o anki bağlamı toplar ve bunu bir sonraki doğru adıma dönüştürür. Teknik detaylar için Geliştirici dokümantasyonu bölümüne bakın.
Bu araç, Claude Code'un yerine geçen bağımsız bir uygulama değildir. Kendi web arayüzü, backend servisi veya tek başına çalışan bir API ürünü sağlamaz.
No comments yet. Be the first to share your thoughts!
Ayrıca bu araç, harici servis hesaplarını sizin adınıza otomatik açmaz veya özel entegrasyonları sıfır eforla garanti etmez; gerekli erişim ve yapılandırmaları sizin sağlamanız gerekir.
Bu aracı kullanmadan önce şunlara aşina olmanız faydalıdır:
Sizde bulunması gerekenler:
jq kurulumu (hook doğrulamaları için)npx ile tek seferlik kullanım (önerilen)Kalfa'yı hedef projenize tek komutla kurabilirsiniz:
npx @komunite/kalfa init
Farklı bir dizine kurmak için:
npx @komunite/kalfa init --target /proje/dizini
[!NOTE]
--targetile verdiğiniz dizin mevcut olmalıdır.
Mevcut dosyaların üzerine yazmak için:
npx @komunite/kalfa init --force
[!WARNING]
--forcemevcut dosyaların üzerine yazar.
Yalnızca ne yapılacağını görmek için:
npx @komunite/kalfa init --dry-run
[!TIP]
--dry-runhiçbir dosyaya yazmaz, yalnızca yapılacak işlemleri gösterir.
npm i -g @komunite/kalfa
kalfa init
Yardım menüsü:
kalfa --help
.claude/ klasörünün mevcut olduğunu doğrulayın.CLAUDE.md dosyasının bulunduğunu kontrol edin..claude/workspace/TaskBoard.md dosyasının erişilebilir olduğundan emin olun./start komutunu çalıştırın./sync çalıştırın./clear kullanın.
/wrap-up ile kapanış yapın./audit çalıştırın./review çalıştırın.
/release ve /handoff kullanın..claude/skills/INDEX.md dosyasından ilgili skill'i bulun.Hook'lar çalışmıyor veya eksik davranıyor
jq --version ile jq kurulumunu doğrulayın.settings.json kaynaklı hatalar alınıyor
.claude/settings.json dosyasını jq . .claude/settings.json ile doğrulayın.Uzun oturumlarda kalite düşüyor
/clear komutunu çalıştırıp bağlamı yeniden yükleyin.https://github.com/komunite/kalfa/issuesKalfa; Claude Code komut dosyaları, shell hook'ları ve hafıza dosyaları üzerinde çalışan bir operasyon katmanıdır. Kritik kontroller, .claude/hooks/*.sh script'leri ile uygulanır; iş akışları ise .claude/commands/*.md üzerinden yönetilir.
.claude/commands/ dizini günlük çalışma ritüellerini ve operasyon komutlarını içerir..claude/hooks/ dizini güvenlik, loglama ve bütünlük denetimlerini içerir..claude/agents/ dizini uzman agent tanımlarını içerir..claude/skills/ dizini kategori bazlı skill kütüphanesini içerir.Geliştirme ortamını hazırlama:
git clone https://github.com/komunite/kalfa.gitcd kalfaKurulum:
npm installnpm run lint:md komutunun çalıştığını doğrulayın.Yapılandırma:
.claude/settings.json dosyasını proje ihtiyaçlarınıza göre düzenleyin.memory.md, knowledge-base.md ve .claude/workspace/TaskBoard.md dosyalarını proje bağlamıyla güncelleyin.Yerelde çalıştırma:
claude başlatın./start, /sync, /wrap-up akışlarını çalıştırın.Testleri çalıştırma:
npm run lint:mdnpm run lint:md:fixnpm testnpm run test:watchKatkı hazırlarken, mevcut repo durumunda doğrulanmış asgari yerel kontroller npm run lint:md ve npm test komutlarıdır.
Mevcut test seti tests/ dizinindedir ve şunları doğrular:
tests/smoke.test.js
tests/cli.integration.test.js
--help) doğrular.help alias davranışını doğrular.init --dry-run çıktısını doğrular.init ile temel dosyaların hedef dizine kopyalandığını doğrular.npm run pack:preview@komunite/kalfa için GitHub repo komunite/kalfa bağlayın..github/workflows/npm-publish.yml seçin.workflow_dispatch ile sınırlıdır ve job varsayılan olarak if: false korumasıyla devre dışıdır; yayın öncesinde .github/workflows/npm-publish.yml dosyasını gözden geçirip etkinleştirin.npm version patch (veya minor / major)git push --follow-tagsTAMLIK KAPISI engeli alınıyor
TODO, TBD, FIXME gibi yer tutucuları kaldırın ve formatı düzeltin.Hook script çalışmıyor
.claude/hooks/*.sh dosyalarının çalıştırılabilir izinlerini kontrol edin.Kalfa bakımcıları katkıları memnuniyetle karşılar.
Katkıdan önce topluluk beklentileri için Code of Conduct dosyasını okuyun. Depodaki mevcut yapı ve yazım standartlarını takip edin.
main üzerinden yeni bir branch oluşturun.npm run lint:md çalıştırın.npm test çalıştırın.Kalfa'nın geliştirilmesine katkı veren Komünite ekibine ve tüm katkıcılara teşekkür ederiz.
Bu proje MIT lisansı ile lisanslanmıştır. Detaylar için LICENSE dosyasına bakın.