smart-compaction - SKILL.md Agent Skill

name: smart-compaction description: Context window dolmadan önce akıllı summarization yapar. PreCompact hook'u tarafından otomatik tetiklenir veya manuel çağrılır. disable-model-invocation: false allowed-tools: Read, Write, Bash, Glob

Smart Compaction Skill

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

Ne Zaman Kullanılır?

Otomatik: PreCompact hook tetiklendiğinde
Manuel: /compact veya "context'i özetle" dendiğinde
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