claude-code-ultimate-guide/guide
Florian BRUNIAUX 8f1dcecfa2 docs: update guide content, examples, tools, and reference files
- guide/ultimate-guide.md — content updates
- guide/workflows/README.md, guide/README.md — navigation improvements
- guide/diagrams/ — diagram updates (context/sessions, config, MCP ecosystem)
- guide/third-party-tools.md — additions
- examples/README.md, hooks/README.md, scripts/README.md — examples updates
- examples/skills/pr-triage/SKILL.md — expanded skill
- machine-readable/reference.yaml — reference sync
- tools/audit-prompt.md, tools/onboarding-prompt.md — tooling updates
- docs/for-cto.md, docs/for-tech-leads.md, docs/resource-evaluations/README.md — doc updates
- .gitignore — gitignore update

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-03-09 15:32:33 +01:00
..
diagrams docs: update guide content, examples, tools, and reference files 2026-03-09 15:32:33 +01:00
images docs: update template count badge (82 → 83) 2026-01-25 13:30:40 +01:00
workflows docs: update guide content, examples, tools, and reference files 2026-03-09 15:32:33 +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(entire-cli): enrich 4 guide files with production diagrams from issue #802 2026-03-05 15:11:32 +01:00
ai-roles.md docs(roles): strengthen salary disclaimer — indicative only, US-only baseline 2026-03-09 15:28:43 +01:00
ai-traceability.md docs(entire-cli): enrich 4 guide files with production diagrams from issue #802 2026-03-05 15:11:32 +01:00
architecture.md feat(mcp): add 4 new tools — compare_versions, get_threat, list_threats, search_examples 2026-02-28 19:22:20 +01:00
cheatsheet.md docs(cheatsheet): add /loop, /stats, /rename, /copy + Ctrl+F (v3.32.2) 2026-03-09 10:44:06 +01:00
claude-code-releases.md docs: update Claude Code releases to v2.1.69 2026-03-05 16:03:04 +01:00
cowork.md docs: tech leads section, straude, session-naming, cowork updates 2026-03-04 17:29:06 +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(roles): add AI roles & career paths guide 2026-03-09 14:57:46 +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.1 - Git MCP + GitHub MCP catalog entries 2026-03-02 16:10:19 +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 docs: update guide content, examples, tools, and reference files 2026-03-09 15:32:33 +01:00
remarkable-ai.md docs: add resource eval #069 + reMarkable AI guide 2026-02-26 18:27:46 +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(entire-cli): enrich 4 guide files with production diagrams from issue #802 2026-03-05 15:11:32 +01:00
third-party-tools.md docs: update guide content, examples, tools, and reference files 2026-03-09 15:32:33 +01:00
ultimate-guide.md docs: update guide content, examples, tools, and reference files 2026-03-09 15:32:33 +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: 41 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
ai-roles.md AI roles mapping: when to use Claude Code vs Claude Desktop vs API 10 min
production-safety.md Production safety: guardrails, review gates, rollback strategies 15 min
remarkable-ai.md Remarkable AI usage patterns and power-user techniques 10 min
sandbox-native.md Native Claude Code sandbox: configuration and security model 10 min
search-tools-cheatsheet.md Search tools quick reference: rg, grepai, Serena, ast-grep 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
workflows/agent-teams.md Orchestrating multi-agent teams for complex tasks
workflows/agent-teams-quick-start.md Quick start guide for agent team patterns
workflows/dual-instance-planning.md Dual-instance planning: Opus plans, Sonnet executes
workflows/event-driven-agents.md Event-driven agent coordination patterns
workflows/plan-pipeline.md End-to-end plan pipeline: start, validate, execute
workflows/design-to-code.md Convert Figma/wireframes to working code
workflows/exploration-workflow.md Systematically explore unfamiliar codebases
workflows/pdf-generation.md Generate professional PDFs with Quarto/Typst
workflows/search-tools-mastery.md Master rg, grepai, Serena, ast-grep combined workflows
workflows/skeleton-projects.md Use battle-tested repos as scaffolding for new projects
workflows/talk-pipeline.md 6-stage talk preparation: raw material to slides
workflows/team-ai-instructions.md Scale CLAUDE.md across multi-developer teams
  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