gabbiesbv/claude-code-sourcemap-learning-notebook
gabbiesbv1updated 25d ago
Reverse-engineer Claude Code sourcemaps to study its architecture, design choices, and reusable AI agent patterns
ClaudeCodexCursorMCP
claude-agent-sdkclaude-agentsclaude-skillscode-agentembeddingsllmlong-term-memorymcpmemory-engineopenmemorypandasproductivity
README
Claude Code Sourcemap Learning Notebook
Reverse-engineering Claude Code's 512K+ lines of TypeScript β extracting the architecture, design decisions, and 11 transferable patterns that make a production AI Agent work.
Not just a code walkthrough. An architectural analysis that explains why each design choice was made, with alternatives compared.
What You'll Learn
- π Query Loop β Streaming tool execution, read-write lock concurrency, 3-layer AbortController cascade
- π οΈ Tool System β
buildTool()factory + Zod schema as prompt, 40+ tools with 18+ feature flags - π 5-Layer Security β Permission rules β mode β tool checks β path safety β macOS Seatbelt sandbox
- π€ Multi-Agent β Coordinator orchestration, default isolation with explicit sharing, cache-friendly forking
- π MCP & Skills β 3-layer skill architecture, bundled skill lazy extraction,
/simplify3-agent parallel review - π§ Prompt Engineering β 7 categories with 40+ prompt files, static/dynamic separation for cache optimization
- ποΈ Voice & Buddy β Record-first-connect-later latency elimination, deterministic generation
Chapters
| # | Topic | Core Source Files | Time |
|---|-------|-------------------|------|
| 00 | Index & Architecture Overview | β | 10min |
| 01 | Global Architecture | main.tsx, App.tsx, QueryEngine.ts | 30min |
| 02 | Tool System | Tool.ts, tools.ts, GlobTool.ts | 45min |
| 03 | Permission & Security | permissions.ts, filesystem.ts | 45min |
| [04](zh