@omerrgocmen/crewctl 1.0.1 → 1.0.3
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/README.md +2 -0
- package/orchestrator/README.md +429 -427
- package/orchestrator/config.default.json +71 -65
- package/orchestrator/roles/executor.md +26 -18
- package/orchestrator/roles/operator.md +77 -75
- package/orchestrator/roles/planner.md +5 -0
- package/orchestrator/roles/reviewer.md +63 -54
- 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 +616 -613
- package/orchestrator/src/cli.js +131 -131
- package/orchestrator/src/doctor.js +64 -64
- package/orchestrator/src/engine.js +216 -32
- package/orchestrator/src/server.js +766 -733
- package/orchestrator/src/skill-registry.js +272 -272
- package/orchestrator/src/store.js +399 -379
- package/orchestrator/web/OrbitControls.js +1417 -1417
- package/orchestrator/web/android-chrome-192x192.png +0 -0
- package/orchestrator/web/android-chrome-512x512.png +0 -0
- package/orchestrator/web/apple-touch-icon.png +0 -0
- package/orchestrator/web/board.html +5 -0
- package/orchestrator/web/code.html +5 -0
- package/orchestrator/web/favicon-16x16.png +0 -0
- package/orchestrator/web/favicon-32x32.png +0 -0
- package/orchestrator/web/favicon.ico +0 -0
- package/orchestrator/web/flow.html +741 -736
- package/orchestrator/web/index.html +588 -539
- 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/site.webmanifest +12 -0
- package/orchestrator/web/three.module.min.js +6 -6
- package/package.json +1 -1
|
@@ -1,26 +1,26 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: debugging
|
|
3
|
-
description: Kök neden bulma disiplini — belirtiyi değil nedeni düzelt
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [implement]
|
|
6
|
-
match: [hata, bug, debug, hata ayikla, ayıkla, crash, cokme, çökme, exception, fix, duzelt, düzelt, sorun, patlama]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Beceri: Hata Ayıklama
|
|
10
|
-
|
|
11
|
-
Rastgele deneme yerine hipotez–kanıt döngüsü yürüt.
|
|
12
|
-
|
|
13
|
-
## Yöntem
|
|
14
|
-
|
|
15
|
-
1. **Yeniden üret:** Hatayı tetikleyen en küçük, deterministik adımı bul. Üretilemeyen hata düzeltilemez.
|
|
16
|
-
2. **Daralt:** Hatanın olduğu ve olmadığı yeri ikiye bölerek (log, ara değer, git bisect mantığı) izole et.
|
|
17
|
-
3. **Kök nedeni bul:** "Neden?" diye zincirle sor. İlk gördüğün belirtiyi değil, onu üreten nedeni hedefle.
|
|
18
|
-
4. **En küçük düzeltme:** Kök nedeni gideren minimal değişikliği yap; ilgisiz refactor ekleme.
|
|
19
|
-
5. **Regresyona karşı test:** Mümkünse hatayı yakalayan bir test ekle; düzeltme öncesi kırmızı, sonrası yeşil olsun.
|
|
20
|
-
6. **Yan etkiyi kontrol et:** Düzeltmenin başka bir davranışı bozmadığını doğrula.
|
|
21
|
-
|
|
22
|
-
## Kurallar
|
|
23
|
-
|
|
24
|
-
- Belirtiyi maskeleyen çözümlerden (boş `catch`, kontrolü kapatma, sihirli bekleme) kaçın.
|
|
25
|
-
- Bulduğun kök nedeni ve neden bu düzeltmenin doğru olduğunu kısaca raporla.
|
|
26
|
-
- Düzeltilemiyorsa (yeniden üretilemiyor, erişim yok) bunu somut kanıtla `BLOCKED` olarak bildir.
|
|
1
|
+
---
|
|
2
|
+
name: debugging
|
|
3
|
+
description: Kök neden bulma disiplini — belirtiyi değil nedeni düzelt
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [implement]
|
|
6
|
+
match: [hata, bug, debug, hata ayikla, ayıkla, crash, cokme, çökme, exception, fix, duzelt, düzelt, sorun, patlama]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Beceri: Hata Ayıklama
|
|
10
|
+
|
|
11
|
+
Rastgele deneme yerine hipotez–kanıt döngüsü yürüt.
|
|
12
|
+
|
|
13
|
+
## Yöntem
|
|
14
|
+
|
|
15
|
+
1. **Yeniden üret:** Hatayı tetikleyen en küçük, deterministik adımı bul. Üretilemeyen hata düzeltilemez.
|
|
16
|
+
2. **Daralt:** Hatanın olduğu ve olmadığı yeri ikiye bölerek (log, ara değer, git bisect mantığı) izole et.
|
|
17
|
+
3. **Kök nedeni bul:** "Neden?" diye zincirle sor. İlk gördüğün belirtiyi değil, onu üreten nedeni hedefle.
|
|
18
|
+
4. **En küçük düzeltme:** Kök nedeni gideren minimal değişikliği yap; ilgisiz refactor ekleme.
|
|
19
|
+
5. **Regresyona karşı test:** Mümkünse hatayı yakalayan bir test ekle; düzeltme öncesi kırmızı, sonrası yeşil olsun.
|
|
20
|
+
6. **Yan etkiyi kontrol et:** Düzeltmenin başka bir davranışı bozmadığını doğrula.
|
|
21
|
+
|
|
22
|
+
## Kurallar
|
|
23
|
+
|
|
24
|
+
- Belirtiyi maskeleyen çözümlerden (boş `catch`, kontrolü kapatma, sihirli bekleme) kaçın.
|
|
25
|
+
- Bulduğun kök nedeni ve neden bu düzeltmenin doğru olduğunu kısaca raporla.
|
|
26
|
+
- Düzeltilemiyorsa (yeniden üretilemiyor, erişim yok) bunu somut kanıtla `BLOCKED` olarak bildir.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dependency-review
|
|
3
|
-
description: Yeni veya güncellenen bağımlılığın güvenlik, lisans, bakım ve paket boyutu etkisini incele; paket değişimlerinde kullan.
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [dependency, bağımlılık, package, paket, lockfile, npm, pip, cargo, license, lisans, upgrade]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Bağımlılık İncelemesi
|
|
10
|
-
|
|
11
|
-
- Önce ihtiyacın mevcut standart kütüphane veya kurulu paketle çözülüp çözülemeyeceğini kontrol et.
|
|
12
|
-
- Manifest ve lockfile farkında doğrudan/dolaylı paketleri, kaynak ve bütünlük değişimlerini incele.
|
|
13
|
-
- Bakım etkinliği, sürüm politikası, lisans, bilinen açık ve çalışma zamanı ayrıcalıklarını değerlendir.
|
|
14
|
-
- İstemci tarafında paket/bundle maliyetini; sunucuda başlangıç ve tedarik zinciri etkisini ölç.
|
|
15
|
-
- Minimum uyumlu sürümü seç, sürümü kilitle ve kullanım yüzeyini küçük tut.
|
|
16
|
-
- Güncellemeden sonra test, build ve güvenlik taramasını çalıştır; körlemesine büyük lockfile farkı kabul etme.
|
|
1
|
+
---
|
|
2
|
+
name: dependency-review
|
|
3
|
+
description: Yeni veya güncellenen bağımlılığın güvenlik, lisans, bakım ve paket boyutu etkisini incele; paket değişimlerinde kullan.
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [dependency, bağımlılık, package, paket, lockfile, npm, pip, cargo, license, lisans, upgrade]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Bağımlılık İncelemesi
|
|
10
|
+
|
|
11
|
+
- Önce ihtiyacın mevcut standart kütüphane veya kurulu paketle çözülüp çözülemeyeceğini kontrol et.
|
|
12
|
+
- Manifest ve lockfile farkında doğrudan/dolaylı paketleri, kaynak ve bütünlük değişimlerini incele.
|
|
13
|
+
- Bakım etkinliği, sürüm politikası, lisans, bilinen açık ve çalışma zamanı ayrıcalıklarını değerlendir.
|
|
14
|
+
- İstemci tarafında paket/bundle maliyetini; sunucuda başlangıç ve tedarik zinciri etkisini ölç.
|
|
15
|
+
- Minimum uyumlu sürümü seç, sürümü kilitle ve kullanım yüzeyini küçük tut.
|
|
16
|
+
- Güncellemeden sonra test, build ve güvenlik taramasını çalıştır; körlemesine büyük lockfile farkı kabul etme.
|
|
@@ -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.
|