claudecode-source (annotated bundle)

Packages a deep source-level analysis of a Claude Code snapshot (~1,900 files) with HTML reports, architecture visuals, and walkthrough guides, plus an independently written source-analysis report in Chinese and English. One of the most complete single bundles for studying the tool definitions, main agent loop, and edit-validation path.

View source on GitHub

Key takeaways

• 01

  Study the tool definition modules to see how schemas constrain model behavior

• 02

  The main loop folds tool results back into context in a strict sequence

• 03

  Edits are validated (read-before-write, diff checks) before hitting disk

Flows built on this research

Agent Architecture

Design a Single-Loop Agent

Build the core agent loop the leading coding agents use: one model, one loop, tools in, results folded back into context.

5 steps · 90-150 minutes

Agent Architecture

Add a Plan/Todo System to Your Agent

Give your agent the planning discipline of the leading harnesses: an explicit, model-visible todo list that survives long tasks.

4 steps · 60-90 minutes

MCP & Tooling

Design Tool Schemas for Agents

Write tool schemas that constrain model behavior: tight types, enums over strings, and parameters that make misuse hard.

4 steps · 60-90 minutes

MCP & Tooling

Tool Result Size Management

Stop tool outputs from flooding context: budgets per tool, smart truncation, pagination, and reference-based results.

4 steps · 60-90 minutes

Harness Engineering

Verification Loops: Never Trust an Unrun Edit

Wire verification into your agent so every edit is checked by machines - syntax, tests, behavior - before it counts as done.

4 steps · 60-100 minutes