DOC: Claude Code Architecture Deep Dive - Partner SDE Research

Overview

Comprehensive architectural analysis of the Claude Code repository conducted for deep technical understanding.

Research Scope

This issue tracks learnings from exploring:

• Overall architecture and entry points
• Tool system and MCP integration
• Agent/task/subagent system
• Hooks system and event lifecycle
• Permissions and security model
• Conversation and context management

Learnings will be documented in comments below

Each major system will have its own detailed comment for reference.

---

@claude and @codex please review this pr