Bu 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
Metrikler
| 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 |
Temel işlevler
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.
Kalfa ne yapmaz
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.
The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
First-time install walkthrough for Claude Code, Codex CLI, and ChatGPT.
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.
Önkoşullar
Bu aracı kullanmadan önce şunlara aşina olmanız faydalıdır:
Claude Code temel kullanım akışı
Git ve Markdown temelleri
Sizde bulunması gerekenler:
Claude Code kurulumu ve aktif Anthropic planı
jq kurulumu (hook doğrulamaları için)
Terminal erişimi olan bir işletim sistemi (macOS, Linux veya Windows)
Proje klasöründe dosya yazma yetkisi
NPM paketi kullanımı
1. 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]
--target ile verdiğiniz dizin mevcut olmalıdır.
Mevcut dosyaların üzerine yazmak için:
npx @komunite/kalfa init --force
[!WARNING]
--force mevcut dosyaların üzerine yazar.
Yalnızca ne yapılacağını görmek için:
npx @komunite/kalfa init --dry-run
[!TIP]
--dry-run hiçbir dosyaya yazmaz, yalnızca yapılacak işlemleri gösterir.
2. Global kurulum ile kullanım
npm i -g @komunite/kalfa
kalfa init
Yardım menüsü:
kalfa --help
Kalfa nasıl kullanılır
Yeni bir oturum başlat
Proje kök dizininde Claude Code'u açın.
.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.
Günün önceliklerini netleştirip ilk işe başlayın.
Gün içinde bağlamı sağlıklı tut
Oturum ortasında /sync çalıştırın.
Bağlam ağırlaştığında /clear kullanın.
Oturum özeti günlük nota yazılır.
Hafıza dosyası güncellenir.
Çalışma kaldığı yerden devam eder.
Gün sonunda /wrap-up ile kapanış yapın.
Kalite kontrollerini işlet
Bir iş kalemi bittiğinde /audit çalıştırın.
Merge öncesi /review çalıştırın.
Kritik bulguları önceliklendirin.
Gerekli düzeltmeleri uygulayın.
Tekrar kontrol edin.
Teslim veya devir için /release ve /handoff kullanın.
Skill kütüphanesinden faydalan
.claude/skills/INDEX.md dosyasından ilgili skill'i bulun.
Claude'a hedefinizi verip skill'i uygulatın.
Net amaç belirtin.
Kısıtları ve beklenen çıktıyı yazın.
Sonraki adımları görev panosuna ekleyin.
Öğrenimleri not alıp tekrar kullanım için saklayın.
Sorun giderme
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.
Yardım alma ve issue bildirme
Hata ve geliştirme talepleri için issue açın: https://github.com/komunite/kalfa/issues
Genel bilgi ve destek için GitHub üzerinden iletişime geçin. Yanıt süresi, bakımcıların uygunluğuna göre değişir.
Geliştirici dokümantasyonu
Teknik uygulama
Kalfa; 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.
Kod yapısı
.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.
Yerel geliştirme
Ortam hazırlığı
Geliştirme ortamını hazırlama:
Depoyu klonlayın.
git clone https://github.com/komunite/kalfa.git
cd kalfa
Kurulum
Kurulum:
Node bağımlılıklarını yükleyin.
npm install
npm run lint:md komutunun çalıştığını doğrulayın.
Yapılandırma
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.
Build ve test
Yerelde çalıştırma:
Bu repo bir uygulama build çıktısı üretmez; operasyon dosyası sağlar.
Hedef projenizde claude başlatın.
/start, /sync, /wrap-up akışlarını çalıştırın.
Testleri çalıştırma:
Markdown kontrollerini çalıştırın.
npm run lint:md
Gerekirse npm run lint:md:fix
CLI testlerini çalıştırın.
npm test
Geliştirme sırasında izleme modunda çalıştırmak için npm run test:watch
Katkı hazırlarken, mevcut repo durumunda doğrulanmış asgari yerel kontroller npm run lint:md ve npm test komutlarıdır.
Test kapsamı
Mevcut test seti tests/ dizinindedir ve şunları doğrular:
tests/smoke.test.js
Test altyapısının temel olarak çalıştığını doğrular.
tests/cli.integration.test.js
Yardım çıktısını (--help) doğrular.
help alias davranışını doğrular.
Geçersiz hedef dizin için hata davranışını doğrular.
init --dry-run çıktısını doğrular.
init ile temel dosyaların hedef dizine kopyalandığını doğrular.
NPM yayını (bakımcılar için)
Paket içeriğini önizleyin.
npm run pack:preview
npm tarafında Trusted Publisher tanımlayın.
npm paket ayarlarında @komunite/kalfa için GitHub repo komunite/kalfa bağlayın.
Workflow olarak .github/workflows/npm-publish.yml seçin.
Mevcut repo durumunda npm publish workflow'u manuel 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.
Sürümü artırın ve etiketi gönderin.
npm version patch (veya minor / major)
git push --follow-tags
Gerekirse etkinleştirdikten sonra workflow'u GitHub arayüzünden elle çalıştırın.
GitHub üzerinde Release oluşturmak tek başına publish başlatmaz.
Hata ayıklama
TAMLIK 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.
Claude Code is an agentic coding tool that lives in your terminal, understands your codebase, and helps you code faster by executing routine tasks, explaining complex code, and handling git workflows - all through natural language commands.
