starter-feature

name

starter-feature

description

Bu Flutter template'inde uctan uca yeni feature iskelesi kurar — lib/feature/<ad>/ klasor yapisi, Freezed state + Cubit, StatelessWidget ya da StatefulWidget+ViewModel view, BlocProvider yerlesimi (global state_initialize mi lokal mi), TypedGoRoute, LocaleKeys cevirileri, AppPaddings/textTheme/colorScheme token'lari ve zorunlu <feature>.md modul dokumani. Kullanici "yeni feature ekleyelim", "su sayfayi projeye gore yaz", "cubit + state + view kur", "feature iskeleti cikar", "scaffold a feature" dediginde kullan.

Feature Iskelesi

Bu depoda bir feature'i bastan sona kurma is akisi. Butun kurallar doc/guides/AGENTS.md ve altindaki rehberlerde tanimli — bu skill onlari tekrar etmez, uygular. Karar gerektiren her adimda ilgili rehberi oku.

Bu skill kural uygulayicidir, kesif araci degil. Kullanici "X nedir" diye soruyorsa ilgili doc dosyasina yonlendir; gercekten yazilacak/refactor edilecek kod varsa calistir.

Ne zaman calistir

• lib/feature/<ad>/ altinda yeni feature.
• Mevcut bir feature'i konvansiyona uydurma.
• "cubit + state + view + (servis) kur".

Ne zaman calistirma

• Yalnizca token/stil sorusu → starter-style-guide.
• Yazilmis kodu denetleme → starter-review.
• Tek satirlik bug fix → dosyayi dogrudan duzenle, iskele kurma.

Baslamadan sor (eksikse, bir kez)

1. Feature adi (snake_case).
2. State kapsami — app geneli mi (product/state/ + global provider) yoksa tek ekrana mi ait (feature state/ + view icinde lokal BlocProvider)? Karar tablosu: state_management.md.
3. View tipi — controller/lifecycle gerekiyor mu? Karar tablosu: view_rules.md.
4. Route gerekiyor mu, gerekiyorsa hangi transition?

Kullanici bunlari zaten yazdiysa tekrar sorma.

Asamalar (her asamadan sonra dur)

1 — Plan

• 4 girdiyi netlestir.
• Klasor yapisini folder_structure.md'e gore ciz.
• lib/product/widget/, lib/product/theme/parts/ ve lib/product/utils/ icinde yeniden kullanilacak ne varsa listele — yeniden implement etme.
• Plani yaz, sonra kod yaz.

2 — Model (gerekiyorsa)

model_rules.md: Hive'a yaziliyorsa product/model/ + @HiveType, degilse feature model/ + Freezed.

3 — State + Cubit

state_management.md sablonlari birebir. Servisler constructor injection ile alinir; emit(state.copyWith(...)) disinda state degismez; exception yutulmaz.

4 — View

view_rules.md. StatefulWidget seciliyse _view.dart + _view_model.dart (abstract State) olarak ayir. Veri ceken her ekran dort durumu ele alir — hazir widget'lar ui_states.md'de.

5 — Baglanti

• Route: route_and_strings.md.
• Ceviriler: tr.json ve en.json, ardindan ./script/lang.sh.
• Servis gerekiyorsa: service_rules.md.

6 — Modul dokumani

lib/feature/<ad>/<ad>.md yazilmadan feature bitmis sayilmaz (folder_structure.md).

7 — Bitirme

./script/codegen.sh (codegen gerektiyse) → ./script/lang.sh (ceviri eklendiyse) → ./script/verify.sh.

Otomatik red — cikti vermeden once duzelt

• Inline TextStyle(fontSize: ...) veya inline renk → textTheme / colorScheme / context.appColors.
• Hardcoded EdgeInsets / piksel / BorderRadius.circular(<int>) → AppPaddings / AppRadius.
• Hardcoded kullanici metni → LocaleKeys.*.tr().
• Hardcoded asset yolu → Assets.*.
• // ignore: ile lint susturma.
• emit disinda state mutasyonu; bos catch {}.
• <feature>.md yok.
• Yeni paket eklenmis ama gerekcesi sorulmamis (clean_code.md → Paket disiplini).

Cikti

Olusturulan/degistirilen her dosya icin tek cumle + tiklanabilir yol. Sonra: kalan manuel adim (codegen, route kaydi, ceviri) ve gerekiyorsa eksik test. Baska bir sey yazma.