https://vrajat.com/tags/observability/Recent content in Observability on vrajatHugoenMon, 25 May 2026 22:15:00 +0530https://vrajat.com/posts/claude-code-hooks/Mon, 25 May 2026 22:15:00 +0530https://vrajat.com/posts/claude-code-hooks/<p>When you submit a prompt to Claude Code, it enters an agent loop with two distinct phases:</p> <ol> <li><strong>Reasoning</strong>: Claude evaluates the prompt, conversation history, available tools, and system instructions to determine whether to provide a final answer or execute a tool call.</li> <li><strong>Action</strong>: If a tool is called, the result is appended to the context, and the loop repeats.</li> </ol> <p>A file edit typically requires 3-4 iterations, while complex refactors can exceed 30. To observe this loop, we have two primary data sources: <strong>Lifecycle Hooks</strong>, which fire during execution to capture real-time events, and <strong>Session Transcripts</strong>, which store the complete state and token usage on disk.</p>