@omerrgocmen/crewctl 1.1.1 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (91) hide show
  1. package/README.md +193 -193
  2. package/orchestrator/README.md +473 -462
  3. package/orchestrator/config.default.json +79 -71
  4. package/orchestrator/roles/executor.md +57 -57
  5. package/orchestrator/roles/operator.md +77 -77
  6. package/orchestrator/roles/planner.md +58 -58
  7. package/orchestrator/roles/reviewer.md +63 -63
  8. package/orchestrator/skills/acceptance-criteria.md +18 -18
  9. package/orchestrator/skills/accessibility-audit.md +16 -16
  10. package/orchestrator/skills/accessible-forms.md +16 -16
  11. package/orchestrator/skills/api-design.md +27 -27
  12. package/orchestrator/skills/api-documentation.md +16 -16
  13. package/orchestrator/skills/architecture-decision-record.md +18 -18
  14. package/orchestrator/skills/authentication-design.md +16 -16
  15. package/orchestrator/skills/authorization-review.md +16 -16
  16. package/orchestrator/skills/backward-compatibility.md +17 -17
  17. package/orchestrator/skills/changelog-writing.md +16 -16
  18. package/orchestrator/skills/ci-pipeline-design.md +16 -16
  19. package/orchestrator/skills/cli-design.md +16 -16
  20. package/orchestrator/skills/code-review.md +27 -27
  21. package/orchestrator/skills/configuration-management.md +16 -16
  22. package/orchestrator/skills/container-review.md +16 -16
  23. package/orchestrator/skills/contract-testing.md +16 -16
  24. package/orchestrator/skills/dashboard-design.md +16 -16
  25. package/orchestrator/skills/database-migration.md +16 -16
  26. package/orchestrator/skills/database-schema-design.md +16 -16
  27. package/orchestrator/skills/debugging.md +26 -26
  28. package/orchestrator/skills/dependency-review.md +16 -16
  29. package/orchestrator/skills/design-review.md +29 -29
  30. package/orchestrator/skills/design-system.md +16 -16
  31. package/orchestrator/skills/docs-api-reference.md +16 -16
  32. package/orchestrator/skills/docs-troubleshooting.md +16 -16
  33. package/orchestrator/skills/docs-tutorial.md +16 -16
  34. package/orchestrator/skills/docs-writing.md +25 -25
  35. package/orchestrator/skills/empty-error-loading-states.md +16 -16
  36. package/orchestrator/skills/end-to-end-testing.md +16 -16
  37. package/orchestrator/skills/error-handling.md +16 -16
  38. package/orchestrator/skills/frontend-design.md +28 -28
  39. package/orchestrator/skills/git-commit-writing.md +16 -16
  40. package/orchestrator/skills/graphql-design.md +16 -16
  41. package/orchestrator/skills/incident-runbook.md +18 -18
  42. package/orchestrator/skills/input-validation.md +16 -16
  43. package/orchestrator/skills/integration-testing.md +16 -16
  44. package/orchestrator/skills/interaction-design.md +16 -16
  45. package/orchestrator/skills/landing-page-design.md +16 -16
  46. package/orchestrator/skills/observability-design.md +16 -16
  47. package/orchestrator/skills/openapi-contract.md +16 -16
  48. package/orchestrator/skills/performance-profiling.md +16 -16
  49. package/orchestrator/skills/privacy-review.md +16 -16
  50. package/orchestrator/skills/property-based-testing.md +16 -16
  51. package/orchestrator/skills/pull-request-writing.md +16 -16
  52. package/orchestrator/skills/refactoring.md +16 -16
  53. package/orchestrator/skills/release-readiness.md +16 -16
  54. package/orchestrator/skills/responsive-design.md +16 -16
  55. package/orchestrator/skills/secrets-management.md +16 -16
  56. package/orchestrator/skills/secure-file-upload.md +16 -16
  57. package/orchestrator/skills/security-review.md +26 -26
  58. package/orchestrator/skills/semantic-versioning.md +17 -17
  59. package/orchestrator/skills/seo-on-page.md +16 -16
  60. package/orchestrator/skills/seo-structured-data.md +16 -16
  61. package/orchestrator/skills/seo-technical-audit.md +16 -16
  62. package/orchestrator/skills/sql-query-review.md +16 -16
  63. package/orchestrator/skills/supply-chain-security.md +16 -16
  64. package/orchestrator/skills/test-strategy.md +16 -16
  65. package/orchestrator/skills/threat-modeling.md +16 -16
  66. package/orchestrator/skills/unit-testing.md +16 -16
  67. package/orchestrator/skills/write-tests.md +28 -28
  68. package/orchestrator/src/cli-registry.js +740 -682
  69. package/orchestrator/src/cli.js +140 -135
  70. package/orchestrator/src/doctor.js +64 -64
  71. package/orchestrator/src/engine.js +1735 -1630
  72. package/orchestrator/src/schedule.js +126 -126
  73. package/orchestrator/src/server.js +818 -795
  74. package/orchestrator/src/skill-registry.js +272 -272
  75. package/orchestrator/src/store.js +470 -426
  76. package/orchestrator/web/OrbitControls.js +1417 -1417
  77. package/orchestrator/web/board.html +146 -146
  78. package/orchestrator/web/code.html +213 -213
  79. package/orchestrator/web/flow.html +741 -741
  80. package/orchestrator/web/index.html +602 -602
  81. package/orchestrator/web/jsm/postprocessing/EffectComposer.js +231 -231
  82. package/orchestrator/web/jsm/postprocessing/MaskPass.js +104 -104
  83. package/orchestrator/web/jsm/postprocessing/Pass.js +95 -95
  84. package/orchestrator/web/jsm/postprocessing/RenderPass.js +99 -99
  85. package/orchestrator/web/jsm/postprocessing/ShaderPass.js +77 -77
  86. package/orchestrator/web/jsm/postprocessing/UnrealBloomPass.js +415 -415
  87. package/orchestrator/web/jsm/shaders/CopyShader.js +45 -45
  88. package/orchestrator/web/jsm/shaders/LuminosityHighPassShader.js +66 -66
  89. package/orchestrator/web/site.webmanifest +12 -12
  90. package/orchestrator/web/three.module.min.js +6 -6
  91. package/package.json +51 -51
@@ -1,16 +1,16 @@
1
- ---
2
- name: error-handling
3
- 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.
4
- category: software
5
- appliesTo: [plan, implement, review]
6
- match: [error handling, hata yönetimi, exception, istisna, retry, timeout, fallback, failure]
7
- ---
8
-
9
- # Hata Yönetimi
10
-
11
- 1. Beklenen iş hatası, geçici altyapı hatası ve programlama hatasını ayır.
12
- 2. Hatayı yakaladığın yerde çözebiliyorsan çöz; aksi halde özgün nedeni koruyarak bağlam ekleyip ilet.
13
- 3. Kullanıcı mesajını uygulanabilir ve güvenli, log ayrıntısını tanılama için yeterli yap.
14
- 4. Retry'ı yalnızca idempotent ve geçici hatalarda, sınırlı exponential backoff ile uygula.
15
- 5. Timeout, iptal, kısmi başarı ve temizleme yollarını birinci sınıf davranış olarak ele al.
16
- 6. Boş `catch`, sessiz fallback ve hassas veri içeren stack trace kullanma; hata yollarını test et.
1
+ ---
2
+ name: error-handling
3
+ 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.
4
+ category: software
5
+ appliesTo: [plan, implement, review]
6
+ match: [error handling, hata yönetimi, exception, istisna, retry, timeout, fallback, failure]
7
+ ---
8
+
9
+ # Hata Yönetimi
10
+
11
+ 1. Beklenen iş hatası, geçici altyapı hatası ve programlama hatasını ayır.
12
+ 2. Hatayı yakaladığın yerde çözebiliyorsan çöz; aksi halde özgün nedeni koruyarak bağlam ekleyip ilet.
13
+ 3. Kullanıcı mesajını uygulanabilir ve güvenli, log ayrıntısını tanılama için yeterli yap.
14
+ 4. Retry'ı yalnızca idempotent ve geçici hatalarda, sınırlı exponential backoff ile uygula.
15
+ 5. Timeout, iptal, kısmi başarı ve temizleme yollarını birinci sınıf davranış olarak ele al.
16
+ 6. Boş `catch`, sessiz fallback ve hassas veri içeren stack trace kullanma; hata yollarını test et.
@@ -1,28 +1,28 @@
1
- ---
2
- name: frontend-design
3
- description: Cilalı, tutarlı ve erişilebilir arayüz kurma rehberi — tasarım token'ları, bileşen ve durum disiplini
4
- category: design
5
- appliesTo: [implement]
6
- match: [ui, arayuz, arayüz, frontend, react, css, html, component, bilesen, bileşen, sayfa, landing, dashboard, tasarla]
7
- ---
8
-
9
- # Beceri: Ön Yüz Tasarımı
10
-
11
- Arayüzü tek seferlik stiller yerine yeniden kullanılabilir bir sistemle kur.
12
-
13
- ## İlkeler
14
-
15
- - **Token'lardan başla:** Renk, aralık, yarıçap, gölge ve tipografi için değişken/token tanımla; ham
16
- hex ve sihirli piksel değerlerini bileşenlere serpme.
17
- - **Aralık ölçeği:** 4/8 px tabanlı tutarlı bir ölçek kullan.
18
- - **Bileşen bazlı:** Buton, input, kart gibi tekrar edenleri tek bir bileşene indir; kopyalama yapma.
19
- - **Tüm durumları uygula:** hover, focus-visible, active, disabled, hata, boş ve yükleniyor.
20
- - **Erişilebilirlik varsayılan olsun:** Anlamlı HTML, `label`/`aria`, klavye erişimi, görünür focus, AA kontrast.
21
- - **Responsive:** Akışkan düzen; sabit genişlik yerine min/max ve `clamp`. Küçük ekranı da test et.
22
- - **Tema uyumu:** Açık/koyu tema varsa iki temada da doğrula; sabit renk yerine token kullan.
23
- - **Hareket ölçülü:** Kısa, amaçlı geçişler; `prefers-reduced-motion` desteğini unutma.
24
-
25
- ## Sınırlar
26
-
27
- Mevcut tasarım dilini ve bileşen kütüphanesini koru; gerekçesiz yeni bir stil sistemi ya da ağır
28
- 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.
1
+ ---
2
+ name: frontend-design
3
+ description: Cilalı, tutarlı ve erişilebilir arayüz kurma rehberi — tasarım token'ları, bileşen ve durum disiplini
4
+ category: design
5
+ appliesTo: [implement]
6
+ match: [ui, arayuz, arayüz, frontend, react, css, html, component, bilesen, bileşen, sayfa, landing, dashboard, tasarla]
7
+ ---
8
+
9
+ # Beceri: Ön Yüz Tasarımı
10
+
11
+ Arayüzü tek seferlik stiller yerine yeniden kullanılabilir bir sistemle kur.
12
+
13
+ ## İlkeler
14
+
15
+ - **Token'lardan başla:** Renk, aralık, yarıçap, gölge ve tipografi için değişken/token tanımla; ham
16
+ hex ve sihirli piksel değerlerini bileşenlere serpme.
17
+ - **Aralık ölçeği:** 4/8 px tabanlı tutarlı bir ölçek kullan.
18
+ - **Bileşen bazlı:** Buton, input, kart gibi tekrar edenleri tek bir bileşene indir; kopyalama yapma.
19
+ - **Tüm durumları uygula:** hover, focus-visible, active, disabled, hata, boş ve yükleniyor.
20
+ - **Erişilebilirlik varsayılan olsun:** Anlamlı HTML, `label`/`aria`, klavye erişimi, görünür focus, AA kontrast.
21
+ - **Responsive:** Akışkan düzen; sabit genişlik yerine min/max ve `clamp`. Küçük ekranı da test et.
22
+ - **Tema uyumu:** Açık/koyu tema varsa iki temada da doğrula; sabit renk yerine token kullan.
23
+ - **Hareket ölçülü:** Kısa, amaçlı geçişler; `prefers-reduced-motion` desteğini unutma.
24
+
25
+ ## Sınırlar
26
+
27
+ Mevcut tasarım dilini ve bileşen kütüphanesini koru; gerekçesiz yeni bir stil sistemi ya da ağır
28
+ 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.
@@ -1,16 +1,16 @@
1
- ---
2
- name: git-commit-writing
3
- description: Küçük ve açıklayıcı git commit kapsamı ile mesajı hazırla; commit planlama veya yazımında kullan.
4
- category: software
5
- appliesTo: [plan, implement, review]
6
- match: [git commit, commit message, conventional commit, commit mesajı, squash, değişiklik kaydı]
7
- ---
8
-
9
- # Git Commit Yazımı
10
-
11
- - Tek bir mantıksal değişikliği seç; ilgisiz dosyaları veya kullanıcıya ait değişiklikleri dahil etme.
12
- - Proje convention'ını kontrol et; yoksa kısa, emir kipinde ve sonucu anlatan bir başlık yaz.
13
- - Conventional Commits kullanılıyorsa doğru tür ve yalnızca yararlı scope seç.
14
- - Gövdede ne değiştiğini tekrarlamak yerine nedenini, davranış etkisini ve önemli ödünleşimi açıkla.
15
- - Kırıcı değişiklik ve issue bağlantısını projenin beklediği biçimde belirt.
16
- - Commit öncesi staged farkı yeniden oku ve ilgili doğrulamayı çalıştır; test edilmemiş iddiada bulunma.
1
+ ---
2
+ name: git-commit-writing
3
+ description: Küçük ve açıklayıcı git commit kapsamı ile mesajı hazırla; commit planlama veya yazımında kullan.
4
+ category: software
5
+ appliesTo: [plan, implement, review]
6
+ match: [git commit, commit message, conventional commit, commit mesajı, squash, değişiklik kaydı]
7
+ ---
8
+
9
+ # Git Commit Yazımı
10
+
11
+ - Tek bir mantıksal değişikliği seç; ilgisiz dosyaları veya kullanıcıya ait değişiklikleri dahil etme.
12
+ - Proje convention'ını kontrol et; yoksa kısa, emir kipinde ve sonucu anlatan bir başlık yaz.
13
+ - Conventional Commits kullanılıyorsa doğru tür ve yalnızca yararlı scope seç.
14
+ - Gövdede ne değiştiğini tekrarlamak yerine nedenini, davranış etkisini ve önemli ödünleşimi açıkla.
15
+ - Kırıcı değişiklik ve issue bağlantısını projenin beklediği biçimde belirt.
16
+ - Commit öncesi staged farkı yeniden oku ve ilgili doğrulamayı çalıştır; test edilmemiş iddiada bulunma.
@@ -1,16 +1,16 @@
1
- ---
2
- name: graphql-design
3
- description: İstemci odaklı, evrilebilir ve maliyeti denetlenebilir GraphQL şeması tasarla; query, mutation ve resolver işlerinde kullan.
4
- category: software
5
- appliesTo: [plan, implement, review]
6
- match: [graphql, query, mutation, resolver, schema, federation, dataloader]
7
- ---
8
-
9
- # GraphQL Tasarımı
10
-
11
- - Şemayı veri tablosuna değil alan diline göre adlandır; nullability sözleşmesini bilinçli seç.
12
- - Query'leri yan etkisiz, mutation sonuçlarını hata ve güncel nesneyle kullanılabilir yap.
13
- - Liste alanlarında kararlı cursor sayfalama ve açık filtre/sıralama girdileri kullan.
14
- - N+1 sorguyu batching/caching ile önle; resolver maliyeti, derinlik ve karmaşıklık sınırı koy.
15
- - Yetkiyi yalnızca UI veya üst resolver'a bırakma; veri erişim sınırında doğrula.
16
- - Alan kaldırmak yerine deprecate et, şema değişimini tüketici sorguları ve entegrasyon testleriyle doğrula.
1
+ ---
2
+ name: graphql-design
3
+ description: İstemci odaklı, evrilebilir ve maliyeti denetlenebilir GraphQL şeması tasarla; query, mutation ve resolver işlerinde kullan.
4
+ category: software
5
+ appliesTo: [plan, implement, review]
6
+ match: [graphql, query, mutation, resolver, schema, federation, dataloader]
7
+ ---
8
+
9
+ # GraphQL Tasarımı
10
+
11
+ - Şemayı veri tablosuna değil alan diline göre adlandır; nullability sözleşmesini bilinçli seç.
12
+ - Query'leri yan etkisiz, mutation sonuçlarını hata ve güncel nesneyle kullanılabilir yap.
13
+ - Liste alanlarında kararlı cursor sayfalama ve açık filtre/sıralama girdileri kullan.
14
+ - N+1 sorguyu batching/caching ile önle; resolver maliyeti, derinlik ve karmaşıklık sınırı koy.
15
+ - Yetkiyi yalnızca UI veya üst resolver'a bırakma; veri erişim sınırında doğrula.
16
+ - Alan kaldırmak yerine deprecate et, şema değişimini tüketici sorguları ve entegrasyon testleriyle doğrula.
@@ -1,18 +1,18 @@
1
- ---
2
- name: incident-runbook
3
- description: Bir üretim olayını güvenle teşhis edip sınırlandıracak uygulanabilir runbook yaz; operasyon ve sorun giderme işlerinde kullan.
4
- category: documentation
5
- appliesTo: [plan, implement, research]
6
- match: [incident, runbook, olay, outage, kesinti, production issue, operasyon, on-call, müdahale]
7
- ---
8
-
9
- # Olay Runbook'u
10
-
11
- 1. Tetikleyici belirtiyi, etkiyi ve ilk güvenlik kontrolünü açıkla.
12
- 2. Komutları salt okunur teşhis adımlarından başlayarak sırala; beklenen çıktıyı ve karar dalını yaz.
13
- 3. Sınırlandırma, geri alma ve servis azaltma seçeneklerinde kullanıcı/veri etkisini belirt.
14
- 4. Her riskli adım için yetki, ön koşul, onay ve geri dönüş noktası ekle.
15
- 5. İletişim sahibi, güncelleme sıklığı ve escalation eşiğini tanımla.
16
- 6. Kurtarma sonrası bütünlük doğrulaması, izleme süresi ve postmortem girdilerini listele.
17
-
18
- Sır, gerçek müşteri verisi veya doğrulanmamış yıkıcı komut ekleme.
1
+ ---
2
+ name: incident-runbook
3
+ description: Bir üretim olayını güvenle teşhis edip sınırlandıracak uygulanabilir runbook yaz; operasyon ve sorun giderme işlerinde kullan.
4
+ category: documentation
5
+ appliesTo: [plan, implement, research]
6
+ match: [incident, runbook, olay, outage, kesinti, production issue, operasyon, on-call, müdahale]
7
+ ---
8
+
9
+ # Olay Runbook'u
10
+
11
+ 1. Tetikleyici belirtiyi, etkiyi ve ilk güvenlik kontrolünü açıkla.
12
+ 2. Komutları salt okunur teşhis adımlarından başlayarak sırala; beklenen çıktıyı ve karar dalını yaz.
13
+ 3. Sınırlandırma, geri alma ve servis azaltma seçeneklerinde kullanıcı/veri etkisini belirt.
14
+ 4. Her riskli adım için yetki, ön koşul, onay ve geri dönüş noktası ekle.
15
+ 5. İletişim sahibi, güncelleme sıklığı ve escalation eşiğini tanımla.
16
+ 6. Kurtarma sonrası bütünlük doğrulaması, izleme süresi ve postmortem girdilerini listele.
17
+
18
+ Sır, gerçek müşteri verisi veya doğrulanmamış yıkıcı komut ekleme.
@@ -1,16 +1,16 @@
1
- ---
2
- name: input-validation
3
- 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.
4
- category: security
5
- appliesTo: [plan, implement, review]
6
- match: [input validation, girdi doğrulama, sanitize, doğrula, schema validation, parser, untrusted input]
7
- ---
8
-
9
- # Girdi Doğrulama
10
-
11
- - Her girdinin kaynağını ve ulaşacağı hassas sink'i belirle; istemci kontrolünü güvenlik sınırı sayma.
12
- - Tür, uzunluk, aralık, kodlama ve izin verilen biçimi allowlist yaklaşımıyla sunucuda doğrula.
13
- - Önce kanonikleştir, sonra doğrula; Unicode, çift kodlama ve boşluk varyantlarını düşün.
14
- - İş kurallarını ve alanlar arası koşulları şema doğrulamasından ayrı ama aynı sınırda uygula.
15
- - SQL/komut/HTML/URL güvenliği için doğrulamaya ek olarak bağlama uygun güvenli API veya çıktı kodlama kullan.
16
- - 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.
1
+ ---
2
+ name: input-validation
3
+ 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.
4
+ category: security
5
+ appliesTo: [plan, implement, review]
6
+ match: [input validation, girdi doğrulama, sanitize, doğrula, schema validation, parser, untrusted input]
7
+ ---
8
+
9
+ # Girdi Doğrulama
10
+
11
+ - Her girdinin kaynağını ve ulaşacağı hassas sink'i belirle; istemci kontrolünü güvenlik sınırı sayma.
12
+ - Tür, uzunluk, aralık, kodlama ve izin verilen biçimi allowlist yaklaşımıyla sunucuda doğrula.
13
+ - Önce kanonikleştir, sonra doğrula; Unicode, çift kodlama ve boşluk varyantlarını düşün.
14
+ - İş kurallarını ve alanlar arası koşulları şema doğrulamasından ayrı ama aynı sınırda uygula.
15
+ - SQL/komut/HTML/URL güvenliği için doğrulamaya ek olarak bağlama uygun güvenli API veya çıktı kodlama kullan.
16
+ - 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.
@@ -1,16 +1,16 @@
1
- ---
2
- name: integration-testing
3
- 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.
4
- category: testing
5
- appliesTo: [implement, review]
6
- match: [integration test, entegrasyon testi, database test, service test, adapter, repository, boundary]
7
- ---
8
-
9
- # Entegrasyon Testi
10
-
11
- - En yüksek riskli sınırı seç: veri tabanı, dosya sistemi, kuyruk, HTTP istemcisi veya servis adaptörü.
12
- - Üretime benzeyen gerçek bileşeni kullan; yalnızca kontrol edemediğin dış uçları fake et.
13
- - Şema, serileştirme, transaction, hata çevirisi ve timeout davranışını gözlemlenebilir sonuçla doğrula.
14
- - Test verisini her test için yalıt; sıra, saat, ağ ve önceki koşudan bağımsız çalıştır.
15
- - Başlangıç/temizleme kodunu güvenilir kıl ve başarısızlıkta tanılama çıktısını koru.
16
- - Mutlu yol yanında kopuk bağlantı, çakışma ve kısmi başarısızlık senaryosu ekle.
1
+ ---
2
+ name: integration-testing
3
+ 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.
4
+ category: testing
5
+ appliesTo: [implement, review]
6
+ match: [integration test, entegrasyon testi, database test, service test, adapter, repository, boundary]
7
+ ---
8
+
9
+ # Entegrasyon Testi
10
+
11
+ - En yüksek riskli sınırı seç: veri tabanı, dosya sistemi, kuyruk, HTTP istemcisi veya servis adaptörü.
12
+ - Üretime benzeyen gerçek bileşeni kullan; yalnızca kontrol edemediğin dış uçları fake et.
13
+ - Şema, serileştirme, transaction, hata çevirisi ve timeout davranışını gözlemlenebilir sonuçla doğrula.
14
+ - Test verisini her test için yalıt; sıra, saat, ağ ve önceki koşudan bağımsız çalıştır.
15
+ - Başlangıç/temizleme kodunu güvenilir kıl ve başarısızlıkta tanılama çıktısını koru.
16
+ - Mutlu yol yanında kopuk bağlantı, çakışma ve kısmi başarısızlık senaryosu ekle.
@@ -1,16 +1,16 @@
1
- ---
2
- name: interaction-design
3
- 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.
4
- category: design
5
- appliesTo: [plan, implement, review]
6
- match: [interaction design, etkileşim tasarımı, ux flow, user flow, modal, feedback, undo, state transition]
7
- ---
8
-
9
- # Etkileşim Tasarımı
10
-
11
- 1. Kullanıcı hedefini, başlangıç durumunu, eylemleri ve başarı/hata son durumlarını akış olarak çıkar.
12
- 2. Birincil eylemi belirgin, ikincil eylemi sakin tut; aynı ekranda rekabet eden CTA üretme.
13
- 3. Her eyleme anlık ve doğru geri bildirim ver; optimistic UI'da başarısızlığı geri al.
14
- 4. Geri döndürülebilir işlemde undo'yu, yıkıcı işlemde kapsam özeti ve bilinçli onayı tercih et.
15
- 5. Klavye, focus, escape/back, çift tıklama ve eşzamanlı güncelleme davranışını tanımla.
16
- 6. Akışı ilk kullanım, uzman kullanım, hata ve kesinti senaryolarıyla doğrula.
1
+ ---
2
+ name: interaction-design
3
+ 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.
4
+ category: design
5
+ appliesTo: [plan, implement, review]
6
+ match: [interaction design, etkileşim tasarımı, ux flow, user flow, modal, feedback, undo, state transition]
7
+ ---
8
+
9
+ # Etkileşim Tasarımı
10
+
11
+ 1. Kullanıcı hedefini, başlangıç durumunu, eylemleri ve başarı/hata son durumlarını akış olarak çıkar.
12
+ 2. Birincil eylemi belirgin, ikincil eylemi sakin tut; aynı ekranda rekabet eden CTA üretme.
13
+ 3. Her eyleme anlık ve doğru geri bildirim ver; optimistic UI'da başarısızlığı geri al.
14
+ 4. Geri döndürülebilir işlemde undo'yu, yıkıcı işlemde kapsam özeti ve bilinçli onayı tercih et.
15
+ 5. Klavye, focus, escape/back, çift tıklama ve eşzamanlı güncelleme davranışını tanımla.
16
+ 6. Akışı ilk kullanım, uzman kullanım, hata ve kesinti senaryolarıyla doğrula.
@@ -1,16 +1,16 @@
1
- ---
2
- name: landing-page-design
3
- description: Net değer önerisi, güven ve tek birincil eylem etrafında yüksek kaliteli landing page tasarla; pazarlama sayfalarında kullan.
4
- category: design
5
- appliesTo: [plan, implement, review]
6
- match: [landing page, pazarlama sayfası, marketing page, hero, cta, conversion, dönüşüm, homepage]
7
- ---
8
-
9
- # Landing Page Tasarımı
10
-
11
- - Hedef kitleyi, problemi, değer önerisini ve tek birincil dönüşümü bir cümlede netleştir.
12
- - İlk ekranda somut başlık, destekleyici kanıt ve açık CTA kur; soyut slogan yığını yapma.
13
- - Akışı problem → çözüm → nasıl çalışır → kanıt → itiraz → CTA sırasıyla düzenle.
14
- - Gerçek ürün görseli, ölçülebilir sonuç ve doğrulanabilir sosyal kanıt kullan; uydurma testimonial ekleme.
15
- - Tipografi, boşluk ve sınırlı renk paletiyle özgün hiyerarşi kur; erişilebilirlik ve performansı koru.
16
- - Mobil, yavaş ağ, uzun çeviri ve form hata durumlarında sayfayı doğrula.
1
+ ---
2
+ name: landing-page-design
3
+ description: Net değer önerisi, güven ve tek birincil eylem etrafında yüksek kaliteli landing page tasarla; pazarlama sayfalarında kullan.
4
+ category: design
5
+ appliesTo: [plan, implement, review]
6
+ match: [landing page, pazarlama sayfası, marketing page, hero, cta, conversion, dönüşüm, homepage]
7
+ ---
8
+
9
+ # Landing Page Tasarımı
10
+
11
+ - Hedef kitleyi, problemi, değer önerisini ve tek birincil dönüşümü bir cümlede netleştir.
12
+ - İlk ekranda somut başlık, destekleyici kanıt ve açık CTA kur; soyut slogan yığını yapma.
13
+ - Akışı problem → çözüm → nasıl çalışır → kanıt → itiraz → CTA sırasıyla düzenle.
14
+ - Gerçek ürün görseli, ölçülebilir sonuç ve doğrulanabilir sosyal kanıt kullan; uydurma testimonial ekleme.
15
+ - Tipografi, boşluk ve sınırlı renk paletiyle özgün hiyerarşi kur; erişilebilirlik ve performansı koru.
16
+ - Mobil, yavaş ağ, uzun çeviri ve form hata durumlarında sayfayı doğrula.
@@ -1,16 +1,16 @@
1
- ---
2
- name: observability-design
3
- description: Log, metrik ve trace sinyallerini kullanıcı etkisi ve tanılama sorularına göre tasarla; gözlemlenebilirlik işlerinde kullan.
4
- category: software
5
- appliesTo: [plan, implement, review]
6
- match: [observability, gözlemlenebilirlik, telemetry, metric, metrik, trace, tracing, logging, monitoring]
7
- ---
8
-
9
- # Gözlemlenebilirlik Tasarımı
10
-
11
- 1. Önce yanıtlanacak operasyon sorularını yaz: ne bozuldu, kim etkilendi, nerede yavaşladı?
12
- 2. Trafik, hata, gecikme ve doygunluk için az sayıda anlamlı metrik seç.
13
- 3. İstek/iş kimliğini log ve trace boyunca taşı; yapılandırılmış, aranabilir alanlar kullan.
14
- 4. Yüksek kardinaliteli kullanıcı/veri alanlarını metrik etiketi yapma; hassas veriyi kaydetme.
15
- 5. Başarı kadar reddedilen, timeout olan ve retry edilen yolları da ölç.
16
- 6. Sinyali dashboard/uyarı tüketicisiyle ve kontrollü hata senaryosuyla uçtan uca doğrula.
1
+ ---
2
+ name: observability-design
3
+ description: Log, metrik ve trace sinyallerini kullanıcı etkisi ve tanılama sorularına göre tasarla; gözlemlenebilirlik işlerinde kullan.
4
+ category: software
5
+ appliesTo: [plan, implement, review]
6
+ match: [observability, gözlemlenebilirlik, telemetry, metric, metrik, trace, tracing, logging, monitoring]
7
+ ---
8
+
9
+ # Gözlemlenebilirlik Tasarımı
10
+
11
+ 1. Önce yanıtlanacak operasyon sorularını yaz: ne bozuldu, kim etkilendi, nerede yavaşladı?
12
+ 2. Trafik, hata, gecikme ve doygunluk için az sayıda anlamlı metrik seç.
13
+ 3. İstek/iş kimliğini log ve trace boyunca taşı; yapılandırılmış, aranabilir alanlar kullan.
14
+ 4. Yüksek kardinaliteli kullanıcı/veri alanlarını metrik etiketi yapma; hassas veriyi kaydetme.
15
+ 5. Başarı kadar reddedilen, timeout olan ve retry edilen yolları da ölç.
16
+ 6. Sinyali dashboard/uyarı tüketicisiyle ve kontrollü hata senaryosuyla uçtan uca doğrula.
@@ -1,16 +1,16 @@
1
- ---
2
- name: openapi-contract
3
- description: HTTP API davranışını doğrulanabilir OpenAPI sözleşmesine dönüştür; API şeması, istemci üretimi ve contract işlerinde kullan.
4
- category: software
5
- appliesTo: [plan, implement, review]
6
- match: [openapi, swagger, api contract, api sözleşmesi, spec, schema, endpoint documentation]
7
- ---
8
-
9
- # OpenAPI Sözleşmesi
10
-
11
- - Uygulamanın desteklediği OpenAPI sürümünü ve mevcut düzenini koru.
12
- - Her operation için kararlı kimlik, özet, parametre, istek gövdesi, başarı ve hata yanıtı tanımla.
13
- - Required, nullable, format, enum, sınır ve örnekleri gerçek çalışma zamanı doğrulamasıyla eşleştir.
14
- - Ortak şemaları yeniden kullan; aşırı kalıtım ve belirsiz serbest nesnelerden kaçın.
15
- - Kimlik doğrulama, sayfalama, idempotency ve hata modelini açıkça göster.
16
- - Spec'i linter/validator ile doğrula ve uygulama testleriyle sözleşme sapmasını yakala.
1
+ ---
2
+ name: openapi-contract
3
+ description: HTTP API davranışını doğrulanabilir OpenAPI sözleşmesine dönüştür; API şeması, istemci üretimi ve contract işlerinde kullan.
4
+ category: software
5
+ appliesTo: [plan, implement, review]
6
+ match: [openapi, swagger, api contract, api sözleşmesi, spec, schema, endpoint documentation]
7
+ ---
8
+
9
+ # OpenAPI Sözleşmesi
10
+
11
+ - Uygulamanın desteklediği OpenAPI sürümünü ve mevcut düzenini koru.
12
+ - Her operation için kararlı kimlik, özet, parametre, istek gövdesi, başarı ve hata yanıtı tanımla.
13
+ - Required, nullable, format, enum, sınır ve örnekleri gerçek çalışma zamanı doğrulamasıyla eşleştir.
14
+ - Ortak şemaları yeniden kullan; aşırı kalıtım ve belirsiz serbest nesnelerden kaçın.
15
+ - Kimlik doğrulama, sayfalama, idempotency ve hata modelini açıkça göster.
16
+ - Spec'i linter/validator ile doğrula ve uygulama testleriyle sözleşme sapmasını yakala.
@@ -1,16 +1,16 @@
1
- ---
2
- name: performance-profiling
3
- 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.
4
- category: software
5
- appliesTo: [plan, implement, review, research]
6
- match: [performance, performans, profiling, profile, yavaş, slow, latency, cpu, memory, benchmark]
7
- ---
8
-
9
- # Performans Profilleme
10
-
11
- 1. Kullanıcı etkisini ve başarı eşiğini tanımla; süre, throughput, bellek veya kaynak metriğini seç.
12
- 2. Temsilî veri ve ısınma koşuluyla tekrarlanabilir baseline ölç.
13
- 3. CPU, allocation, I/O, sorgu veya ağ profilinden baskın maliyeti bul; tahmine göre kod değiştirme.
14
- 4. En dar nedeni hedefleyen küçük optimizasyon yap ve davranışı koruyan testleri çalıştır.
15
- 5. Aynı koşulda önce/sonra dağılımını karşılaştır; tek ölçümü sonuç sayma.
16
- 6. Kazanç, ödünleşim, veri boyutu ve kalan darboğazı raporla; ölçülmeyen “hızlandı” iddiası kurma.
1
+ ---
2
+ name: performance-profiling
3
+ 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.
4
+ category: software
5
+ appliesTo: [plan, implement, review, research]
6
+ match: [performance, performans, profiling, profile, yavaş, slow, latency, cpu, memory, benchmark]
7
+ ---
8
+
9
+ # Performans Profilleme
10
+
11
+ 1. Kullanıcı etkisini ve başarı eşiğini tanımla; süre, throughput, bellek veya kaynak metriğini seç.
12
+ 2. Temsilî veri ve ısınma koşuluyla tekrarlanabilir baseline ölç.
13
+ 3. CPU, allocation, I/O, sorgu veya ağ profilinden baskın maliyeti bul; tahmine göre kod değiştirme.
14
+ 4. En dar nedeni hedefleyen küçük optimizasyon yap ve davranışı koruyan testleri çalıştır.
15
+ 5. Aynı koşulda önce/sonra dağılımını karşılaştır; tek ölçümü sonuç sayma.
16
+ 6. Kazanç, ödünleşim, veri boyutu ve kalan darboğazı raporla; ölçülmeyen “hızlandı” iddiası kurma.
@@ -1,16 +1,16 @@
1
- ---
2
- name: privacy-review
3
- description: Kişisel veri akışını minimizasyon, amaç, saklama ve kullanıcı kontrolü açısından incele; analytics ve veri özelliğinde kullan.
4
- category: security
5
- appliesTo: [plan, implement, review]
6
- match: [privacy, gizlilik, personal data, kişisel veri, pii, gdpr, kvkk, consent, analytics, telemetry]
7
- ---
8
-
9
- # Gizlilik İncelemesi
10
-
11
- - Toplanan veriyi, kaynağı, amacı, alıcıyı, saklama süresini ve silme yolunu haritala.
12
- - Özellik için gerekmeyen alanı toplama; kimlik bağını mümkün olan en erken yerde azalt.
13
- - İzin/hukuki dayanak ve kullanıcı beklentisini ürün sahibinden doğrula; hukuki sonuç uydurma.
14
- - Log, telemetry, URL, cache, export ve üçüncü taraf aktarımında sızıntı yüzeyini incele.
15
- - Erişim, düzeltme, dışa aktarma, silme ve izin geri çekme akışlarının gerçekten çalıştığını test et.
16
- - Bulguları veri türü, etki, kanıt ve teknik azaltımla raporla; hukuki inceleme gereğini ayır.
1
+ ---
2
+ name: privacy-review
3
+ description: Kişisel veri akışını minimizasyon, amaç, saklama ve kullanıcı kontrolü açısından incele; analytics ve veri özelliğinde kullan.
4
+ category: security
5
+ appliesTo: [plan, implement, review]
6
+ match: [privacy, gizlilik, personal data, kişisel veri, pii, gdpr, kvkk, consent, analytics, telemetry]
7
+ ---
8
+
9
+ # Gizlilik İncelemesi
10
+
11
+ - Toplanan veriyi, kaynağı, amacı, alıcıyı, saklama süresini ve silme yolunu haritala.
12
+ - Özellik için gerekmeyen alanı toplama; kimlik bağını mümkün olan en erken yerde azalt.
13
+ - İzin/hukuki dayanak ve kullanıcı beklentisini ürün sahibinden doğrula; hukuki sonuç uydurma.
14
+ - Log, telemetry, URL, cache, export ve üçüncü taraf aktarımında sızıntı yüzeyini incele.
15
+ - Erişim, düzeltme, dışa aktarma, silme ve izin geri çekme akışlarının gerçekten çalıştığını test et.
16
+ - Bulguları veri türü, etki, kanıt ve teknik azaltımla raporla; hukuki inceleme gereğini ayır.
@@ -1,16 +1,16 @@
1
- ---
2
- name: property-based-testing
3
- description: Çok sayıda üretilmiş girdide değişmezleri ve sınırları doğrula; parser, dönüşüm ve algoritma testlerinde kullan.
4
- category: testing
5
- appliesTo: [implement, review]
6
- match: [property based testing, property test, özellik tabanlı test, quickcheck, hypothesis, fast-check, invariant, fuzz]
7
- ---
8
-
9
- # Özellik Tabanlı Test
10
-
11
- - Örnek çıktılar yerine değişmezi tanımla: round-trip, idempotency, sıralama, korunum veya referans model.
12
- - Üreticiyi geçerli alanı temsil edecek şekilde kur; boş, uç, Unicode ve büyük değerleri ağırlıklandır.
13
- - Geçersiz girdiyi ayrı özellikte ve beklenen hata sınıfıyla test et.
14
- - Küçültmenin anlaşılır minimal karşı örnek ürettiğini kontrol et.
15
- - Seed ve başarısız örneği kaydet; regresyon için sabit örneğe dönüştür.
16
- - Sonsuz/çok pahalı vakaları boyut sınırıyla denetle ve özelliğin hatalı uygulamayı gerçekten yakaladığını sınayarak doğrula.
1
+ ---
2
+ name: property-based-testing
3
+ description: Çok sayıda üretilmiş girdide değişmezleri ve sınırları doğrula; parser, dönüşüm ve algoritma testlerinde kullan.
4
+ category: testing
5
+ appliesTo: [implement, review]
6
+ match: [property based testing, property test, özellik tabanlı test, quickcheck, hypothesis, fast-check, invariant, fuzz]
7
+ ---
8
+
9
+ # Özellik Tabanlı Test
10
+
11
+ - Örnek çıktılar yerine değişmezi tanımla: round-trip, idempotency, sıralama, korunum veya referans model.
12
+ - Üreticiyi geçerli alanı temsil edecek şekilde kur; boş, uç, Unicode ve büyük değerleri ağırlıklandır.
13
+ - Geçersiz girdiyi ayrı özellikte ve beklenen hata sınıfıyla test et.
14
+ - Küçültmenin anlaşılır minimal karşı örnek ürettiğini kontrol et.
15
+ - Seed ve başarısız örneği kaydet; regresyon için sabit örneğe dönüştür.
16
+ - Sonsuz/çok pahalı vakaları boyut sınırıyla denetle ve özelliğin hatalı uygulamayı gerçekten yakaladığını sınayarak doğrula.
@@ -1,16 +1,16 @@
1
- ---
2
- name: pull-request-writing
3
- description: İncelenebilir kapsam, gerekçe ve doğrulama içeren pull request açıklaması hazırla; PR açma veya güncellemede kullan.
4
- category: documentation
5
- appliesTo: [implement, review]
6
- match: [pull request, pr description, merge request, değişiklik özeti, reviewer, inceleme açıklaması]
7
- ---
8
-
9
- # Pull Request Yazımı
10
-
11
- - Başlığı kullanıcı etkisini anlatan tek bir değişikliğe odakla.
12
- - Özette sorunu, çözüm yaklaşımını ve neden bu kapsamın seçildiğini kısa yaz.
13
- - Davranış değişikliklerini, önemli dosyaları ve özellikle incelenmesi gereken riskli noktaları belirt.
14
- - Çalıştırılan testleri gerçek komut ve sonuçla listele; çalıştırılmayan kontrolü açıkça söyle.
15
- - UI değişiminde görsel kanıtı, veri/API değişiminde migration ve uyumluluk notunu ekle.
16
- - İlgili issue'yu bağla; büyük log, dosya listesi veya commit mesajlarını aynen tekrarlama.
1
+ ---
2
+ name: pull-request-writing
3
+ description: İncelenebilir kapsam, gerekçe ve doğrulama içeren pull request açıklaması hazırla; PR açma veya güncellemede kullan.
4
+ category: documentation
5
+ appliesTo: [implement, review]
6
+ match: [pull request, pr description, merge request, değişiklik özeti, reviewer, inceleme açıklaması]
7
+ ---
8
+
9
+ # Pull Request Yazımı
10
+
11
+ - Başlığı kullanıcı etkisini anlatan tek bir değişikliğe odakla.
12
+ - Özette sorunu, çözüm yaklaşımını ve neden bu kapsamın seçildiğini kısa yaz.
13
+ - Davranış değişikliklerini, önemli dosyaları ve özellikle incelenmesi gereken riskli noktaları belirt.
14
+ - Çalıştırılan testleri gerçek komut ve sonuçla listele; çalıştırılmayan kontrolü açıkça söyle.
15
+ - UI değişiminde görsel kanıtı, veri/API değişiminde migration ve uyumluluk notunu ekle.
16
+ - İlgili issue'yu bağla; büyük log, dosya listesi veya commit mesajlarını aynen tekrarlama.
@@ -1,16 +1,16 @@
1
- ---
2
- name: refactoring
3
- description: Dış davranışı koruyarak kod yapısını küçük ve kanıtlanabilir adımlarla iyileştir; sadeleştirme işlerinde kullan.
4
- category: software
5
- appliesTo: [plan, implement, review]
6
- match: [refactor, refactoring, yeniden düzenleme, sadeleştir, simplify, cleanup, clean code, duplication]
7
- ---
8
-
9
- # Refactoring
10
-
11
- 1. Korunacak gözlemlenebilir davranışı ve mevcut test güvenlik ağını belirle.
12
- 2. Somut kokuyu seç: tekrar, uzun işlev, yanlış sorumluluk, örtük bağımlılık veya gereksiz soyutlama.
13
- 3. Her adımda tek yapısal değişiklik yap; özellik ekleme ve davranış düzeltmesini ayrı tut.
14
- 4. Önce mevcut kavram ve yardımcıları yeniden kullan; spekülatif katman ekleme.
15
- 5. Her küçük adım sonrası ilgili test ve statik kontrolleri çalıştır.
16
- 6. Diff büyüdükçe kapsamı yeniden değerlendir; daha az kod ve daha açık bağımlılık hedefle.
1
+ ---
2
+ name: refactoring
3
+ description: Dış davranışı koruyarak kod yapısını küçük ve kanıtlanabilir adımlarla iyileştir; sadeleştirme işlerinde kullan.
4
+ category: software
5
+ appliesTo: [plan, implement, review]
6
+ match: [refactor, refactoring, yeniden düzenleme, sadeleştir, simplify, cleanup, clean code, duplication]
7
+ ---
8
+
9
+ # Refactoring
10
+
11
+ 1. Korunacak gözlemlenebilir davranışı ve mevcut test güvenlik ağını belirle.
12
+ 2. Somut kokuyu seç: tekrar, uzun işlev, yanlış sorumluluk, örtük bağımlılık veya gereksiz soyutlama.
13
+ 3. Her adımda tek yapısal değişiklik yap; özellik ekleme ve davranış düzeltmesini ayrı tut.
14
+ 4. Önce mevcut kavram ve yardımcıları yeniden kullan; spekülatif katman ekleme.
15
+ 5. Her küçük adım sonrası ilgili test ve statik kontrolleri çalıştır.
16
+ 6. Diff büyüdükçe kapsamı yeniden değerlendir; daha az kod ve daha açık bağımlılık hedefle.
@@ -1,16 +1,16 @@
1
- ---
2
- name: release-readiness
3
- 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.
4
- category: software
5
- appliesTo: [plan, review]
6
- match: [release readiness, sürüm hazırlığı, go live, production release, yayın, deploy checklist, rollout]
7
- ---
8
-
9
- # Sürüm Hazırlığı
10
-
11
- - Kapsamı ve kabul kriterlerini sürüm adayındaki gerçek commit/artefaktla eşleştir.
12
- - Zorunlu test, build, güvenlik ve uyumluluk kontrollerinin güncel kanıtını doğrula.
13
- - Yapılandırma, sır, migration, veri yedeği ve bağımlı servis ön koşullarını kontrol et.
14
- - Kademeli rollout, sağlık metriği, gözlem süresi, durdurma eşiği ve geri alma adımını tanımla.
15
- - Changelog, kullanıcı iletişimi, runbook ve destek sahipliğini doğrula.
16
- - Bilinmeyenleri risk/etki/sahip ile kaydet ve sonunda READY, CONDITIONAL veya NOT READY kararı ver.
1
+ ---
2
+ name: release-readiness
3
+ 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.
4
+ category: software
5
+ appliesTo: [plan, review]
6
+ match: [release readiness, sürüm hazırlığı, go live, production release, yayın, deploy checklist, rollout]
7
+ ---
8
+
9
+ # Sürüm Hazırlığı
10
+
11
+ - Kapsamı ve kabul kriterlerini sürüm adayındaki gerçek commit/artefaktla eşleştir.
12
+ - Zorunlu test, build, güvenlik ve uyumluluk kontrollerinin güncel kanıtını doğrula.
13
+ - Yapılandırma, sır, migration, veri yedeği ve bağımlı servis ön koşullarını kontrol et.
14
+ - Kademeli rollout, sağlık metriği, gözlem süresi, durdurma eşiği ve geri alma adımını tanımla.
15
+ - Changelog, kullanıcı iletişimi, runbook ve destek sahipliğini doğrula.
16
+ - Bilinmeyenleri risk/etki/sahip ile kaydet ve sonunda READY, CONDITIONAL veya NOT READY kararı ver.