Skip to content

Technical Architecture & Design

Understanding how the tools work helps you use them better—and debug them when they don't.

This category explores the technical foundations of AI-assisted development tools. From how Claude Code processes your requests, to how the Model Context Protocol enables tool integration, to why sometimes bash is all you need.

Articles in This Category

ArticleAuthorKey Question
How Claude Code WorksOutsight TeamWhat happens behind the scenes when you talk to Claude Code?
MCP: What It Is and Why It MattersAddy OsmaniWhat is the Model Context Protocol and why should you care?
Build Agents with Filesystems and BashVercel TeamCan simple filesystem tools outperform complex agent architectures?
Testing If Bash Is All You NeedVercel & BraintrustHow do different tool abstractions compare in practice?
Self-Improving Coding AgentsAddy OsmaniCan coding agents learn and improve autonomously?
Multi-Agent Systems for AI-Native EngineeringResolve AIHow do multi-agent systems handle production-grade challenges?

Reading Recommendations

  • Curious about internals? Start with "How Claude Code Works"
  • Building integrations? Read "MCP: What It Is and Why It Matters"
  • Optimizing agent performance? Compare "Filesystems and Bash" with "Testing Bash vs SQL"
Alpha Preview:This is an early internal build. Some chapters are still incomplete and issues may exist. Feedback is very welcome on GitHub.