Proje bilgisini 4 katmanli yapida organize et. Aktif projeler, sorumluluk alanlari, referans kaynaklar ve arsiv. Progressive summarization ile bilgiyi katman katman ozumse. Second brain pattern'i ile codebase bilgisini yapilandir.
Buyuk projelerde bilgi kaybini onleyen 4 katmanli organizasyon sistemi.
KATMAN 1: AKTIF ISLER
Simdi uzerinde calisilanlar. Sprint task'lari, aktif bug'lar, devam eden feature'lar.
Konum: thoughts/active/ veya .claude/active/
Kural: Max 5-7 aktif is. Fazlasi = fokus kaybı.
KATMAN 2: SORUMLULUK ALANLARI
Surekli sahip oldugun alanlar. Auth modulu, API layer, deployment pipeline.
Konum: thoughts/areas/ veya .claude/areas/
Kural: Her alan icin tek sayfalik "durum raporu" tut.
KATMAN 3: REFERANSLAR
Tekrar tekrar basvurulan bilgiler. API dokumantasyonu, tasarim kararlari, benchmark sonuclari.
Konum: thoughts/references/ veya .claude/references/
Kural: Ihtiyac duyuldugunda hizla bulunabilmeli.
KATMAN 4: ARSIV
Tamamlanan isler, eski kararlar, deprecated feature'lar.
Konum: thoughts/archive/ veya .claude/archive/
Kural: Silme, tasi. Bir gun lazim olabilir.
YENi BILGI geldiginde:
1. Aktif is ile ilgiliyse → KATMAN 1'e ekle
2. Surekli sorumluluk alaniysa → KATMAN 2'ye ekle
3. Referans/dokumantasyonsa → KATMAN 3'e ekle
4. Hicbirine uymuyorsa → KATMA (gereksiz bilgi)
IS TAMAMLANDIGINDA:
1. KATMAN 1'den kaldir
2. Ogrenimleri KATMAN 3'e tasi (referans olarak)
3. Detaylari KATMAN 4'e arsivle
Bilgiyi katman katman ozumseme teknigi. Her geciste bilgi daha yogun ve erislebilir olur.
Orijinal icerik -- commit mesajlari, PR aciklamalari, meeting notlari, hata loglari.
Ilgili kisimları kaydet. Tam metni degil, onemli parcalari.
# Auth Refactoring Notlari
- JWT'den session-based'e gecis karari alindi (2026-03-15)
- Neden: JWT revocation problemi, token boyutu sisiyor
- Redis session store kullanilacak
- Migration 3 fazda yapilacak
En onemli cumleler/kavramlar bold ile isaretle.
# Auth Refactoring Notlari
- **JWT'den session-based'e gecis** karari alindi (2026-03-15)
- Neden: **JWT revocation problemi**, token boyutu sisiyor
- **Redis session store** kullanilacak
- Migration **3 fazda** yapilacak
Kendi cumlenle 2-3 satirlik ozet yaz.
# Auth Refactoring
JWT revocation problemi nedeniyle session-based auth'a geciliyor.
Redis session store + 3 fazli migration plani var.
Baska bilgilerle birlestir, yeni icerik uret.
# Auth Sistemi Mimari Karar Kaydi
Session-based auth (Redis) tercih edildi. JWT'nin revocation ve boyut
problemleri cozumsuzdu. Bu karar API gateway tasarimini da etkiliyor --
her istekte Redis lookup gerekecek, caching stratejisi buna gore ayarlanmali.
thoughts/
active/
current-sprint.md # Bu sprint'in task'lari
in-progress-feature.md # Uzerinde calisilanlar
areas/
auth.md # Auth modulu durumu
api.md # API layer durumu
infrastructure.md # Infra durumu
references/
adr/ # Architecture Decision Records
001-session-auth.md
002-redis-cache.md
benchmarks/ # Performans sonuclari
api-contracts/ # API sozlesmeleri
archive/
2026-q1/ # Ceyreklik arsiv
deprecated/ # Kaldirilmis feature'lar
# ADR-001: Session-Based Authentication
## Durum
Kabul edildi (2026-03-15)
## Baglam
JWT token'lari revoke edilemiyor, token boyutu buyuyor.
## Karar
Redis-backed session authentication'a gecis.
## Sonuclar
- (+) Anlik revocation mumkun
- (+) Token boyutu sorun degil
- (-) Redis bagimliligi eklendi
- (-) Her istekte session lookup gerekiyor
| Olay | Yakalanacak Bilgi | Nereye |
|---|---|---|
| Mimari karar alindi | ADR yaz | references/adr/ |
| Bug cozuldu | Root cause + fix | references/ veya memory |
| Sprint basladi | Task listesi | active/ |
| Sprint bitti | Retrospektif | archive/ |
| Yeni modul eklendi | Alan durumu | areas/ |
| Performance test yapildi | Benchmark sonuclari | references/benchmarks/ |
| API degisti | Contract guncelle | references/api-contracts/ |
| Dependency upgrade | Migration notlari | active/ (sonra archive/) |
Bir soruya cevap ararken su sirada bak:
1. AKTIF ISLER (thoughts/active/) → Simdi alakali mi?
2. ALAN DURUMLARI (thoughts/areas/) → Bu alanla ilgili mi?
3. REFERANSLAR (thoughts/references/) → Daha once karar alinmis mi?
4. ARSIV (thoughts/archive/) → Gecmiste benzer is yapilmis mi?
5. GIT HISTORY (git log/blame) → Kodda ne degismis?
6. MEMORY SYSTEM (recall) → Baska session'larda ne ogrenmisiz?
Her hafta 15 dakika:
[ ] Aktif isler guncelle (tamamlananlar archive'a)
[ ] Alan durumlari guncelle (degisen varsa)
[ ] Referanslar guncelle (yeni karar varsa ADR yaz)
[ ] Gereksiz bilgileri sil veya arsivle
YAPMA: Her seyi kaydet
YAP: Sadece tekrar kullanilacak bilgiyi kaydet
YAPMA: Tek buyuk dosyada tut
YAP: Konu basina ayri dosya
YAPMA: Arsivi hicbir zaman temizleme
YAP: Ceyreklik arsiv, yillik temizlik
YAPMA: Bilgiyi sadece kafanda tut
YAP: Yazdığın an unutabilirsin, hemen kaydet
YAPMA: Her dosyayi ayni seviyede tut
YAP: Progressive summarization ile katmanla