@omerrgocmen/crewctl 1.3.0 → 1.3.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/README.md +193 -193
- package/orchestrator/README.md +473 -473
- package/orchestrator/config.default.json +90 -79
- package/orchestrator/roles/executor.md +57 -57
- package/orchestrator/roles/operator.md +77 -77
- package/orchestrator/roles/planner.md +58 -58
- 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/checkpoints.js +0 -4
- package/orchestrator/src/cli-registry.js +848 -740
- package/orchestrator/src/cli.js +140 -140
- package/orchestrator/src/doctor.js +64 -64
- package/orchestrator/src/engine.js +1914 -1735
- package/orchestrator/src/schedule.js +124 -126
- package/orchestrator/src/server.js +817 -818
- package/orchestrator/src/skill-registry.js +272 -272
- package/orchestrator/src/store.js +478 -470
- package/orchestrator/web/OrbitControls.js +1417 -1417
- package/orchestrator/web/board.html +146 -146
- package/orchestrator/web/code.html +213 -213
- package/orchestrator/web/flow.html +741 -741
- package/orchestrator/web/index.html +622 -602
- 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 -12
- package/orchestrator/web/three.module.min.js +6 -6
- package/package.json +51 -51
|
@@ -1,63 +1,63 @@
|
|
|
1
|
-
# Rol: Denetçi
|
|
2
|
-
|
|
3
|
-
## Amaç
|
|
4
|
-
|
|
5
|
-
Teslimatı kullanıcı hedefi, kabul kriterleri ve mevcut proje davranışına karşı bağımsız olarak
|
|
6
|
-
doğrula. Uygulayıcının raporunu kanıt kabul etme; dosyaları, farkları ve test sonuçlarını kendin
|
|
7
|
-
incele. Bu rolde çözümü değiştirmezsin.
|
|
8
|
-
|
|
9
|
-
## İnceleme ilkeleri
|
|
10
|
-
|
|
11
|
-
- **Rapora değil koda güven.** "Yaptım/geçti" ifadesini doğrulama sayma; değişen dosyayı ve etkilediği
|
|
12
|
-
çağrı yerlerini kendin oku.
|
|
13
|
-
- **Çalıştırabildiğini çalıştır.** Hedefli testleri veya salt okunur kontrolleri gerçekten yürüt ve
|
|
14
|
-
gözlemlediğin sonucu kanıt yaz. Çalıştıramadığını `NOT RUN` işaretle, uydurma.
|
|
15
|
-
- **Kanıtsız reddetme, göz boyamayla onaylama.** Her bulguya dosya/konum ve somut kanıt bağla; bulgu
|
|
16
|
-
yoksa yapay sorun icat etme, gerçek riski de örtme.
|
|
17
|
-
|
|
18
|
-
## İnceleme sırası
|
|
19
|
-
|
|
20
|
-
1. Ana hedefi ve delegasyon kapsamını çıkar.
|
|
21
|
-
2. Değişen dosyaları ve ilgili mevcut kodu inceleyerek davranışın gerçekten uygulandığını doğrula.
|
|
22
|
-
3. Mümkünse hedefli testleri veya salt okunur kontrolleri çalıştır; başarısız ya da çalıştırılamayan
|
|
23
|
-
kontrolleri açıkça ayır.
|
|
24
|
-
4. Doğruluk, kapsam eksikleri, regresyon, güvenlik, veri kaybı, hata yönetimi ve test yeterliliğini
|
|
25
|
-
görevle orantılı değerlendir.
|
|
26
|
-
5. Bulguları önem sırasına koy; her bulguya dosya/konum veya başka somut kanıt ekle.
|
|
27
|
-
|
|
28
|
-
## Karar kuralları
|
|
29
|
-
|
|
30
|
-
- `PASS`: Tüm kabul kriterleri karşılanmış, doğrulama yeterli ve düzeltme gerektiren `CRITICAL` veya
|
|
31
|
-
`HIGH` önemde somut sorun yok.
|
|
32
|
-
- `FAIL`: Yalnızca `CRITICAL`/`HIGH` önemde işlevsel hata, eksik kabul kriteri, kapsam dışı/riskli
|
|
33
|
-
değişiklik, regresyon veya teslimatı güvenilmez kılan doğrulama eksikliği için ver.
|
|
34
|
-
- Yalnızca `MEDIUM`/`LOW` bulgular kaldıysa `PASS` ver; bulguları yine listele ve `KALAN RİSK`
|
|
35
|
-
bölümünde özetle. Küçük kenar durumları teslimatı başarısız saymanın gerekçesi değildir.
|
|
36
|
-
- Stil tercihini, kanıtsız ihtimali veya görev dışı iyileştirme fikrini hata olarak sunma.
|
|
37
|
-
- Bir bulgu için beklenen davranışı, gözlenen davranışı, etkisini ve uygulanabilir düzeltme yönünü yaz.
|
|
38
|
-
- Sorun yoksa yapay bulgu üretme. Kullanamadığın bir araç (örn. canlı tarayıcı) nedeniyle `FAIL`
|
|
39
|
-
verme; o kontrolü `NOT RUN` olarak işaretle ve kalan riskini yaz.
|
|
40
|
-
|
|
41
|
-
## Sınırlar
|
|
42
|
-
|
|
43
|
-
- Dosya, kod, test veya yapılandırma değiştirme; düzeltmeyi kendin uygulama.
|
|
44
|
-
- Yeni kapsam icat etme veya uygulayıcının yaklaşımını sırf farklı tercih ettiğin için reddetme.
|
|
45
|
-
- Görmediğin test sonucunu, dosyayı ya da davranışı doğrulanmış gibi gösterme.
|
|
46
|
-
|
|
47
|
-
## Çıktı sözleşmesi
|
|
48
|
-
|
|
49
|
-
Önce karar verilmesini sağlayan bilgiyi ver; uzun özet ve ham log kopyalama:
|
|
50
|
-
|
|
51
|
-
```text
|
|
52
|
-
DEĞERLENDİRME: <1-2 cümlelik sonuç>
|
|
53
|
-
BULGULAR:
|
|
54
|
-
- [CRITICAL|HIGH|MEDIUM|LOW] <dosya/konum> — <sorun, etkisi ve düzeltme yönü>
|
|
55
|
-
# Bulgu yoksa: - Yok
|
|
56
|
-
DOĞRULAMA:
|
|
57
|
-
- `<çalıştırılan komut veya kontrol>` — PASS|FAIL|NOT RUN (<kısa kanıt>)
|
|
58
|
-
KALAN RİSK: <varsa kısa açıklama> | Yok
|
|
59
|
-
VERDICT: PASS
|
|
60
|
-
```
|
|
61
|
-
|
|
62
|
-
Çıktının son satırı, arkasında hiçbir metin olmadan, mutlaka tam olarak `VERDICT: PASS` veya
|
|
63
|
-
`VERDICT: FAIL` olmalıdır.
|
|
1
|
+
# Rol: Denetçi
|
|
2
|
+
|
|
3
|
+
## Amaç
|
|
4
|
+
|
|
5
|
+
Teslimatı kullanıcı hedefi, kabul kriterleri ve mevcut proje davranışına karşı bağımsız olarak
|
|
6
|
+
doğrula. Uygulayıcının raporunu kanıt kabul etme; dosyaları, farkları ve test sonuçlarını kendin
|
|
7
|
+
incele. Bu rolde çözümü değiştirmezsin.
|
|
8
|
+
|
|
9
|
+
## İnceleme ilkeleri
|
|
10
|
+
|
|
11
|
+
- **Rapora değil koda güven.** "Yaptım/geçti" ifadesini doğrulama sayma; değişen dosyayı ve etkilediği
|
|
12
|
+
çağrı yerlerini kendin oku.
|
|
13
|
+
- **Çalıştırabildiğini çalıştır.** Hedefli testleri veya salt okunur kontrolleri gerçekten yürüt ve
|
|
14
|
+
gözlemlediğin sonucu kanıt yaz. Çalıştıramadığını `NOT RUN` işaretle, uydurma.
|
|
15
|
+
- **Kanıtsız reddetme, göz boyamayla onaylama.** Her bulguya dosya/konum ve somut kanıt bağla; bulgu
|
|
16
|
+
yoksa yapay sorun icat etme, gerçek riski de örtme.
|
|
17
|
+
|
|
18
|
+
## İnceleme sırası
|
|
19
|
+
|
|
20
|
+
1. Ana hedefi ve delegasyon kapsamını çıkar.
|
|
21
|
+
2. Değişen dosyaları ve ilgili mevcut kodu inceleyerek davranışın gerçekten uygulandığını doğrula.
|
|
22
|
+
3. Mümkünse hedefli testleri veya salt okunur kontrolleri çalıştır; başarısız ya da çalıştırılamayan
|
|
23
|
+
kontrolleri açıkça ayır.
|
|
24
|
+
4. Doğruluk, kapsam eksikleri, regresyon, güvenlik, veri kaybı, hata yönetimi ve test yeterliliğini
|
|
25
|
+
görevle orantılı değerlendir.
|
|
26
|
+
5. Bulguları önem sırasına koy; her bulguya dosya/konum veya başka somut kanıt ekle.
|
|
27
|
+
|
|
28
|
+
## Karar kuralları
|
|
29
|
+
|
|
30
|
+
- `PASS`: Tüm kabul kriterleri karşılanmış, doğrulama yeterli ve düzeltme gerektiren `CRITICAL` veya
|
|
31
|
+
`HIGH` önemde somut sorun yok.
|
|
32
|
+
- `FAIL`: Yalnızca `CRITICAL`/`HIGH` önemde işlevsel hata, eksik kabul kriteri, kapsam dışı/riskli
|
|
33
|
+
değişiklik, regresyon veya teslimatı güvenilmez kılan doğrulama eksikliği için ver.
|
|
34
|
+
- Yalnızca `MEDIUM`/`LOW` bulgular kaldıysa `PASS` ver; bulguları yine listele ve `KALAN RİSK`
|
|
35
|
+
bölümünde özetle. Küçük kenar durumları teslimatı başarısız saymanın gerekçesi değildir.
|
|
36
|
+
- Stil tercihini, kanıtsız ihtimali veya görev dışı iyileştirme fikrini hata olarak sunma.
|
|
37
|
+
- Bir bulgu için beklenen davranışı, gözlenen davranışı, etkisini ve uygulanabilir düzeltme yönünü yaz.
|
|
38
|
+
- Sorun yoksa yapay bulgu üretme. Kullanamadığın bir araç (örn. canlı tarayıcı) nedeniyle `FAIL`
|
|
39
|
+
verme; o kontrolü `NOT RUN` olarak işaretle ve kalan riskini yaz.
|
|
40
|
+
|
|
41
|
+
## Sınırlar
|
|
42
|
+
|
|
43
|
+
- Dosya, kod, test veya yapılandırma değiştirme; düzeltmeyi kendin uygulama.
|
|
44
|
+
- Yeni kapsam icat etme veya uygulayıcının yaklaşımını sırf farklı tercih ettiğin için reddetme.
|
|
45
|
+
- Görmediğin test sonucunu, dosyayı ya da davranışı doğrulanmış gibi gösterme.
|
|
46
|
+
|
|
47
|
+
## Çıktı sözleşmesi
|
|
48
|
+
|
|
49
|
+
Önce karar verilmesini sağlayan bilgiyi ver; uzun özet ve ham log kopyalama:
|
|
50
|
+
|
|
51
|
+
```text
|
|
52
|
+
DEĞERLENDİRME: <1-2 cümlelik sonuç>
|
|
53
|
+
BULGULAR:
|
|
54
|
+
- [CRITICAL|HIGH|MEDIUM|LOW] <dosya/konum> — <sorun, etkisi ve düzeltme yönü>
|
|
55
|
+
# Bulgu yoksa: - Yok
|
|
56
|
+
DOĞRULAMA:
|
|
57
|
+
- `<çalıştırılan komut veya kontrol>` — PASS|FAIL|NOT RUN (<kısa kanıt>)
|
|
58
|
+
KALAN RİSK: <varsa kısa açıklama> | Yok
|
|
59
|
+
VERDICT: PASS
|
|
60
|
+
```
|
|
61
|
+
|
|
62
|
+
Çıktının son satırı, arkasında hiçbir metin olmadan, mutlaka tam olarak `VERDICT: PASS` veya
|
|
63
|
+
`VERDICT: FAIL` olmalıdır.
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: acceptance-criteria
|
|
3
|
-
description: Belirsiz bir isteği test edilebilir kabul kriterlerine çevir; planlama ve kapsam netleştirmede kullan.
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [kabul kriteri, acceptance criteria, gereksinim, requirement, kapsam, scope, done, tamamlanma]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Kabul Kriterleri
|
|
10
|
-
|
|
11
|
-
1. Kullanıcı hedefini, aktörleri ve gözlemlenebilir sonucu ayır.
|
|
12
|
-
2. Her kriteri tek davranış olarak `Verilen / Ne zaman / O zaman` veya açık girdi-sonuç biçiminde yaz.
|
|
13
|
-
3. Mutlu yolun yanında hata, boş durum, yetki ve sınır koşullarını kapsa.
|
|
14
|
-
4. Uygulama ayrıntısını değil dışarıdan doğrulanabilir davranışı tanımla.
|
|
15
|
-
5. Yoruma açık sıfatları ölçülebilir eşiklere dönüştür; bilinmeyenleri varsayım olarak işaretle.
|
|
16
|
-
6. Kriterleri ilgili test veya doğrulama adımıyla eşleştir.
|
|
17
|
-
|
|
18
|
-
Teslimatta kapsam dışını ve kabulü engelleyen belirsizlikleri ayrıca belirt.
|
|
1
|
+
---
|
|
2
|
+
name: acceptance-criteria
|
|
3
|
+
description: Belirsiz bir isteği test edilebilir kabul kriterlerine çevir; planlama ve kapsam netleştirmede kullan.
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [kabul kriteri, acceptance criteria, gereksinim, requirement, kapsam, scope, done, tamamlanma]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Kabul Kriterleri
|
|
10
|
+
|
|
11
|
+
1. Kullanıcı hedefini, aktörleri ve gözlemlenebilir sonucu ayır.
|
|
12
|
+
2. Her kriteri tek davranış olarak `Verilen / Ne zaman / O zaman` veya açık girdi-sonuç biçiminde yaz.
|
|
13
|
+
3. Mutlu yolun yanında hata, boş durum, yetki ve sınır koşullarını kapsa.
|
|
14
|
+
4. Uygulama ayrıntısını değil dışarıdan doğrulanabilir davranışı tanımla.
|
|
15
|
+
5. Yoruma açık sıfatları ölçülebilir eşiklere dönüştür; bilinmeyenleri varsayım olarak işaretle.
|
|
16
|
+
6. Kriterleri ilgili test veya doğrulama adımıyla eşleştir.
|
|
17
|
+
|
|
18
|
+
Teslimatta kapsam dışını ve kabulü engelleyen belirsizlikleri ayrıca belirt.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: accessibility-audit
|
|
3
|
-
description: Bir arayüzü WCAG odaklı klavye, semantik, kontrast ve ekran okuyucu kontrolleriyle denetle; erişilebilirlik incelemesinde kullan.
|
|
4
|
-
category: design
|
|
5
|
-
appliesTo: [review]
|
|
6
|
-
match: [accessibility audit, erişilebilirlik denetimi, wcag, a11y, screen reader, ekran okuyucu, keyboard]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Erişilebilirlik Denetimi
|
|
10
|
-
|
|
11
|
-
1. Kritik akışları yalnız klavye ile tamamla; sıra, focus görünürlüğü, trap ve skip link davranışını kaydet.
|
|
12
|
-
2. Semantik başlık, landmark, link, buton, form adı/rol/değerini accessibility tree üzerinden incele.
|
|
13
|
-
3. Metin, kontrol, focus ve durum kontrastını; %200–400 zoom ve reflow'u doğrula.
|
|
14
|
-
4. Alternatif metin, caption, hareket azaltma, hata/başarı duyurusu ve dinamik güncellemeleri kontrol et.
|
|
15
|
-
5. Otomatik taramayı yardımcı kanıt olarak çalıştır; manuel klavye ve ekran okuyucu kontrolünün yerine koyma.
|
|
16
|
-
6. Her bulguyu WCAG ölçütü, kullanıcı etkisi, tekrar adımı ve minimal düzeltmeyle önem sırasına koy.
|
|
1
|
+
---
|
|
2
|
+
name: accessibility-audit
|
|
3
|
+
description: Bir arayüzü WCAG odaklı klavye, semantik, kontrast ve ekran okuyucu kontrolleriyle denetle; erişilebilirlik incelemesinde kullan.
|
|
4
|
+
category: design
|
|
5
|
+
appliesTo: [review]
|
|
6
|
+
match: [accessibility audit, erişilebilirlik denetimi, wcag, a11y, screen reader, ekran okuyucu, keyboard]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Erişilebilirlik Denetimi
|
|
10
|
+
|
|
11
|
+
1. Kritik akışları yalnız klavye ile tamamla; sıra, focus görünürlüğü, trap ve skip link davranışını kaydet.
|
|
12
|
+
2. Semantik başlık, landmark, link, buton, form adı/rol/değerini accessibility tree üzerinden incele.
|
|
13
|
+
3. Metin, kontrol, focus ve durum kontrastını; %200–400 zoom ve reflow'u doğrula.
|
|
14
|
+
4. Alternatif metin, caption, hareket azaltma, hata/başarı duyurusu ve dinamik güncellemeleri kontrol et.
|
|
15
|
+
5. Otomatik taramayı yardımcı kanıt olarak çalıştır; manuel klavye ve ekran okuyucu kontrolünün yerine koyma.
|
|
16
|
+
6. Her bulguyu WCAG ölçütü, kullanıcı etkisi, tekrar adımı ve minimal düzeltmeyle önem sırasına koy.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: accessible-forms
|
|
3
|
-
description: Formları etiket, klavye, hata ve yardım davranışıyla erişilebilir kur; input, validation ve checkout işlerinde kullan.
|
|
4
|
-
category: design
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [accessible form, erişilebilir form, input, form, label, validation error, checkout, aria-describedby]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Erişilebilir Formlar
|
|
10
|
-
|
|
11
|
-
- Her kontrolü görünür ve programatik label ile eşleştir; placeholder'ı label yerine kullanma.
|
|
12
|
-
- Doğru native input türü, autocomplete, inputmode ve fieldset/legend seç.
|
|
13
|
-
- Talimat ile hata metnini kontrole bağla; hatayı yalnız renk ile gösterme ve düzeltme yolunu söyle.
|
|
14
|
-
- Gönderimde hata özetine/failing alana yönetilebilir focus taşı; girilmiş veriyi koru.
|
|
15
|
-
- Klavye sırası DOM akışını izlesin, focus görünür olsun ve özel kontrol native davranışı taklit etsin.
|
|
16
|
-
- Zoom, ekran okuyucu, klavye, mobil ve sunucu tarafı validation ile akışı uçtan uca doğrula.
|
|
1
|
+
---
|
|
2
|
+
name: accessible-forms
|
|
3
|
+
description: Formları etiket, klavye, hata ve yardım davranışıyla erişilebilir kur; input, validation ve checkout işlerinde kullan.
|
|
4
|
+
category: design
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [accessible form, erişilebilir form, input, form, label, validation error, checkout, aria-describedby]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Erişilebilir Formlar
|
|
10
|
+
|
|
11
|
+
- Her kontrolü görünür ve programatik label ile eşleştir; placeholder'ı label yerine kullanma.
|
|
12
|
+
- Doğru native input türü, autocomplete, inputmode ve fieldset/legend seç.
|
|
13
|
+
- Talimat ile hata metnini kontrole bağla; hatayı yalnız renk ile gösterme ve düzeltme yolunu söyle.
|
|
14
|
+
- Gönderimde hata özetine/failing alana yönetilebilir focus taşı; girilmiş veriyi koru.
|
|
15
|
+
- Klavye sırası DOM akışını izlesin, focus görünür olsun ve özel kontrol native davranışı taklit etsin.
|
|
16
|
+
- Zoom, ekran okuyucu, klavye, mobil ve sunucu tarafı validation ile akışı uçtan uca doğrula.
|
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: api-design
|
|
3
|
-
description: Tutarlı, öngörülebilir ve sürüm-güvenli HTTP/REST API tasarımı rehberi
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [implement, plan]
|
|
6
|
-
match: [api, endpoint, rest, http, route, controller, backend, servis, service, sozlesme, sözleşme, contract]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Beceri: API Tasarımı
|
|
10
|
-
|
|
11
|
-
API'yi bir sözleşme gibi tasarla: tutarlı, tahmin edilebilir ve kırmadan geliştirilebilir.
|
|
12
|
-
|
|
13
|
-
## İlkeler
|
|
14
|
-
|
|
15
|
-
- **Kaynak odaklı yollar:** Çoğul isimler (`/users/{id}/orders`), fiil değil. HTTP metodunu doğru kullan
|
|
16
|
-
(GET okur, POST oluşturur, PUT/PATCH günceller, DELETE siler).
|
|
17
|
-
- **Doğru durum kodları:** 200/201/204, 400/401/403/404/409/422, 5xx. Hataları tutarlı bir gövde şemasıyla döndür.
|
|
18
|
-
- **Tutarlı sözleşme:** Alan adlandırması, tarih formatı (ISO 8601), sayfalama, filtreleme ve sıralama her yerde aynı.
|
|
19
|
-
- **Girdi doğrulama:** Sınırda doğrula; net, alanı belirten hata mesajları ver. Güvenilmeyen girdiye güvenme.
|
|
20
|
-
- **Idempotency & yan etki:** GET yan etkisiz olsun; tekrar denenebilir işlemlerde idempotency düşün.
|
|
21
|
-
- **Sürümleme & geriye uyumluluk:** Kırıcı değişiklikten kaçın; gerekiyorsa sürümle. Alan ekle, sessizce kaldırma.
|
|
22
|
-
- **Güvenlik:** Kimlik/yetki her hassas yolda; hassas veriyi yanıtta ve logda sızdırma.
|
|
23
|
-
|
|
24
|
-
## Teslimat
|
|
25
|
-
|
|
26
|
-
Endpoint'i mevcut API stiliyle uyumlu uygula, girdi/çıktı şemasını netleştir ve davranışı testle doğrula.
|
|
27
|
-
Sözleşmeyi (yol, metot, gövde, kodlar) kısaca belgele.
|
|
1
|
+
---
|
|
2
|
+
name: api-design
|
|
3
|
+
description: Tutarlı, öngörülebilir ve sürüm-güvenli HTTP/REST API tasarımı rehberi
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [implement, plan]
|
|
6
|
+
match: [api, endpoint, rest, http, route, controller, backend, servis, service, sozlesme, sözleşme, contract]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Beceri: API Tasarımı
|
|
10
|
+
|
|
11
|
+
API'yi bir sözleşme gibi tasarla: tutarlı, tahmin edilebilir ve kırmadan geliştirilebilir.
|
|
12
|
+
|
|
13
|
+
## İlkeler
|
|
14
|
+
|
|
15
|
+
- **Kaynak odaklı yollar:** Çoğul isimler (`/users/{id}/orders`), fiil değil. HTTP metodunu doğru kullan
|
|
16
|
+
(GET okur, POST oluşturur, PUT/PATCH günceller, DELETE siler).
|
|
17
|
+
- **Doğru durum kodları:** 200/201/204, 400/401/403/404/409/422, 5xx. Hataları tutarlı bir gövde şemasıyla döndür.
|
|
18
|
+
- **Tutarlı sözleşme:** Alan adlandırması, tarih formatı (ISO 8601), sayfalama, filtreleme ve sıralama her yerde aynı.
|
|
19
|
+
- **Girdi doğrulama:** Sınırda doğrula; net, alanı belirten hata mesajları ver. Güvenilmeyen girdiye güvenme.
|
|
20
|
+
- **Idempotency & yan etki:** GET yan etkisiz olsun; tekrar denenebilir işlemlerde idempotency düşün.
|
|
21
|
+
- **Sürümleme & geriye uyumluluk:** Kırıcı değişiklikten kaçın; gerekiyorsa sürümle. Alan ekle, sessizce kaldırma.
|
|
22
|
+
- **Güvenlik:** Kimlik/yetki her hassas yolda; hassas veriyi yanıtta ve logda sızdırma.
|
|
23
|
+
|
|
24
|
+
## Teslimat
|
|
25
|
+
|
|
26
|
+
Endpoint'i mevcut API stiliyle uyumlu uygula, girdi/çıktı şemasını netleştir ve davranışı testle doğrula.
|
|
27
|
+
Sözleşmeyi (yol, metot, gövde, kodlar) kısaca belgele.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: api-documentation
|
|
3
|
-
description: Bir API'yi hızlı başlangıç, kimlik doğrulama, örnek ve hata davranışıyla tüketilebilir biçimde belgele; API docs işlerinde kullan.
|
|
4
|
-
category: documentation
|
|
5
|
-
appliesTo: [implement, review]
|
|
6
|
-
match: [api documentation, api docs, endpoint docs, api belgesi, developer portal, request response example]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# API Dokümantasyonu
|
|
10
|
-
|
|
11
|
-
- Okuyucunun ilk başarılı isteğini en kısa yoldan çalıştıracağı başlangıç örneği ver.
|
|
12
|
-
- Base URL, kimlik doğrulama, gerekli header ve ortam farklarını açıkla; gerçek sır kullanma.
|
|
13
|
-
- Her endpoint için amaç, parametre, istek, yanıt, durum kodu, hata ve idempotency davranışını göster.
|
|
14
|
-
- Örnekleri geçerli, kopyalanabilir ve şemayla tutarlı tut; sahte alan uydurma.
|
|
15
|
-
- Sayfalama, rate limit, retry, webhook ve sürümleme gibi çapraz davranışları tek yerde belgeleyip bağla.
|
|
16
|
-
- Dokümanı çalışan sözleşme/testle karşılaştır ve kod değişikliğiyle birlikte güncelle.
|
|
1
|
+
---
|
|
2
|
+
name: api-documentation
|
|
3
|
+
description: Bir API'yi hızlı başlangıç, kimlik doğrulama, örnek ve hata davranışıyla tüketilebilir biçimde belgele; API docs işlerinde kullan.
|
|
4
|
+
category: documentation
|
|
5
|
+
appliesTo: [implement, review]
|
|
6
|
+
match: [api documentation, api docs, endpoint docs, api belgesi, developer portal, request response example]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# API Dokümantasyonu
|
|
10
|
+
|
|
11
|
+
- Okuyucunun ilk başarılı isteğini en kısa yoldan çalıştıracağı başlangıç örneği ver.
|
|
12
|
+
- Base URL, kimlik doğrulama, gerekli header ve ortam farklarını açıkla; gerçek sır kullanma.
|
|
13
|
+
- Her endpoint için amaç, parametre, istek, yanıt, durum kodu, hata ve idempotency davranışını göster.
|
|
14
|
+
- Örnekleri geçerli, kopyalanabilir ve şemayla tutarlı tut; sahte alan uydurma.
|
|
15
|
+
- Sayfalama, rate limit, retry, webhook ve sürümleme gibi çapraz davranışları tek yerde belgeleyip bağla.
|
|
16
|
+
- Dokümanı çalışan sözleşme/testle karşılaştır ve kod değişikliğiyle birlikte güncelle.
|
|
@@ -1,18 +1,18 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: architecture-decision-record
|
|
3
|
-
description: Önemli teknik kararı bağlamı, seçenekleri ve sonuçlarıyla kısa bir ADR olarak kaydet; mimari seçimlerde kullan.
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [plan, implement]
|
|
6
|
-
match: [adr, architecture decision, mimari karar, teknik karar, tradeoff, ödünleşim, karar kaydı]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Mimari Karar Kaydı
|
|
10
|
-
|
|
11
|
-
- Önce kararın durumunu, tarihini ve tek cümlelik başlığını yaz.
|
|
12
|
-
- Bağlamda yalnızca kararı zorunlu kılan kuvvetleri, kısıtları ve kalite hedeflerini açıkla.
|
|
13
|
-
- Gerçekçi seçenekleri aynı ölçütlerle karşılaştır; seçilmeyenleri karikatürleştirme.
|
|
14
|
-
- Kararı kesin bir cümleyle belirt ve nedenini kanıta bağla.
|
|
15
|
-
- Olumlu/olumsuz sonuçları, geçiş maliyetini ve geri dönüş koşulunu kaydet.
|
|
16
|
-
- Var olan ADR numarası, şablonu ve dizin düzenini koru.
|
|
17
|
-
|
|
18
|
-
Karar verilmemişse sahte kesinlik üretme; açık soruları ve karar sahibini belirt.
|
|
1
|
+
---
|
|
2
|
+
name: architecture-decision-record
|
|
3
|
+
description: Önemli teknik kararı bağlamı, seçenekleri ve sonuçlarıyla kısa bir ADR olarak kaydet; mimari seçimlerde kullan.
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [plan, implement]
|
|
6
|
+
match: [adr, architecture decision, mimari karar, teknik karar, tradeoff, ödünleşim, karar kaydı]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Mimari Karar Kaydı
|
|
10
|
+
|
|
11
|
+
- Önce kararın durumunu, tarihini ve tek cümlelik başlığını yaz.
|
|
12
|
+
- Bağlamda yalnızca kararı zorunlu kılan kuvvetleri, kısıtları ve kalite hedeflerini açıkla.
|
|
13
|
+
- Gerçekçi seçenekleri aynı ölçütlerle karşılaştır; seçilmeyenleri karikatürleştirme.
|
|
14
|
+
- Kararı kesin bir cümleyle belirt ve nedenini kanıta bağla.
|
|
15
|
+
- Olumlu/olumsuz sonuçları, geçiş maliyetini ve geri dönüş koşulunu kaydet.
|
|
16
|
+
- Var olan ADR numarası, şablonu ve dizin düzenini koru.
|
|
17
|
+
|
|
18
|
+
Karar verilmemişse sahte kesinlik üretme; açık soruları ve karar sahibini belirt.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: authentication-design
|
|
3
|
-
description: Kullanıcı kimliğini güvenli oturum, parola ve yeniden doğrulama akışıyla tasarla; login ve hesap güvenliğinde kullan.
|
|
4
|
-
category: security
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [authentication, authn, kimlik doğrulama, login, signin, password, parola, session, mfa]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Kimlik Doğrulama Tasarımı
|
|
10
|
-
|
|
11
|
-
- Yerleşik framework/kimlik sağlayıcısını tercih et; özel kriptografik protokol tasarlama.
|
|
12
|
-
- Kimlik belirteçlerini yüksek entropili, süreli, iptal edilebilir ve aktarımda/depoda korumalı yap.
|
|
13
|
-
- Parolayı güncel adaptif hash ile sakla; giriş, reset ve kayıt yanıtlarında hesap varlığını sızdırma.
|
|
14
|
-
- Brute force ve credential stuffing'e rate limit, gecikme, izleme ve uygun MFA ile katmanlı savunma uygula.
|
|
15
|
-
- Hassas işlemde yeniden doğrulama, oturum döndürme ve tüm oturumları sonlandırma desteği sağla.
|
|
16
|
-
- Cookie bayrakları, logout/timeout, hata ve kurtarma yollarını güvenlik testleriyle doğrula.
|
|
1
|
+
---
|
|
2
|
+
name: authentication-design
|
|
3
|
+
description: Kullanıcı kimliğini güvenli oturum, parola ve yeniden doğrulama akışıyla tasarla; login ve hesap güvenliğinde kullan.
|
|
4
|
+
category: security
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [authentication, authn, kimlik doğrulama, login, signin, password, parola, session, mfa]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Kimlik Doğrulama Tasarımı
|
|
10
|
+
|
|
11
|
+
- Yerleşik framework/kimlik sağlayıcısını tercih et; özel kriptografik protokol tasarlama.
|
|
12
|
+
- Kimlik belirteçlerini yüksek entropili, süreli, iptal edilebilir ve aktarımda/depoda korumalı yap.
|
|
13
|
+
- Parolayı güncel adaptif hash ile sakla; giriş, reset ve kayıt yanıtlarında hesap varlığını sızdırma.
|
|
14
|
+
- Brute force ve credential stuffing'e rate limit, gecikme, izleme ve uygun MFA ile katmanlı savunma uygula.
|
|
15
|
+
- Hassas işlemde yeniden doğrulama, oturum döndürme ve tüm oturumları sonlandırma desteği sağla.
|
|
16
|
+
- Cookie bayrakları, logout/timeout, hata ve kurtarma yollarını güvenlik testleriyle doğrula.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: authorization-review
|
|
3
|
-
description: Her kaynak ve işlemde sunucu tarafı erişim kararlarını denetle; rol, izin, IDOR ve yetki işlerinde kullan.
|
|
4
|
-
category: security
|
|
5
|
-
appliesTo: [implement, review]
|
|
6
|
-
match: [authorization, authz, yetkilendirme, permission, izin, role, rol, access control, idor, privilege]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Yetkilendirme İncelemesi
|
|
10
|
-
|
|
11
|
-
1. Aktör × kaynak × işlem matrisi çıkar; varsayılanı deny yap.
|
|
12
|
-
2. Yetkiyi yalnızca route/UI'da değil, kaynağın sahipliği ve tenant sınırıyla veri erişiminde doğrula.
|
|
13
|
-
3. Kullanıcı kontrollü ID, rol, tenant veya durum alanının kararı manipüle edip etmediğini izle.
|
|
14
|
-
4. Yatay/dikey yetki yükseltme, toplu endpoint ve dolaylı nesne erişimini test et.
|
|
15
|
-
5. Admin/bakım yollarını ve arka plan işlerini aynı politikaya bağla.
|
|
16
|
-
6. Her izin için allow ve deny regresyon testi yaz; reddi güvenli biçimde logla, hassas ayrıntı sızdırma.
|
|
1
|
+
---
|
|
2
|
+
name: authorization-review
|
|
3
|
+
description: Her kaynak ve işlemde sunucu tarafı erişim kararlarını denetle; rol, izin, IDOR ve yetki işlerinde kullan.
|
|
4
|
+
category: security
|
|
5
|
+
appliesTo: [implement, review]
|
|
6
|
+
match: [authorization, authz, yetkilendirme, permission, izin, role, rol, access control, idor, privilege]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Yetkilendirme İncelemesi
|
|
10
|
+
|
|
11
|
+
1. Aktör × kaynak × işlem matrisi çıkar; varsayılanı deny yap.
|
|
12
|
+
2. Yetkiyi yalnızca route/UI'da değil, kaynağın sahipliği ve tenant sınırıyla veri erişiminde doğrula.
|
|
13
|
+
3. Kullanıcı kontrollü ID, rol, tenant veya durum alanının kararı manipüle edip etmediğini izle.
|
|
14
|
+
4. Yatay/dikey yetki yükseltme, toplu endpoint ve dolaylı nesne erişimini test et.
|
|
15
|
+
5. Admin/bakım yollarını ve arka plan işlerini aynı politikaya bağla.
|
|
16
|
+
6. Her izin için allow ve deny regresyon testi yaz; reddi güvenli biçimde logla, hassas ayrıntı sızdırma.
|
|
@@ -1,17 +1,17 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: backward-compatibility
|
|
3
|
-
description: API, veri ve davranış değişikliklerinde mevcut tüketicileri koru; kırıcı değişiklik veya yükseltme işlerinde kullan.
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [backward compatibility, geriye uyumluluk, breaking change, kırıcı değişiklik, deprecation, migration, upgrade]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Geriye Uyumluluk
|
|
10
|
-
|
|
11
|
-
1. Dış sözleşmeleri çıkar: API, CLI bayrağı, dosya biçimi, olay, şema ve varsayılan davranış.
|
|
12
|
-
2. Mevcut tüketicinin yeni sürümle çalışıp çalışmadığını somut örneklerle sınayarak kırılmayı bul.
|
|
13
|
-
3. Alan ekleme, toleranslı okuma, adaptör veya aşamalı kullanımdan kaldırma ile uyumluluğu koru.
|
|
14
|
-
4. Kaçınılmaz kırılmada sürümleme, geçiş yolu, uyarı dönemi ve geri alma planı sağla.
|
|
15
|
-
5. Eski ve yeni biçimi aynı test matrisinde doğrula.
|
|
16
|
-
|
|
17
|
-
Sessiz anlam değişikliğini uyumlu sayma; aynı şeklin farklı davranması da kırıcı olabilir.
|
|
1
|
+
---
|
|
2
|
+
name: backward-compatibility
|
|
3
|
+
description: API, veri ve davranış değişikliklerinde mevcut tüketicileri koru; kırıcı değişiklik veya yükseltme işlerinde kullan.
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [backward compatibility, geriye uyumluluk, breaking change, kırıcı değişiklik, deprecation, migration, upgrade]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Geriye Uyumluluk
|
|
10
|
+
|
|
11
|
+
1. Dış sözleşmeleri çıkar: API, CLI bayrağı, dosya biçimi, olay, şema ve varsayılan davranış.
|
|
12
|
+
2. Mevcut tüketicinin yeni sürümle çalışıp çalışmadığını somut örneklerle sınayarak kırılmayı bul.
|
|
13
|
+
3. Alan ekleme, toleranslı okuma, adaptör veya aşamalı kullanımdan kaldırma ile uyumluluğu koru.
|
|
14
|
+
4. Kaçınılmaz kırılmada sürümleme, geçiş yolu, uyarı dönemi ve geri alma planı sağla.
|
|
15
|
+
5. Eski ve yeni biçimi aynı test matrisinde doğrula.
|
|
16
|
+
|
|
17
|
+
Sessiz anlam değişikliğini uyumlu sayma; aynı şeklin farklı davranması da kırıcı olabilir.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: changelog-writing
|
|
3
|
-
description: Kullanıcıya etkili değişiklikleri taranabilir sürüm notlarına dönüştür; changelog ve release note işlerinde kullan.
|
|
4
|
-
category: documentation
|
|
5
|
-
appliesTo: [implement, review]
|
|
6
|
-
match: [changelog, release notes, sürüm notu, değişiklik günlüğü, keep a changelog, yayın notu]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Changelog Yazımı
|
|
10
|
-
|
|
11
|
-
- Hedef kitleyi paket tüketicisi veya ürün kullanıcısı olarak belirle; iç refactor ayrıntısını ele.
|
|
12
|
-
- Değişiklikleri Added, Changed, Fixed, Deprecated, Removed ve Security başlıklarında grupla.
|
|
13
|
-
- Her maddeyi kullanıcı etkisiyle başlat; kısa, geçmiş zamanlı ve bağlantı kurulabilir yaz.
|
|
14
|
-
- Kırıcı değişiklikleri, gerekli geçiş adımını ve güvenlik etkisini görünür kıl.
|
|
15
|
-
- Tarih, sürüm ve bağlantı biçiminde projenin mevcut düzenini koru.
|
|
16
|
-
- Git geçmişini kanıt olarak kullan; yapılmayan özelliği yazma ve aynı değişikliği tekrarlama.
|
|
1
|
+
---
|
|
2
|
+
name: changelog-writing
|
|
3
|
+
description: Kullanıcıya etkili değişiklikleri taranabilir sürüm notlarına dönüştür; changelog ve release note işlerinde kullan.
|
|
4
|
+
category: documentation
|
|
5
|
+
appliesTo: [implement, review]
|
|
6
|
+
match: [changelog, release notes, sürüm notu, değişiklik günlüğü, keep a changelog, yayın notu]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Changelog Yazımı
|
|
10
|
+
|
|
11
|
+
- Hedef kitleyi paket tüketicisi veya ürün kullanıcısı olarak belirle; iç refactor ayrıntısını ele.
|
|
12
|
+
- Değişiklikleri Added, Changed, Fixed, Deprecated, Removed ve Security başlıklarında grupla.
|
|
13
|
+
- Her maddeyi kullanıcı etkisiyle başlat; kısa, geçmiş zamanlı ve bağlantı kurulabilir yaz.
|
|
14
|
+
- Kırıcı değişiklikleri, gerekli geçiş adımını ve güvenlik etkisini görünür kıl.
|
|
15
|
+
- Tarih, sürüm ve bağlantı biçiminde projenin mevcut düzenini koru.
|
|
16
|
+
- Git geçmişini kanıt olarak kullan; yapılmayan özelliği yazma ve aynı değişikliği tekrarlama.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: ci-pipeline-design
|
|
3
|
-
description: Hızlı, deterministik ve en az yetkili CI doğrulama hattı tasarla; build, test ve workflow işlerinde kullan.
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [ci, pipeline, workflow, github actions, build, continuous integration, sürekli entegrasyon, job]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# CI Hattı Tasarımı
|
|
10
|
-
|
|
11
|
-
1. Birleştirmeyi engelleyen asgari kontrolleri belirle: biçim, statik analiz, test, build ve güvenlik.
|
|
12
|
-
2. Bağımsız işleri paralelleştir; pahalı işleri değişen dosya veya riskle koşullandır.
|
|
13
|
-
3. Sürümleri sabitle, önbellek anahtarlarını lockfile ile bağla ve temiz ortamda deterministik çalıştır.
|
|
14
|
-
4. İş akışına yalnızca gereken izinleri ver; güvenilmeyen PR koduyla sırları buluşturma.
|
|
15
|
-
5. Hata çıktısını uygulanabilir yap, geçici ağ hatalarıyla gerçek test hatalarını ayır.
|
|
16
|
-
6. Yerelde eşdeğer komutu belgeleyip hattı gerçek bir çalıştırmayla doğrula.
|
|
1
|
+
---
|
|
2
|
+
name: ci-pipeline-design
|
|
3
|
+
description: Hızlı, deterministik ve en az yetkili CI doğrulama hattı tasarla; build, test ve workflow işlerinde kullan.
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [ci, pipeline, workflow, github actions, build, continuous integration, sürekli entegrasyon, job]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# CI Hattı Tasarımı
|
|
10
|
+
|
|
11
|
+
1. Birleştirmeyi engelleyen asgari kontrolleri belirle: biçim, statik analiz, test, build ve güvenlik.
|
|
12
|
+
2. Bağımsız işleri paralelleştir; pahalı işleri değişen dosya veya riskle koşullandır.
|
|
13
|
+
3. Sürümleri sabitle, önbellek anahtarlarını lockfile ile bağla ve temiz ortamda deterministik çalıştır.
|
|
14
|
+
4. İş akışına yalnızca gereken izinleri ver; güvenilmeyen PR koduyla sırları buluşturma.
|
|
15
|
+
5. Hata çıktısını uygulanabilir yap, geçici ağ hatalarıyla gerçek test hatalarını ayır.
|
|
16
|
+
6. Yerelde eşdeğer komutu belgeleyip hattı gerçek bir çalıştırmayla doğrula.
|
|
@@ -1,16 +1,16 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: cli-design
|
|
3
|
-
description: Öngörülebilir komut, bayrak, çıktı ve hata davranışı tasarla; komut satırı aracı geliştirmede kullan.
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [plan, implement, review]
|
|
6
|
-
match: [cli, command line, komut satırı, flag, bayrak, argument, stdout, stderr, exit code]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# CLI Tasarımı
|
|
10
|
-
|
|
11
|
-
- Komut ve alt komutları kullanıcı niyetine göre adlandır; mevcut söz dizimini koru.
|
|
12
|
-
- Zorunlu girdiyi az tut, güvenli varsayılanlar ve açık `--help` örnekleri sağla.
|
|
13
|
-
- İnsan çıktısını stdout'a, uyarı/hataları stderr'e yaz; otomasyon için kararlı makine biçimi sun.
|
|
14
|
-
- Başarı ve farklı hata sınıfları için tutarlı çıkış kodları kullan.
|
|
15
|
-
- Tehlikeli veya geri döndürülemez eylemde dry-run, kapsam özeti ve açık onay düşün.
|
|
16
|
-
- TTY olmayan ortamı, boşluklu yolları, Unicode'u ve sinyal/iptal davranışını test et.
|
|
1
|
+
---
|
|
2
|
+
name: cli-design
|
|
3
|
+
description: Öngörülebilir komut, bayrak, çıktı ve hata davranışı tasarla; komut satırı aracı geliştirmede kullan.
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [plan, implement, review]
|
|
6
|
+
match: [cli, command line, komut satırı, flag, bayrak, argument, stdout, stderr, exit code]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# CLI Tasarımı
|
|
10
|
+
|
|
11
|
+
- Komut ve alt komutları kullanıcı niyetine göre adlandır; mevcut söz dizimini koru.
|
|
12
|
+
- Zorunlu girdiyi az tut, güvenli varsayılanlar ve açık `--help` örnekleri sağla.
|
|
13
|
+
- İnsan çıktısını stdout'a, uyarı/hataları stderr'e yaz; otomasyon için kararlı makine biçimi sun.
|
|
14
|
+
- Başarı ve farklı hata sınıfları için tutarlı çıkış kodları kullan.
|
|
15
|
+
- Tehlikeli veya geri döndürülemez eylemde dry-run, kapsam özeti ve açık onay düşün.
|
|
16
|
+
- TTY olmayan ortamı, boşluklu yolları, Unicode'u ve sinyal/iptal davranışını test et.
|
|
@@ -1,27 +1,27 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: code-review
|
|
3
|
-
description: Doğruluk, sadeleştirme, yeniden kullanım ve okunabilirlik odaklı kod incelemesi
|
|
4
|
-
category: software
|
|
5
|
-
appliesTo: [review]
|
|
6
|
-
match: [inceleme, review, kod, refactor, temiz, clean, okunabilir, kalite, quality, denetle]
|
|
7
|
-
---
|
|
8
|
-
|
|
9
|
-
# Beceri: Kod İncelemesi
|
|
10
|
-
|
|
11
|
-
Değişikliği iddia değil kanıt olarak sorgula. Önce doğruluk, sonra sadelik.
|
|
12
|
-
|
|
13
|
-
## Öncelik sırası
|
|
14
|
-
|
|
15
|
-
1. **Doğruluk:** Mantık hataları, sınır durumları, yarış koşulları, hatalı varsayımlar, ele alınmayan
|
|
16
|
-
hata yolları. Somut bir "şu girdide şu bozulur" senaryosu kurabiliyor musun?
|
|
17
|
-
2. **Sadeleştirme & yeniden kullanım:** Tekrarlayan mantık, gereksiz soyutlama, mevcut yardımcı yerine
|
|
18
|
-
yeniden yazılmış kod, ölü kod.
|
|
19
|
-
3. **Okunabilirlik:** İsimlendirme, işlev boyutu, örtük bağımlılık, yanıltıcı yorum.
|
|
20
|
-
4. **Kapsam:** Değişiklik istenen işi mi yapıyor, yoksa ilgisiz alanlara mı taşıyor?
|
|
21
|
-
|
|
22
|
-
## Kurallar
|
|
23
|
-
|
|
24
|
-
- Yalnızca gerçekten gözlemlediğin sorunları raporla; stil tercihini "hata" gibi sunma.
|
|
25
|
-
- Her bulgu için dosya:satır ve minimal, uygulanabilir düzeltme öner.
|
|
26
|
-
- Mevcut kullanıcı değişikliklerini, mimariyi ve stili koru; gereksiz büyük refactor önerme.
|
|
27
|
-
- Sonunda net bir karar ver: `VERDICT: PASS` veya `VERDICT: FAIL` ve en kritik bulguları özetle.
|
|
1
|
+
---
|
|
2
|
+
name: code-review
|
|
3
|
+
description: Doğruluk, sadeleştirme, yeniden kullanım ve okunabilirlik odaklı kod incelemesi
|
|
4
|
+
category: software
|
|
5
|
+
appliesTo: [review]
|
|
6
|
+
match: [inceleme, review, kod, refactor, temiz, clean, okunabilir, kalite, quality, denetle]
|
|
7
|
+
---
|
|
8
|
+
|
|
9
|
+
# Beceri: Kod İncelemesi
|
|
10
|
+
|
|
11
|
+
Değişikliği iddia değil kanıt olarak sorgula. Önce doğruluk, sonra sadelik.
|
|
12
|
+
|
|
13
|
+
## Öncelik sırası
|
|
14
|
+
|
|
15
|
+
1. **Doğruluk:** Mantık hataları, sınır durumları, yarış koşulları, hatalı varsayımlar, ele alınmayan
|
|
16
|
+
hata yolları. Somut bir "şu girdide şu bozulur" senaryosu kurabiliyor musun?
|
|
17
|
+
2. **Sadeleştirme & yeniden kullanım:** Tekrarlayan mantık, gereksiz soyutlama, mevcut yardımcı yerine
|
|
18
|
+
yeniden yazılmış kod, ölü kod.
|
|
19
|
+
3. **Okunabilirlik:** İsimlendirme, işlev boyutu, örtük bağımlılık, yanıltıcı yorum.
|
|
20
|
+
4. **Kapsam:** Değişiklik istenen işi mi yapıyor, yoksa ilgisiz alanlara mı taşıyor?
|
|
21
|
+
|
|
22
|
+
## Kurallar
|
|
23
|
+
|
|
24
|
+
- Yalnızca gerçekten gözlemlediğin sorunları raporla; stil tercihini "hata" gibi sunma.
|
|
25
|
+
- Her bulgu için dosya:satır ve minimal, uygulanabilir düzeltme öner.
|
|
26
|
+
- Mevcut kullanıcı değişikliklerini, mimariyi ve stili koru; gereksiz büyük refactor önerme.
|
|
27
|
+
- Sonunda net bir karar ver: `VERDICT: PASS` veya `VERDICT: FAIL` ve en kritik bulguları özetle.
|