token-budget

Token Budget Management

Her agent cagri token harcar. Butce yonetimi olmadan maliyetler kontrolsuz buyur.

Maliyet Tablosu (2026 Q2)

| Model | Input (1M token) | Output (1M token) | Cache Read (1M) | |-------|----------------:|------------------:|----------------:| | Opus 4.6 | $15.00 | $75.00 | $1.50 | | Sonnet 4.6 | $3.00 | $15.00 | $0.30 | | Haiku 4.5 | $0.80 | $4.00 | $0.08 |

Agent Basina Ortalama Maliyet

| Agent Tipi | Ortalama Token/Cagri | Ortalama Maliyet | Notlar | |------------|--------------------:|------------------:|--------| | scout (arastirma) | 15K-50K | $0.15-0.75 | Cok dosya okur | | code-reviewer | 10K-30K | $0.10-0.45 | Diff boyutuna bagli | | architect | 20K-60K | $0.30-0.90 | Derin dusunme gerektirir | | spark (quick fix) | 3K-10K | $0.03-0.15 | En verimli | | kraken (TDD) | 30K-100K | $0.45-1.50 | Test + implement | | sleuth (debug) | 20K-80K | $0.30-1.20 | Bug karmasikligina bagli | | verifier | 5K-15K | $0.05-0.22 | Build + test calistirma | | security-reviewer | 10K-40K | $0.15-0.60 | Tarama derinligine bagli | | planner | 15K-40K | $0.22-0.60 | Plan buyuklugune bagli |

Butce Planlama

Session Butcesi

KUCUK IS (bug fix, kucuk feature):
  Beklenen: 50K-150K token
  Butce: $0.50-2.00
  Agent sayisi: 2-4

ORTA IS (feature, refactoring):
  Beklenen: 200K-500K token
  Butce: $3.00-7.00
  Agent sayisi: 4-8

BUYUK IS (yeni modul, buyuk refactor):
  Beklenen: 500K-2M token
  Butce: $7.00-30.00
  Agent sayisi: 8-15

SWARM (tam ekip):
  Beklenen: 1M-5M token
  Butce: $15.00-75.00
  Agent sayisi: 15-30

Aylik Butce Tahmini

Gunluk 3-5 session x 30 gun:

Hafif kullanim (vibe coding):
  ~100K token/gun = $1.50/gun = ~$45/ay

Normal kullanim (aktif gelistirme):
  ~500K token/gun = $7.50/gun = ~$225/ay

Yogun kullanim (tam ekip, swarm):
  ~2M token/gun = $30/gun = ~$900/ay

Claude Max abone ise:
  Sabit $200/ay -- token limiti var ama birim maliyet yok
  ROI: Normal kullanim ustu her sey Max ile karli

Maliyet Optimizasyon Stratejileri

1. Model Routing (En Buyuk Tasarruf)

Opus kullan:
  - Mimari kararlar (architect)
  - Karmasik debug (sleuth)
  - Guvenlik analizi (security-reviewer)
  - Kritik code review

Sonnet kullan:
  - Genel gelistirme (kraken, spark)
  - Rutin review (code-reviewer)
  - Dokumantasyon (technical-writer)
  - Test yazma (tdd-guide)

Sonuc: %40-60 maliyet dususu, %5-10 kalite kaybı

2. Context Yonetimi

YAPMA: 5 dosyayi tamamen okuyup agent'a gonder
YAP:   Sadece ilgili fonksiyonlari gonder

YAPMA: Her seferinde tum CLAUDE.md'yi inject et
YAP:   Sadece ilgili kurallari sec

YAPMA: Agent'a "her seyi kontrol et" de
YAP:   Spesifik kontrol listesi ver

Token tasarrufu: %30-50

3. Agent Secimi

PAHALI YOLDAN GITME:
  architect (60K) + kraken (100K) + verifier (15K) = 175K token

VERIMLI YOL:
  spark (10K) + verifier (10K) = 20K token
  (Kucuk is icin spark yeterli, architect/kraken gereksiz)

Kural: Is buyuklugune uygun agent sec

4. Cache Kullanimi

Ayni dosyayi tekrar tekrar okuma:
  Ilk okuma: 10K token (tam fiyat)
  Cache hit: 10K token (%90 indirimli)

Strateji: Session basinda ilgili dosyalari bir kere oku,
sonraki agent'lar cache'ten okusun

5. Paralel vs Sequential

PARALEL (daha pahali ama hizli):
  3 agent ayni anda = 3x token ama 3x hizli
  Kullan: Deadline varsa, bagimsiz isler

SEQUENTIAL (daha ucuz):
  Agent 1 bitir → ciktisini Agent 2'ye ver
  Kullan: Butce kisitliysa, bagimli isler

ROI Analizi

Agent Basina ROI

ROI = (Tasarruf edilen sure x saat ucreti) / Agent maliyeti

Ornek: code-reviewer
  Maliyet: ~$0.30/review
  Tasarruf: ~15 dk/review (manual review vs)
  Saat ucreti: $50/saat
  ROI: ($12.50) / ($0.30) = 41x

Ornek: sleuth (bug investigation)
  Maliyet: ~$0.75/investigation
  Tasarruf: ~45 dk/bug (manual debug vs)
  ROI: ($37.50) / ($0.75) = 50x

Ornek: architect (buyuk plan)
  Maliyet: ~$0.90/plan
  Tasarruf: ~2 saat (manual planning vs)
  ROI: ($100) / ($0.90) = 111x

En Yuksek ROI Agent'lar

| Siralama | Agent | ROI | Neden | |----------|-------|-----|-------| | 1 | architect | 111x | Buyuk zaman tasarrufu, dusuk maliyet | | 2 | sleuth | 50x | Bug investigation cok zaman alir | | 3 | code-reviewer | 41x | Her commit icin gerekli | | 4 | verifier | 35x | Otomatik quality gate | | 5 | spark | 30x | Kucuk isler icin cok verimli |

En Dusuk ROI Agent'lar

| Agent | ROI | Neden | Oneri | |-------|-----|-------|-------| | scout (gereksiz arama) | 5x | Bazen cok dosya okur, az bilgi bulur | Spesifik soru sor | | kraken (kucuk is) | 8x | TDD overhead kucuk isler icin fazla | Kucuk is = spark | | designer (sadece oneri) | 3x | Oneri verir ama implement etmez | Frontend-dev yeterli |

Harcama Raporu Sablonu

# Token Harcama Raporu - [Tarih]

## Ozet
- Toplam token: XXX,XXX
- Tahmini maliyet: $XX.XX
- Agent sayisi: X
- Session suresi: X saat

## Agent Bazli Dagilim

| Agent | Token | Maliyet | Is | ROI |
|-------|------:|--------:|---|----|
| architect | 45K | $0.67 | Auth redesign plani | 111x |
| kraken | 85K | $1.27 | Implementation | 25x |
| code-reviewer | 20K | $0.30 | Review | 41x |
| verifier | 12K | $0.18 | Final check | 35x |
| **TOPLAM** | **162K** | **$2.42** | | |

## Optimizasyon Onerisi
- kraken yerine spark kullanilabilirdi (-70K token)
- architect ciktisi daha spesifik olabilirdi (-15K token)
- Potansiyel tasarruf: %52

vibecosystem Entegrasyonu

• cost-tracker agent: Bu skill'i kullanarak session maliyet raporu uretir
• smart-model-routing skill: Model secimini maliyet/kalite dengesine gore yapar
• swarm-optimizer agent: Swarm calistirmalarinda butce optimizasyonu yapar
• session-replay-analyzer agent: Gecmis session'larin token verimliligini analiz eder