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