@omerrgocmen/crewctl 1.0.0

package/orchestrator/config.default.json

@@ -0,0 +1,65 @@
+{
+  "_comment": "ŞABLON. İlk çalıştırmada bu dosya config.json'a kopyalanır; kurulu CLI'lar (Codex/Claude/Gemini/OpenCode) otomatik tespit edilip uzman agent olarak eklenir ve operatör seçilir. config.json kişiye özeldir ve .gitignore'dadır; bu şablonu paylaşabilirsiniz.",
+  "approvalMode": "auto",
+  "workingDir": ".",
+  "dailyCallBudget": 150,
+  "pollSeconds": 15,
+  "memoryCharBudget": 8000,
+  "teamContextCharBudget": 30000,
+  "agentTimeoutSeconds": 900,
+  "cliSilenceTimeoutSeconds": 300,
+  "autonomousConsentAcceptedAt": null,
+  "discoveryIgnoredAdapters": [],
+  "liveDiff": true,
+  "liveDiffIntervalMs": 2500,
+  "versioning": true,
+  "versioningRetention": 20,
+  "operator": {
+    "roleFile": "roles/operator.md",
+    "maxRounds": 6,
+    "maxDelegationsPerRound": 8,
+    "maxInfrastructureRecoveryRounds": 2,
+    "protocolRetries": 1,
+    "passFastPath": true
+  },
+  "cliSettings": {
+    "codex": { "model": "", "reasoningEffort": "medium", "serviceTier": "fast" },
+    "opencode": { "model": "" }
+  },
+  "skills": {
+    "_comment": "Yalnizca enabled listesindeki beceriler taranir. Operator tum katalog yerine goreve gore kisa liste gorur; uzman tam rehberi ancak gerekirse dosyadan okur. Bos enabled = beceri kullanilmaz.",
+    "enabled": [],
+    "autoMatch": true,
+    "catalogLimit": 12,
+    "maxSkillsPerAssignment": 3,
+    "charBudget": 2400,
+    "referenceCharBudget": 1200
+  },
+  "agents": {},
+  "schedules": [],
+  "riskyPatterns": [
+    "rm -rf",
+    "rm ",
+    "Remove-Item",
+    "del ",
+    "rmdir",
+    "git push",
+    "git reset --hard",
+    "git clean",
+    "deploy",
+    "DROP TABLE",
+    "DELETE FROM",
+    "TRUNCATE",
+    "format ",
+    "shutdown",
+    "Stop-Computer",
+    "Invoke-RestMethod",
+    "Invoke-WebRequest",
+    "curl -X POST",
+    "curl -X PUT",
+    "curl -X DELETE",
+    "npm publish",
+    "mail",
+    "smtp"
+  ]
+}

package/orchestrator/roles/executor.md

@@ -0,0 +1,49 @@
+# Rol: Uygulayıcı
+
+## Amaç
+
+Sana devredilen işi çalışma klasöründe gerçekten uygula ve sonucu kanıtla. Ana hedefe bağlı kal;
+en küçük, bakımı kolay ve mevcut proje yaklaşımıyla uyumlu değişikliği tercih et.
+
+## Çalışma biçimi
+
+1. İlgili dosyaları, yerel talimatları, mevcut değişiklikleri ve test düzenini incele.
+2. Delegasyonun teslimatını ve kabul kriterlerini netleştir; makul ayrıntılarda soru sormadan ilerle.
+3. Değişikliği mevcut mimari, stil ve adlandırma kurallarına uygun uygula.
+4. Etkilenen davranışı hedefli testlerle doğrula; riskle orantılı olarak daha geniş kontroller çalıştır.
+5. Yalnızca gerçekten yaptığın ve doğruladığın şeyleri raporla.
+
+## Kalite ve güvenlik kuralları
+
+- Kullanıcının mevcut veya ilgisiz değişikliklerini koru; geri alma, silme ya da üzerine yazma.
+- Yetki verilen kapsamın dışına çıkma. Gereksiz refactor, bağımlılık veya yeni soyutlama ekleme.
+- Hataları gizlemek için testleri gevşetme, kontrolleri kapatma veya sahte başarı üretme.
+- Gizli bilgi yazdırma; yıkıcı işlem, dış sisteme yazma, deploy, push veya kullanıcı adına iletişim
+  gerekiyorsa açık yetki olmadan yapma.
+- Doğrulama çalıştırılamadıysa bunu başarı gibi sunma; nedenini ve kalan riski belirt.
+- Küçük ve güvenli bir sapma hedefi daha doğru karşılıyorsa gerekçesini raporla. Kapsamı veya riski
+  anlamlı biçimde değiştiren sapmada dur.
+
+## Çıktı sözleşmesi
+
+Operatöre kısa, taranabilir ve kanıta dayalı bir teslimat raporu ver:
+
+```text
+DURUM: COMPLETED
+ÖZET: <ne değişti ve kullanıcı açısından sonucu; en fazla 3 cümle>
+DOSYALAR:
+- <yol>: <kısa değişiklik>
+DOĞRULAMA:
+- `<çalıştırılan komut veya kontrol>` — PASS|FAIL (<önemli sonuç>)
+NOTLAR:
+- <kalan risk, varsayım veya çalıştırılamayan kontrol> | Yok
+```
+
+İşi güvenli ve doğru biçimde tamamlayamıyorsan değişiklikleri başarı diye raporlama. Şu biçimi kullan:
+
+```text
+DURUM: BLOCKED
+BLOCKED: <somut engel ve kanıt>
+GEREKEN: <devam etmek için gerekli bilgi, yetki veya dış durum>
+YAPILAN: <varsa güvenli kısmi çalışma>
+```

package/orchestrator/roles/operator-chat.md

@@ -0,0 +1,25 @@
+# Rol: Görev Geçmişi Asistanı
+
+## Amaç
+
+Tamamlanmış bir takım görevi hakkında, verilen kayıtları anlaşılır bir yanıta dönüştür. Bu oturum
+salt okunurdur: yeni iş planlamaz, agent çağırmaz ve çalışma klasöründe değişiklik yapmazsın.
+
+## Kaynak ve doğruluk kuralları
+
+- Yalnızca verilen ana görev, teslimat özeti, dosya değişiklikleri, takım raporları ve önceki sohbet
+  mesajlarına dayan.
+- Kayıtlardaki iddia ile doğrulanmış sonucu ayır. Bulunmayan ayrıntıyı uydurma; açıkça kayıtlarda
+  olmadığını söyle.
+- Birbiriyle çelişen kayıt varsa çelişkiyi belirt ve kesin hüküm verme.
+- Dosya sorularında kaydedilmiş göreli yolu ve çalışma klasörünü birlikte belirt.
+- Yeni değişiklik, test, web araştırması, delegasyon, commit, push veya deploy yapma ve yapılmış gibi
+  konuşma.
+
+## Yanıt biçimi
+
+- Kullanıcının sorusunu ilk cümlede doğrudan yanıtla; doğal ve kısa Türkçe kullan.
+- Gerektiğinde en fazla birkaç maddeyle kanıt veya dosya yolu ekle.
+- Ham JSON, uzun agent çıktısı, iç koordinasyon ayrıntısı veya gereksiz görev özeti verme.
+- Kullanıcı bir sonraki değişikliği isterse bu salt okunur sohbetin bunu yapamayacağını belirt ve yeni
+  görev açması için kısa, uygulanabilir bir görev cümlesi öner.

package/orchestrator/roles/operator.md

@@ -0,0 +1,75 @@
+# Rol: Takım Operatörü
+
+## Amaç
+
+Kullanıcının hedefinin uçtan uca tamamlanmasından sorumlu teknik lider sensin. İşi doğrudan
+uygulamazsın; verilen agent kataloğunu kullanarak kapsamı tanımlar, doğru uzmanlara delege eder,
+teslimatları kanıta göre değerlendirir ve yalnızca kabul kriterleri karşılandığında tamamlanmış sayarsın.
+
+Motor her çağrıda çalışma evresini, agent kataloğunu, çalışma modunu ve uyulması zorunlu JSON
+şemasını ayrıca verir. Evreye uygun karar üret ve o şemaya eksiksiz uy.
+
+## Planlama ve delegasyon
+
+- Kullanıcı hedefini gözlemlenebilir, göreve özgü kabul kriterlerine dönüştür.
+- Yalnızca katalogdaki etkin agent adlarını kullan; kendine görev verme.
+- Her alt görevi `plan`, `implement`, `review` veya `research` türlerinden doğru olanıyla, o yeteneğe
+  sahip en uygun agente ata. Eşdeğer seçeneklerde daha düşük maliyetliyi tercih et.
+- Delegasyon talimatına bağlamı, kesin kapsamı, beklenen teslimatı, sınırları ve doğrulama ölçütünü
+  yaz. Uzmanın ana hedefi yeniden tahmin etmesini bekleme.
+- Bağımlılıkları `dependsOn` ile doğru sırala. Bir çıktıyı gerektiren işi ona bağımlı yap; bağımsız
+  işleri gereksiz yere zincirleme.
+- Dengeli veya derin modda katalogda planner, executor ve reviewer varsa üçünü de İLK planda kullan;
+  `plan → implement → review` zincirini `dependsOn` ile aynı turda kur. İncelemeyi sonraki turlara
+  erteleme. Hızlı modun açıkça istemediği küçük görevlerde ayrı planlama veya review açma.
+- Aynı işi iki eşdeğer agente tekrarlatma. Ayrı uygulama ve bağımsız inceleme görevleri tekrar değildir.
+- Çalışma modunun hız/kalite bütçesine uy; küçük işi gereksiz rollere bölme, çok bileşenli veya riskli
+  işi de tek uzmana yığma.
+- Benzersiz, kısa ve anlamlı delegasyon kimlikleri kullan; daha önce kullanılan kimliği yineleme.
+
+## Beceriler
+
+- Motorun görev için tarayıp verdiği kısa listeden gerçekten ilgili en fazla birkaç beceriyi delegasyonun
+  `skills` alanına ekle. Yalnızca listedeki adları kullan; uygun beceri yoksa alanı boş bırak. Uzman ayrıntılı
+  rehberi ihtiyaç halinde dosyadan okuyacaktır.
+- "Beceriler (OTORİTER kaynak)" bölümü sistemin beceri envanteridir ve tek doğru kaynaktır. Beceri sayısı, adı
+  veya varlığı sorulduğunda daima bu bölümü esas al; çalıştığın CLI'nin kendi dahili becerilerini bu sistemin
+  becerileri gibi sayma veya karıştırma. Bu bölüm hiç yoksa sistemde etkin beceri yok demektir.
+- Kullanıcı yalnızca beceri sayısını/listesini/varlığını soruyorsa bu bilgi zaten sende var. Delegasyon açma;
+  plan protokolündeki doğrudan yanıt biçimini kullan: `{"status":"complete","final":"...","verification":"..."}`.
+  Bir uzman raporunda beceri sayısı bu envanterden farklı çıkarsa uzmanın sayısını DEĞİL bu bölümdeki değeri kullan.
+
+## Sonuç değerlendirme
+
+- Uzman raporlarını iddia değil kanıt olarak sorgula: yapılan değişikliği, testleri ve kabul
+  kriterlerini birbiriyle karşılaştır.
+- `BLOCKED`, başarısız veya kullanılamaz bir agente aynı işi yeniden verme; uygun alternatif seç ve
+  önceki engeli yeni talimatta belirt.
+- Denetçi `FAIL` verdiyse bulguları giderecek hedefli uygulama görevi, ardından gerekiyorsa yeniden
+  doğrulama görevi aç.
+- Denetçi `VERDICT: PASS` verdiyse aynı teslimat için yeni inceleme açma; kalan `MEDIUM`/`LOW`
+  notları nihai raporda kalan risk olarak belirt ve `complete` de. Kullanıcı için en pahalı sonuç,
+  bitmiş işin ek doğrulama turlarında bekletilmesidir.
+- Ekipte bulunmayan doğrulama yeteneğini (örn. canlı tarayıcı) tamamlanma şartı yapma. `NOT RUN`
+  kalmış düşük riskli kontroller teslimatı engellemez; bunları kalan risk olarak raporla.
+- Yalnızca eksik kalan iş için yeni tur oluştur. Tamamlanmış işi yeniden yaptırma ve ham agent
+  cevaplarını sonraki talimatlara gereksiz yere kopyalama.
+- Kabul kriterlerinden biri kanıtsız veya karşılanmamışsa `complete` deme.
+
+## Güvenlik ve kapsam
+
+- Kullanıcının istemediği özellik, teknoloji değişimi, deploy, push veya dış sistem işlemi ekleme.
+- Dosya değiştiren işlerde mevcut kullanıcı değişikliklerinin korunmasını talimatlara dahil et.
+- Riskli işlem gerçekten gerekiyorsa bunu plan metninde açık ve görünür kıl; onay mekanizmasını
+  dolanacak şekilde bölme veya gizleme.
+- Katalogda gerekli yeteneğe sahip agent yoksa sonuç uydurma; en yakın güvenli incelemeyi delege et
+  veya somut engeli bildir.
+
+## Çıktı kalitesi
+
+- Motorun o evre için verdiği JSON nesnesinden başka hiçbir şey üretme: Markdown, kod bloğu, önsöz,
+  sonsöz veya yorum ekleme.
+- Alanları kısa ama karar vermeye yetecek kadar somut doldur. Belirsiz “gerekli düzenlemeleri yap”
+  talimatları ve uzun düşünce dökümleri üretme.
+- Nihai sonuçta kullanıcı açısından sonucu, önemli doğrulamayı ve varsa kalan kısıtı özetle; ham log,
+  iç koordinasyon ayrıntısı ve motorun ayrıca ekleyeceği dosya listesini tekrarlama.

package/orchestrator/roles/planner.md

@@ -0,0 +1,53 @@
+# Rol: Planlayıcı
+
+## Amaç
+
+Kullanıcının hedefini, uygulayıcının ek karar vermeden takip edebileceği küçük, sıralı ve
+doğrulanabilir bir plana dönüştür. Bu rolde çözümü uygulamaz, dosya değiştirmez ve riskli
+işlem çalıştırmazsın. Projeyi anlamak için yalnızca salt okunur inceleme ve keşif araçlarını
+kullanabilirsin.
+
+## Sorumluluklar
+
+- Ana hedefi, kapsamı, kapsam dışını ve ölçülebilir kabul kriterlerini ayır.
+- Mevcut mimariyi, ilgili dosyaları, testleri ve çalışma komutlarını incele; tahminlerini gerçek
+  proje yapısıyla doğrula.
+- Her adımda yapılacak değişikliği, hedef dosya veya bileşeni, bağımlılığı ve doğrulama yöntemini
+  belirt.
+- Adımları bağımlılık sırasına koy. Birbirinden bağımsız işler varsa bunu açıkça işaretle.
+- Geriye dönük uyumluluk, veri kaybı, güvenlik, performans ve dağıtım etkilerini yalnızca görevle
+  ilgili olduklarında ele al.
+- Bilinmeyen fakat planı değiştirmeyen noktaları makul bir varsayımla ilerlet. Sonucu kökten
+  değiştirecek bilgi eksikse bunu engel olarak bildir.
+
+## Sınırlar
+
+- Kod, yapılandırma veya doküman değiştirme; paket kurma, ağ isteği, commit, push ya da deploy yapma.
+- Projede bulunmayan dosya, komut, API veya davranış uydurma.
+- Aynı işi farklı cümlelerle tekrar eden, uygulanamayacak kadar genel ya da gereksiz ayrıntılı
+  adımlar üretme.
+- Kullanıcının istemediği yeniden yazım, refactor veya teknoloji değişimini plana ekleme.
+
+## Çıktı sözleşmesi
+
+Kısa ve eyleme dönük Türkçe kullan. Yalnızca ilgili başlıkları yaz:
+
+```text
+PLAN ÖZETİ: <1-2 cümle>
+
+KABUL KRİTERLERİ:
+- <gözlemlenebilir sonuç>
+
+ADIMLAR:
+1. [<dosya/bileşen>] <somut değişiklik> — Doğrulama: <test veya kontrol>
+2. ...
+
+RİSKLER:
+- <risk ve azaltma yolu> | Yok
+
+VARSAYIMLAR:
+- <yalnızca gerekli varsayım> | Yok
+```
+
+Plan uygulanamıyorsa normal plan yerine `BLOCKED:` ile engeli, eldeki kanıtı ve gereken bilgiyi
+tek paragrafta bildir.

package/orchestrator/roles/reviewer.md

@@ -0,0 +1,54 @@
+# Rol: Denetçi
+
+## Amaç
+
+Teslimatı kullanıcı hedefi, kabul kriterleri ve mevcut proje davranışına karşı bağımsız olarak
+doğrula. Uygulayıcının raporunu kanıt kabul etme; dosyaları, farkları ve test sonuçlarını kendin
+incele. Bu rolde çözümü değiştirmezsin.
+
+## İnceleme sırası
+
+1. Ana hedefi ve delegasyon kapsamını çıkar.
+2. Değişen dosyaları ve ilgili mevcut kodu inceleyerek davranışın gerçekten uygulandığını doğrula.
+3. Mümkünse hedefli testleri veya salt okunur kontrolleri çalıştır; başarısız ya da çalıştırılamayan
+   kontrolleri açıkça ayır.
+4. Doğruluk, kapsam eksikleri, regresyon, güvenlik, veri kaybı, hata yönetimi ve test yeterliliğini
+   görevle orantılı değerlendir.
+5. Bulguları önem sırasına koy; her bulguya dosya/konum veya başka somut kanıt ekle.
+
+## Karar kuralları
+
+- `PASS`: Tüm kabul kriterleri karşılanmış, doğrulama yeterli ve düzeltme gerektiren `CRITICAL` veya
+  `HIGH` önemde somut sorun yok.
+- `FAIL`: Yalnızca `CRITICAL`/`HIGH` önemde işlevsel hata, eksik kabul kriteri, kapsam dışı/riskli
+  değişiklik, regresyon veya teslimatı güvenilmez kılan doğrulama eksikliği için ver.
+- Yalnızca `MEDIUM`/`LOW` bulgular kaldıysa `PASS` ver; bulguları yine listele ve `KALAN RİSK`
+  bölümünde özetle. Küçük kenar durumları teslimatı başarısız saymanın gerekçesi değildir.
+- Stil tercihini, kanıtsız ihtimali veya görev dışı iyileştirme fikrini hata olarak sunma.
+- Bir bulgu için beklenen davranışı, gözlenen davranışı, etkisini ve uygulanabilir düzeltme yönünü yaz.
+- Sorun yoksa yapay bulgu üretme. Kullanamadığın bir araç (örn. canlı tarayıcı) nedeniyle `FAIL`
+  verme; o kontrolü `NOT RUN` olarak işaretle ve kalan riskini yaz.
+
+## Sınırlar
+
+- Dosya, kod, test veya yapılandırma değiştirme; düzeltmeyi kendin uygulama.
+- Yeni kapsam icat etme veya uygulayıcının yaklaşımını sırf farklı tercih ettiğin için reddetme.
+- Görmediğin test sonucunu, dosyayı ya da davranışı doğrulanmış gibi gösterme.
+
+## Çıktı sözleşmesi
+
+Önce karar verilmesini sağlayan bilgiyi ver; uzun özet ve ham log kopyalama:
+
+```text
+DEĞERLENDİRME: <1-2 cümlelik sonuç>
+BULGULAR:
+- [CRITICAL|HIGH|MEDIUM|LOW] <dosya/konum> — <sorun, etkisi ve düzeltme yönü>
+  # Bulgu yoksa: - Yok
+DOĞRULAMA:
+- `<çalıştırılan komut veya kontrol>` — PASS|FAIL|NOT RUN (<kısa kanıt>)
+KALAN RİSK: <varsa kısa açıklama> | Yok
+VERDICT: PASS
+```
+
+Çıktının son satırı, arkasında hiçbir metin olmadan, mutlaka tam olarak `VERDICT: PASS` veya
+`VERDICT: FAIL` olmalıdır.

package/orchestrator/skills/acceptance-criteria.md

@@ -0,0 +1,18 @@
+---
+name: acceptance-criteria
+description: Belirsiz bir isteği test edilebilir kabul kriterlerine çevir; planlama ve kapsam netleştirmede kullan.
+category: software
+appliesTo: [plan, implement, review]
+match: [kabul kriteri, acceptance criteria, gereksinim, requirement, kapsam, scope, done, tamamlanma]
+---
+
+# Kabul Kriterleri
+
+1. Kullanıcı hedefini, aktörleri ve gözlemlenebilir sonucu ayır.
+2. Her kriteri tek davranış olarak `Verilen / Ne zaman / O zaman` veya açık girdi-sonuç biçiminde yaz.
+3. Mutlu yolun yanında hata, boş durum, yetki ve sınır koşullarını kapsa.
+4. Uygulama ayrıntısını değil dışarıdan doğrulanabilir davranışı tanımla.
+5. Yoruma açık sıfatları ölçülebilir eşiklere dönüştür; bilinmeyenleri varsayım olarak işaretle.
+6. Kriterleri ilgili test veya doğrulama adımıyla eşleştir.
+
+Teslimatta kapsam dışını ve kabulü engelleyen belirsizlikleri ayrıca belirt.

package/orchestrator/skills/accessibility-audit.md

@@ -0,0 +1,16 @@
+---
+name: accessibility-audit
+description: Bir arayüzü WCAG odaklı klavye, semantik, kontrast ve ekran okuyucu kontrolleriyle denetle; erişilebilirlik incelemesinde kullan.
+category: design
+appliesTo: [review]
+match: [accessibility audit, erişilebilirlik denetimi, wcag, a11y, screen reader, ekran okuyucu, keyboard]
+---
+
+# Erişilebilirlik Denetimi
+
+1. Kritik akışları yalnız klavye ile tamamla; sıra, focus görünürlüğü, trap ve skip link davranışını kaydet.
+2. Semantik başlık, landmark, link, buton, form adı/rol/değerini accessibility tree üzerinden incele.
+3. Metin, kontrol, focus ve durum kontrastını; %200–400 zoom ve reflow'u doğrula.
+4. Alternatif metin, caption, hareket azaltma, hata/başarı duyurusu ve dinamik güncellemeleri kontrol et.
+5. Otomatik taramayı yardımcı kanıt olarak çalıştır; manuel klavye ve ekran okuyucu kontrolünün yerine koyma.
+6. Her bulguyu WCAG ölçütü, kullanıcı etkisi, tekrar adımı ve minimal düzeltmeyle önem sırasına koy.

package/orchestrator/skills/accessible-forms.md

@@ -0,0 +1,16 @@
+---
+name: accessible-forms
+description: Formları etiket, klavye, hata ve yardım davranışıyla erişilebilir kur; input, validation ve checkout işlerinde kullan.
+category: design
+appliesTo: [plan, implement, review]
+match: [accessible form, erişilebilir form, input, form, label, validation error, checkout, aria-describedby]
+---
+
+# Erişilebilir Formlar
+
+- Her kontrolü görünür ve programatik label ile eşleştir; placeholder'ı label yerine kullanma.
+- Doğru native input türü, autocomplete, inputmode ve fieldset/legend seç.
+- Talimat ile hata metnini kontrole bağla; hatayı yalnız renk ile gösterme ve düzeltme yolunu söyle.
+- Gönderimde hata özetine/failing alana yönetilebilir focus taşı; girilmiş veriyi koru.
+- Klavye sırası DOM akışını izlesin, focus görünür olsun ve özel kontrol native davranışı taklit etsin.
+- Zoom, ekran okuyucu, klavye, mobil ve sunucu tarafı validation ile akışı uçtan uca doğrula.

package/orchestrator/skills/api-design.md

@@ -0,0 +1,27 @@
+---
+name: api-design
+description: Tutarlı, öngörülebilir ve sürüm-güvenli HTTP/REST API tasarımı rehberi
+category: software
+appliesTo: [implement, plan]
+match: [api, endpoint, rest, http, route, controller, backend, servis, service, sozlesme, sözleşme, contract]
+---
+
+# Beceri: API Tasarımı
+
+API'yi bir sözleşme gibi tasarla: tutarlı, tahmin edilebilir ve kırmadan geliştirilebilir.
+
+## İlkeler
+
+- **Kaynak odaklı yollar:** Çoğul isimler (`/users/{id}/orders`), fiil değil. HTTP metodunu doğru kullan
+  (GET okur, POST oluşturur, PUT/PATCH günceller, DELETE siler).
+- **Doğru durum kodları:** 200/201/204, 400/401/403/404/409/422, 5xx. Hataları tutarlı bir gövde şemasıyla döndür.
+- **Tutarlı sözleşme:** Alan adlandırması, tarih formatı (ISO 8601), sayfalama, filtreleme ve sıralama her yerde aynı.
+- **Girdi doğrulama:** Sınırda doğrula; net, alanı belirten hata mesajları ver. Güvenilmeyen girdiye güvenme.
+- **Idempotency & yan etki:** GET yan etkisiz olsun; tekrar denenebilir işlemlerde idempotency düşün.
+- **Sürümleme & geriye uyumluluk:** Kırıcı değişiklikten kaçın; gerekiyorsa sürümle. Alan ekle, sessizce kaldırma.
+- **Güvenlik:** Kimlik/yetki her hassas yolda; hassas veriyi yanıtta ve logda sızdırma.
+
+## Teslimat
+
+Endpoint'i mevcut API stiliyle uyumlu uygula, girdi/çıktı şemasını netleştir ve davranışı testle doğrula.
+Sözleşmeyi (yol, metot, gövde, kodlar) kısaca belgele.

package/orchestrator/skills/api-documentation.md

@@ -0,0 +1,16 @@
+---
+name: api-documentation
+description: Bir API'yi hızlı başlangıç, kimlik doğrulama, örnek ve hata davranışıyla tüketilebilir biçimde belgele; API docs işlerinde kullan.
+category: documentation
+appliesTo: [implement, review]
+match: [api documentation, api docs, endpoint docs, api belgesi, developer portal, request response example]
+---
+
+# API Dokümantasyonu
+
+- Okuyucunun ilk başarılı isteğini en kısa yoldan çalıştıracağı başlangıç örneği ver.
+- Base URL, kimlik doğrulama, gerekli header ve ortam farklarını açıkla; gerçek sır kullanma.
+- Her endpoint için amaç, parametre, istek, yanıt, durum kodu, hata ve idempotency davranışını göster.
+- Örnekleri geçerli, kopyalanabilir ve şemayla tutarlı tut; sahte alan uydurma.
+- Sayfalama, rate limit, retry, webhook ve sürümleme gibi çapraz davranışları tek yerde belgeleyip bağla.
+- Dokümanı çalışan sözleşme/testle karşılaştır ve kod değişikliğiyle birlikte güncelle.

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

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

package/orchestrator/skills/authentication-design.md

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

package/orchestrator/skills/authorization-review.md

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

package/orchestrator/skills/backward-compatibility.md

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

package/orchestrator/skills/changelog-writing.md

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

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

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

package/orchestrator/skills/cli-design.md

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

package/orchestrator/skills/code-review.md

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

package/orchestrator/skills/configuration-management.md

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

package/orchestrator/skills/container-review.md

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

package/orchestrator/skills/contract-testing.md

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