claude-code-ultimate-guide/guide
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
..
diagrams docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
images docs: update template count badge (82 → 83) 2026-01-25 13:30:40 +01:00
workflows release: v3.28.1 - Visual Diagrams Series (40 Mermaid diagrams) 2026-02-22 15:51:21 +01:00
adoption-approaches.md docs(guide): add YAML frontmatter to 24 top-level guide files 2026-02-15 19:20:31 +01:00
agent-evaluation.md docs(guide): add YAML frontmatter to 24 top-level guide files 2026-02-15 19:20:31 +01:00
ai-ecosystem.md docs: add Kairn memory MCP + resource evaluations + guide updates 2026-02-25 17:39:20 +01:00
ai-traceability.md docs(guide): add YAML frontmatter to 24 top-level guide files 2026-02-15 19:20:31 +01:00
architecture.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
cheatsheet.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
claude-code-releases.md docs: update Claude Code releases to v2.1.56 2026-02-25 11:49:34 +01:00
cowork.md docs(guide): add YAML frontmatter to 24 top-level guide files 2026-02-15 19:20:31 +01:00
data-privacy.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
devops-sre.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
known-issues.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
learning-with-ai.md docs: add Borg et al. 2025 RCT on AI code maintainability (v3.27.7) 2026-02-19 09:59:50 +01:00
mcp-servers-ecosystem.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
methodologies.md release: v3.28.1 - Visual Diagrams Series (40 Mermaid diagrams) 2026-02-22 15:51:21 +01:00
observability.md release: v3.29.0 2026-02-24 13:58:09 +01:00
production-safety.md docs(guide): add YAML frontmatter to 24 top-level guide files 2026-02-15 19:20:31 +01:00
README.md release: v3.28.1 - Visual Diagrams Series (40 Mermaid diagrams) 2026-02-22 15:51:21 +01:00
sandbox-isolation.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
sandbox-native.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
search-tools-cheatsheet.md docs(guide): add YAML frontmatter to 24 top-level guide files 2026-02-15 19:20:31 +01:00
security-hardening.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
third-party-tools.md docs: integrate veille hebdo Anthropic 17-23 fev 2026 (+177 lignes guide) 2026-02-23 12:59:28 +01:00
ultimate-guide.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00
visual-reference.md docs: factual audit + reference sync — 260 findings corrected 2026-02-26 12:10:14 +01:00

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