Repository navigation
v2026.11
Verified against Claude Code v2.1.292 (stable).
Editions 2 and 3: the Intermediate and Advanced paths, with checked exercises. Every level is now rebuilt, and no page from the previous edition remains.
Added
- The Intermediate level: eight lessons, from a first skill to plugins, by way of project memory, model and effort, permissions and the sandbox, hooks, subagents and MCP, and a capstone that sets a repository up for a new teammate. Every lesson and the capstone has a check in the practice template. You can run the lesson checks against your own repository with
--dir; the capstone runs in the template copy. - Four Intermediate Electives: skill patterns, Claude in Chrome, the status line and fast mode.
- Examples for the Intermediate lessons: two skills, three hook scripts, a read-only reviewer subagent and a pinned Chrome DevTools MCP configuration. Each one is inert until you copy it into a project, and has a smoke test.
- The Advanced level: seven lessons, from parallel sessions in worktrees to bounds on autonomous runs, by way of orchestration patterns, dynamic workflows,
claude -pscripts, GitHub Actions and a setup shared with a team, and a capstone that adds CI review a team can share. Every lesson and the capstone has a check in the practice template. Most lesson checks run against your own repository with--dir; the GitHub Actions lesson and the capstone run in a separate template copy that you tear down afterwards. - Five Advanced Electives: agent teams, agent view,
/goal,/loopand routines, testing and publishing a plugin and dev containers. - Beyond this guide: where to go next for building your own agents and MCP servers, and for running and rolling out Claude Code in an organization.
- Examples for the Advanced level: the
team-toolsmarketplace with itsteam-kitplugin (theonboardskill and the read-onlyconfig-reviewersubagent) and the settings that share it, and the read-onlysecurity-reviewerandtest-reviewersubagents for the agent teams Elective. Each one is inert until you copy it into a project, and has a smoke test.
Changed
- The Beginner lessons and capstone use code review, plan review, recovery and project instructions as practice tasks. The learning app's questions focus on decisions, and its checks read available evidence directly from files, git and the installed CLI.
- The Intermediate lessons and capstone use real work as practice tasks: a console error found through Chrome DevTools MCP and fixed, a commit made by a plugin, a lookup through a code intelligence plugin, and a malformed-link crash fixed in the capstone. Each lesson asks at most three graded questions, and the capstone asks none.
- The Advanced lessons and capstone use real work as practice tasks: two backlog changes in parallel worktrees, a release-week backlog sorted by orchestration pattern, a migration across two folders that a saved workflow keeps fixing until the tests pass, a staged-change review you act on, and a bounded run whose diff you review for changes outside the task. Self-checks ask for a decision the check can't see, and the capstone groups its check list by lesson and caps the review script's spend with
--max-budget-usd. - The animated Claude mascot is back beside README's title, and the social card shows it in place of the trail blazes. It comes from shanraisshan/claude-code-best-practice under the MIT License.
- Every stamped page is re-verified against Claude Code v2.1.292 (stable), and the social card carries the full tagline, "Learn it in three levels, with cited facts and checked exercises."
- The topic pages, Commands by level and the Feature map link the Intermediate and Advanced lessons and Electives, and "When to use what" on the Intermediate index links the dynamic workflows lesson.
- docs/reference/effort-levels.md and docs/skills.md are now stubs that point to the lessons and reference pages that replace them, and the
mcp-servers/andspecialized-agents/stubs point to the MCP and subagent lessons. - docs/agent-teams.md, docs/workflows.md and docs/reference/faq.md are now stubs that point to the lessons, Electives and reference pages that replace them.
- The
inertnesscheck also fails on an example marketplace manifest that is not renamed todot-claude-plugin/, and on a.claude-plugin/folder at the repository root. Thestatic-validationcheck also covers the skills and agents of the plugins in an example marketplace.
Removed
- The previous edition's pages on skills, hooks, MCP and fast mode under
docs/legacy/, and the subagents section of the subagents and parallel work page: the Intermediate lessons and Electives replace them. Links to the previous edition's README sections land on a line that points to the new page. - The skill-resolution diagram, which no page used any more.
- The previous edition's last page under
docs/legacy/, on subagents and parallel work, and README's index row of previous-edition pages: the Advanced lessons and Electives replace them, anddocs/legacy/is gone. Links to the previous edition's README sections land on a line that points to the new page.