Smart Compaction

Smart Compaction Skill

Bu skill, Anthropic'in "Effective Context Engineering" makalesindeki compaction best practice'lerini uygular.

Ne Zaman Kullanılır?

1. Otomatik: PreCompact hook tetiklendiğinde
2. Manuel: /compact veya "context'i özetle" dendiğinde
3. Session sonu: Uzun görevlerin sonunda

Compaction Süreci

Adım 1: Durum Tespiti

# Git durumu
git status --porcelain
git log --oneline -5
git branch --show-current

# Feature progress
cat feature-list.json 2>/dev/null | jq '.completed_features, .total_features'

Adım 2: Kritik Bilgileri Topla

Aşağıdakileri MUTLAKA kaydet:

• Aktif çalışılan feature/modül
• Yarım kalan işler
• Alınan kararlar (ADR'ler)
• Karşılaşılan hatalar ve çözümleri
• Sonraki adımlar
• Önemli dosya yolları

Adım 3: CLAUDE.md Güncelle

## Son Durum

### Güncelleme: [TARİH - SAAT]

**Aktif Feature:** F00X - [Feature adı]
**Branch:** feature/xxx
**Durum:** %XX tamamlandı

**Bu Session'da Yapılanlar:**
- [x] Task 1
- [x] Task 2
- [ ] Task 3 (yarım kaldı)

**Kritik Kararlar:**
- Karar 1: [neden]

**Karşılaşılan Sorunlar:**
- Sorun 1: [çözüm]

**Sonraki Adımlar:**
1. [ ] Öncelikli iş 1
2. [ ] Öncelikli iş 2

**Son Çalışılan Dosyalar:**
- path/to/file1.ts (değiştirildi)
- path/to/file2.ts (oluşturuldu)

Adım 4: feature-list.json Güncelle

{
  "id": "F00X",
  "passes": false,
  "notes": "Login tamamlandı, register yarım kaldı. Session 3'te devam edilecek.",
  "actual_sessions": 3
}

Adım 5: Git Commit (Opsiyonel)

git add -A
git commit -m "wip: [Feature] - Session checkpoint

- Tamamlanan: [liste]
- Devam edecek: [liste]

Context compact öncesi checkpoint."

Neyi SAKLA, Neyi AT

✅ SAKLA (Kritik)

• Mimari kararlar
• API contract değişiklikleri
• Database schema değişiklikleri
• Güvenlik ile ilgili notlar
• Test sonuçları (fail olanlar özellikle)
• Dependency değişiklikleri
• Environment config değişiklikleri

❌ AT (Güvenle Silinebilir)

• Tam tool output'ları (özeti yeterli)
• Lint çıktıları (fix edildiyse)
• Build log'ları (başarılıysa)
• Ara adım dosya okumalar
• Tekrarlanan hata mesajları

Compaction Prompt Template

Aşağıdaki prompt'u kullanarak özet oluştur:

Bu session'daki tüm önemli bilgileri özetle:

1. HEDEF: Ne yapmaya çalışıyorduk?
2. İLERLEME: Ne kadar tamamlandı?
3. KARARLAR: Hangi önemli kararlar alındı ve neden?
4. SORUNLAR: Hangi sorunlarla karşılaşıldı ve nasıl çözüldü?
5. YARIM KALAN: Ne yarım kaldı ve nerede?
6. SONRAKİ: İlk yapılması gereken şey ne?
7. DOSYALAR: Hangi dosyalar kritik?

Özet CLAUDE.md'ye kaydedilecek, sonraki session bu bilgiyle başlayacak.

Anti-Patterns

❌ Yapma:

• Tüm kod değişikliklerini kopyalama
• Her tool call sonucunu saklama
• Belirsiz notlar bırakma ("devam edilecek" yerine "register endpoint'i yazılacak")
• Commit yapmadan compact (değişiklikler kaybolabilir)

✅ Yap:

• Spesifik, actionable notlar bırak
• Dosya yollarını tam yaz
• Sonraki adımları numaralandır
• Önce commit, sonra compact