27 hook tek tek

27 hook’un detaylı listesi /hooks sayfasında. Burada gerçek use case’ler üzerinden gidelim.

Session lifecycle (3 hook)

• SessionStart — repo doğrulama, env hazırlığı, ses
• SessionEnd — log rotasyonu, geçici dosya temizliği
• InstructionsLoaded — yüklenen rules’ları doğrulama

Turn (5 hook)

• UserPromptSubmit — denylist, prompt önizleme, retorik enjekte
• PreToolUse — yan etkili komutu engelleme, audit
• PostToolUse — auto-format, lint, telemetry
• PostToolUseFailure — failure raporlama, retry kararı
• Stop / StopFailure — tamamlanma sesi, fallback model

Sub-agent (2 hook)

• SubagentStart — sub-agent kullanım metrikleri
• SubagentStop — süre ölçümü, sonuç doğrulama

Context (2 hook)

• PreCompact — önemli notları memory’ye taşı
• PostCompact — yeni context boyutunu logla

Idle / tasks / mcp / errors (toplam 6 hook)

• Notification (60s idle) — sesli bildirim
• TaskCreated / TaskCompleted — Slack/board sync
• Elicitation / ElicitationResult — MCP onay otomasyonu
• ApiError — bildirim, key rotasyonu

Workspace (5 hook)

• WorktreeCreated / WorktreeRemoved — branch env setup/cleanup
• Setup / SetupFailure — ek setup, smoke test
• CurrentWorkingDirectoryChange — path-aware tooling
• FileChanged — reload, secret rotasyonu

Settings + Agent teams (2 hook)

• ConfigChange — settings.json doğrulama
• TeammateIdle — agent team’de görev redagne

Best practice

• Bir hook deterministik olsun (yan etkisi öngörülebilir)
• Hook çıktısı kısa olsun (büyük JSON Claude’u boğar)
• block: true dönerse iş duracaktır — dikkatli kullan

Sıradaki

MCP server entegrasyonu — Chrome DevTools, Slack, Postgres gibi sistemleri standart protokolle bağla.