@omerrgocmen/crewctl 1.0.2 → 1.0.3

package/orchestrator/skills/architecture-decision-record.md

@@ -1,18 +1,18 @@
----
-name: architecture-decision-record
-description: Önemli teknik kararı bağlamı, seçenekleri ve sonuçlarıyla kısa bir ADR olarak kaydet; mimari seçimlerde kullan.
-category: software
-appliesTo: [plan, implement]
-match: [adr, architecture decision, mimari karar, teknik karar, tradeoff, ödünleşim, karar kaydı]
----
-
-# Mimari Karar Kaydı
-
-- Önce kararın durumunu, tarihini ve tek cümlelik başlığını yaz.
-- Bağlamda yalnızca kararı zorunlu kılan kuvvetleri, kısıtları ve kalite hedeflerini açıkla.
-- Gerçekçi seçenekleri aynı ölçütlerle karşılaştır; seçilmeyenleri karikatürleştirme.
-- Kararı kesin bir cümleyle belirt ve nedenini kanıta bağla.
-- Olumlu/olumsuz sonuçları, geçiş maliyetini ve geri dönüş koşulunu kaydet.
-- Var olan ADR numarası, şablonu ve dizin düzenini koru.
-
-Karar verilmemişse sahte kesinlik üretme; açık soruları ve karar sahibini belirt.
+---
+name: architecture-decision-record
+description: Önemli teknik kararı bağlamı, seçenekleri ve sonuçlarıyla kısa bir ADR olarak kaydet; mimari seçimlerde kullan.
+category: software
+appliesTo: [plan, implement]
+match: [adr, architecture decision, mimari karar, teknik karar, tradeoff, ödünleşim, karar kaydı]
+---
+
+# Mimari Karar Kaydı
+
+- Önce kararın durumunu, tarihini ve tek cümlelik başlığını yaz.
+- Bağlamda yalnızca kararı zorunlu kılan kuvvetleri, kısıtları ve kalite hedeflerini açıkla.
+- Gerçekçi seçenekleri aynı ölçütlerle karşılaştır; seçilmeyenleri karikatürleştirme.
+- Kararı kesin bir cümleyle belirt ve nedenini kanıta bağla.
+- Olumlu/olumsuz sonuçları, geçiş maliyetini ve geri dönüş koşulunu kaydet.
+- Var olan ADR numarası, şablonu ve dizin düzenini koru.
+
+Karar verilmemişse sahte kesinlik üretme; açık soruları ve karar sahibini belirt.

package/orchestrator/skills/authentication-design.md

@@ -1,16 +1,16 @@
----
-name: authentication-design
-description: Kullanıcı kimliğini güvenli oturum, parola ve yeniden doğrulama akışıyla tasarla; login ve hesap güvenliğinde kullan.
-category: security
-appliesTo: [plan, implement, review]
-match: [authentication, authn, kimlik doğrulama, login, signin, password, parola, session, mfa]
----
-
-# Kimlik Doğrulama Tasarımı
-
-- Yerleşik framework/kimlik sağlayıcısını tercih et; özel kriptografik protokol tasarlama.
-- Kimlik belirteçlerini yüksek entropili, süreli, iptal edilebilir ve aktarımda/depoda korumalı yap.
-- Parolayı güncel adaptif hash ile sakla; giriş, reset ve kayıt yanıtlarında hesap varlığını sızdırma.
-- Brute force ve credential stuffing'e rate limit, gecikme, izleme ve uygun MFA ile katmanlı savunma uygula.
-- Hassas işlemde yeniden doğrulama, oturum döndürme ve tüm oturumları sonlandırma desteği sağla.
-- Cookie bayrakları, logout/timeout, hata ve kurtarma yollarını güvenlik testleriyle doğrula.
+---
+name: authentication-design
+description: Kullanıcı kimliğini güvenli oturum, parola ve yeniden doğrulama akışıyla tasarla; login ve hesap güvenliğinde kullan.
+category: security
+appliesTo: [plan, implement, review]
+match: [authentication, authn, kimlik doğrulama, login, signin, password, parola, session, mfa]
+---
+
+# Kimlik Doğrulama Tasarımı
+
+- Yerleşik framework/kimlik sağlayıcısını tercih et; özel kriptografik protokol tasarlama.
+- Kimlik belirteçlerini yüksek entropili, süreli, iptal edilebilir ve aktarımda/depoda korumalı yap.
+- Parolayı güncel adaptif hash ile sakla; giriş, reset ve kayıt yanıtlarında hesap varlığını sızdırma.
+- Brute force ve credential stuffing'e rate limit, gecikme, izleme ve uygun MFA ile katmanlı savunma uygula.
+- Hassas işlemde yeniden doğrulama, oturum döndürme ve tüm oturumları sonlandırma desteği sağla.
+- Cookie bayrakları, logout/timeout, hata ve kurtarma yollarını güvenlik testleriyle doğrula.

package/orchestrator/skills/authorization-review.md

@@ -1,16 +1,16 @@
----
-name: authorization-review
-description: Her kaynak ve işlemde sunucu tarafı erişim kararlarını denetle; rol, izin, IDOR ve yetki işlerinde kullan.
-category: security
-appliesTo: [implement, review]
-match: [authorization, authz, yetkilendirme, permission, izin, role, rol, access control, idor, privilege]
----
-
-# Yetkilendirme İncelemesi
-
-1. Aktör × kaynak × işlem matrisi çıkar; varsayılanı deny yap.
-2. Yetkiyi yalnızca route/UI'da değil, kaynağın sahipliği ve tenant sınırıyla veri erişiminde doğrula.
-3. Kullanıcı kontrollü ID, rol, tenant veya durum alanının kararı manipüle edip etmediğini izle.
-4. Yatay/dikey yetki yükseltme, toplu endpoint ve dolaylı nesne erişimini test et.
-5. Admin/bakım yollarını ve arka plan işlerini aynı politikaya bağla.
-6. Her izin için allow ve deny regresyon testi yaz; reddi güvenli biçimde logla, hassas ayrıntı sızdırma.
+---
+name: authorization-review
+description: Her kaynak ve işlemde sunucu tarafı erişim kararlarını denetle; rol, izin, IDOR ve yetki işlerinde kullan.
+category: security
+appliesTo: [implement, review]
+match: [authorization, authz, yetkilendirme, permission, izin, role, rol, access control, idor, privilege]
+---
+
+# Yetkilendirme İncelemesi
+
+1. Aktör × kaynak × işlem matrisi çıkar; varsayılanı deny yap.
+2. Yetkiyi yalnızca route/UI'da değil, kaynağın sahipliği ve tenant sınırıyla veri erişiminde doğrula.
+3. Kullanıcı kontrollü ID, rol, tenant veya durum alanının kararı manipüle edip etmediğini izle.
+4. Yatay/dikey yetki yükseltme, toplu endpoint ve dolaylı nesne erişimini test et.
+5. Admin/bakım yollarını ve arka plan işlerini aynı politikaya bağla.
+6. Her izin için allow ve deny regresyon testi yaz; reddi güvenli biçimde logla, hassas ayrıntı sızdırma.

package/orchestrator/skills/backward-compatibility.md

@@ -1,17 +1,17 @@
----
-name: backward-compatibility
-description: API, veri ve davranış değişikliklerinde mevcut tüketicileri koru; kırıcı değişiklik veya yükseltme işlerinde kullan.
-category: software
-appliesTo: [plan, implement, review]
-match: [backward compatibility, geriye uyumluluk, breaking change, kırıcı değişiklik, deprecation, migration, upgrade]
----
-
-# Geriye Uyumluluk
-
-1. Dış sözleşmeleri çıkar: API, CLI bayrağı, dosya biçimi, olay, şema ve varsayılan davranış.
-2. Mevcut tüketicinin yeni sürümle çalışıp çalışmadığını somut örneklerle sınayarak kırılmayı bul.
-3. Alan ekleme, toleranslı okuma, adaptör veya aşamalı kullanımdan kaldırma ile uyumluluğu koru.
-4. Kaçınılmaz kırılmada sürümleme, geçiş yolu, uyarı dönemi ve geri alma planı sağla.
-5. Eski ve yeni biçimi aynı test matrisinde doğrula.
-
-Sessiz anlam değişikliğini uyumlu sayma; aynı şeklin farklı davranması da kırıcı olabilir.
+---
+name: backward-compatibility
+description: API, veri ve davranış değişikliklerinde mevcut tüketicileri koru; kırıcı değişiklik veya yükseltme işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [backward compatibility, geriye uyumluluk, breaking change, kırıcı değişiklik, deprecation, migration, upgrade]
+---
+
+# Geriye Uyumluluk
+
+1. Dış sözleşmeleri çıkar: API, CLI bayrağı, dosya biçimi, olay, şema ve varsayılan davranış.
+2. Mevcut tüketicinin yeni sürümle çalışıp çalışmadığını somut örneklerle sınayarak kırılmayı bul.
+3. Alan ekleme, toleranslı okuma, adaptör veya aşamalı kullanımdan kaldırma ile uyumluluğu koru.
+4. Kaçınılmaz kırılmada sürümleme, geçiş yolu, uyarı dönemi ve geri alma planı sağla.
+5. Eski ve yeni biçimi aynı test matrisinde doğrula.
+
+Sessiz anlam değişikliğini uyumlu sayma; aynı şeklin farklı davranması da kırıcı olabilir.

package/orchestrator/skills/changelog-writing.md

@@ -1,16 +1,16 @@
----
-name: changelog-writing
-description: Kullanıcıya etkili değişiklikleri taranabilir sürüm notlarına dönüştür; changelog ve release note işlerinde kullan.
-category: documentation
-appliesTo: [implement, review]
-match: [changelog, release notes, sürüm notu, değişiklik günlüğü, keep a changelog, yayın notu]
----
-
-# Changelog Yazımı
-
-- Hedef kitleyi paket tüketicisi veya ürün kullanıcısı olarak belirle; iç refactor ayrıntısını ele.
-- Değişiklikleri Added, Changed, Fixed, Deprecated, Removed ve Security başlıklarında grupla.
-- Her maddeyi kullanıcı etkisiyle başlat; kısa, geçmiş zamanlı ve bağlantı kurulabilir yaz.
-- Kırıcı değişiklikleri, gerekli geçiş adımını ve güvenlik etkisini görünür kıl.
-- Tarih, sürüm ve bağlantı biçiminde projenin mevcut düzenini koru.
-- Git geçmişini kanıt olarak kullan; yapılmayan özelliği yazma ve aynı değişikliği tekrarlama.
+---
+name: changelog-writing
+description: Kullanıcıya etkili değişiklikleri taranabilir sürüm notlarına dönüştür; changelog ve release note işlerinde kullan.
+category: documentation
+appliesTo: [implement, review]
+match: [changelog, release notes, sürüm notu, değişiklik günlüğü, keep a changelog, yayın notu]
+---
+
+# Changelog Yazımı
+
+- Hedef kitleyi paket tüketicisi veya ürün kullanıcısı olarak belirle; iç refactor ayrıntısını ele.
+- Değişiklikleri Added, Changed, Fixed, Deprecated, Removed ve Security başlıklarında grupla.
+- Her maddeyi kullanıcı etkisiyle başlat; kısa, geçmiş zamanlı ve bağlantı kurulabilir yaz.
+- Kırıcı değişiklikleri, gerekli geçiş adımını ve güvenlik etkisini görünür kıl.
+- Tarih, sürüm ve bağlantı biçiminde projenin mevcut düzenini koru.
+- Git geçmişini kanıt olarak kullan; yapılmayan özelliği yazma ve aynı değişikliği tekrarlama.

package/orchestrator/skills/ci-pipeline-design.md

@@ -1,16 +1,16 @@
----
-name: ci-pipeline-design
-description: Hızlı, deterministik ve en az yetkili CI doğrulama hattı tasarla; build, test ve workflow işlerinde kullan.
-category: software
-appliesTo: [plan, implement, review]
-match: [ci, pipeline, workflow, github actions, build, continuous integration, sürekli entegrasyon, job]
----
-
-# CI Hattı Tasarımı
-
-1. Birleştirmeyi engelleyen asgari kontrolleri belirle: biçim, statik analiz, test, build ve güvenlik.
-2. Bağımsız işleri paralelleştir; pahalı işleri değişen dosya veya riskle koşullandır.
-3. Sürümleri sabitle, önbellek anahtarlarını lockfile ile bağla ve temiz ortamda deterministik çalıştır.
-4. İş akışına yalnızca gereken izinleri ver; güvenilmeyen PR koduyla sırları buluşturma.
-5. Hata çıktısını uygulanabilir yap, geçici ağ hatalarıyla gerçek test hatalarını ayır.
-6. Yerelde eşdeğer komutu belgeleyip hattı gerçek bir çalıştırmayla doğrula.
+---
+name: ci-pipeline-design
+description: Hızlı, deterministik ve en az yetkili CI doğrulama hattı tasarla; build, test ve workflow işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [ci, pipeline, workflow, github actions, build, continuous integration, sürekli entegrasyon, job]
+---
+
+# CI Hattı Tasarımı
+
+1. Birleştirmeyi engelleyen asgari kontrolleri belirle: biçim, statik analiz, test, build ve güvenlik.
+2. Bağımsız işleri paralelleştir; pahalı işleri değişen dosya veya riskle koşullandır.
+3. Sürümleri sabitle, önbellek anahtarlarını lockfile ile bağla ve temiz ortamda deterministik çalıştır.
+4. İş akışına yalnızca gereken izinleri ver; güvenilmeyen PR koduyla sırları buluşturma.
+5. Hata çıktısını uygulanabilir yap, geçici ağ hatalarıyla gerçek test hatalarını ayır.
+6. Yerelde eşdeğer komutu belgeleyip hattı gerçek bir çalıştırmayla doğrula.

package/orchestrator/skills/cli-design.md

@@ -1,16 +1,16 @@
----
-name: cli-design
-description: Öngörülebilir komut, bayrak, çıktı ve hata davranışı tasarla; komut satırı aracı geliştirmede kullan.
-category: software
-appliesTo: [plan, implement, review]
-match: [cli, command line, komut satırı, flag, bayrak, argument, stdout, stderr, exit code]
----
-
-# CLI Tasarımı
-
-- Komut ve alt komutları kullanıcı niyetine göre adlandır; mevcut söz dizimini koru.
-- Zorunlu girdiyi az tut, güvenli varsayılanlar ve açık `--help` örnekleri sağla.
-- İnsan çıktısını stdout'a, uyarı/hataları stderr'e yaz; otomasyon için kararlı makine biçimi sun.
-- Başarı ve farklı hata sınıfları için tutarlı çıkış kodları kullan.
-- Tehlikeli veya geri döndürülemez eylemde dry-run, kapsam özeti ve açık onay düşün.
-- TTY olmayan ortamı, boşluklu yolları, Unicode'u ve sinyal/iptal davranışını test et.
+---
+name: cli-design
+description: Öngörülebilir komut, bayrak, çıktı ve hata davranışı tasarla; komut satırı aracı geliştirmede kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [cli, command line, komut satırı, flag, bayrak, argument, stdout, stderr, exit code]
+---
+
+# CLI Tasarımı
+
+- Komut ve alt komutları kullanıcı niyetine göre adlandır; mevcut söz dizimini koru.
+- Zorunlu girdiyi az tut, güvenli varsayılanlar ve açık `--help` örnekleri sağla.
+- İnsan çıktısını stdout'a, uyarı/hataları stderr'e yaz; otomasyon için kararlı makine biçimi sun.
+- Başarı ve farklı hata sınıfları için tutarlı çıkış kodları kullan.
+- Tehlikeli veya geri döndürülemez eylemde dry-run, kapsam özeti ve açık onay düşün.
+- TTY olmayan ortamı, boşluklu yolları, Unicode'u ve sinyal/iptal davranışını test et.

package/orchestrator/skills/code-review.md

@@ -1,27 +1,27 @@
----
-name: code-review
-description: Doğruluk, sadeleştirme, yeniden kullanım ve okunabilirlik odaklı kod incelemesi
-category: software
-appliesTo: [review]
-match: [inceleme, review, kod, refactor, temiz, clean, okunabilir, kalite, quality, denetle]
----
-
-# Beceri: Kod İncelemesi
-
-Değişikliği iddia değil kanıt olarak sorgula. Önce doğruluk, sonra sadelik.
-
-## Öncelik sırası
-
-1. **Doğruluk:** Mantık hataları, sınır durumları, yarış koşulları, hatalı varsayımlar, ele alınmayan
-   hata yolları. Somut bir "şu girdide şu bozulur" senaryosu kurabiliyor musun?
-2. **Sadeleştirme & yeniden kullanım:** Tekrarlayan mantık, gereksiz soyutlama, mevcut yardımcı yerine
-   yeniden yazılmış kod, ölü kod.
-3. **Okunabilirlik:** İsimlendirme, işlev boyutu, örtük bağımlılık, yanıltıcı yorum.
-4. **Kapsam:** Değişiklik istenen işi mi yapıyor, yoksa ilgisiz alanlara mı taşıyor?
-
-## Kurallar
-
-- Yalnızca gerçekten gözlemlediğin sorunları raporla; stil tercihini "hata" gibi sunma.
-- Her bulgu için dosya:satır ve minimal, uygulanabilir düzeltme öner.
-- Mevcut kullanıcı değişikliklerini, mimariyi ve stili koru; gereksiz büyük refactor önerme.
-- Sonunda net bir karar ver: `VERDICT: PASS` veya `VERDICT: FAIL` ve en kritik bulguları özetle.
+---
+name: code-review
+description: Doğruluk, sadeleştirme, yeniden kullanım ve okunabilirlik odaklı kod incelemesi
+category: software
+appliesTo: [review]
+match: [inceleme, review, kod, refactor, temiz, clean, okunabilir, kalite, quality, denetle]
+---
+
+# Beceri: Kod İncelemesi
+
+Değişikliği iddia değil kanıt olarak sorgula. Önce doğruluk, sonra sadelik.
+
+## Öncelik sırası
+
+1. **Doğruluk:** Mantık hataları, sınır durumları, yarış koşulları, hatalı varsayımlar, ele alınmayan
+   hata yolları. Somut bir "şu girdide şu bozulur" senaryosu kurabiliyor musun?
+2. **Sadeleştirme & yeniden kullanım:** Tekrarlayan mantık, gereksiz soyutlama, mevcut yardımcı yerine
+   yeniden yazılmış kod, ölü kod.
+3. **Okunabilirlik:** İsimlendirme, işlev boyutu, örtük bağımlılık, yanıltıcı yorum.
+4. **Kapsam:** Değişiklik istenen işi mi yapıyor, yoksa ilgisiz alanlara mı taşıyor?
+
+## Kurallar
+
+- Yalnızca gerçekten gözlemlediğin sorunları raporla; stil tercihini "hata" gibi sunma.
+- Her bulgu için dosya:satır ve minimal, uygulanabilir düzeltme öner.
+- Mevcut kullanıcı değişikliklerini, mimariyi ve stili koru; gereksiz büyük refactor önerme.
+- Sonunda net bir karar ver: `VERDICT: PASS` veya `VERDICT: FAIL` ve en kritik bulguları özetle.

package/orchestrator/skills/configuration-management.md

@@ -1,16 +1,16 @@
----
-name: configuration-management
-description: Güvenli varsayılanlı, doğrulanabilir ve katmanlı uygulama yapılandırması kur; config ve environment işlerinde kullan.
-category: software
-appliesTo: [plan, implement, review]
-match: [config, configuration, yapılandırma, ayar, environment, env, feature setting, default]
----
-
-# Yapılandırma Yönetimi
-
-1. Kaynak önceliğini açık tanımla: varsayılan, dosya, ortam değişkeni, CLI ve çalışma zamanı.
-2. Yapılandırmayı sınırda tür, aralık ve ilişki kurallarıyla doğrula; hatayı alan adıyla ver.
-3. Güvenli varsayılan kullan; sırları örnek dosyaya, loga veya istemci paketine koyma.
-4. Eski alanları idempotent biçimde taşı ve bilinmeyen alan politikasını belirle.
-5. Etkin yapılandırmayı sırları maskeleyerek teşhis edilebilir kıl.
-6. Eksik, bozuk, eski ve çakışan değerler için test yaz.
+---
+name: configuration-management
+description: Güvenli varsayılanlı, doğrulanabilir ve katmanlı uygulama yapılandırması kur; config ve environment işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [config, configuration, yapılandırma, ayar, environment, env, feature setting, default]
+---
+
+# Yapılandırma Yönetimi
+
+1. Kaynak önceliğini açık tanımla: varsayılan, dosya, ortam değişkeni, CLI ve çalışma zamanı.
+2. Yapılandırmayı sınırda tür, aralık ve ilişki kurallarıyla doğrula; hatayı alan adıyla ver.
+3. Güvenli varsayılan kullan; sırları örnek dosyaya, loga veya istemci paketine koyma.
+4. Eski alanları idempotent biçimde taşı ve bilinmeyen alan politikasını belirle.
+5. Etkin yapılandırmayı sırları maskeleyerek teşhis edilebilir kıl.
+6. Eksik, bozuk, eski ve çakışan değerler için test yaz.

package/orchestrator/skills/container-review.md

@@ -1,16 +1,16 @@
----
-name: container-review
-description: Container imajını küçük, tekrarlanabilir ve en az ayrıcalıklı olacak şekilde incele; Dockerfile ve image işlerinde kullan.
-category: security
-appliesTo: [implement, review]
-match: [dockerfile, docker, container, image, konteyner, compose, registry, base image]
----
-
-# Container İncelemesi
-
-- Güvenilir ve mümkünse digest ile sabitlenmiş minimal base image seç; güncelleme politikasını koru.
-- Multi-stage build ile derleyici, cache ve gereksiz dosyaları çalışma imajından çıkar.
-- Non-root kullanıcı, dar dosya izinleri ve yalnızca gerekli capability/port kullan.
-- Sırları ARG, ENV, layer veya build context içine koyma; `.dockerignore` kapsamını kontrol et.
-- Paketleri tek katmanda kurup cache'i temizle; healthcheck ve sinyal iletimini doğrula.
-- İmajı build et, boyut/layer farkını ve uygulamanın salt-okunur, kısıtlı çalışma koşulunu test et.
+---
+name: container-review
+description: Container imajını küçük, tekrarlanabilir ve en az ayrıcalıklı olacak şekilde incele; Dockerfile ve image işlerinde kullan.
+category: security
+appliesTo: [implement, review]
+match: [dockerfile, docker, container, image, konteyner, compose, registry, base image]
+---
+
+# Container İncelemesi
+
+- Güvenilir ve mümkünse digest ile sabitlenmiş minimal base image seç; güncelleme politikasını koru.
+- Multi-stage build ile derleyici, cache ve gereksiz dosyaları çalışma imajından çıkar.
+- Non-root kullanıcı, dar dosya izinleri ve yalnızca gerekli capability/port kullan.
+- Sırları ARG, ENV, layer veya build context içine koyma; `.dockerignore` kapsamını kontrol et.
+- Paketleri tek katmanda kurup cache'i temizle; healthcheck ve sinyal iletimini doğrula.
+- İmajı build et, boyut/layer farkını ve uygulamanın salt-okunur, kısıtlı çalışma koşulunu test et.

package/orchestrator/skills/contract-testing.md

@@ -1,16 +1,16 @@
----
-name: contract-testing
-description: Servis sağlayıcı ve tüketici arasındaki istek/yanıt sözleşmesini bağımsız doğrula; mikroservis ve API entegrasyonlarında kullan.
-category: testing
-appliesTo: [plan, implement, review]
-match: [contract test, sözleşme testi, consumer driven, pact, provider, consumer, api compatibility]
----
-
-# Sözleşme Testi
-
-1. Tüketicinin gerçekten kullandığı alan, durum kodu ve hata davranışını çıkar.
-2. Sözleşmeyi uygulama ayrıntısından bağımsız, sürümlenebilir artefakt olarak tanımla.
-3. Tüketici tarafında beklentiyi, sağlayıcı tarafında gerçek uygulamaya karşı doğrulamayı çalıştır.
-4. Opsiyonel alan, enum genişlemesi, null ve bilinmeyen alan toleransını açık test et.
-5. Eski tüketici ile yeni sağlayıcı ve yeni tüketici ile mevcut sağlayıcı uyumunu değerlendir.
-6. Sahte sunucunun gerçek protokolden sapmasını önlemek için sözleşmeyi CI yayın/verify akışına bağla.
+---
+name: contract-testing
+description: Servis sağlayıcı ve tüketici arasındaki istek/yanıt sözleşmesini bağımsız doğrula; mikroservis ve API entegrasyonlarında kullan.
+category: testing
+appliesTo: [plan, implement, review]
+match: [contract test, sözleşme testi, consumer driven, pact, provider, consumer, api compatibility]
+---
+
+# Sözleşme Testi
+
+1. Tüketicinin gerçekten kullandığı alan, durum kodu ve hata davranışını çıkar.
+2. Sözleşmeyi uygulama ayrıntısından bağımsız, sürümlenebilir artefakt olarak tanımla.
+3. Tüketici tarafında beklentiyi, sağlayıcı tarafında gerçek uygulamaya karşı doğrulamayı çalıştır.
+4. Opsiyonel alan, enum genişlemesi, null ve bilinmeyen alan toleransını açık test et.
+5. Eski tüketici ile yeni sağlayıcı ve yeni tüketici ile mevcut sağlayıcı uyumunu değerlendir.
+6. Sahte sunucunun gerçek protokolden sapmasını önlemek için sözleşmeyi CI yayın/verify akışına bağla.

package/orchestrator/skills/dashboard-design.md

@@ -1,16 +1,16 @@
----
-name: dashboard-design
-description: Karar vermeyi hızlandıran hiyerarşik, yoğun ama okunabilir dashboard tasarla; metrik ve yönetim ekranlarında kullan.
-category: design
-appliesTo: [plan, implement, review]
-match: [dashboard, admin panel, yönetim paneli, analytics ui, metrics, kpi, data dashboard]
----
-
-# Dashboard Tasarımı
-
-- Kullanıcının vereceği kararları ve bu kararlar için gereken 3–7 birincil sinyali belirle.
-- Özet → eğilim → ayrıntı hiyerarşisi kur; her kartı aynı görsel ağırlığa getirme.
-- Değerlerde birim, dönem, karşılaştırma temeli, güncellik ve veri kalitesi göster.
-- Tablo/grafik türünü karşılaştırma amacına göre seç; dekoratif görselleştirmeden kaçın.
-- Filtreleri paylaşılabilir duruma bağla, aktif filtreyi görünür kıl ve boş/yükleniyor/hata durumlarını tasarla.
-- Küçük ekran, klavye, renk körlüğü ve gerçek uzun veriyle düzeni doğrula.
+---
+name: dashboard-design
+description: Karar vermeyi hızlandıran hiyerarşik, yoğun ama okunabilir dashboard tasarla; metrik ve yönetim ekranlarında kullan.
+category: design
+appliesTo: [plan, implement, review]
+match: [dashboard, admin panel, yönetim paneli, analytics ui, metrics, kpi, data dashboard]
+---
+
+# Dashboard Tasarımı
+
+- Kullanıcının vereceği kararları ve bu kararlar için gereken 3–7 birincil sinyali belirle.
+- Özet → eğilim → ayrıntı hiyerarşisi kur; her kartı aynı görsel ağırlığa getirme.
+- Değerlerde birim, dönem, karşılaştırma temeli, güncellik ve veri kalitesi göster.
+- Tablo/grafik türünü karşılaştırma amacına göre seç; dekoratif görselleştirmeden kaçın.
+- Filtreleri paylaşılabilir duruma bağla, aktif filtreyi görünür kıl ve boş/yükleniyor/hata durumlarını tasarla.
+- Küçük ekran, klavye, renk körlüğü ve gerçek uzun veriyle düzeni doğrula.

package/orchestrator/skills/database-migration.md

@@ -1,16 +1,16 @@
----
-name: database-migration
-description: Üretimde güvenli, geri alınabilir ve aşamalı veri tabanı geçişi uygula; şema veya veri migration işlerinde kullan.
-category: software
-appliesTo: [plan, implement, review]
-match: [database migration, db migration, veri tabanı geçişi, schema migration, backfill, ddl, rollback]
----
-
-# Veri Tabanı Geçişi
-
-- Önce mevcut şema, veri hacmi, kilit süresi ve eski uygulama sürümüyle uyumu incele.
-- Expand/contract uygula: uyumlu alanı ekle, çift okuma/yazmayı geçir, veriyi doldur, sonra eskisini kaldır.
-- Büyük backfill'i küçük, tekrar çalıştırılabilir partilere böl; ilerleme ve hata kaydı tut.
-- Uzun tablo kilidi ve tam tablo yeniden yazımını üretim hacminde değerlendir.
-- İleri geçiş, geri dönüş ve kısmi başarısızlık davranışını prova et.
-- Veri kaybı riski olan adımı açık onay ve doğrulanmış yedek olmadan çalıştırma.
+---
+name: database-migration
+description: Üretimde güvenli, geri alınabilir ve aşamalı veri tabanı geçişi uygula; şema veya veri migration işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [database migration, db migration, veri tabanı geçişi, schema migration, backfill, ddl, rollback]
+---
+
+# Veri Tabanı Geçişi
+
+- Önce mevcut şema, veri hacmi, kilit süresi ve eski uygulama sürümüyle uyumu incele.
+- Expand/contract uygula: uyumlu alanı ekle, çift okuma/yazmayı geçir, veriyi doldur, sonra eskisini kaldır.
+- Büyük backfill'i küçük, tekrar çalıştırılabilir partilere böl; ilerleme ve hata kaydı tut.
+- Uzun tablo kilidi ve tam tablo yeniden yazımını üretim hacminde değerlendir.
+- İleri geçiş, geri dönüş ve kısmi başarısızlık davranışını prova et.
+- Veri kaybı riski olan adımı açık onay ve doğrulanmış yedek olmadan çalıştırma.

package/orchestrator/skills/database-schema-design.md

@@ -1,16 +1,16 @@
----
-name: database-schema-design
-description: Bütünlük, sorgu biçimi ve evrim maliyetine göre veri şeması tasarla; tablo ve ilişki işlerinde kullan.
-category: software
-appliesTo: [plan, implement, review]
-match: [database schema, veri tabanı şeması, table, tablo, relation, ilişki, index, constraint, normalization]
----
-
-# Veri Şeması Tasarımı
-
-1. Varlıkları, kimlikleri, kardinaliteyi, sahipliği ve yaşam döngüsünü çıkar.
-2. Null, varsayılan, unique, foreign key ve check kurallarıyla bütünlüğü veriye yakın uygula.
-3. Normalizasyonu başlangıç noktası al; denormalizasyonu ölçülmüş sorgu ihtiyacıyla gerekçelendir.
-4. İndeksleri gerçek filtre, sıralama ve join kalıplarına göre tasarla; yazma maliyetini hesaba kat.
-5. Saat dilimi, para, hassasiyet, Unicode ve silme politikasını açık seç.
-6. Şemayı örnek sorgular ve evrim/migration senaryosuyla doğrula.
+---
+name: database-schema-design
+description: Bütünlük, sorgu biçimi ve evrim maliyetine göre veri şeması tasarla; tablo ve ilişki işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [database schema, veri tabanı şeması, table, tablo, relation, ilişki, index, constraint, normalization]
+---
+
+# Veri Şeması Tasarımı
+
+1. Varlıkları, kimlikleri, kardinaliteyi, sahipliği ve yaşam döngüsünü çıkar.
+2. Null, varsayılan, unique, foreign key ve check kurallarıyla bütünlüğü veriye yakın uygula.
+3. Normalizasyonu başlangıç noktası al; denormalizasyonu ölçülmüş sorgu ihtiyacıyla gerekçelendir.
+4. İndeksleri gerçek filtre, sıralama ve join kalıplarına göre tasarla; yazma maliyetini hesaba kat.
+5. Saat dilimi, para, hassasiyet, Unicode ve silme politikasını açık seç.
+6. Şemayı örnek sorgular ve evrim/migration senaryosuyla doğrula.

package/orchestrator/skills/debugging.md

@@ -1,26 +1,26 @@
----
-name: debugging
-description: Kök neden bulma disiplini — belirtiyi değil nedeni düzelt
-category: software
-appliesTo: [implement]
-match: [hata, bug, debug, hata ayikla, ayıkla, crash, cokme, çökme, exception, fix, duzelt, düzelt, sorun, patlama]
----
-
-# Beceri: Hata Ayıklama
-
-Rastgele deneme yerine hipotez–kanıt döngüsü yürüt.
-
-## Yöntem
-
-1. **Yeniden üret:** Hatayı tetikleyen en küçük, deterministik adımı bul. Üretilemeyen hata düzeltilemez.
-2. **Daralt:** Hatanın olduğu ve olmadığı yeri ikiye bölerek (log, ara değer, git bisect mantığı) izole et.
-3. **Kök nedeni bul:** "Neden?" diye zincirle sor. İlk gördüğün belirtiyi değil, onu üreten nedeni hedefle.
-4. **En küçük düzeltme:** Kök nedeni gideren minimal değişikliği yap; ilgisiz refactor ekleme.
-5. **Regresyona karşı test:** Mümkünse hatayı yakalayan bir test ekle; düzeltme öncesi kırmızı, sonrası yeşil olsun.
-6. **Yan etkiyi kontrol et:** Düzeltmenin başka bir davranışı bozmadığını doğrula.
-
-## Kurallar
-
-- Belirtiyi maskeleyen çözümlerden (boş `catch`, kontrolü kapatma, sihirli bekleme) kaçın.
-- Bulduğun kök nedeni ve neden bu düzeltmenin doğru olduğunu kısaca raporla.
-- Düzeltilemiyorsa (yeniden üretilemiyor, erişim yok) bunu somut kanıtla `BLOCKED` olarak bildir.
+---
+name: debugging
+description: Kök neden bulma disiplini — belirtiyi değil nedeni düzelt
+category: software
+appliesTo: [implement]
+match: [hata, bug, debug, hata ayikla, ayıkla, crash, cokme, çökme, exception, fix, duzelt, düzelt, sorun, patlama]
+---
+
+# Beceri: Hata Ayıklama
+
+Rastgele deneme yerine hipotez–kanıt döngüsü yürüt.
+
+## Yöntem
+
+1. **Yeniden üret:** Hatayı tetikleyen en küçük, deterministik adımı bul. Üretilemeyen hata düzeltilemez.
+2. **Daralt:** Hatanın olduğu ve olmadığı yeri ikiye bölerek (log, ara değer, git bisect mantığı) izole et.
+3. **Kök nedeni bul:** "Neden?" diye zincirle sor. İlk gördüğün belirtiyi değil, onu üreten nedeni hedefle.
+4. **En küçük düzeltme:** Kök nedeni gideren minimal değişikliği yap; ilgisiz refactor ekleme.
+5. **Regresyona karşı test:** Mümkünse hatayı yakalayan bir test ekle; düzeltme öncesi kırmızı, sonrası yeşil olsun.
+6. **Yan etkiyi kontrol et:** Düzeltmenin başka bir davranışı bozmadığını doğrula.
+
+## Kurallar
+
+- Belirtiyi maskeleyen çözümlerden (boş `catch`, kontrolü kapatma, sihirli bekleme) kaçın.
+- Bulduğun kök nedeni ve neden bu düzeltmenin doğru olduğunu kısaca raporla.
+- Düzeltilemiyorsa (yeniden üretilemiyor, erişim yok) bunu somut kanıtla `BLOCKED` olarak bildir.

package/orchestrator/skills/dependency-review.md

@@ -1,16 +1,16 @@
----
-name: dependency-review
-description: Yeni veya güncellenen bağımlılığın güvenlik, lisans, bakım ve paket boyutu etkisini incele; paket değişimlerinde kullan.
-category: software
-appliesTo: [plan, implement, review]
-match: [dependency, bağımlılık, package, paket, lockfile, npm, pip, cargo, license, lisans, upgrade]
----
-
-# Bağımlılık İncelemesi
-
-- Önce ihtiyacın mevcut standart kütüphane veya kurulu paketle çözülüp çözülemeyeceğini kontrol et.
-- Manifest ve lockfile farkında doğrudan/dolaylı paketleri, kaynak ve bütünlük değişimlerini incele.
-- Bakım etkinliği, sürüm politikası, lisans, bilinen açık ve çalışma zamanı ayrıcalıklarını değerlendir.
-- İstemci tarafında paket/bundle maliyetini; sunucuda başlangıç ve tedarik zinciri etkisini ölç.
-- Minimum uyumlu sürümü seç, sürümü kilitle ve kullanım yüzeyini küçük tut.
-- Güncellemeden sonra test, build ve güvenlik taramasını çalıştır; körlemesine büyük lockfile farkı kabul etme.
+---
+name: dependency-review
+description: Yeni veya güncellenen bağımlılığın güvenlik, lisans, bakım ve paket boyutu etkisini incele; paket değişimlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [dependency, bağımlılık, package, paket, lockfile, npm, pip, cargo, license, lisans, upgrade]
+---
+
+# Bağımlılık İncelemesi
+
+- Önce ihtiyacın mevcut standart kütüphane veya kurulu paketle çözülüp çözülemeyeceğini kontrol et.
+- Manifest ve lockfile farkında doğrudan/dolaylı paketleri, kaynak ve bütünlük değişimlerini incele.
+- Bakım etkinliği, sürüm politikası, lisans, bilinen açık ve çalışma zamanı ayrıcalıklarını değerlendir.
+- İstemci tarafında paket/bundle maliyetini; sunucuda başlangıç ve tedarik zinciri etkisini ölç.
+- Minimum uyumlu sürümü seç, sürümü kilitle ve kullanım yüzeyini küçük tut.
+- Güncellemeden sonra test, build ve güvenlik taramasını çalıştır; körlemesine büyük lockfile farkı kabul etme.