Degisiklik Denetimi
Calisma dizinindeki (ya da verilen) degisiklikleri
doc/guides/AGENTS.md ve altindaki rehberlere gore denetler.
Kural kaynagi doc'tur; burada kural tanimlanmaz.
Kapsam
Yalnizca degisen dosyalar ve o dosyalarin degisen satirlari. Butun repoyu
denetleme.
git diff --stat
git diff
# ya da branch karsilastirmasi:
git diff main...HEAD
Degisiklik yoksa bunu soyle ve dur.
Yontem
doc/guides/AGENTS.md + degisikligin dokundugu alanin rehberini oku.- Her degisen dosyayi oku.
- Kapsam genisse (5+ dosya, ya da mimari degisiklik) derin denetimi
starter-architecture-reviewer subagent'ina devret ve bulgularini birlestir.
- Her bulguyu bir doc kuralina ve bir
dosya:satir'a bagla. Bagli degilse bulgu degildir.
Ne aranir
Kaynak: doc/guides/clean_code.md, doc/*. Ozet:
Mimari — Freezed state + Cubit sablonu; servis constructor injection ile;
emit(state.copyWith(...)) disinda mutasyon yok; app-geneli state product/state/;
BlocProvider yerlesimi (global/lokal) dogru secilmis.
View — StatelessWidget varsayilan; controller/lifecycle varsa
StatefulWidget + ayri _view_model.dart; build() icinde agir islem yok;
build() ~80 satiri gecmisse parcalanmis; tekrar eden UI metot degil widget sinifi.
Durumlar — veri ceken ekranda loading/error/empty/data dordu de var.
Hata yonetimi — bos catch {} yok; exception yutulmuyor; kullaniciya ham
exception gosterilmiyor.
Token'lar — inline renk, inline TextStyle(fontSize:), ham EdgeInsets,
BorderRadius.circular(<int>), ham Duration yok.
Metin/asset — hardcoded kullanici metni yok (LocaleKeys), hardcoded asset
yolu yok (Assets.*), yeni anahtar hem tr.json hem en.json'da.
Yapi — dosya adlari snake_case, bir dosya bir ana sinif, yeni feature'da
<feature>.md var, enum product/enum/, sabit product/const/.
Lint/kalite — // ignore: ile susturma yok, olu/yorumlanmis kod yok,
magic number yok, yorum "neden"i anlatiyor.
Test — yeni is mantigi (cubit/servis metodu) testle gelmis mi.
Paket — yeni bagimlilik eklendiyse gerekcesi sorulmus mu.
Siddet
- blocker — doc kuralinin dogrudan ihlali: inline renk/stil, hardcoded metin,
yutulan exception, eksik
<feature>.md, // ignore:, emit disi mutasyon.
- warning — konvansiyon sapmasi: view'da is mantigi, parcalanmamis
build(),
eksik durum dali, yanlis klasor.
- info — nit: eksik
const, isimlendirme, gereksiz import.
Cikti
## Review — <N blocker, N warning, N info>
### 🔴 Blocker
- <dosya>:<satir> — <sorun + hangi doc kurali>. Duzeltme: <somut degisiklik>.
### 🟡 Warning
- <dosya>:<satir> — <sorun>. Duzeltme: <somut degisiklik>.
### 🔵 Oneri
- <dosya>:<satir> — <nit>.
### ✅ Dogru yapilmis
- <1-3 madde>
Bos bolumleri yazma. Ayni satiri bir kez, en yuksek siddetle bildir.
Duzeltmeyi kullanici istemeden uygulama.