@omerrgocmen/crewctl 1.0.2 → 1.1.1
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.
- package/orchestrator/README.md +462 -462
- package/orchestrator/config.default.json +71 -71
- package/orchestrator/roles/operator.md +77 -77
- package/orchestrator/roles/reviewer.md +63 -63
- package/orchestrator/skills/acceptance-criteria.md +18 -18
- package/orchestrator/skills/accessibility-audit.md +16 -16
- package/orchestrator/skills/accessible-forms.md +16 -16
- package/orchestrator/skills/api-design.md +27 -27
- package/orchestrator/skills/api-documentation.md +16 -16
- package/orchestrator/skills/architecture-decision-record.md +18 -18
- package/orchestrator/skills/authentication-design.md +16 -16
- package/orchestrator/skills/authorization-review.md +16 -16
- package/orchestrator/skills/backward-compatibility.md +17 -17
- package/orchestrator/skills/changelog-writing.md +16 -16
- package/orchestrator/skills/ci-pipeline-design.md +16 -16
- package/orchestrator/skills/cli-design.md +16 -16
- package/orchestrator/skills/code-review.md +27 -27
- package/orchestrator/skills/configuration-management.md +16 -16
- package/orchestrator/skills/container-review.md +16 -16
- package/orchestrator/skills/contract-testing.md +16 -16
- package/orchestrator/skills/dashboard-design.md +16 -16
- package/orchestrator/skills/database-migration.md +16 -16
- package/orchestrator/skills/database-schema-design.md +16 -16
- package/orchestrator/skills/debugging.md +26 -26
- package/orchestrator/skills/dependency-review.md +16 -16
- package/orchestrator/skills/design-review.md +29 -29
- package/orchestrator/skills/design-system.md +16 -16
- package/orchestrator/skills/docs-api-reference.md +16 -16
- package/orchestrator/skills/docs-troubleshooting.md +16 -16
- package/orchestrator/skills/docs-tutorial.md +16 -16
- package/orchestrator/skills/docs-writing.md +25 -25
- package/orchestrator/skills/empty-error-loading-states.md +16 -16
- package/orchestrator/skills/end-to-end-testing.md +16 -16
- package/orchestrator/skills/error-handling.md +16 -16
- package/orchestrator/skills/frontend-design.md +28 -28
- package/orchestrator/skills/git-commit-writing.md +16 -16
- package/orchestrator/skills/graphql-design.md +16 -16
- package/orchestrator/skills/incident-runbook.md +18 -18
- package/orchestrator/skills/input-validation.md +16 -16
- package/orchestrator/skills/integration-testing.md +16 -16
- package/orchestrator/skills/interaction-design.md +16 -16
- package/orchestrator/skills/landing-page-design.md +16 -16
- package/orchestrator/skills/observability-design.md +16 -16
- package/orchestrator/skills/openapi-contract.md +16 -16
- package/orchestrator/skills/performance-profiling.md +16 -16
- package/orchestrator/skills/privacy-review.md +16 -16
- package/orchestrator/skills/property-based-testing.md +16 -16
- package/orchestrator/skills/pull-request-writing.md +16 -16
- package/orchestrator/skills/refactoring.md +16 -16
- package/orchestrator/skills/release-readiness.md +16 -16
- package/orchestrator/skills/responsive-design.md +16 -16
- package/orchestrator/skills/secrets-management.md +16 -16
- package/orchestrator/skills/secure-file-upload.md +16 -16
- package/orchestrator/skills/security-review.md +26 -26
- package/orchestrator/skills/semantic-versioning.md +17 -17
- package/orchestrator/skills/seo-on-page.md +16 -16
- package/orchestrator/skills/seo-structured-data.md +16 -16
- package/orchestrator/skills/seo-technical-audit.md +16 -16
- package/orchestrator/skills/sql-query-review.md +16 -16
- package/orchestrator/skills/supply-chain-security.md +16 -16
- package/orchestrator/skills/test-strategy.md +16 -16
- package/orchestrator/skills/threat-modeling.md +16 -16
- package/orchestrator/skills/unit-testing.md +16 -16
- package/orchestrator/skills/write-tests.md +28 -28
- package/orchestrator/src/cli-registry.js +682 -616
- package/orchestrator/src/cli.js +131 -131
- package/orchestrator/src/doctor.js +64 -64
- package/orchestrator/src/engine.js +246 -37
- package/orchestrator/src/server.js +795 -766
- package/orchestrator/src/skill-registry.js +272 -272
- package/orchestrator/src/store.js +426 -399
- package/orchestrator/web/OrbitControls.js +1417 -1417
- package/orchestrator/web/flow.html +740 -740
- package/orchestrator/web/index.html +601 -557
- package/orchestrator/web/jsm/postprocessing/EffectComposer.js +231 -231
- package/orchestrator/web/jsm/postprocessing/MaskPass.js +104 -104
- package/orchestrator/web/jsm/postprocessing/Pass.js +95 -95
- package/orchestrator/web/jsm/postprocessing/RenderPass.js +99 -99
- package/orchestrator/web/jsm/postprocessing/ShaderPass.js +77 -77
- package/orchestrator/web/jsm/postprocessing/UnrealBloomPass.js +415 -415
- package/orchestrator/web/jsm/shaders/CopyShader.js +45 -45
- package/orchestrator/web/jsm/shaders/LuminosityHighPassShader.js +66 -66
- package/orchestrator/web/three.module.min.js +6 -6
- package/package.json +2 -2
|
@@ -1,29 +1,29 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: design-review
|
|
3
|
-
description: UI/UX ve tasarım sistemi incelemesi — hiyerarşi, erişilebilirlik, tutarlılık ve tema uyumu
|
|
4
|
-
category: design
|
|
5
|
-
appliesTo: [review, implement]
|
|
6
|
-
match: [tasarim, tasarım, design, ui, ux, arayuz, arayüz, layout, renk, color, tema, theme, erisilebilir, erişilebilir, accessibility, responsive]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Beceri: Tasarım İncelemesi
|
|
10
|
-
|
|
11
|
-
Bir arayüzü tek bir tasarım sistemi gibi okunacak biçimde değerlendir. Estetik yorumdan çok
|
|
12
|
-
gözlemlenebilir kurallara dayan.
|
|
13
|
-
|
|
14
|
-
## Kontrol listesi
|
|
15
|
-
|
|
16
|
-
- **Görsel hiyerarşi:** Başlık/gövde/aksiyon ayrımı net mi? Birincil eylem sayfada tek ve baskın mı?
|
|
17
|
-
- **Boşluk ve ritim:** Tutarlı bir aralık ölçeği (4/8 px) var mı? Rastgele margin/padding sıçramaları var mı?
|
|
18
|
-
- **Tipografi:** En fazla 2 font ailesi, sınırlı boyut/ağırlık ölçeği; satır uzunluğu 45–90 karakter.
|
|
19
|
-
- **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.
|
|
20
|
-
- **Tutarlılık:** Aynı işlevin bileşenleri (buton, kart, input) her yerde aynı görünsün; tek seferlik istisnalar işaretlensin.
|
|
21
|
-
- **Durumlar:** hover / focus / active / disabled / hata / boş / yükleniyor durumları tanımlı mı?
|
|
22
|
-
- **Erişilebilirlik:** Klavyeyle gezilebilir mi, görünür focus halkası var mı, etiketler/alt metinler eksik mi?
|
|
23
|
-
- **Tema:** Açık ve koyu temada da okunur mu? Sabit renk yerine tema değişkenleri kullanılmış mı?
|
|
24
|
-
- **Responsive:** Dar ve geniş ekranda taşma/kırılma var mı?
|
|
25
|
-
|
|
26
|
-
## Teslimat
|
|
27
|
-
|
|
28
|
-
Bulguları önem sırasıyla (HIGH/MEDIUM/LOW) ve mümkünse dosya:satır ile ver. Her bulgu için somut,
|
|
29
|
-
minimal düzeltme öner. Estetik tercihleri "kural" gibi sunma; gerekçesini yaz.
|
|
1
|
+
---
|
|
2
|
+
name: design-review
|
|
3
|
+
description: UI/UX ve tasarım sistemi incelemesi — hiyerarşi, erişilebilirlik, tutarlılık ve tema uyumu
|
|
4
|
+
category: design
|
|
5
|
+
appliesTo: [review, implement]
|
|
6
|
+
match: [tasarim, tasarım, design, ui, ux, arayuz, arayüz, layout, renk, color, tema, theme, erisilebilir, erişilebilir, accessibility, responsive]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Beceri: Tasarım İncelemesi
|
|
10
|
+
|
|
11
|
+
Bir arayüzü tek bir tasarım sistemi gibi okunacak biçimde değerlendir. Estetik yorumdan çok
|
|
12
|
+
gözlemlenebilir kurallara dayan.
|
|
13
|
+
|
|
14
|
+
## Kontrol listesi
|
|
15
|
+
|
|
16
|
+
- **Görsel hiyerarşi:** Başlık/gövde/aksiyon ayrımı net mi? Birincil eylem sayfada tek ve baskın mı?
|
|
17
|
+
- **Boşluk ve ritim:** Tutarlı bir aralık ölçeği (4/8 px) var mı? Rastgele margin/padding sıçramaları var mı?
|
|
18
|
+
- **Tipografi:** En fazla 2 font ailesi, sınırlı boyut/ağırlık ölçeği; satır uzunluğu 45–90 karakter.
|
|
19
|
+
- **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.
|
|
20
|
+
- **Tutarlılık:** Aynı işlevin bileşenleri (buton, kart, input) her yerde aynı görünsün; tek seferlik istisnalar işaretlensin.
|
|
21
|
+
- **Durumlar:** hover / focus / active / disabled / hata / boş / yükleniyor durumları tanımlı mı?
|
|
22
|
+
- **Erişilebilirlik:** Klavyeyle gezilebilir mi, görünür focus halkası var mı, etiketler/alt metinler eksik mi?
|
|
23
|
+
- **Tema:** Açık ve koyu temada da okunur mu? Sabit renk yerine tema değişkenleri kullanılmış mı?
|
|
24
|
+
- **Responsive:** Dar ve geniş ekranda taşma/kırılma var mı?
|
|
25
|
+
|
|
26
|
+
## Teslimat
|
|
27
|
+
|
|
28
|
+
Bulguları önem sırasıyla (HIGH/MEDIUM/LOW) ve mümkünse dosya:satır ile ver. Her bulgu için somut,
|
|
29
|
+
minimal düzeltme öner. Estetik tercihleri "kural" gibi sunma; gerekçesini yaz.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: design-system
|
|
3
|
-
description: Token, bileşen, varyant ve dokümantasyonla tutarlı bir arayüz sistemi kur; tekrar eden UI ve tema işlerinde kullan.
|
|
4
|
-
category: design
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [design system, tasarım sistemi, token, component library, bileşen kütüphanesi, theme, tema]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Tasarım Sistemi
|
|
10
|
-
|
|
11
|
-
1. Mevcut ürün dilini ve tekrar eden kararları envanterle; ihtiyaç kanıtı olmadan sistem kurma.
|
|
12
|
-
2. Renk, tipografi, boşluk, radius, elevation ve motion için anlamsal token katmanı oluştur.
|
|
13
|
-
3. Bileşenin anatomy, varyant, boyut, durum, erişilebilirlik ve içerik kurallarını açık tanımla.
|
|
14
|
-
4. Composition'ı tek seferlik prop çoğalmasına tercih et; kaçış noktalarını kontrollü bırak.
|
|
15
|
-
5. Görsel örnek, kullanım/kullanma örneği ve değişiklik/migration notu sağla.
|
|
16
|
-
6. Açık-koyu tema, responsive, klavye ve görsel regresyon testleriyle sistemi doğrula.
|
|
1
|
+
---
|
|
2
|
+
name: design-system
|
|
3
|
+
description: Token, bileşen, varyant ve dokümantasyonla tutarlı bir arayüz sistemi kur; tekrar eden UI ve tema işlerinde kullan.
|
|
4
|
+
category: design
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [design system, tasarım sistemi, token, component library, bileşen kütüphanesi, theme, tema]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Tasarım Sistemi
|
|
10
|
+
|
|
11
|
+
1. Mevcut ürün dilini ve tekrar eden kararları envanterle; ihtiyaç kanıtı olmadan sistem kurma.
|
|
12
|
+
2. Renk, tipografi, boşluk, radius, elevation ve motion için anlamsal token katmanı oluştur.
|
|
13
|
+
3. Bileşenin anatomy, varyant, boyut, durum, erişilebilirlik ve içerik kurallarını açık tanımla.
|
|
14
|
+
4. Composition'ı tek seferlik prop çoğalmasına tercih et; kaçış noktalarını kontrollü bırak.
|
|
15
|
+
5. Görsel örnek, kullanım/kullanma örneği ve değişiklik/migration notu sağla.
|
|
16
|
+
6. Açık-koyu tema, responsive, klavye ve görsel regresyon testleriyle sistemi doğrula.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: docs-api-reference
|
|
3
|
-
description: Kod veya sözleşmeden eksiksiz ve taranabilir API referansı üret; fonksiyon, sınıf, config ve endpoint belgelerinde kullan.
|
|
4
|
-
category: documentation
|
|
5
|
-
appliesTo: [implement, review]
|
|
6
|
-
match: [api reference, referans dokümanı, function docs, class docs, configuration reference, endpoint reference]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# API Referansı
|
|
10
|
-
|
|
11
|
-
- Kaynak gerçek olarak kodu, şemayı ve çalışan davranışı kullan; tahminden alan üretme.
|
|
12
|
-
- Öğeleri kararlı ad ve hiyerarşiyle sırala; kısa amaç cümlesinden sonra imza/söz dizimi ver.
|
|
13
|
-
- Parametre türü, zorunluluk, varsayılan, sınır, dönüş, hata ve yan etkiyi açıkla.
|
|
14
|
-
- Her öğeye minimal çalışan örnek ekle; örneğin çıktısını ve ön koşulunu göster.
|
|
15
|
-
- Ortak kavramı tek yerde belgeleyip bağla; referansta uzun öğretici anlatı kullanma.
|
|
16
|
-
- Eksik/deprecated öğeleri ve sürüm farkını işaretle, örnekleri test veya doğrulama ile senkron tut.
|
|
1
|
+
---
|
|
2
|
+
name: docs-api-reference
|
|
3
|
+
description: Kod veya sözleşmeden eksiksiz ve taranabilir API referansı üret; fonksiyon, sınıf, config ve endpoint belgelerinde kullan.
|
|
4
|
+
category: documentation
|
|
5
|
+
appliesTo: [implement, review]
|
|
6
|
+
match: [api reference, referans dokümanı, function docs, class docs, configuration reference, endpoint reference]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# API Referansı
|
|
10
|
+
|
|
11
|
+
- Kaynak gerçek olarak kodu, şemayı ve çalışan davranışı kullan; tahminden alan üretme.
|
|
12
|
+
- Öğeleri kararlı ad ve hiyerarşiyle sırala; kısa amaç cümlesinden sonra imza/söz dizimi ver.
|
|
13
|
+
- Parametre türü, zorunluluk, varsayılan, sınır, dönüş, hata ve yan etkiyi açıkla.
|
|
14
|
+
- Her öğeye minimal çalışan örnek ekle; örneğin çıktısını ve ön koşulunu göster.
|
|
15
|
+
- Ortak kavramı tek yerde belgeleyip bağla; referansta uzun öğretici anlatı kullanma.
|
|
16
|
+
- Eksik/deprecated öğeleri ve sürüm farkını işaretle, örnekleri test veya doğrulama ile senkron tut.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: docs-troubleshooting
|
|
3
|
-
description: Belirtiyi tanı, nedeni doğrula ve güvenli çözüm sunan sorun giderme belgesi yaz; hata ve destek dokümanında kullan.
|
|
4
|
-
category: documentation
|
|
5
|
-
appliesTo: [implement, review]
|
|
6
|
-
match: [troubleshooting, sorun giderme, common errors, yaygın hatalar, diagnosis, hata belgesi, faq]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Sorun Giderme Belgesi
|
|
10
|
-
|
|
11
|
-
- Bölümü kullanıcının gördüğü tam belirti, hata kodu veya davranışla adlandır.
|
|
12
|
-
- Hızlı güvenli kontrollerden başlayıp ayırt edici tanı adımlarını sırala; beklenen çıktıyı yaz.
|
|
13
|
-
- Her dalda olası neden, doğrulama kanıtı ve en dar çözümü eşleştir.
|
|
14
|
-
- Veri silen, izin değiştiren veya güvenliği gevşeten komutu varsayılan çözüm yapma; risk ve geri dönüşü belirt.
|
|
15
|
-
- Sırları maskeleyen log toplama ve destek escalation bilgisi ekle.
|
|
16
|
-
- Komut, dosya yolu ve hata metnini güncel üründe yeniden üretip doğrula.
|
|
1
|
+
---
|
|
2
|
+
name: docs-troubleshooting
|
|
3
|
+
description: Belirtiyi tanı, nedeni doğrula ve güvenli çözüm sunan sorun giderme belgesi yaz; hata ve destek dokümanında kullan.
|
|
4
|
+
category: documentation
|
|
5
|
+
appliesTo: [implement, review]
|
|
6
|
+
match: [troubleshooting, sorun giderme, common errors, yaygın hatalar, diagnosis, hata belgesi, faq]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Sorun Giderme Belgesi
|
|
10
|
+
|
|
11
|
+
- Bölümü kullanıcının gördüğü tam belirti, hata kodu veya davranışla adlandır.
|
|
12
|
+
- Hızlı güvenli kontrollerden başlayıp ayırt edici tanı adımlarını sırala; beklenen çıktıyı yaz.
|
|
13
|
+
- Her dalda olası neden, doğrulama kanıtı ve en dar çözümü eşleştir.
|
|
14
|
+
- Veri silen, izin değiştiren veya güvenliği gevşeten komutu varsayılan çözüm yapma; risk ve geri dönüşü belirt.
|
|
15
|
+
- Sırları maskeleyen log toplama ve destek escalation bilgisi ekle.
|
|
16
|
+
- Komut, dosya yolu ve hata metnini güncel üründe yeniden üretip doğrula.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: docs-tutorial
|
|
3
|
-
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.
|
|
4
|
-
category: documentation
|
|
5
|
-
appliesTo: [implement, review]
|
|
6
|
-
match: [tutorial, öğretici, quickstart, getting started, başlangıç, onboarding, walkthrough]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Öğretici Yazımı
|
|
10
|
-
|
|
11
|
-
1. Tek öğrenme hedefi ve görünür nihai ürün seç; kavramsal kapsamı dar tut.
|
|
12
|
-
2. Temiz ortam için ön koşul, kurulum ve yaklaşık süreyi başta belirt.
|
|
13
|
-
3. Küçük, sıralı ve kopyalanabilir adımlar ver; her adımın beklenen sonucunu göster.
|
|
14
|
-
4. Okuyucunun başarı hissini erken üret, sonra bir kavramı uygulama içinde açıklayarak ilerle.
|
|
15
|
-
5. Alternatifler ve tam referansla ana akışı bölme; ilgili belgeye bağla.
|
|
16
|
-
6. Öğreticiyi sıfırdan aynen çalıştır, sürüm/yol/çıktı doğruluğunu kontrol et ve temizleme adımı ekle.
|
|
1
|
+
---
|
|
2
|
+
name: docs-tutorial
|
|
3
|
+
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.
|
|
4
|
+
category: documentation
|
|
5
|
+
appliesTo: [implement, review]
|
|
6
|
+
match: [tutorial, öğretici, quickstart, getting started, başlangıç, onboarding, walkthrough]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Öğretici Yazımı
|
|
10
|
+
|
|
11
|
+
1. Tek öğrenme hedefi ve görünür nihai ürün seç; kavramsal kapsamı dar tut.
|
|
12
|
+
2. Temiz ortam için ön koşul, kurulum ve yaklaşık süreyi başta belirt.
|
|
13
|
+
3. Küçük, sıralı ve kopyalanabilir adımlar ver; her adımın beklenen sonucunu göster.
|
|
14
|
+
4. Okuyucunun başarı hissini erken üret, sonra bir kavramı uygulama içinde açıklayarak ilerle.
|
|
15
|
+
5. Alternatifler ve tam referansla ana akışı bölme; ilgili belgeye bağla.
|
|
16
|
+
6. Öğreticiyi sıfırdan aynen çalıştır, sürüm/yol/çıktı doğruluğunu kontrol et ve temizleme adımı ekle.
|
|
@@ -1,25 +1,25 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: docs-writing
|
|
3
|
-
description: Net, doğru ve bakımı kolay dokümantasyon/README yazma rehberi
|
|
4
|
-
category: documentation
|
|
5
|
-
appliesTo: [implement]
|
|
6
|
-
match: [dokuman, doküman, docs, readme, belge, documentation, aciklama, açıklama, guide, kilavuz, kılavuz, yorum]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Beceri: Dokümantasyon Yazma
|
|
10
|
-
|
|
11
|
-
Okuyucunun hedefine en kısa yoldan ulaşmasını sağla. Doğruluk, kısalıktan önce gelir.
|
|
12
|
-
|
|
13
|
-
## İlkeler
|
|
14
|
-
|
|
15
|
-
- **Önce okuyucu:** Kim, ne yapmaya çalışıyor? Önvarsayımı ve gerekli ön koşulları baştan söyle.
|
|
16
|
-
- **Çalıştırılabilir örnek:** Kopyala-çalıştır komutları ve gerçek girdi/çıktı ver; sözde koddan kaçın.
|
|
17
|
-
- **Yapı:** Kısa giriş → hızlı başlangıç → yaygın görevler → başvuru → sorun giderme. Taranabilir başlıklar kullan.
|
|
18
|
-
- **Doğruluk:** Yalnızca kod tabanında gerçekten var olan komut, bayrak, yol ve davranışı yaz; uydurma.
|
|
19
|
-
- **Kısalık:** Gereksiz sıfat ve tekrar yok. Bir cümle bir iş yapsın.
|
|
20
|
-
- **Bakım:** Kırılgan ayrıntıyı (sürüm numarası, iç yol) tek yerde tut; kodla dokümanı senkron bırak.
|
|
21
|
-
|
|
22
|
-
## Kurallar
|
|
23
|
-
|
|
24
|
-
Mevcut dokümanın dilini, tonunu ve biçimini koru. Var olan bir belgeyi güncelliyorsan üslubu değiştirme.
|
|
25
|
-
Yalnızca doğruladığın bilgiyi yaz; emin olmadığın davranışı "kesin" gibi sunma.
|
|
1
|
+
---
|
|
2
|
+
name: docs-writing
|
|
3
|
+
description: Net, doğru ve bakımı kolay dokümantasyon/README yazma rehberi
|
|
4
|
+
category: documentation
|
|
5
|
+
appliesTo: [implement]
|
|
6
|
+
match: [dokuman, doküman, docs, readme, belge, documentation, aciklama, açıklama, guide, kilavuz, kılavuz, yorum]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Beceri: Dokümantasyon Yazma
|
|
10
|
+
|
|
11
|
+
Okuyucunun hedefine en kısa yoldan ulaşmasını sağla. Doğruluk, kısalıktan önce gelir.
|
|
12
|
+
|
|
13
|
+
## İlkeler
|
|
14
|
+
|
|
15
|
+
- **Önce okuyucu:** Kim, ne yapmaya çalışıyor? Önvarsayımı ve gerekli ön koşulları baştan söyle.
|
|
16
|
+
- **Çalıştırılabilir örnek:** Kopyala-çalıştır komutları ve gerçek girdi/çıktı ver; sözde koddan kaçın.
|
|
17
|
+
- **Yapı:** Kısa giriş → hızlı başlangıç → yaygın görevler → başvuru → sorun giderme. Taranabilir başlıklar kullan.
|
|
18
|
+
- **Doğruluk:** Yalnızca kod tabanında gerçekten var olan komut, bayrak, yol ve davranışı yaz; uydurma.
|
|
19
|
+
- **Kısalık:** Gereksiz sıfat ve tekrar yok. Bir cümle bir iş yapsın.
|
|
20
|
+
- **Bakım:** Kırılgan ayrıntıyı (sürüm numarası, iç yol) tek yerde tut; kodla dokümanı senkron bırak.
|
|
21
|
+
|
|
22
|
+
## Kurallar
|
|
23
|
+
|
|
24
|
+
Mevcut dokümanın dilini, tonunu ve biçimini koru. Var olan bir belgeyi güncelliyorsan üslubu değiştirme.
|
|
25
|
+
Yalnızca doğruladığın bilgiyi yaz; emin olmadığın davranışı "kesin" gibi sunma.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: empty-error-loading-states
|
|
3
|
-
description: Boş, hata, yükleniyor ve kısmi başarı durumlarını eyleme dönük tasarla; veri getiren arayüzlerde kullan.
|
|
4
|
-
category: design
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [empty state, boş durum, error state, hata durumu, loading, yükleniyor, skeleton, retry, partial]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Arayüz Durumları
|
|
10
|
-
|
|
11
|
-
- İlk kullanım boşluğu, filtre sonucu boşluğu, izin yokluğu ve gerçek veri yokluğunu farklı ele al.
|
|
12
|
-
- Yüklenirken düzeni sabit tut; bilinmeyen süre için ilerleme/skeleton, uzun işlem için durum ve iptal sun.
|
|
13
|
-
- Hata metninde ne olduğunu, kullanıcı etkisini ve güvenli sonraki eylemi söyle; teknik ayrıntıyı sızdırma.
|
|
14
|
-
- Retry yalnız güvenliyse göster; girilmiş veri ve önceki başarılı içeriği mümkünse koru.
|
|
15
|
-
- Kısmi başarıyı tüm ekran hatası gibi sunma; güncellik ve eksik bölümü açık işaretle.
|
|
16
|
-
- Durumları gerçek gecikme, offline, 401/403/404/429/5xx ve dar ekran koşullarında test et.
|
|
1
|
+
---
|
|
2
|
+
name: empty-error-loading-states
|
|
3
|
+
description: Boş, hata, yükleniyor ve kısmi başarı durumlarını eyleme dönük tasarla; veri getiren arayüzlerde kullan.
|
|
4
|
+
category: design
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [empty state, boş durum, error state, hata durumu, loading, yükleniyor, skeleton, retry, partial]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Arayüz Durumları
|
|
10
|
+
|
|
11
|
+
- İlk kullanım boşluğu, filtre sonucu boşluğu, izin yokluğu ve gerçek veri yokluğunu farklı ele al.
|
|
12
|
+
- Yüklenirken düzeni sabit tut; bilinmeyen süre için ilerleme/skeleton, uzun işlem için durum ve iptal sun.
|
|
13
|
+
- Hata metninde ne olduğunu, kullanıcı etkisini ve güvenli sonraki eylemi söyle; teknik ayrıntıyı sızdırma.
|
|
14
|
+
- Retry yalnız güvenliyse göster; girilmiş veri ve önceki başarılı içeriği mümkünse koru.
|
|
15
|
+
- Kısmi başarıyı tüm ekran hatası gibi sunma; güncellik ve eksik bölümü açık işaretle.
|
|
16
|
+
- Durumları gerçek gecikme, offline, 401/403/404/429/5xx ve dar ekran koşullarında test et.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: end-to-end-testing
|
|
3
|
-
description: Kritik kullanıcı yolunu gerçek sistem sınırları boyunca güvenilir E2E testle doğrula; UI ve tam akış testlerinde kullan.
|
|
4
|
-
category: testing
|
|
5
|
-
appliesTo: [implement, review]
|
|
6
|
-
match: [e2e, end to end, uçtan uca, playwright, cypress, browser test, kullanıcı akışı]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Uçtan Uca Test
|
|
10
|
-
|
|
11
|
-
1. İş değeri yüksek, katmanlar arası tek bir kullanıcı yolunu seç; her ayrıntıyı E2E'ye taşıma.
|
|
12
|
-
2. Testi erişilebilir rol, etiket ve görünen sonuçlarla sür; kırılgan CSS veya zamanlama seçicilerinden kaçın.
|
|
13
|
-
3. Veriyi API/fixture ile deterministik kur, testler arasında benzersizleştir ve temizle.
|
|
14
|
-
4. Sabit sleep yerine gözlemlenebilir koşulu bekle; retry ile gerçek flakiness'i gizleme.
|
|
15
|
-
5. Başarısızlıkta ekran görüntüsü, trace, ağ ve uygulama logunu sakla.
|
|
16
|
-
6. En az bir hata/izin yolunu ekleyip testi temiz ortamda tekrarlı çalıştır.
|
|
1
|
+
---
|
|
2
|
+
name: end-to-end-testing
|
|
3
|
+
description: Kritik kullanıcı yolunu gerçek sistem sınırları boyunca güvenilir E2E testle doğrula; UI ve tam akış testlerinde kullan.
|
|
4
|
+
category: testing
|
|
5
|
+
appliesTo: [implement, review]
|
|
6
|
+
match: [e2e, end to end, uçtan uca, playwright, cypress, browser test, kullanıcı akışı]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Uçtan Uca Test
|
|
10
|
+
|
|
11
|
+
1. İş değeri yüksek, katmanlar arası tek bir kullanıcı yolunu seç; her ayrıntıyı E2E'ye taşıma.
|
|
12
|
+
2. Testi erişilebilir rol, etiket ve görünen sonuçlarla sür; kırılgan CSS veya zamanlama seçicilerinden kaçın.
|
|
13
|
+
3. Veriyi API/fixture ile deterministik kur, testler arasında benzersizleştir ve temizle.
|
|
14
|
+
4. Sabit sleep yerine gözlemlenebilir koşulu bekle; retry ile gerçek flakiness'i gizleme.
|
|
15
|
+
5. Başarısızlıkta ekran görüntüsü, trace, ağ ve uygulama logunu sakla.
|
|
16
|
+
6. En az bir hata/izin yolunu ekleyip testi temiz ortamda tekrarlı çalıştır.
|
|
@@ -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.
|