claude-code-ultimate-guide/guide/README.md
Florian BRUNIAUX dbb62306d7 release: v3.28.1 - Visual Diagrams Series (40 Mermaid diagrams)
guide/diagrams/: new directory with 40 interactive Mermaid diagrams
- 10 thematic files: foundations, context/sessions, configuration,
  architecture, MCP ecosystem, dev workflows, multi-agent patterns,
  security/production, cost/optimization, adoption/learning
- Each diagram: Mermaid (GitHub-native) + ASCII fallback + source link
- Bold Guy palette (6-color system) consistent across all diagrams
- README with index, visual palette legend, navigation by use case

Also includes (backlog from v3.28.0→v3.28.1):
- guide/ultimate-guide.md: Managing Large MCP Server Sets, AI Code
  Disclosure Policy, claude-mem Gemini alternative, observability
- guide/workflows/plan-driven.md: Boris Tane custom markdown plans (+172L)
- guide/security-hardening.md: Part 4 PR security review workflow
- examples/agents/security-patcher.md: new security agent
- examples/hooks/bash/security-gate.sh: PreToolUse security hook
- guide/observability.md: activity monitoring, external tools, proxying
- docs/resource-evaluations/: 4 new evaluations (Boris Cherny, Moigneu,
  Boris Tane, Aristote AI instructions)
- README.md: Visual Diagrams section in "What Makes This Guide Unique"

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-22 15:51:21 +01:00

4.8 KiB

title description tags
Guide Documentation Index of all core documentation files for mastering Claude Code
guide
reference

Guide Documentation

Core documentation for mastering Claude Code.

Contents

File Description Time
ultimate-guide.md Complete reference covering all Claude Code features ~3 hours
mcp-servers-ecosystem.md Community MCP servers: 8 validated servers (Playwright, Semgrep, Kubernetes, etc.) with production configs 25 min
third-party-tools.md Community tools: GUIs, TUIs, config managers, token trackers, alternative UIs 15 min
claude-code-releases.md Official release history (condensed) 10 min
known-issues.md Critical bugs tracker: security issues, token consumption, verified community reports 15 min
cheatsheet.md 1-page printable quick reference 5 min
visual-reference.md Visual cheatsheet — ASCII diagrams for key concepts 5 min
diagrams/ Visual Diagrams Series: 40 Mermaid interactive diagrams for model selection, agent lifecycle, security, multi-agent patterns 15 min
architecture.md How Claude Code works internally (master loop, tools, context) 25 min
learning-with-ai.md Guide for juniors on using AI without losing skills 15 min
adoption-approaches.md Implementation strategies for teams 15 min
agent-evaluation.md Agent quality metrics: Measuring custom agent effectiveness with hooks, tests, and feedback loops 20 min
data-privacy.md Data retention and privacy guide 10 min
observability.md Session monitoring and cost tracking 15 min
methodologies.md 15 development methodologies reference (TDD, SDD, BDD, etc.) 20 min
security-hardening.md Security threats, MCP vetting, injection defense 25 min
ai-traceability.md AI attribution, disclosure policies, git-ai, compliance 20 min
devops-sre.md FIRE framework for infrastructure diagnosis and incident response 30 min
sandbox-isolation.md Docker Sandboxes, cloud alternatives, safe autonomy workflows 10 min
ai-ecosystem.md Complementary AI tools (Perplexity, Gemini, Kimi, NotebookLM, TTS) 30 min
cowork.md Claude Cowork: Summary (see dedicated repo for full docs) 5 min
workflows/ Practical workflow guides for Claude Code 30 min

Cowork Documentation

For knowledge workers using Claude Cowork (agentic desktop):

Resource Description
Cowork Hub Complete Cowork documentation
Getting Started Setup and first workflow
Capabilities What Cowork can/cannot do
Security Guide Safe usage practices
Prompt Library 50+ ready-to-use prompts
Cheatsheet 1-page quick reference

Workflows

Hands-on guides for effective development patterns:

File Description
workflows/tdd-with-claude.md Test-Driven Development with Claude
workflows/spec-first.md Spec-First Development (SDD)
workflows/plan-driven.md Using /plan mode effectively
workflows/iterative-refinement.md Iterative improvement loops
workflows/tts-setup.md Add text-to-speech narration to Claude Code (18 min)
workflows/task-management.md Multi-session task tracking, TodoWrite migration
  1. New users: Start with Quick Start section in ultimate-guide.md
  2. Daily reference: Print cheatsheet.md
  3. Team leads: Read adoption-approaches.md for rollout strategies

Back to main README