Lifecycle Hook Mapping Matrix (Claude Pattern)

This matrix defines how the Claude Code specification maps conceptually and technically through the Emacs ecosystem down into the macher-agent implementation.

Claude Code Event	gptel Integration	Macher VFS Concept	Macher-Agent Tool Hook
SessionStart	gptel-mode-hook	macher-init-session-hook	N/A (Handled at workspace init)
UserPromptSubmit	gptel-pre-response-functions	macher-before-send-hook	N/A (Handled at request dispatch)
PreToolUse	Intercept via tool wrapper	macher-pre-execute-tool-hook	macher-agent-pre-tool-use-hook
PermissionRequest	Interactive custom wrappers	macher-diff-review-hook	macher-agent-permission-request-hook
PostToolUse	Callback return structure	macher-post-execute-tool-hook	macher-agent-post-tool-use-hook
PostToolUseFailure	Callback error handling	macher-error-recovery-hook	macher-agent-post-tool-use-failure-hook
**Stop / SubagentStop**	gptel-post-response-functions	macher-post-response-hook	N/A (Handled at completion)