claude-code-ultimate-guide/guide/diagrams
Florian BRUNIAUX 2874eee382 docs(diagrams): add budget modifier to model selection decision flow
Le diagramme assumait implicitement un budget illimité (Max/API).
Ajout d'un budget modifier table et community pattern basé sur le
feedback de Frédéric Camblor (Teams Standard $25/mo: Sonnet plan → Haiku impl).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-23 11:33:23 +01:00
..
01-foundations.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
02-context-and-sessions.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
03-configuration-system.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
04-architecture-internals.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
05-mcp-ecosystem.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
06-development-workflows.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
07-multi-agent-patterns.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
08-security-and-production.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
09-cost-and-optimization.md docs(diagrams): add budget modifier to model selection decision flow 2026-02-23 11:33:23 +01:00
10-adoption-and-learning.md feat(diagrams): add per-node click hrefs to all 40 flowchart diagrams 2026-02-22 22:21:30 +01:00
README.md release: v3.28.1 - Visual Diagrams Series (40 Mermaid diagrams) 2026-02-22 15:51:21 +01:00

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