@omerrgocmen/crewctl 1.0.0

package/orchestrator/skills/dashboard-design.md

@@ -0,0 +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.

package/orchestrator/skills/database-migration.md

@@ -0,0 +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.

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

@@ -0,0 +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.

package/orchestrator/skills/debugging.md

@@ -0,0 +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.

package/orchestrator/skills/dependency-review.md

@@ -0,0 +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.

package/orchestrator/skills/design-review.md

@@ -0,0 +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.

package/orchestrator/skills/design-system.md

@@ -0,0 +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.

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

@@ -0,0 +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.

package/orchestrator/skills/docs-troubleshooting.md

@@ -0,0 +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.

package/orchestrator/skills/docs-tutorial.md

@@ -0,0 +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.

package/orchestrator/skills/docs-writing.md

@@ -0,0 +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.

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

@@ -0,0 +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.

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

@@ -0,0 +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.

package/orchestrator/skills/error-handling.md

@@ -0,0 +1,16 @@
+---
+name: error-handling
+description: Hataları kaybetmeden sınıflandır, bağlam ekle ve güvenli biçimde kullanıcıya taşı; hata yolu tasarımında kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [error handling, hata yönetimi, exception, istisna, retry, timeout, fallback, failure]
+---
+
+# Hata Yönetimi
+
+1. Beklenen iş hatası, geçici altyapı hatası ve programlama hatasını ayır.
+2. Hatayı yakaladığın yerde çözebiliyorsan çöz; aksi halde özgün nedeni koruyarak bağlam ekleyip ilet.
+3. Kullanıcı mesajını uygulanabilir ve güvenli, log ayrıntısını tanılama için yeterli yap.
+4. Retry'ı yalnızca idempotent ve geçici hatalarda, sınırlı exponential backoff ile uygula.
+5. Timeout, iptal, kısmi başarı ve temizleme yollarını birinci sınıf davranış olarak ele al.
+6. Boş `catch`, sessiz fallback ve hassas veri içeren stack trace kullanma; hata yollarını test et.

package/orchestrator/skills/frontend-design.md

@@ -0,0 +1,28 @@
+---
+name: frontend-design
+description: Cilalı, tutarlı ve erişilebilir arayüz kurma rehberi — tasarım token'ları, bileşen ve durum disiplini
+category: design
+appliesTo: [implement]
+match: [ui, arayuz, arayüz, frontend, react, css, html, component, bilesen, bileşen, sayfa, landing, dashboard, tasarla]
+---
+
+# Beceri: Ön Yüz Tasarımı
+
+Arayüzü tek seferlik stiller yerine yeniden kullanılabilir bir sistemle kur.
+
+## İlkeler
+
+- **Token'lardan başla:** Renk, aralık, yarıçap, gölge ve tipografi için değişken/token tanımla; ham
+  hex ve sihirli piksel değerlerini bileşenlere serpme.
+- **Aralık ölçeği:** 4/8 px tabanlı tutarlı bir ölçek kullan.
+- **Bileşen bazlı:** Buton, input, kart gibi tekrar edenleri tek bir bileşene indir; kopyalama yapma.
+- **Tüm durumları uygula:** hover, focus-visible, active, disabled, hata, boş ve yükleniyor.
+- **Erişilebilirlik varsayılan olsun:** Anlamlı HTML, `label`/`aria`, klavye erişimi, görünür focus, AA kontrast.
+- **Responsive:** Akışkan düzen; sabit genişlik yerine min/max ve `clamp`. Küçük ekranı da test et.
+- **Tema uyumu:** Açık/koyu tema varsa iki temada da doğrula; sabit renk yerine token kullan.
+- **Hareket ölçülü:** Kısa, amaçlı geçişler; `prefers-reduced-motion` desteğini unutma.
+
+## Sınırlar
+
+Mevcut tasarım dilini ve bileşen kütüphanesini koru; gerekçesiz yeni bir stil sistemi ya da ağır
+bağımlılık ekleme. Değişikliği tarayıcıda görünür biçimde doğrula ve ne test ettiğini raporla.

package/orchestrator/skills/git-commit-writing.md

@@ -0,0 +1,16 @@
+---
+name: git-commit-writing
+description: Küçük ve açıklayıcı git commit kapsamı ile mesajı hazırla; commit planlama veya yazımında kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [git commit, commit message, conventional commit, commit mesajı, squash, değişiklik kaydı]
+---
+
+# Git Commit Yazımı
+
+- Tek bir mantıksal değişikliği seç; ilgisiz dosyaları veya kullanıcıya ait değişiklikleri dahil etme.
+- Proje convention'ını kontrol et; yoksa kısa, emir kipinde ve sonucu anlatan bir başlık yaz.
+- Conventional Commits kullanılıyorsa doğru tür ve yalnızca yararlı scope seç.
+- Gövdede ne değiştiğini tekrarlamak yerine nedenini, davranış etkisini ve önemli ödünleşimi açıkla.
+- Kırıcı değişiklik ve issue bağlantısını projenin beklediği biçimde belirt.
+- Commit öncesi staged farkı yeniden oku ve ilgili doğrulamayı çalıştır; test edilmemiş iddiada bulunma.

package/orchestrator/skills/graphql-design.md

@@ -0,0 +1,16 @@
+---
+name: graphql-design
+description: İstemci odaklı, evrilebilir ve maliyeti denetlenebilir GraphQL şeması tasarla; query, mutation ve resolver işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [graphql, query, mutation, resolver, schema, federation, dataloader]
+---
+
+# GraphQL Tasarımı
+
+- Şemayı veri tablosuna değil alan diline göre adlandır; nullability sözleşmesini bilinçli seç.
+- Query'leri yan etkisiz, mutation sonuçlarını hata ve güncel nesneyle kullanılabilir yap.
+- Liste alanlarında kararlı cursor sayfalama ve açık filtre/sıralama girdileri kullan.
+- N+1 sorguyu batching/caching ile önle; resolver maliyeti, derinlik ve karmaşıklık sınırı koy.
+- Yetkiyi yalnızca UI veya üst resolver'a bırakma; veri erişim sınırında doğrula.
+- Alan kaldırmak yerine deprecate et, şema değişimini tüketici sorguları ve entegrasyon testleriyle doğrula.

package/orchestrator/skills/incident-runbook.md

@@ -0,0 +1,18 @@
+---
+name: incident-runbook
+description: Bir üretim olayını güvenle teşhis edip sınırlandıracak uygulanabilir runbook yaz; operasyon ve sorun giderme işlerinde kullan.
+category: documentation
+appliesTo: [plan, implement, research]
+match: [incident, runbook, olay, outage, kesinti, production issue, operasyon, on-call, müdahale]
+---
+
+# Olay Runbook'u
+
+1. Tetikleyici belirtiyi, etkiyi ve ilk güvenlik kontrolünü açıkla.
+2. Komutları salt okunur teşhis adımlarından başlayarak sırala; beklenen çıktıyı ve karar dalını yaz.
+3. Sınırlandırma, geri alma ve servis azaltma seçeneklerinde kullanıcı/veri etkisini belirt.
+4. Her riskli adım için yetki, ön koşul, onay ve geri dönüş noktası ekle.
+5. İletişim sahibi, güncelleme sıklığı ve escalation eşiğini tanımla.
+6. Kurtarma sonrası bütünlük doğrulaması, izleme süresi ve postmortem girdilerini listele.
+
+Sır, gerçek müşteri verisi veya doğrulanmamış yıkıcı komut ekleme.

package/orchestrator/skills/input-validation.md

@@ -0,0 +1,16 @@
+---
+name: input-validation
+description: Güvenilmeyen girdiyi tür, biçim, boyut ve iş kuralıyla sınırda doğrula; form, API ve parser işlerinde kullan.
+category: security
+appliesTo: [plan, implement, review]
+match: [input validation, girdi doğrulama, sanitize, doğrula, schema validation, parser, untrusted input]
+---
+
+# Girdi Doğrulama
+
+- Her girdinin kaynağını ve ulaşacağı hassas sink'i belirle; istemci kontrolünü güvenlik sınırı sayma.
+- Tür, uzunluk, aralık, kodlama ve izin verilen biçimi allowlist yaklaşımıyla sunucuda doğrula.
+- Önce kanonikleştir, sonra doğrula; Unicode, çift kodlama ve boşluk varyantlarını düşün.
+- İş kurallarını ve alanlar arası koşulları şema doğrulamasından ayrı ama aynı sınırda uygula.
+- SQL/komut/HTML/URL güvenliği için doğrulamaya ek olarak bağlama uygun güvenli API veya çıktı kodlama kullan.
+- Hatalı, aşırı büyük ve sınır girdileri test et; kullanıcıya alan odaklı, sır sızdırmayan hata ver.

package/orchestrator/skills/integration-testing.md

@@ -0,0 +1,16 @@
+---
+name: integration-testing
+description: Bileşen sınırları ve gerçek adaptörler arasındaki sözleşmeleri doğrula; servis, veri tabanı ve entegrasyon testlerinde kullan.
+category: testing
+appliesTo: [implement, review]
+match: [integration test, entegrasyon testi, database test, service test, adapter, repository, boundary]
+---
+
+# Entegrasyon Testi
+
+- En yüksek riskli sınırı seç: veri tabanı, dosya sistemi, kuyruk, HTTP istemcisi veya servis adaptörü.
+- Üretime benzeyen gerçek bileşeni kullan; yalnızca kontrol edemediğin dış uçları fake et.
+- Şema, serileştirme, transaction, hata çevirisi ve timeout davranışını gözlemlenebilir sonuçla doğrula.
+- Test verisini her test için yalıt; sıra, saat, ağ ve önceki koşudan bağımsız çalıştır.
+- Başlangıç/temizleme kodunu güvenilir kıl ve başarısızlıkta tanılama çıktısını koru.
+- Mutlu yol yanında kopuk bağlantı, çakışma ve kısmi başarısızlık senaryosu ekle.

package/orchestrator/skills/interaction-design.md

@@ -0,0 +1,16 @@
+---
+name: interaction-design
+description: Kullanıcı eylemlerini görünür geri bildirim, güvenli geri alma ve tutarlı durum geçişleriyle tasarla; etkileşim işlerinde kullan.
+category: design
+appliesTo: [plan, implement, review]
+match: [interaction design, etkileşim tasarımı, ux flow, user flow, modal, feedback, undo, state transition]
+---
+
+# Etkileşim Tasarımı
+
+1. Kullanıcı hedefini, başlangıç durumunu, eylemleri ve başarı/hata son durumlarını akış olarak çıkar.
+2. Birincil eylemi belirgin, ikincil eylemi sakin tut; aynı ekranda rekabet eden CTA üretme.
+3. Her eyleme anlık ve doğru geri bildirim ver; optimistic UI'da başarısızlığı geri al.
+4. Geri döndürülebilir işlemde undo'yu, yıkıcı işlemde kapsam özeti ve bilinçli onayı tercih et.
+5. Klavye, focus, escape/back, çift tıklama ve eşzamanlı güncelleme davranışını tanımla.
+6. Akışı ilk kullanım, uzman kullanım, hata ve kesinti senaryolarıyla doğrula.

package/orchestrator/skills/landing-page-design.md

@@ -0,0 +1,16 @@
+---
+name: landing-page-design
+description: Net değer önerisi, güven ve tek birincil eylem etrafında yüksek kaliteli landing page tasarla; pazarlama sayfalarında kullan.
+category: design
+appliesTo: [plan, implement, review]
+match: [landing page, pazarlama sayfası, marketing page, hero, cta, conversion, dönüşüm, homepage]
+---
+
+# Landing Page Tasarımı
+
+- Hedef kitleyi, problemi, değer önerisini ve tek birincil dönüşümü bir cümlede netleştir.
+- İlk ekranda somut başlık, destekleyici kanıt ve açık CTA kur; soyut slogan yığını yapma.
+- Akışı problem → çözüm → nasıl çalışır → kanıt → itiraz → CTA sırasıyla düzenle.
+- Gerçek ürün görseli, ölçülebilir sonuç ve doğrulanabilir sosyal kanıt kullan; uydurma testimonial ekleme.
+- Tipografi, boşluk ve sınırlı renk paletiyle özgün hiyerarşi kur; erişilebilirlik ve performansı koru.
+- Mobil, yavaş ağ, uzun çeviri ve form hata durumlarında sayfayı doğrula.

package/orchestrator/skills/observability-design.md

@@ -0,0 +1,16 @@
+---
+name: observability-design
+description: Log, metrik ve trace sinyallerini kullanıcı etkisi ve tanılama sorularına göre tasarla; gözlemlenebilirlik işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [observability, gözlemlenebilirlik, telemetry, metric, metrik, trace, tracing, logging, monitoring]
+---
+
+# Gözlemlenebilirlik Tasarımı
+
+1. Önce yanıtlanacak operasyon sorularını yaz: ne bozuldu, kim etkilendi, nerede yavaşladı?
+2. Trafik, hata, gecikme ve doygunluk için az sayıda anlamlı metrik seç.
+3. İstek/iş kimliğini log ve trace boyunca taşı; yapılandırılmış, aranabilir alanlar kullan.
+4. Yüksek kardinaliteli kullanıcı/veri alanlarını metrik etiketi yapma; hassas veriyi kaydetme.
+5. Başarı kadar reddedilen, timeout olan ve retry edilen yolları da ölç.
+6. Sinyali dashboard/uyarı tüketicisiyle ve kontrollü hata senaryosuyla uçtan uca doğrula.

package/orchestrator/skills/openapi-contract.md

@@ -0,0 +1,16 @@
+---
+name: openapi-contract
+description: HTTP API davranışını doğrulanabilir OpenAPI sözleşmesine dönüştür; API şeması, istemci üretimi ve contract işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [openapi, swagger, api contract, api sözleşmesi, spec, schema, endpoint documentation]
+---
+
+# OpenAPI Sözleşmesi
+
+- Uygulamanın desteklediği OpenAPI sürümünü ve mevcut düzenini koru.
+- Her operation için kararlı kimlik, özet, parametre, istek gövdesi, başarı ve hata yanıtı tanımla.
+- Required, nullable, format, enum, sınır ve örnekleri gerçek çalışma zamanı doğrulamasıyla eşleştir.
+- Ortak şemaları yeniden kullan; aşırı kalıtım ve belirsiz serbest nesnelerden kaçın.
+- Kimlik doğrulama, sayfalama, idempotency ve hata modelini açıkça göster.
+- Spec'i linter/validator ile doğrula ve uygulama testleriyle sözleşme sapmasını yakala.

package/orchestrator/skills/performance-profiling.md

@@ -0,0 +1,16 @@
+---
+name: performance-profiling
+description: Performans sorununu ölçüm ve profil kanıtıyla bulup en dar darboğazı düzelt; yavaşlık ve optimizasyon işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review, research]
+match: [performance, performans, profiling, profile, yavaş, slow, latency, cpu, memory, benchmark]
+---
+
+# Performans Profilleme
+
+1. Kullanıcı etkisini ve başarı eşiğini tanımla; süre, throughput, bellek veya kaynak metriğini seç.
+2. Temsilî veri ve ısınma koşuluyla tekrarlanabilir baseline ölç.
+3. CPU, allocation, I/O, sorgu veya ağ profilinden baskın maliyeti bul; tahmine göre kod değiştirme.
+4. En dar nedeni hedefleyen küçük optimizasyon yap ve davranışı koruyan testleri çalıştır.
+5. Aynı koşulda önce/sonra dağılımını karşılaştır; tek ölçümü sonuç sayma.
+6. Kazanç, ödünleşim, veri boyutu ve kalan darboğazı raporla; ölçülmeyen “hızlandı” iddiası kurma.

package/orchestrator/skills/privacy-review.md

@@ -0,0 +1,16 @@
+---
+name: privacy-review
+description: Kişisel veri akışını minimizasyon, amaç, saklama ve kullanıcı kontrolü açısından incele; analytics ve veri özelliğinde kullan.
+category: security
+appliesTo: [plan, implement, review]
+match: [privacy, gizlilik, personal data, kişisel veri, pii, gdpr, kvkk, consent, analytics, telemetry]
+---
+
+# Gizlilik İncelemesi
+
+- Toplanan veriyi, kaynağı, amacı, alıcıyı, saklama süresini ve silme yolunu haritala.
+- Özellik için gerekmeyen alanı toplama; kimlik bağını mümkün olan en erken yerde azalt.
+- İzin/hukuki dayanak ve kullanıcı beklentisini ürün sahibinden doğrula; hukuki sonuç uydurma.
+- Log, telemetry, URL, cache, export ve üçüncü taraf aktarımında sızıntı yüzeyini incele.
+- Erişim, düzeltme, dışa aktarma, silme ve izin geri çekme akışlarının gerçekten çalıştığını test et.
+- Bulguları veri türü, etki, kanıt ve teknik azaltımla raporla; hukuki inceleme gereğini ayır.

package/orchestrator/skills/property-based-testing.md

@@ -0,0 +1,16 @@
+---
+name: property-based-testing
+description: Çok sayıda üretilmiş girdide değişmezleri ve sınırları doğrula; parser, dönüşüm ve algoritma testlerinde kullan.
+category: testing
+appliesTo: [implement, review]
+match: [property based testing, property test, özellik tabanlı test, quickcheck, hypothesis, fast-check, invariant, fuzz]
+---
+
+# Özellik Tabanlı Test
+
+- Örnek çıktılar yerine değişmezi tanımla: round-trip, idempotency, sıralama, korunum veya referans model.
+- Üreticiyi geçerli alanı temsil edecek şekilde kur; boş, uç, Unicode ve büyük değerleri ağırlıklandır.
+- Geçersiz girdiyi ayrı özellikte ve beklenen hata sınıfıyla test et.
+- Küçültmenin anlaşılır minimal karşı örnek ürettiğini kontrol et.
+- Seed ve başarısız örneği kaydet; regresyon için sabit örneğe dönüştür.
+- Sonsuz/çok pahalı vakaları boyut sınırıyla denetle ve özelliğin hatalı uygulamayı gerçekten yakaladığını sınayarak doğrula.

package/orchestrator/skills/pull-request-writing.md

@@ -0,0 +1,16 @@
+---
+name: pull-request-writing
+description: İncelenebilir kapsam, gerekçe ve doğrulama içeren pull request açıklaması hazırla; PR açma veya güncellemede kullan.
+category: documentation
+appliesTo: [implement, review]
+match: [pull request, pr description, merge request, değişiklik özeti, reviewer, inceleme açıklaması]
+---
+
+# Pull Request Yazımı
+
+- Başlığı kullanıcı etkisini anlatan tek bir değişikliğe odakla.
+- Özette sorunu, çözüm yaklaşımını ve neden bu kapsamın seçildiğini kısa yaz.
+- Davranış değişikliklerini, önemli dosyaları ve özellikle incelenmesi gereken riskli noktaları belirt.
+- Çalıştırılan testleri gerçek komut ve sonuçla listele; çalıştırılmayan kontrolü açıkça söyle.
+- UI değişiminde görsel kanıtı, veri/API değişiminde migration ve uyumluluk notunu ekle.
+- İlgili issue'yu bağla; büyük log, dosya listesi veya commit mesajlarını aynen tekrarlama.

package/orchestrator/skills/refactoring.md

@@ -0,0 +1,16 @@
+---
+name: refactoring
+description: Dış davranışı koruyarak kod yapısını küçük ve kanıtlanabilir adımlarla iyileştir; sadeleştirme işlerinde kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [refactor, refactoring, yeniden düzenleme, sadeleştir, simplify, cleanup, clean code, duplication]
+---
+
+# Refactoring
+
+1. Korunacak gözlemlenebilir davranışı ve mevcut test güvenlik ağını belirle.
+2. Somut kokuyu seç: tekrar, uzun işlev, yanlış sorumluluk, örtük bağımlılık veya gereksiz soyutlama.
+3. Her adımda tek yapısal değişiklik yap; özellik ekleme ve davranış düzeltmesini ayrı tut.
+4. Önce mevcut kavram ve yardımcıları yeniden kullan; spekülatif katman ekleme.
+5. Her küçük adım sonrası ilgili test ve statik kontrolleri çalıştır.
+6. Diff büyüdükçe kapsamı yeniden değerlendir; daha az kod ve daha açık bağımlılık hedefle.

package/orchestrator/skills/release-readiness.md

@@ -0,0 +1,16 @@
+---
+name: release-readiness
+description: Bir sürümün kalite, güvenlik, geçiş ve geri dönüş hazırlığını kanıtlarla denetle; yayın öncesinde kullan.
+category: software
+appliesTo: [plan, review]
+match: [release readiness, sürüm hazırlığı, go live, production release, yayın, deploy checklist, rollout]
+---
+
+# Sürüm Hazırlığı
+
+- Kapsamı ve kabul kriterlerini sürüm adayındaki gerçek commit/artefaktla eşleştir.
+- Zorunlu test, build, güvenlik ve uyumluluk kontrollerinin güncel kanıtını doğrula.
+- Yapılandırma, sır, migration, veri yedeği ve bağımlı servis ön koşullarını kontrol et.
+- Kademeli rollout, sağlık metriği, gözlem süresi, durdurma eşiği ve geri alma adımını tanımla.
+- Changelog, kullanıcı iletişimi, runbook ve destek sahipliğini doğrula.
+- Bilinmeyenleri risk/etki/sahip ile kaydet ve sonunda READY, CONDITIONAL veya NOT READY kararı ver.

package/orchestrator/skills/responsive-design.md

@@ -0,0 +1,16 @@
+---
+name: responsive-design
+description: İçeriğe göre akışkan, mobile-first ve zoom dayanıklı düzen kur; responsive CSS ve çoklu ekran işlerinde kullan.
+category: design
+appliesTo: [plan, implement, review]
+match: [responsive, duyarlı tasarım, mobile first, breakpoint, media query, viewport, tablet, reflow]
+---
+
+# Responsive Tasarım
+
+- En dar anlamlı görünümden başla; içerik önceliğini koruyarak progressive enhancement uygula.
+- Sabit genişlik yerine grid/flex, min/max, `clamp()` ve doğal wrapping kullan.
+- Breakpoint'i cihaz adına değil içeriğin bozulduğu noktaya koy; gereksiz varyant üretme.
+- Dokunma hedefi, okuma genişliği, görsel oranı, tablo ve navigasyon davranışını ayrı çöz.
+- Yatay kaydırmayı yalnız gerçekten iki boyutlu içerikte kontrollü kullan.
+- 320px'den geniş ekrana, %400 zoom'a, uzun metne, RTL'ye ve ekran klavyesine kadar test et.

package/orchestrator/skills/secrets-management.md

@@ -0,0 +1,16 @@
+---
+name: secrets-management
+description: Anahtar, token ve parolaları koddan ayırıp en az yetkiyle döndür; secret veya credential işlerinde kullan.
+category: security
+appliesTo: [plan, implement, review]
+match: [secret, sır, api key, token, credential, kimlik bilgisi, password, parola, vault, rotation]
+---
+
+# Sır Yönetimi
+
+- Sır envanterini, sahibini, tüketicisini ve gereken en dar yetkiyi belirle.
+- Sırrı kod, git geçmişi, örnek config, log, hata, build artefaktı veya istemci paketinde tutma.
+- Çalışma ortamının güvenli secret store/enjeksiyon mekanizmasını kullan; dosya ve process görünürlüğünü sınırla.
+- Kısa ömürlü kimlik ve otomatik rotation'ı statik uzun ömürlü anahtara tercih et.
+- Eksik/bozuk sırda güvenli biçimde fail et ve değeri maskeleyerek tanıla.
+- Sızıntıda iptal, döndürme, geçmiş temizliği ve etki incelemesi adımlarını tanımlayıp test et.

package/orchestrator/skills/secure-file-upload.md

@@ -0,0 +1,16 @@
+---
+name: secure-file-upload
+description: Dosya yüklemeyi tür, boyut, ad, depolama ve sunum sınırlarıyla güvenli kur; upload ve attachment işlerinde kullan.
+category: security
+appliesTo: [plan, implement, review]
+match: [file upload, dosya yükleme, attachment, multipart, mime, image upload, path traversal]
+---
+
+# Güvenli Dosya Yükleme
+
+1. İzin verilen iş amaçlı türleri, dosya/adet boyutunu ve kullanıcı kotasını allowlist ile sınırla.
+2. Uzantı, MIME ve magic byte'ı birlikte kontrol et; istemci adına veya Content-Type'a güvenme.
+3. Sunucu tarafında rastgele dosya adı üret, yolu kanonikleştir ve web root dışında depola.
+4. İçeriği mümkünse yeniden kodla/tara; arşiv açmada oran, derinlik ve yol sınırı uygula.
+5. İndirmeyi güvenli header, ayrı origin ve yetki kontrolüyle sun; aktif içeriği inline çalıştırma.
+6. Eksik, sahte, büyük, çift uzantılı ve eşzamanlı yükleme vakalarını test et.