@omerrgocmen/crewctl 1.1.1 → 1.3.0

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.

package/orchestrator/skills/design-review.md

@@ -1,29 +1,29 @@
----
-name: design-review
-description: UI/UX ve tasarım sistemi incelemesi — hiyerarşi, erişilebilirlik, tutarlılık ve tema uyumu
-category: design
-appliesTo: [review, implement]
-match: [tasarim, tasarım, design, ui, ux, arayuz, arayüz, layout, renk, color, tema, theme, erisilebilir, erişilebilir, accessibility, responsive]
----
-
-# Beceri: Tasarım İncelemesi
-
-Bir arayüzü tek bir tasarım sistemi gibi okunacak biçimde değerlendir. Estetik yorumdan çok
-gözlemlenebilir kurallara dayan.
-
-## Kontrol listesi
-
-- **Görsel hiyerarşi:** Başlık/gövde/aksiyon ayrımı net mi? Birincil eylem sayfada tek ve baskın mı?
-- **Boşluk ve ritim:** Tutarlı bir aralık ölçeği (4/8 px) var mı? Rastgele margin/padding sıçramaları var mı?
-- **Tipografi:** En fazla 2 font ailesi, sınırlı boyut/ağırlık ölçeği; satır uzunluğu 45–90 karakter.
-- **Renk ve kontrast:** Metin/arka plan kontrastı WCAG AA (normal 4.5:1, büyük 3:1). Renk tek başına anlam taşımasın.
-- **Tutarlılık:** Aynı işlevin bileşenleri (buton, kart, input) her yerde aynı görünsün; tek seferlik istisnalar işaretlensin.
-- **Durumlar:** hover / focus / active / disabled / hata / boş / yükleniyor durumları tanımlı mı?
-- **Erişilebilirlik:** Klavyeyle gezilebilir mi, görünür focus halkası var mı, etiketler/alt metinler eksik mi?
-- **Tema:** Açık ve koyu temada da okunur mu? Sabit renk yerine tema değişkenleri kullanılmış mı?
-- **Responsive:** Dar ve geniş ekranda taşma/kırılma var mı?
-
-## Teslimat
-
-Bulguları önem sırasıyla (HIGH/MEDIUM/LOW) ve mümkünse dosya:satır ile ver. Her bulgu için somut,
-minimal düzeltme öner. Estetik tercihleri "kural" gibi sunma; gerekçesini yaz.
+---
+name: design-review
+description: UI/UX ve tasarım sistemi incelemesi — hiyerarşi, erişilebilirlik, tutarlılık ve tema uyumu
+category: design
+appliesTo: [review, implement]
+match: [tasarim, tasarım, design, ui, ux, arayuz, arayüz, layout, renk, color, tema, theme, erisilebilir, erişilebilir, accessibility, responsive]
+---
+
+# Beceri: Tasarım İncelemesi
+
+Bir arayüzü tek bir tasarım sistemi gibi okunacak biçimde değerlendir. Estetik yorumdan çok
+gözlemlenebilir kurallara dayan.
+
+## Kontrol listesi
+
+- **Görsel hiyerarşi:** Başlık/gövde/aksiyon ayrımı net mi? Birincil eylem sayfada tek ve baskın mı?
+- **Boşluk ve ritim:** Tutarlı bir aralık ölçeği (4/8 px) var mı? Rastgele margin/padding sıçramaları var mı?
+- **Tipografi:** En fazla 2 font ailesi, sınırlı boyut/ağırlık ölçeği; satır uzunluğu 45–90 karakter.
+- **Renk ve kontrast:** Metin/arka plan kontrastı WCAG AA (normal 4.5:1, büyük 3:1). Renk tek başına anlam taşımasın.
+- **Tutarlılık:** Aynı işlevin bileşenleri (buton, kart, input) her yerde aynı görünsün; tek seferlik istisnalar işaretlensin.
+- **Durumlar:** hover / focus / active / disabled / hata / boş / yükleniyor durumları tanımlı mı?
+- **Erişilebilirlik:** Klavyeyle gezilebilir mi, görünür focus halkası var mı, etiketler/alt metinler eksik mi?
+- **Tema:** Açık ve koyu temada da okunur mu? Sabit renk yerine tema değişkenleri kullanılmış mı?
+- **Responsive:** Dar ve geniş ekranda taşma/kırılma var mı?
+
+## Teslimat
+
+Bulguları önem sırasıyla (HIGH/MEDIUM/LOW) ve mümkünse dosya:satır ile ver. Her bulgu için somut,
+minimal düzeltme öner. Estetik tercihleri "kural" gibi sunma; gerekçesini yaz.

package/orchestrator/skills/design-system.md

@@ -1,16 +1,16 @@
----
-name: design-system
-description: Token, bileşen, varyant ve dokümantasyonla tutarlı bir arayüz sistemi kur; tekrar eden UI ve tema işlerinde kullan.
-category: design
-appliesTo: [plan, implement, review]
-match: [design system, tasarım sistemi, token, component library, bileşen kütüphanesi, theme, tema]
----
-
-# Tasarım Sistemi
-
-1. Mevcut ürün dilini ve tekrar eden kararları envanterle; ihtiyaç kanıtı olmadan sistem kurma.
-2. Renk, tipografi, boşluk, radius, elevation ve motion için anlamsal token katmanı oluştur.
-3. Bileşenin anatomy, varyant, boyut, durum, erişilebilirlik ve içerik kurallarını açık tanımla.
-4. Composition'ı tek seferlik prop çoğalmasına tercih et; kaçış noktalarını kontrollü bırak.
-5. Görsel örnek, kullanım/kullanma örneği ve değişiklik/migration notu sağla.
-6. Açık-koyu tema, responsive, klavye ve görsel regresyon testleriyle sistemi doğrula.
+---
+name: design-system
+description: Token, bileşen, varyant ve dokümantasyonla tutarlı bir arayüz sistemi kur; tekrar eden UI ve tema işlerinde kullan.
+category: design
+appliesTo: [plan, implement, review]
+match: [design system, tasarım sistemi, token, component library, bileşen kütüphanesi, theme, tema]
+---
+
+# Tasarım Sistemi
+
+1. Mevcut ürün dilini ve tekrar eden kararları envanterle; ihtiyaç kanıtı olmadan sistem kurma.
+2. Renk, tipografi, boşluk, radius, elevation ve motion için anlamsal token katmanı oluştur.
+3. Bileşenin anatomy, varyant, boyut, durum, erişilebilirlik ve içerik kurallarını açık tanımla.
+4. Composition'ı tek seferlik prop çoğalmasına tercih et; kaçış noktalarını kontrollü bırak.
+5. Görsel örnek, kullanım/kullanma örneği ve değişiklik/migration notu sağla.
+6. Açık-koyu tema, responsive, klavye ve görsel regresyon testleriyle sistemi doğrula.

package/orchestrator/skills/docs-api-reference.md

@@ -1,16 +1,16 @@
----
-name: docs-api-reference
-description: Kod veya sözleşmeden eksiksiz ve taranabilir API referansı üret; fonksiyon, sınıf, config ve endpoint belgelerinde kullan.
-category: documentation
-appliesTo: [implement, review]
-match: [api reference, referans dokümanı, function docs, class docs, configuration reference, endpoint reference]
----
-
-# API Referansı
-
-- Kaynak gerçek olarak kodu, şemayı ve çalışan davranışı kullan; tahminden alan üretme.
-- Öğeleri kararlı ad ve hiyerarşiyle sırala; kısa amaç cümlesinden sonra imza/söz dizimi ver.
-- Parametre türü, zorunluluk, varsayılan, sınır, dönüş, hata ve yan etkiyi açıkla.
-- Her öğeye minimal çalışan örnek ekle; örneğin çıktısını ve ön koşulunu göster.
-- Ortak kavramı tek yerde belgeleyip bağla; referansta uzun öğretici anlatı kullanma.
-- Eksik/deprecated öğeleri ve sürüm farkını işaretle, örnekleri test veya doğrulama ile senkron tut.
+---
+name: docs-api-reference
+description: Kod veya sözleşmeden eksiksiz ve taranabilir API referansı üret; fonksiyon, sınıf, config ve endpoint belgelerinde kullan.
+category: documentation
+appliesTo: [implement, review]
+match: [api reference, referans dokümanı, function docs, class docs, configuration reference, endpoint reference]
+---
+
+# API Referansı
+
+- Kaynak gerçek olarak kodu, şemayı ve çalışan davranışı kullan; tahminden alan üretme.
+- Öğeleri kararlı ad ve hiyerarşiyle sırala; kısa amaç cümlesinden sonra imza/söz dizimi ver.
+- Parametre türü, zorunluluk, varsayılan, sınır, dönüş, hata ve yan etkiyi açıkla.
+- Her öğeye minimal çalışan örnek ekle; örneğin çıktısını ve ön koşulunu göster.
+- Ortak kavramı tek yerde belgeleyip bağla; referansta uzun öğretici anlatı kullanma.
+- Eksik/deprecated öğeleri ve sürüm farkını işaretle, örnekleri test veya doğrulama ile senkron tut.

package/orchestrator/skills/docs-troubleshooting.md

@@ -1,16 +1,16 @@
----
-name: docs-troubleshooting
-description: Belirtiyi tanı, nedeni doğrula ve güvenli çözüm sunan sorun giderme belgesi yaz; hata ve destek dokümanında kullan.
-category: documentation
-appliesTo: [implement, review]
-match: [troubleshooting, sorun giderme, common errors, yaygın hatalar, diagnosis, hata belgesi, faq]
----
-
-# Sorun Giderme Belgesi
-
-- Bölümü kullanıcının gördüğü tam belirti, hata kodu veya davranışla adlandır.
-- Hızlı güvenli kontrollerden başlayıp ayırt edici tanı adımlarını sırala; beklenen çıktıyı yaz.
-- Her dalda olası neden, doğrulama kanıtı ve en dar çözümü eşleştir.
-- Veri silen, izin değiştiren veya güvenliği gevşeten komutu varsayılan çözüm yapma; risk ve geri dönüşü belirt.
-- Sırları maskeleyen log toplama ve destek escalation bilgisi ekle.
-- Komut, dosya yolu ve hata metnini güncel üründe yeniden üretip doğrula.
+---
+name: docs-troubleshooting
+description: Belirtiyi tanı, nedeni doğrula ve güvenli çözüm sunan sorun giderme belgesi yaz; hata ve destek dokümanında kullan.
+category: documentation
+appliesTo: [implement, review]
+match: [troubleshooting, sorun giderme, common errors, yaygın hatalar, diagnosis, hata belgesi, faq]
+---
+
+# Sorun Giderme Belgesi
+
+- Bölümü kullanıcının gördüğü tam belirti, hata kodu veya davranışla adlandır.
+- Hızlı güvenli kontrollerden başlayıp ayırt edici tanı adımlarını sırala; beklenen çıktıyı yaz.
+- Her dalda olası neden, doğrulama kanıtı ve en dar çözümü eşleştir.
+- Veri silen, izin değiştiren veya güvenliği gevşeten komutu varsayılan çözüm yapma; risk ve geri dönüşü belirt.
+- Sırları maskeleyen log toplama ve destek escalation bilgisi ekle.
+- Komut, dosya yolu ve hata metnini güncel üründe yeniden üretip doğrula.

package/orchestrator/skills/docs-tutorial.md

@@ -1,16 +1,16 @@
----
-name: docs-tutorial
-description: Yeni kullanıcıyı çalışan ve anlamlı bir sonuca adım adım ulaştıran öğretici yaz; onboarding ve başlangıç rehberinde kullan.
-category: documentation
-appliesTo: [implement, review]
-match: [tutorial, öğretici, quickstart, getting started, başlangıç, onboarding, walkthrough]
----
-
-# Öğretici Yazımı
-
-1. Tek öğrenme hedefi ve görünür nihai ürün seç; kavramsal kapsamı dar tut.
-2. Temiz ortam için ön koşul, kurulum ve yaklaşık süreyi başta belirt.
-3. Küçük, sıralı ve kopyalanabilir adımlar ver; her adımın beklenen sonucunu göster.
-4. Okuyucunun başarı hissini erken üret, sonra bir kavramı uygulama içinde açıklayarak ilerle.
-5. Alternatifler ve tam referansla ana akışı bölme; ilgili belgeye bağla.
-6. Öğreticiyi sıfırdan aynen çalıştır, sürüm/yol/çıktı doğruluğunu kontrol et ve temizleme adımı ekle.
+---
+name: docs-tutorial
+description: Yeni kullanıcıyı çalışan ve anlamlı bir sonuca adım adım ulaştıran öğretici yaz; onboarding ve başlangıç rehberinde kullan.
+category: documentation
+appliesTo: [implement, review]
+match: [tutorial, öğretici, quickstart, getting started, başlangıç, onboarding, walkthrough]
+---
+
+# Öğretici Yazımı
+
+1. Tek öğrenme hedefi ve görünür nihai ürün seç; kavramsal kapsamı dar tut.
+2. Temiz ortam için ön koşul, kurulum ve yaklaşık süreyi başta belirt.
+3. Küçük, sıralı ve kopyalanabilir adımlar ver; her adımın beklenen sonucunu göster.
+4. Okuyucunun başarı hissini erken üret, sonra bir kavramı uygulama içinde açıklayarak ilerle.
+5. Alternatifler ve tam referansla ana akışı bölme; ilgili belgeye bağla.
+6. Öğreticiyi sıfırdan aynen çalıştır, sürüm/yol/çıktı doğruluğunu kontrol et ve temizleme adımı ekle.

package/orchestrator/skills/docs-writing.md

@@ -1,25 +1,25 @@
----
-name: docs-writing
-description: Net, doğru ve bakımı kolay dokümantasyon/README yazma rehberi
-category: documentation
-appliesTo: [implement]
-match: [dokuman, doküman, docs, readme, belge, documentation, aciklama, açıklama, guide, kilavuz, kılavuz, yorum]
----
-
-# Beceri: Dokümantasyon Yazma
-
-Okuyucunun hedefine en kısa yoldan ulaşmasını sağla. Doğruluk, kısalıktan önce gelir.
-
-## İlkeler
-
-- **Önce okuyucu:** Kim, ne yapmaya çalışıyor? Önvarsayımı ve gerekli ön koşulları baştan söyle.
-- **Çalıştırılabilir örnek:** Kopyala-çalıştır komutları ve gerçek girdi/çıktı ver; sözde koddan kaçın.
-- **Yapı:** Kısa giriş → hızlı başlangıç → yaygın görevler → başvuru → sorun giderme. Taranabilir başlıklar kullan.
-- **Doğruluk:** Yalnızca kod tabanında gerçekten var olan komut, bayrak, yol ve davranışı yaz; uydurma.
-- **Kısalık:** Gereksiz sıfat ve tekrar yok. Bir cümle bir iş yapsın.
-- **Bakım:** Kırılgan ayrıntıyı (sürüm numarası, iç yol) tek yerde tut; kodla dokümanı senkron bırak.
-
-## Kurallar
-
-Mevcut dokümanın dilini, tonunu ve biçimini koru. Var olan bir belgeyi güncelliyorsan üslubu değiştirme.
-Yalnızca doğruladığın bilgiyi yaz; emin olmadığın davranışı "kesin" gibi sunma.
+---
+name: docs-writing
+description: Net, doğru ve bakımı kolay dokümantasyon/README yazma rehberi
+category: documentation
+appliesTo: [implement]
+match: [dokuman, doküman, docs, readme, belge, documentation, aciklama, açıklama, guide, kilavuz, kılavuz, yorum]
+---
+
+# Beceri: Dokümantasyon Yazma
+
+Okuyucunun hedefine en kısa yoldan ulaşmasını sağla. Doğruluk, kısalıktan önce gelir.
+
+## İlkeler
+
+- **Önce okuyucu:** Kim, ne yapmaya çalışıyor? Önvarsayımı ve gerekli ön koşulları baştan söyle.
+- **Çalıştırılabilir örnek:** Kopyala-çalıştır komutları ve gerçek girdi/çıktı ver; sözde koddan kaçın.
+- **Yapı:** Kısa giriş → hızlı başlangıç → yaygın görevler → başvuru → sorun giderme. Taranabilir başlıklar kullan.
+- **Doğruluk:** Yalnızca kod tabanında gerçekten var olan komut, bayrak, yol ve davranışı yaz; uydurma.
+- **Kısalık:** Gereksiz sıfat ve tekrar yok. Bir cümle bir iş yapsın.
+- **Bakım:** Kırılgan ayrıntıyı (sürüm numarası, iç yol) tek yerde tut; kodla dokümanı senkron bırak.
+
+## Kurallar
+
+Mevcut dokümanın dilini, tonunu ve biçimini koru. Var olan bir belgeyi güncelliyorsan üslubu değiştirme.
+Yalnızca doğruladığın bilgiyi yaz; emin olmadığın davranışı "kesin" gibi sunma.

package/orchestrator/skills/empty-error-loading-states.md

@@ -1,16 +1,16 @@
----
-name: empty-error-loading-states
-description: Boş, hata, yükleniyor ve kısmi başarı durumlarını eyleme dönük tasarla; veri getiren arayüzlerde kullan.
-category: design
-appliesTo: [plan, implement, review]
-match: [empty state, boş durum, error state, hata durumu, loading, yükleniyor, skeleton, retry, partial]
----
-
-# Arayüz Durumları
-
-- İlk kullanım boşluğu, filtre sonucu boşluğu, izin yokluğu ve gerçek veri yokluğunu farklı ele al.
-- Yüklenirken düzeni sabit tut; bilinmeyen süre için ilerleme/skeleton, uzun işlem için durum ve iptal sun.
-- Hata metninde ne olduğunu, kullanıcı etkisini ve güvenli sonraki eylemi söyle; teknik ayrıntıyı sızdırma.
-- Retry yalnız güvenliyse göster; girilmiş veri ve önceki başarılı içeriği mümkünse koru.
-- Kısmi başarıyı tüm ekran hatası gibi sunma; güncellik ve eksik bölümü açık işaretle.
-- Durumları gerçek gecikme, offline, 401/403/404/429/5xx ve dar ekran koşullarında test et.
+---
+name: empty-error-loading-states
+description: Boş, hata, yükleniyor ve kısmi başarı durumlarını eyleme dönük tasarla; veri getiren arayüzlerde kullan.
+category: design
+appliesTo: [plan, implement, review]
+match: [empty state, boş durum, error state, hata durumu, loading, yükleniyor, skeleton, retry, partial]
+---
+
+# Arayüz Durumları
+
+- İlk kullanım boşluğu, filtre sonucu boşluğu, izin yokluğu ve gerçek veri yokluğunu farklı ele al.
+- Yüklenirken düzeni sabit tut; bilinmeyen süre için ilerleme/skeleton, uzun işlem için durum ve iptal sun.
+- Hata metninde ne olduğunu, kullanıcı etkisini ve güvenli sonraki eylemi söyle; teknik ayrıntıyı sızdırma.
+- Retry yalnız güvenliyse göster; girilmiş veri ve önceki başarılı içeriği mümkünse koru.
+- Kısmi başarıyı tüm ekran hatası gibi sunma; güncellik ve eksik bölümü açık işaretle.
+- Durumları gerçek gecikme, offline, 401/403/404/429/5xx ve dar ekran koşullarında test et.

package/orchestrator/skills/end-to-end-testing.md

@@ -1,16 +1,16 @@
----
-name: end-to-end-testing
-description: Kritik kullanıcı yolunu gerçek sistem sınırları boyunca güvenilir E2E testle doğrula; UI ve tam akış testlerinde kullan.
-category: testing
-appliesTo: [implement, review]
-match: [e2e, end to end, uçtan uca, playwright, cypress, browser test, kullanıcı akışı]
----
-
-# Uçtan Uca Test
-
-1. İş değeri yüksek, katmanlar arası tek bir kullanıcı yolunu seç; her ayrıntıyı E2E'ye taşıma.
-2. Testi erişilebilir rol, etiket ve görünen sonuçlarla sür; kırılgan CSS veya zamanlama seçicilerinden kaçın.
-3. Veriyi API/fixture ile deterministik kur, testler arasında benzersizleştir ve temizle.
-4. Sabit sleep yerine gözlemlenebilir koşulu bekle; retry ile gerçek flakiness'i gizleme.
-5. Başarısızlıkta ekran görüntüsü, trace, ağ ve uygulama logunu sakla.
-6. En az bir hata/izin yolunu ekleyip testi temiz ortamda tekrarlı çalıştır.
+---
+name: end-to-end-testing
+description: Kritik kullanıcı yolunu gerçek sistem sınırları boyunca güvenilir E2E testle doğrula; UI ve tam akış testlerinde kullan.
+category: testing
+appliesTo: [implement, review]
+match: [e2e, end to end, uçtan uca, playwright, cypress, browser test, kullanıcı akışı]
+---
+
+# Uçtan Uca Test
+
+1. İş değeri yüksek, katmanlar arası tek bir kullanıcı yolunu seç; her ayrıntıyı E2E'ye taşıma.
+2. Testi erişilebilir rol, etiket ve görünen sonuçlarla sür; kırılgan CSS veya zamanlama seçicilerinden kaçın.
+3. Veriyi API/fixture ile deterministik kur, testler arasında benzersizleştir ve temizle.
+4. Sabit sleep yerine gözlemlenebilir koşulu bekle; retry ile gerçek flakiness'i gizleme.
+5. Başarısızlıkta ekran görüntüsü, trace, ağ ve uygulama logunu sakla.
+6. En az bir hata/izin yolunu ekleyip testi temiz ortamda tekrarlı çalıştır.