claude-code-ultimate-guide/guide
Florian BRUNIAUX 4a0a0bf30e docs: complete factual audit pass 2 — 90+ corrections
Second 10-agent parallel audit covering all remaining sections:
ultimate-guide.md (ch1-ch11), workflows/ (17 files), quiz/ (12 files),
examples/agents+skills+commands. Source of truth: official Anthropic docs.

Key corrections:

Hook system (+8 missing events):
- Complete 17-event list: PermissionRequest, PostToolUseFailure, SubagentStart,
  TeammateIdle, TaskCompleted, WorktreeCreate, WorktreeRemove, SessionEnd
- SessionStart confirmed valid (previous audit wrongly doubted it)
- Hook output format: hookSpecificOutput.permissionDecision (not {"decision":"block"})
- Missing common input fields added: transcript_path, cwd, permission_mode

Agent YAML frontmatter (13 valid fields restored/added):
- Restored: disallowedTools, memory, background, isolation, skills, permissionMode, hooks
- Added new: maxTurns, mcpServers
- Fixed: tools format is comma-separated (not space-separated)

Plan Mode (12 occurrences fixed):
- Ctrl+G = "open plan in text editor" (NOT "enter plan mode")
- Plan Mode = Shift+Tab × 2 (Normal → acceptEdits → plan)

Commands table (10.1) + built-in commands (6.1):
- Added 18+ missing commands: /copy, /doctor, /hooks, /memory, /model,
  /config, /permissions, /remote-control, /rename, /resume, /sandbox, etc.

Workflow files:
- agent-teams.md: removed fake --experimental-agent-teams flag
- hooks.yaml + post_edit event → settings.json + PostToolUse (2 files)
- TodoWrite → TaskCreate/TaskUpdate (3 files)
- task-management.md: removed fake "failed" task status

Quiz / examples:
- 01-010: Esc stops mid-action (not Ctrl+C)
- refactoring-specialist.md: removed MultiEdit (not a valid tool)
- ast-grep-patterns.md: name field (not title)
- validate-changes.md, diagnose.md: field name fixes

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-02-26 18:21:28 +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 docs: complete factual audit pass 2 — 90+ corrections 2026-02-26 18:21:28 +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: complete factual audit pass 2 — 90+ corrections 2026-02-26 18:21:28 +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.59 2026-02-26 12:10:25 +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 docs: complete factual audit pass 2 — 90+ corrections 2026-02-26 18:21:28 +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: complete factual audit pass 2 — 90+ corrections 2026-02-26 18:21:28 +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