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

title	description	tags
Claude Code — Visual Diagrams	40 Mermaid interactive diagrams covering all major Claude Code concepts	reference architecture diagrams mermaid

Claude Code — Visual Diagrams

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

---

Navigate by Use Case

"I'm new to Claude Code — where do I start?"

1. Quick Decision Tree — Should I use Claude Code?
2. 9-Step Workflow Pipeline — How does it work?
3. Permission Modes — What are the safety modes?
4. Onboarding Paths — Which path fits me?

"I want to understand the architecture"

1. The Master Loop — Core execution engine
2. System Prompt Assembly — How context is built
3. 4-Layer Context System — The transformation model
4. Tool Categories — What tools are available

"I'm worried about security"

1. MCP Rug Pull Attack — The main threat vector
2. 3-Layer Defense — How to protect yourself
3. Sandbox Decision Tree — When to sandbox
4. Verification Paradox — Don't trust Claude to verify itself

"I want to reduce my token costs"

1. Model Selection Decision Flow — Pick the right model
2. Cost Optimization Tree — Systematic cost reduction
3. Token Reduction Pipeline — RTK + session hygiene
4. Context Management Zones — Manage context size

"I want to use multiple agents"

1. Agent Teams Topology — 3 orchestration patterns
2. Multi-Instance Decision Matrix — Which pattern to use?
3. Git Worktree Multi-Instance — Parallel isolation
4. Sub-Agent Context Isolation — How agents are isolated

"I want to set up MCP servers"

1. MCP Ecosystem Map — What servers exist
2. MCP Architecture — How it works
3. MCP Config Hierarchy — Where configs live

---

Back to guide/README.md | ASCII diagrams → visual-reference.md