Edition 1 (v2026.10)

Edition 1 of the guide: start at the Beginner level, and practice in your own copy of the practice template.

Verified against Claude Code v2.1.285 (stable).

Edition 1: the Beginner path, with checked exercises, and the structure the next two levels build on. Intermediate and Advanced are being rebuilt; copies of the previous edition's README sections on skills, hooks, subagents and parallel work, MCP and fast mode stay readable under docs/legacy/, labelled as not yet re-verified.

Added

• The Beginner level: five lessons, from installing Claude Code to giving a project its memory, a capstone and three Electives. Every lesson and the capstone has a check you run in the practice template, whose solutions branch passes every check.
• A front door that places you at a level, and indexes for the three levels, the topics and the reference pages, including a Feature map and a glossary.
• Pages from the previous edition, kept readable under docs/legacy/ with a note until the lessons that replace them land.
• Issue forms for lesson trouble, bugs and stale facts, with a "Stuck on this lesson?" link at the bottom of every lesson.
• Checks on every pull request: internal links and anchors, page stamps, lesson structure, images, em dashes, config validation and the safety of examples/. Scheduled checks watch external links, expiry markers and new stable releases, and open an issue when something needs attention.
• A listing policy in CONTRIBUTING.md and a form to suggest a resource.
• Agent rules in AGENTS.md, which a new CLAUDE.md imports.
• A rewritten CONTRIBUTING.md, a pull request template with a claim table and a dry-run section, and a CODEOWNERS file.

Changed

• The listing freeze has ended: resource suggestions are reviewed against the listing bar again.
• The guide has its own mark, three trail blazes climbing a post, in place of the mascot image, so it no longer uses a likeness of an Anthropic character. A new social card goes with it, carrying nothing that can go stale.
• The reference pages are rewritten for lookup: Models and effort, Commands by level and Further learning. They carry no prices, plan limits or model specifications, and link the official pages for those.

Removed

• The guide's summary of Claude Code releases, docs/reference/changelog.md, is now a stub that points to the official CHANGELOG and What's new.

• Third-party listings that no lesson uses: the skills ecosystem catalog (registries, curated lists and community skill names), the MCP server tables and the MCP ecosystem survey, the four MCP server walkthroughs in mcp-servers/, the SuperClaude and BMAD frameworks, and the ten role prompts and nine role descriptions in specialized-agents/. The listing policy says what the guide lists now. Old links to these pages and sections land on a line that says so.

• From Further learning: model announcements, a token calculator, third-party MCP server examples and an MCP authentication post, hook and workflow collections, terminal and note-taking tools, another coding assistant, and an agent-interoperability announcement. No lesson uses them.

• The repo's live Claude Code setup no longer runs anything when you clone the repo and trust the folder. Gone: the spoken Notification hook with its text-to-speech and LLM helper scripts, the 14 allow rules, the five subagent personas in .claude/agents/, the seven slash commands in .claude/commands/, and the skills catalog and workflow recipes in docs/skills.md that described them. .claude/ keeps a deny rule for reading .env files, the claude-md-review skill and the stale-docs-audit workflow. To keep a spoken notification of your own, add a Notification hook to ~/.claude/settings.json.