Loading skill
Install any skill in seconds. Free to start, no credit card required.
Get Started Free →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.
.claude/skills/knowledge-management/SKILL.md| Test case | Without → With | Effect | Δ tokens | Δ turns |
|---|---|---|---|---|
| case-15 | ✗→✓ | ▲ Improved | — | — |
| case-01 | ✗→✓ | ▲ Improved | — | — |
| case-22 | ✗→✓ | ▲ Improved | — | — |
| case-03 | ✗→✓ | ▲ Improved | — | — |
| case-10 | ✗→✓ | ▲ Improved | — | — |
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 arsivleBilgiyi 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.
markdown# 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.
markdown# 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.
markdown# 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.
markdown# 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'larmarkdown# 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 arsivleYAPMA: 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| Case | Status | Duration (ms) | Turns | Tokens | Tool calls | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Without | With | Δ | Without | With | Δ | Without | With | Δ | Without | With | Δ | ||
case-15 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-01 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-23 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-22 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-13 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-25 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-11 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-03 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-10 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-14 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-26 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-05 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-12 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-21 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-04 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-08 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-20 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-02 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-19 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-16 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-09 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
case-06 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-07 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-17 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-18 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-24 | fail→pass | — | — | — | — | — | — | — | — | — | — | — | — |
case-27 | fail→fail | — | — | — | — | — | — | — | — | — | — | — | — |
DecimalAI ran this skill against gemini-3.6-flash twice over the same eval suite — once with the skill loaded and once without — and compared the two runs case by case. 27 cases were attempted. The headline lift of +63 percentage points is the difference between those two pass rates over the 27 comparable cases.
The per-case answers from this run were removed by the retention sweep, so the case table below shows the verdicts without the text either arm produced. The counts above were recorded at the time and are unaffected. Answers are now kept for 180 days.
Other measured skills in the registry, with their headline benchmark lift.