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 8e63d84b47 docs: factual audit + reference sync — 260 findings corrected 
Parallel 6-agent audit against official Anthropic docs (llms-full.txt).
Key corrections applied across permissions, hooks, MCP, security, privacy, reference.yaml.

Highlights:
- Fix MCP config path (~/.claude.json), mcpServers key, variable substitution syntax
- Fix permission modes (5 not 3), :* syntax (×6), Stop event description
- Fix hook JSON field names (hook_event_name, tool_name, tool_input, session_id)
- Fix filesystem restriction docs (permission rules, not settings.json keys)
- Fix data-privacy: 4-tier retention, /bug 5yr warning, ZDR conditions, 5 telemetry opt-out vars
- Add official llms.txt/llms-full.txt references to CLAUDE.md + machine-readable/llms.txt
- Reference.yaml: 375 entries re-synced (92% had wrong line numbers — guide grew 15K→21K lines)
- New script: scripts/resync-reference-yaml.py for automated line number sync
- Quiz: corrected answers for hooks (07), memory settings (03), MCP servers (08)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-26 12:10:14 +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 docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +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 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.29.0 2026-02-24 13:58:09 +01:00

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

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