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
History
Florian BRUNIAUX b65630641b refactor(guide): restructure guide/ into thematic subdirectories 
Reorganize 22 guide files from a flat directory into 5 thematic subdirs:
- core/ (architecture, methodologies, known-issues, claude-code-releases, visual-reference)
- security/ (security-hardening, sandbox-isolation, sandbox-native, production-safety, data-privacy)
- ecosystem/ (ai-ecosystem, mcp-servers-ecosystem, third-party-tools, remarkable-ai)
- roles/ (ai-roles, adoption-approaches, learning-with-ai, agent-evaluation)
- ops/ (devops-sre, observability, ai-traceability)

All internal links updated across ~50 files (ultimate-guide.md, workflows/,
diagrams/, README.md, docs/, tools/, examples/, machine-readable/).

Also: merge search-tools-cheatsheet.md into cheatsheet.md, rewrite guide/README.md
with H2 grouped sections, update CLAUDE.md repository structure.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-10 08:35:13 +01:00
..
01-foundations.md refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +01:00
02-context-and-sessions.md refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +01:00
03-configuration-system.md refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +01:00
04-architecture-internals.md refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +01:00
05-mcp-ecosystem.md refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +01:00
06-development-workflows.md release: v3.29.0 2026-02-24 13:58:09 +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 refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +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 refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +01:00
README.md refactor(guide): restructure guide/ into thematic subdirectories 2026-03-10 08:35:13 +01:00

README.md

title description tags
Claude Code — Visual Diagrams 41 Mermaid interactive diagrams covering all major Claude Code concepts
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 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
Total 41

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