marketing-shibata50/claude-code-ultimate-guide
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
claude-code-ultimate-guide/guide/diagrams/README.md
Florian BRUNIAUX a4a6c49cb5 docs(diagrams): audit, fix and expand Mermaid diagram suite (7 files → 9) 
Phase 1-2 — fixes on existing diagrams:
- 01-foundations: add Plan Mode + dontAsk subgraphs (3→5 permission modes)
- 04-architecture-internals: add Control Flow Tools category (5→6 tool categories)
- 05-mcp-ecosystem: clarify local+user scopes both live in ~/.claude.json
- 07-multi-agent-patterns: fix disconnected B2 node (now proper third branch)
- 09-cost-and-optimization: replace hardcoded prices with relative ratios + disclaimer

Phase 3 — new diagram files:
- 11-context-engineering.md: 4 diagrams (3-layer system, budget/adherence, monolithic vs modular, rule placement decision tree)
- 12-enterprise-governance.md: 3 diagrams (governance risk tiers, MCP approval workflow, data classification)

README.md updated: 41→48 diagrams, navigation table extended, 2 new use-case sections

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-13 10:08:49 +01:00

6.9 KiB
Raw Permalink Blame History

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

Claude Code — Visual Diagrams

48 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 5 TDD cycle, spec-first pipeline, plan-driven, iterative refinement, AI fluency paths
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
11-context-engineering.md 4 3-layer context system, adherence degradation, modular architecture, rule placement
12-enterprise-governance.md 3 Governance risk tiers, MCP approval workflow, data classification
Total 48

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

"I want to govern Claude Code across my team"

  1. Governance Risk Tiers — Which control level fits your context?
  2. MCP Governance Workflow — Approval pipeline for MCP servers
  3. Data Classification Rules — What Claude can and cannot access

"I want to improve Claude's context adherence"

  1. Rule Placement Decision Tree — Where does this rule go?
  2. 3-Layer Context System — Global / Project / Session
  3. Context Budget & Adherence — Why rules stop being followed
  4. Modular Architecture — Path-scoping as the fix

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