convez.ai
MCP ServerDesenvolvimento WebAvançado
gabbiesbv

Claude Code Sourcemap Learning Notebook

gabbiesbv/claude-code-sourcemap-learning-notebook

Estude a arquitetura interna do Claude Code através de análise estruturada

Ver no GitHub
InicialPluginScore · de 0 a 100

Análise arquitetural de engenharia reversa do Claude Code (512K+ linhas TypeScript) que extrai 11 padrões transferíveis de agentes IA em produção. Cobre query loop, sistema de ferramentas, segurança multi-camadas, orquestração multi-agent, MCP, prompt engineering e voice mode com explicações de decisões de design.

Instalação

$npx convez-ai gabbiesbv/claude-code-sourcemap-learning-notebook

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
1
Acompanhando
0
Saúde
42%
Último commit
há 1 mês
Versão
—
Issues abertas
0
Contribuidores
4

Casos de uso

  • Aprender arquitetura de agentes IA complexos em produção
  • Entender padrões de segurança e permissões em 5 camadas
  • Dominar orquestração multi-agent e cache-friendly forking
  • Pesquisar prompt engineering em escala (40+ templates)
  • Extrair padrões reutilizáveis para seus próprios sistemas

Veredito

Recurso acadêmico de altíssimo valor para engenheiros que querem entender como sistemas IA complexos funcionam internamente. Cobertura profunda com ~5.5h de conteúdo estruturado, mas exige sólido conhecimento prévio de TypeScript, arquitetura de software e agentes IA.

README

A tradução para o português deste README ainda está na fila.

Claude Code Sourcemap Learning Notebook

GitHub License: MIT

🌐 中文版 / Chinese Version

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, /simplify 3-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

#TopicCore Source FilesTime
00Index & Architecture Overview—10min
01Global Architecturemain.tsx, App.tsx, QueryEngine.ts30min
02Tool SystemTool.ts, tools.ts, GlobTool.ts45min
03Permission & Securitypermissions.ts, filesystem.ts45min
04Query Loop & API ⭐query.ts, StreamingToolExecutor.ts50min
05Multi-Agent + Coordinator ⭐AgentTool.tsx, runAgent.ts50min
06MCP, Skills & Extensionsmcp/client.ts, skills/45min
07Prompt Engineeringprompts.ts, BashTool/prompt.ts60min
08Voice Mode & BuddyvoiceStreamSTT.ts, buddy/30min

Total ~5.5 hours for a systematic understanding of Claude Code internals.

Course content available in Chinese (zh-CN/) and English (en/).

Learning Paths

PathChaptersTime
Quick Start00 → 01 → 02 → 042h
Security Focus00 → 03 → 021.5h
Agent Research00 → 05 → 04 → 062.5h
Prompt Research00 → 071h
Full Course00 → 01 → ... → 085.5h

Key Discoveries

ChapterMost Valuable Finding
01React/Ink terminal UI — CLI can use React
02buildTool() factory + Zod schema doubles as prompt
035-layer defense; bypass mode still has safety floor (.git/.claude protected)
04StreamingToolExecutor concurrent execution, 5-layer compression pipeline
05Coordinator star topology, fork prompt cache sharing, 10-step finally cleanup
06Skills 3-layer architecture, /simplify 3-agent parallel review
0740+ prompt files with static/dynamic separation, Meta-Prompt generates Agents
08Record-first-connect-later eliminates latency, Buddy Bones not persisted

11 Transferable Design Patterns

Extracted from Ch.04 & Ch.05 — applicable to any Agent system:

From Query Loop: Optimistic Recovery · Layered Degradation · State Machine + Transition Log · Read-Write Lock Concurrency · Immutable Config Snapshot · Hierarchical Cancellation

From Multi-Agent: Capability-based Security · Cache-Friendly Forking · Deterministic Cleanup · Star Topology Orchestration · Monotonic Permission Narrowing

Each pattern includes Claude Code implementation details and universal applications (DB, K8s, microservices, etc.) in the chapter notes.

Sister Project: nano-claude-code

1,646 lines of TypeScript · 15 files · 4 dependencies

nano-claude-code rewrites Claude Code's core as a minimal, hackable implementation you can actually run and modify.

Claude Codenano-claude-code
Files~1,90015
Lines512,000+1,646
Dependencies50+4
Tools40+6

Read the notebook to understand the architecture. Run nano-claude-code to build your own.

👉 github.com/dadiaomengmeimei/nano-claude-code

Links

License

MIT. The analyzed Claude Code source code is copyrighted by Anthropic. This project is for educational and research purposes only.


If this helps you, give it a ⭐! Follow @dadiaomengmeimei for more AI source code analysis.

Ver o original no GitHub

Bom para

Relacionados