⚠️ Güvenlik uyarısı: Bu marketplace'teki plugin'ler, Claude Code hook'ları aracılığıyla makinenizde gerçek kod çalıştırır (Node.js script'leri). Yalnızca güvendiğiniz bir kaynaktan (bu repo'nun resmî adresi veya kendi fork'unuz) kurun; kurmadan önceplugins/*/hooks/hooks.jsonveplugins/*/scripts/içeriğini incelemeniz önerilir.🚧 Aktif geliştiriliyor / erken aşama: API'ler, hook davranışları ve plugin sürümleri haber verilmeden değişebilir. Üretim iş akışlarına almadan önce test edin.
Kişisel/takım agentic geliştirme altyapısı — Claude Code Plugin + Marketplace mimarisi üzerine kurulu. Tek kişilik bir kurucunun birden fazla projesini tutarlı, denetlenebilir ve hataya karşı dayanıklı bir disiplinle geliştirmesi; ileride ekiple paylaşılabilecek kadar versiyonlanmış olması için.
Claude gibi yapay zekâ ajanlarına yazılım geliştirtirken en büyük sorun, hatalı işin sessizce ilerlemesidir. agentic-base, Claude Code'a takılan bir "disiplin katmanı"dır: her ajanın yaptığı işi kalıcı bir kayıt defterine yazar, riskli komutları (silme, yayınlama, dışa gönderim gibi) çalışmadan önce durdurup insan onayına düşürür ve ajanın kendi işinden ne kadar emin olduğunu ölçüp emin olmadığı işleri incelemeye gönderir. Kısacası: yapay zekâya iş yaptırırken "güven ama doğrula" ilkesini otomatikleştirir.
Tam spesifikasyon: agentic-base-sistemi-spec.md ·
Mimari: docs/ARCHITECTURE.md ·
Katkı: docs/CONTRIBUTING.md
Bu sistem hatayı yok etmez; erken yakalayan, kaydeden ve eskale eden bir disiplin
kurar. Yeşil bir log kaydı ya da yüksek bir confidence skoru, işin gerçekten doğru
olduğu anlamına gelmez — kritik noktalarda insan doğrulaması hâlâ gereklidir.
Bilinen sınırlamalar için docs/ARCHITECTURE.md §6.
| Plugin | Sürüm | İçerik |
|---|---|---|
core-loop |
0.5.0 | Zorunlu çekirdek: append-only log, riskli-komut gate'i, confidence eşik makinesi (0.7/0.85), critic zorunluluğu, review kuyruğu, kill-criteria, /start-project skill'i (PRD ingestion), main-edit dedektörü (disiplin dışı kod düzenlemesi tespiti) |
dev-roles |
0.2.0 | backend / frontend / database / llm-integration ajanları |
security-roles |
0.1.2 | auth / security ajanları + 3 katmanlı deterministik güvenlik gate'i (kapsam: yalnızca proje içi dosyalar) |
growth-roles |
0.1.0 | marketing / sales / data-research ajanları + kaynak-doğrulama |
Sürümler plugin başına bağımsızdır (SemVer): çekirdek mantıkta kırıcı değişiklik → major,
yeni ajan/hook → minor, bugfix → patch. Her değişiklik CHANGELOG.md'ye yazılır.
Repo public'tir; ek erişim veya kimlik doğrulama adımı gerekmez. Claude Code içinde:
# 1) Marketplace'i ekle — repo klonlanır
/plugin marketplace add boranesn/agentic-base
# (tam URL de olur: /plugin marketplace add https://github.com/boranesn/agentic-base)
# 2) İhtiyaca göre plugin kur
/plugin install core-loop@agentic-base # zorunlu — her projede
/plugin install dev-roles@agentic-base # kod yazımı olan projelerde
/plugin install security-roles@agentic-base # auth/ödeme/kişisel veri olan projelerde
/plugin install growth-roles@agentic-base # pazarlama/satış/veri araştırması için
Her proje sadece ihtiyaç duyduğu plugin'leri yükler (modülerlik). Base'de yapılan
güncelleme /plugin marketplace update agentic-base + /plugin update ile tüm
projelere yayılır — dosya kopyalama yok.
Opsiyonel ama önerilen — Semgrep: security-roles plugin'inin güvenlik gate'i,
Semgrep PATH'te kuruluysa onu ek tarama katmanı olarak çalıştırır
(pip install semgrep veya brew install semgrep). Semgrep kurulu değilse tarama
yalnızca 8 yerleşik regex kuralıyla çalışır — bu minimal bir tabandır, tam bir SAST
aracının yerini tutmaz. Detay: docs/ARCHITECTURE.md §6.
İpucu: Yeni bir projeye başlarken bir PRD dosyan varsa
/start-projectskill'i (core-loop) PRD'yi okuyup CLAUDE.md çıpasını kurar ve gerekli rolleri önerir.
Düşük confidence, yüksek riskli rol veya critic reddi bir sonucu review kuyruğuna düşürür. Onayı Claude oturumunun DIŞINDA, terminalden verirsiniz:
node <core-loop-plugin>/scripts/review-queue-cli.mjs list
node <core-loop-plugin>/scripts/review-queue-cli.mjs approve <no> "not"
node <core-loop-plugin>/scripts/review-queue-cli.mjs reject <no> "not"
- Marketplace public git repo olarak barındırılır:
https://github.com/boranesn/agentic-base. Ekip üyeleri/plugin marketplace add boranesn/agentic-baseile bağlanır,/plugin marketplace update agentic-base+/plugin updateile senkron kalır. Yazma erişimi vermek için: repo → Settings → Collaborators. - Güvenlik uyarısı: Plugin'ler kullanıcı yetkisiyle kod çalıştırır. Bu marketplace'i yalnızca güvendiğiniz kaynaktan (kendi/ekip repo'nuz) ekleyin; bilinmeyen kaynaklardan plugin yüklemeyin.
- Yeni rol/agent eklemek için
docs/CONTRIBUTING.md.
Hook'ların sözleşmeleri (exit code, log/state yan etkileri, kapsam sınırları) saf Node.js testleriyle doğrulanır — framework ve bağımlılık yok:
npm test # ya da: node tests/run-all.mjs
Aynı suite her push/PR'da GitHub Actions ile koşar (.github/workflows/test.yml).
Dışarıdan gelen PR'larda testlerin yeşil olması beklenir.
Birden fazla subagent aynı anda paralel çalıştırılırsa (örn. 5+ ajan) Claude Max/Pro abonelik kotasına hızla çarpılabilir; bu durumda API-key tabanlı faturalandırmaya geçmek gerekebilir. Maliyet planlamasına dahil edin.
| Faz | İçerik | Durum |
|---|---|---|
| 0 | Repo iskeleti, marketplace + core-loop manifestleri | Yapıldı |
| 1 | Log/gate mekanizması (echo ajanla kanıt) | Yapıldı |
| 2 | backend-agent + critic-agent uçtan uca test | Yapıldı |
| 3 | dev-roles | Yapıldı |
| 4 | security-roles (deterministik gate ile) | Yapıldı |
| 5 | growth-roles | Yapıldı |
| 6 | Versiyonlama ve takım paylaşımı | Yapıldı |
MIT — bkz. LICENSE.