gunluk-ozet

name	gunluk-ozet
description	O gün yapılan tüm değişiklikleri (git commit'leri + commit'lenmemiş değişiklikler) toplayıp, başkalarının anlayabileceği sade bir Türkçe özet olarak markdown dosyasına yazar. Dosya isimleri değil, NE yapıldığını ve NEDEN yapıldığını anlatır. Kullanıcı "günlük özet", "bugün ne yaptım", "gün sonu raporu", "değişiklikleri md yap" gibi bir şey istediğinde kullan.

Günlük Değişiklik Özeti

Amaç: Bir günün sonunda yapılan işleri, teknik olmayan biri bile anlayabilecek şekilde özetleyip paylaşılabilir bir markdown dosyasına yazmak. Ham git çıktısı değil, insan dili.

Adım 1 — O günün değişikliklerini topla

Bugünün commit'lerini al:

git log --since="00:00" --until="now" --pretty=format:"%h %s" --stat

Commit'lenmemiş (henüz devam eden) değişiklikleri de dahil et:

git status --short
git diff --stat

Değişikliklerin ne olduğunu gerçekten anlamak için ilgili diff'lere bak (sadece dosya adına bakma):

git log --since="00:00" -p        # bugünkü commit'lerin içeriği
git diff                          # commit'lenmemiş değişiklikler

Not: Eğer bugün hiç değişiklik yoksa, kullanıcıya bildir ve son değişiklik gününü öner (git log -1 --format=%cd), o günü özetlemeyi teklif et.

Adım 2 — Anlamlı grupla ve sadeleştir

Değişiklikleri konuya göre grupla, dosya dosya listeleme:

• Yeni özellikler / endpoint'ler
• Düzeltmeler (bug fix)
• Altyapı / yapılandırma (Docker, migration, config)
• Dokümantasyon

Her madde için:

• Ne yapıldığını sade dille yaz (ör. "Kategoriler için tam CRUD API'si eklendi")
• Gerekiyorsa neden yapıldığını ekle (ör. "aynı isimde kategori engellensin diye unique kısıtı eklendi")
• Teknik jargonu minimuma indir; kullanılan teknoloji adı gerekliyse parantezle ver

Yapma:

• app.module.ts değiştirildi gibi dosya-seviyesi ifadeler (bunun yerine "modül sisteme bağlandı")
• Ham commit hash'leri listesi
• İç içe teknik ayrıntı yığını

Adım 3 — Markdown dosyasına yaz

Dosyayı docs/gunluk/YYYY-MM-DD.md yoluna yaz (klasör yoksa oluştur). Tarihi bugünün gerçek tarihinden al.

Şablon:

# Günlük Özet — <GG.AA.YYYY>

## Özet
<2-3 cümlelik, o günün en önemli çıktısı>

## Yapılanlar

### ✨ Yeni Özellikler
- ...

### 🐛 Düzeltmeler
- ...

### 🔧 Altyapı / Yapılandırma
- ...

### 📄 Dokümantasyon
- ...

## Notlar / Sıradaki İşler
- <varsa yarım kalan işler veya bir sonraki adım>

Boş olan bölümleri (o gün o kategoride iş yoksa) şablondan çıkar — sadece dolu başlıklar kalsın.

Adım 4 — Kullanıcıya bildir

Dosyayı oluşturduktan sonra:

• Dosyanın yolunu ver
• Özetin markdown önizlemesini sohbete de yaz ki kullanıcı hemen görsün
• İstenirse PR açıklamasına / issue yorumuna yapıştırılabilir formatta olduğunu belirt

Notlar

• Tek bir kişinin o günkü işini özetliyorsun; "biz" yerine sade, nötr bir dil kullan.
• Tarih/gün belirsizse bugünü varsay; kullanıcı "dün" veya belirli bir tarih derse --since/--until aralığını ona göre ayarla.
• Amaç ekip içi paylaşım — okuyan kişi kodu görmeden ne olduğunu anlayabilmeli.