claude-code-ultimate-guide/guide/diagrams/README.md

---
title: "Claude Code — Visual Diagrams"
description: "40 Mermaid interactive diagrams covering all major Claude Code concepts"
tags: [reference, architecture, diagrams, mermaid]
---

# Claude Code — Visual Diagrams

41 interactive Mermaid diagrams organized in 10 thematic files. Each diagram includes a Mermaid version (rendered natively on GitHub) and an ASCII fallback.

> For ASCII-only diagrams and a printable visual reference → [visual-reference.md](../visual-reference.md)

---

## Visual Palette

All diagrams use the consistent Bold Guy palette:

| Color | Hex | Usage |
|-------|-----|-------|
| Warm Beige | `#F5E6D3` | User actions, input nodes |
| Orange Brûlé | `#E87E2F` | Key decisions, Claude actions |
| Soft Green | `#7BC47F` | Success paths, recommendations |
| Alert Red | `#E85D5D` | Danger, anti-patterns, risks |
| Neutral Gray | `#B8B8B8` | Infrastructure, passive elements |
| Light Blue | `#6DB3F2` | Information, documentation refs |

## Mermaid Conventions

| Shape | Syntax | Meaning |
|-------|--------|---------|
| Rounded rect | `(text)` | Process step, action |
| Diamond | `{text}` | Decision point |
| Stadium | `([text])` | Start / End terminal |
| Hexagon | `{{text}}` | External system or API |
| Subroutine | `[[text]]` | Internal Claude Code component |
| Cylinder | `[(text)]` | Data store, persistent state |

---

## Navigation

| File | Diagrams | Topics |
|------|----------|--------|
| [01-foundations.md](./01-foundations.md) | 4 | 4-layer model, workflow pipeline, decision tree, permission modes |
| [02-context-and-sessions.md](./02-context-and-sessions.md) | 4 | Context zones, memory hierarchy, session teleportation, fresh context |
| [03-configuration-system.md](./03-configuration-system.md) | 4 | Config precedence, skills vs commands vs agents, agent lifecycle, hooks |
| [04-architecture-internals.md](./04-architecture-internals.md) | 4 | Master loop, tool categories, system prompt assembly, sub-agent isolation |
| [05-mcp-ecosystem.md](./05-mcp-ecosystem.md) | 4 | MCP ecosystem map, MCP architecture, rug pull attack, config hierarchy |
| [06-development-workflows.md](./06-development-workflows.md) | 5 | TDD cycle, spec-first pipeline, plan-driven, iterative refinement, AI fluency paths |
| [07-multi-agent-patterns.md](./07-multi-agent-patterns.md) | 5 | Agent topologies, worktrees, dual-instance, horizontal scaling, decision matrix |
| [08-security-and-production.md](./08-security-and-production.md) | 4 | 3-layer defense, sandbox decision, verification paradox, CI/CD pipeline |
| [09-cost-and-optimization.md](./09-cost-and-optimization.md) | 4 | Model selection, cost optimization, subscription tiers, token reduction |
| [10-adoption-and-learning.md](./10-adoption-and-learning.md) | 3 | Onboarding paths, UVAL protocol, trust calibration |
| **Total** | **41** | |

---

## Navigate by Use Case

### "I'm new to Claude Code — where do I start?"
1. [Quick Decision Tree](./01-foundations.md#quick-decision-tree) — Should I use Claude Code?
2. [9-Step Workflow Pipeline](./01-foundations.md#9-step-workflow-pipeline) — How does it work?
3. [Permission Modes](./01-foundations.md#permission-modes-comparison) — What are the safety modes?
4. [Onboarding Paths](./10-adoption-and-learning.md#onboarding-adaptive-learning-paths) — Which path fits me?

### "I want to understand the architecture"
1. [The Master Loop](./04-architecture-internals.md#the-master-loop) — Core execution engine
2. [System Prompt Assembly](./04-architecture-internals.md#system-prompt-assembly) — How context is built
3. [4-Layer Context System](./01-foundations.md#chatbot-to-context-system-4-layer-model) — The transformation model
4. [Tool Categories](./04-architecture-internals.md#tool-categories) — What tools are available

### "I'm worried about security"
1. [MCP Rug Pull Attack](./05-mcp-ecosystem.md#mcp-rug-pull-attack-chain) — The main threat vector
2. [3-Layer Defense](./08-security-and-production.md#security-3-layer-defense) — How to protect yourself
3. [Sandbox Decision Tree](./08-security-and-production.md#sandbox-decision-tree) — When to sandbox
4. [Verification Paradox](./08-security-and-production.md#the-verification-paradox) — Don't trust Claude to verify itself

### "I want to reduce my token costs"
1. [Model Selection Decision Flow](./09-cost-and-optimization.md#model-selection-decision-flow) — Pick the right model
2. [Cost Optimization Tree](./09-cost-and-optimization.md#cost-optimization-decision-tree) — Systematic cost reduction
3. [Token Reduction Pipeline](./09-cost-and-optimization.md#token-reduction-strategies-pipeline) — RTK + session hygiene
4. [Context Management Zones](./02-context-and-sessions.md#context-management-zones) — Manage context size

### "I want to use multiple agents"
1. [Agent Teams Topology](./07-multi-agent-patterns.md#agent-teams-topology-3-patterns) — 3 orchestration patterns
2. [Multi-Instance Decision Matrix](./07-multi-agent-patterns.md#multi-instance-decision-matrix) — Which pattern to use?
3. [Git Worktree Multi-Instance](./07-multi-agent-patterns.md#git-worktree-multi-instance-pattern) — Parallel isolation
4. [Sub-Agent Context Isolation](./04-architecture-internals.md#sub-agent-context-isolation) — How agents are isolated

### "I want to set up MCP servers"
1. [MCP Ecosystem Map](./05-mcp-ecosystem.md#mcp-server-ecosystem-map) — What servers exist
2. [MCP Architecture](./05-mcp-ecosystem.md#mcp-architecture-client-server) — How it works
3. [MCP Config Hierarchy](./05-mcp-ecosystem.md#mcp-config-hierarchy) — Where configs live

---

*Back to [guide/README.md](../README.md) | ASCII diagrams → [visual-reference.md](../visual-reference.md)*