diff --git a/.claude/skills/self-assessment/SKILL.md b/.claude/skills/self-assessment/SKILL.md index 17a419b..24acee6 100644 --- a/.claude/skills/self-assessment/SKILL.md +++ b/.claude/skills/self-assessment/SKILL.md @@ -1,6 +1,6 @@ --- name: self-assessment -version: 2.0.0 +version: 2.1.0 description: Comprehensive Claude Code self-assessment and learning path advisor. Runs a multi-category quiz covering 10 feature areas, produces a detailed skill profile with per-topic scores, identifies specific gaps, and generates a personalized learning path with prioritized next steps. Use when asked to "assess my level", "take the quiz", "find my level", "where should I start", "what should I learn next", "check my skills", "skill check", or "level up". --- diff --git a/CHANGELOG.md b/CHANGELOG.md new file mode 100644 index 0000000..abb962e --- /dev/null +++ b/CHANGELOG.md @@ -0,0 +1,75 @@ +# Changelog + +## v2.1.0 — 2026-03-13 + +### Features + +- Add adaptive learning path with self-assessment and lesson quiz skills (1ef46cd) @luongnv89 + - `/self-assessment` — interactive proficiency quiz across 10 feature areas with personalized learning path + - `/lesson-quiz [lesson]` — per-lesson knowledge check with 8-10 targeted questions + +### Bug Fixes + +- Update broken URLs, deprecations, and outdated references (8fe4520) @luongnv89 +- Fix broken links in resources and self-assessment skill (7a05863) @luongnv89 +- Use tilde fences for nested code blocks in concepts guide (5f82719) @VikalpP +- Add missing words to cSpell dictionary (8df7572) @luongnv89 + +### Documentation + +- Phase 5 QA — fix consistency, URLs, and terminology across docs (00bbe4c) @luongnv89 +- Complete Phases 3-4 — new feature coverage and reference doc updates (132de29) @luongnv89 +- Add MCPorter runtime to MCP context bloat section (ef52705) @luongnv89 +- Add missing commands, features, and settings across 6 guides (4bc8f15) @luongnv89 +- Add style guide based on existing repo conventions (84141d0) @luongnv89 +- Add self-assessment row to guide comparison table (8fe0c96) @luongnv89 +- Add VikalpP to contributors list for PR #7 (d5b4350) @luongnv89 +- Add self-assessment and lesson-quiz skill references to README and roadmap (d5a6106) @luongnv89 + +### New Contributors + +- @VikalpP made their first contribution in #7 + +**Full Changelog**: https://github.com/luongnv89/claude-howto/compare/v2.0.0...v2.1.0 + +--- + +## v2.0.0 — 2026-02-01 + +### Features + +- Sync all documentation with Claude Code February 2026 features (487c96d) + - Update 26 files across all 10 tutorial directories and 7 reference documents + - Add documentation for **Auto Memory** — persistent learnings per project + - Add documentation for **Remote Control**, **Web Sessions**, and **Desktop App** + - Add documentation for **Agent Teams** (experimental multi-agent collaboration) + - Add documentation for **MCP OAuth 2.0**, **Tool Search**, and **Claude.ai Connectors** + - Add documentation for **Persistent Memory** and **Worktree Isolation** for subagents + - Add documentation for **Background Subagents**, **Task List**, **Prompt Suggestions** + - Add documentation for **Sandboxing** and **Managed Settings** (Enterprise) + - Add documentation for **HTTP Hooks** and 7 new hook events + - Add documentation for **Plugin Settings**, **LSP Servers**, and Marketplace updates + - Add documentation for **Summarize from Checkpoint** rewind option + - Document 17 new slash commands (`/fork`, `/desktop`, `/teleport`, `/tasks`, `/fast`, etc.) + - Document new CLI flags (`--worktree`, `--from-pr`, `--remote`, `--teleport`, `--teammate-mode`, etc.) + - Document new environment variables for auto memory, effort levels, agent teams, and more + +### Design + +- Redesign logo to compass-bracket mark with minimal palette (20779db) + +### Bug Fixes / Corrections + +- Update model names: Sonnet 4.5 → **Sonnet 4.6**, Opus 4.5 → **Opus 4.6** +- Fix permission mode names: replace fictional "Unrestricted/Confirm/Read-only" with actual `default`/`acceptEdits`/`plan`/`dontAsk`/`bypassPermissions` +- Fix hook events: remove fictional `PreCommit`/`PostCommit`/`PrePush`, add real events (`SubagentStart`, `WorktreeCreate`, `ConfigChange`, etc.) +- Fix CLI syntax: replace `claude-code --headless` with `claude -p` (print mode) +- Fix checkpoint commands: replace fictional `/checkpoint save/list/rewind/diff` with actual `Esc+Esc` / `/rewind` interface +- Fix session management: replace fictional `/session list/new/switch/save` with real `/resume`/`/rename`/`/fork` +- Fix plugin manifest format: migrate `plugin.yaml` → `.claude-plugin/plugin.json` +- Fix MCP config paths: `~/.claude/mcp.json` → `.mcp.json` (project) / `~/.claude.json` (user) +- Fix documentation URLs: `docs.claude.com` → `docs.anthropic.com`; remove fictional `plugins.claude.com` +- Remove fictional configuration fields across multiple files +- Update all "Last Updated" dates to February 2026 + +**Full Changelog**: https://github.com/luongnv89/claude-howto/compare/20779db...v2.0.0 diff --git a/README.md b/README.md index 43606cb..b8315a2 100644 --- a/README.md +++ b/README.md @@ -940,6 +940,6 @@ Thanks to everyone who has contributed to this project! --- -**Last Updated**: February 2026 +**Last Updated**: March 2026 **Claude Code Version**: 2.1+ **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.6, Claude Haiku 4.5 diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md index ac9feed..1a33bb0 100644 --- a/RELEASE_NOTES.md +++ b/RELEASE_NOTES.md @@ -1,39 +1,31 @@ -## What's Changed +## v2.1.0 — 2026-03-13 ### Features -- Sync all documentation with Claude Code February 2026 features (487c96d) - - Update 26 files across all 10 tutorial directories and 7 reference documents - - Add documentation for **Auto Memory** — persistent learnings per project - - Add documentation for **Remote Control**, **Web Sessions**, and **Desktop App** - - Add documentation for **Agent Teams** (experimental multi-agent collaboration) - - Add documentation for **MCP OAuth 2.0**, **Tool Search**, and **Claude.ai Connectors** - - Add documentation for **Persistent Memory** and **Worktree Isolation** for subagents - - Add documentation for **Background Subagents**, **Task List**, **Prompt Suggestions** - - Add documentation for **Sandboxing** and **Managed Settings** (Enterprise) - - Add documentation for **HTTP Hooks** and 7 new hook events - - Add documentation for **Plugin Settings**, **LSP Servers**, and Marketplace updates - - Add documentation for **Summarize from Checkpoint** rewind option - - Document 17 new slash commands (`/fork`, `/desktop`, `/teleport`, `/tasks`, `/fast`, etc.) - - Document new CLI flags (`--worktree`, `--from-pr`, `--remote`, `--teleport`, `--teammate-mode`, etc.) - - Document new environment variables for auto memory, effort levels, agent teams, and more +- Add adaptive learning path with self-assessment and lesson quiz skills (1ef46cd) + - `/self-assessment` — interactive proficiency quiz across 10 feature areas with personalized learning path + - `/lesson-quiz [lesson]` — per-lesson knowledge check with 8-10 targeted questions -### Design +### Bug Fixes -- Redesign logo to compass-bracket mark with minimal palette (20779db) +- Update broken URLs, deprecations, and outdated references (8fe4520) +- Fix broken links in resources and self-assessment skill (7a05863) +- Use tilde fences for nested code blocks in concepts guide (5f82719) — thanks @VikalpP! +- Add missing words to cSpell dictionary (8df7572) -### Bug Fixes / Corrections +### Documentation -- Update model names: Sonnet 4.5 → **Sonnet 4.6**, Opus 4.5 → **Opus 4.6** -- Fix permission mode names: replace fictional "Unrestricted/Confirm/Read-only" with actual `default`/`acceptEdits`/`plan`/`dontAsk`/`bypassPermissions` -- Fix hook events: remove fictional `PreCommit`/`PostCommit`/`PrePush`, add real events (`SubagentStart`, `WorktreeCreate`, `ConfigChange`, etc.) -- Fix CLI syntax: replace `claude-code --headless` with `claude -p` (print mode) -- Fix checkpoint commands: replace fictional `/checkpoint save/list/rewind/diff` with actual `Esc+Esc` / `/rewind` interface -- Fix session management: replace fictional `/session list/new/switch/save` with real `/resume`/`/rename`/`/fork` -- Fix plugin manifest format: migrate `plugin.yaml` → `.claude-plugin/plugin.json` -- Fix MCP config paths: `~/.claude/mcp.json` → `.mcp.json` (project) / `~/.claude.json` (user) -- Fix documentation URLs: `docs.claude.com` → `docs.anthropic.com`; remove fictional `plugins.claude.com` -- Remove fictional configuration fields across multiple files -- Update all "Last Updated" dates to February 2026 +- Phase 5 QA — fix consistency, URLs, and terminology across docs (00bbe4c) +- Complete Phases 3-4 — new feature coverage and reference doc updates (132de29) +- Add MCPorter runtime to MCP context bloat section (ef52705) +- Add missing commands, features, and settings across 6 guides (4bc8f15) +- Add style guide based on existing repo conventions (84141d0) +- Add self-assessment row to guide comparison table (8fe0c96) +- Add VikalpP to contributors list for PR #7 (d5b4350) +- Add self-assessment and lesson-quiz skill references to README and roadmap (d5a6106) -**Full Changelog**: https://github.com/luongnv89/claude-howto/compare/20779db...v2.0.0 +### New Contributors + +- @VikalpP made their first contribution in #7 + +**Full Changelog**: https://github.com/luongnv89/claude-howto/compare/v2.0.0...v2.1.0 diff --git a/update-plan.md b/update-plan.md deleted file mode 100644 index d6c7509..0000000 --- a/update-plan.md +++ /dev/null @@ -1,257 +0,0 @@ -# Docs Sync Update Plan - -> Generated: 2026-03-13 -> Source: Official Claude Code docs at `code.claude.com/docs/en/` -> Repo version: Last updated February 2026 -> Latest Claude Code version: 2.1.74 (March 12, 2026) - ---- - -## Phase 1: Critical Updates (Broken/Misleading Content) ✅ COMPLETED - -> **Completed**: 2026-03-13 | **Commit**: `8fe4520` - -These items were factually wrong or referenced deprecated/removed features. - -### Task 1.1: Fix official docs URL ✅ - -- **Files modified**: `README.md`, `resources.md`, `CATALOG.md`, `02-memory/README.md`, `claude_concepts_guide.md`, `LEARNING-ROADMAP.md`, `STYLE_GUIDE.md`, `.github/ISSUE_TEMPLATE/config.yml` -- **Change**: Replaced 16 instances of `docs.anthropic.com/en/docs/claude-code` URLs with `code.claude.com/docs/en/` equivalents (with correct subpath mapping per page) - -### Task 1.2: Mark `/review` as deprecated ✅ - -- **File**: `01-slash-commands/README.md` -- **Change**: Marked `/review` as **Deprecated** with `code-review` plugin install instructions - -### Task 1.3: Mark `/output-style` as deprecated — SKIPPED - -- **Reason**: `/output-style` was not present in the repo. No action needed. - -### Task 1.4: Fix model name references ✅ - -- **File**: `01-slash-commands/README.md` -- **Change**: Fixed "Sonnet 4.5" → "Sonnet 4.6" (only outdated instance found) - -### Task 1.5: Mark SSE transport as deprecated — SKIPPED - -- **Reason**: Already marked as deprecated in `05-mcp/README.md` line 100. No action needed. - -### Task 1.6: Fix `Task()` → `Agent()` rename ✅ - -- **File**: `04-subagents/README.md` -- **Change**: Updated `Task(agent_type)` → `Agent(agent_type)` in description and YAML example. Added backward-compatibility note about v2.1.63 rename. - -### Task 1.7: Resolve `/todos` conflict ✅ - -- **File**: `01-slash-commands/README.md` -- **Change**: Removed `/todos` from built-in commands table. Verified it is not listed in official docs at `code.claude.com/docs/en/interactive-mode`. `/tasks` already covers task management. - -### Task 1.8: Resolve memory hierarchy conflict ✅ - -- **File**: `02-memory/README.md` -- **Change**: Added verification note that `CLAUDE.local.md` is not mentioned in official docs as of March 2026. Kept the entry (may still work as legacy) with recommendation to use `~/.claude/CLAUDE.md` or `.claude/rules/` for new projects. - ---- - -## Phase 2: Missing Commands & Features (Incomplete Content) ✅ COMPLETED - -> **Completed**: 2026-03-13 - -Content existed but was missing significant features that shipped in Jan–Mar 2026. - -### Task 2.1: Add missing built-in commands to slash commands table ✅ - -- **File modified**: `01-slash-commands/README.md` -- **Change**: Added 15 missing commands (`/btw`, `/chrome`, `/diff`, `/extra-usage`, `/feedback`, `/insights`, `/install-slack-app`, `/keybindings`, `/mobile`, `/passes`, `/reload-plugins`, `/remote-control`, `/skills`, `/stickers`, `/upgrade`) in alphabetical order to the built-in commands table - -### Task 2.2: Add bundled skills section ✅ - -- **File modified**: `03-skills/README.md` -- **Change**: Added "Bundled Skills" section documenting 5 built-in skills (`/simplify`, `/batch`, `/debug`, `/loop`, `/claude-api`) between "Skills vs Other Features" and "Sharing Skills" sections - -### Task 2.3: Add `${CLAUDE_SKILL_DIR}` to skills substitutions ✅ - -- **File modified**: `03-skills/README.md` -- **Change**: Added `${CLAUDE_SKILL_DIR}` row to the String Substitutions table - -### Task 2.4: Add missing CLI flags — SKIPPED - -- **Reason**: All 19 flags were already documented in `10-cli/README.md` across Core Flags, Model & Configuration, Tool & Permission, Workspace & Directory, MCP Configuration, Session Management, and Advanced Features tables. No action needed. - -### Task 2.5: Update MCP OAuth documentation ✅ - -- **File modified**: `05-mcp/README.md` -- **Changes**: Added `oauth.authServerMetadataUrl` config section, `ENABLE_CLAUDEAI_MCP_SERVERS=false` env var, and updated MCP scope terminology (Local/User with old name notes). 4 items (`--callback-port`, `--client-id`/`--client-secret`, env var expansion, Tool Search) were already present. - -### Task 2.6: Add missing built-in subagents — SKIPPED - -- **Reason**: "Bash" and "Claude Code Guide" subagents were already fully documented in `04-subagents/README.md` with both table entries and detailed subsections. No action needed. - -### Task 2.7: Add `autoMemoryDirectory` and auto-memory settings ✅ - -- **File modified**: `02-memory/README.md` -- **Changes**: Added `autoMemoryDirectory` setting (v2.1.74), v2.1.59+ version requirement note, and `claudeMdExcludes` setting for monorepos. 2 items (`CLAUDE_CODE_DISABLE_AUTO_MEMORY` env var, Windows managed policy path) were already present. - -### Task 2.8: Update effort levels ✅ - -- **File modified**: `09-advanced-features/README.md` -- **Change**: Added visual effort indicators low (○), medium (◐), high (●) in 3 locations. "max" was never mentioned (no removal needed). "ultrathink" note was already present. - -### Task 2.9: Update `/context` command description ✅ - -- **File modified**: `01-slash-commands/README.md` -- **Change**: Updated `/context` description to "Visualize context usage with actionable optimization suggestions" (combined with Task 2.1) - -### Task 2.10: Add hook events update ✅ - -- **File modified**: `06-hooks/README.md` -- **Changes**: Added 2 missing hook events (`InstructionsLoaded`, `Setup`) to events table (updated count 16→18), added HTTP hooks v2.1.63 version note, documented `once: true` in field reference, added `agent_id`/`agent_type`/`worktree` fields to JSON input, added `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` env var. Items already present: 6 other hook events, `last_assistant_message`, component-scoped hooks. - ---- - -## Phase 3: New Feature Coverage (Content Gaps) ✅ COMPLETED - -> **Completed**: 2026-03-13 - -These are significant features that existed in official docs but had no or minimal corresponding content in the guide. All 8 tasks completed — new tutorial content added. - -### Task 3.1: Expand Agent Teams tutorial content ✅ - -- **File modified**: `04-subagents/README.md` -- **Change**: Expanded Agent Teams section from 25 lines to ~140 lines. Added subagents vs agent teams comparison table, enabling instructions (env var + settings.json), starting a team example, display modes table, Mermaid architecture diagram (Team Lead → Shared Task List → Teammates + Mailbox), task assignment and messaging, plan approval workflow, hook events table (TeammateIdle, TaskCompleted), best practices (5 items), limitations (6 items) - -### Task 3.2: Add Scheduled Tasks / `/loop` documentation ✅ - -- **File modified**: `09-advanced-features/README.md` -- **Change**: Added new "Scheduled Tasks" section (~80 lines) between Background Tasks and Permission Modes. Covers `/loop` command syntax, one-time reminders, CronCreate/CronList/CronDelete tools table, behavior details table (jitter, missed fires, persistence), `CLAUDE_CODE_DISABLE_CRON` env var, deployment monitoring example - -### Task 3.3: Add Chrome Integration section ✅ - -- **File modified**: `09-advanced-features/README.md` -- **Change**: Added new "Chrome Integration" section (~65 lines) between Interactive Features and Remote Control. Covers enabling via `--chrome`/`/chrome`, capabilities table (6 items), site-level permissions, how it works, known limitations (Brave/Arc, WSL, third-party providers) - -### Task 3.4: Expand Remote Control section ✅ - -- **File modified**: `09-advanced-features/README.md` -- **Change**: Expanded Remote Control from 18 lines to ~75 lines. Added version/plan requirements, CLI + REPL commands, flags table (--name, --verbose, --sandbox), 3 connection methods (QR code, URL, find by name), security details, Remote Control vs Claude Code on Web comparison table, limitations - -### Task 3.5: Expand Plugin Marketplaces ✅ - -- **File modified**: `07-plugins/README.md` -- **Change**: Added ~80 lines after existing marketplace section. New subsections: marketplace.json schema with code example and field reference table, plugin source types table (6 sources: relative, GitHub, git URL, git-subdir, npm, pip), distribution methods, strict mode with `strictKnownMarketplaces` allowlist - -### Task 3.6: Expand LSP Servers in Plugins ✅ - -- **File modified**: `07-plugins/README.md` -- **Change**: Expanded LSP section from 15 lines to ~70 lines. Added `.lsp.json` configuration locations, 12-field reference table, 3 example configs (Go/gopls, Python/pyright, TypeScript), available LSP plugins table, LSP capabilities summary - -### Task 3.7: Expand Keyboard Shortcuts Customization ✅ - -- **File modified**: `09-advanced-features/README.md` -- **Change**: Added ~60 lines after existing keyboard shortcuts tables. New subsections: customizing keybindings (`/keybindings` command, v2.1.18+), JSON configuration format example, available contexts table (18 contexts), chord support with keystroke syntax, reserved and conflicting keys table - -### Task 3.8: Expand Desktop App ✅ - -- **File modified**: `09-advanced-features/README.md` -- **Change**: Expanded Desktop App from 20 lines to ~100 lines. Added installation info, core features table (6 features), `.claude/launch.json` app preview config, connectors table (6 connectors), remote/SSH sessions, permission modes table, enterprise features - ---- - -## Phase 4: Reference Document Updates (Cascading Changes) - -After Phases 1-3, these reference documents need updates to reflect all changes. - -### Task 4.1: Update CATALOG.md - -- Sync all command counts (40 → 55+ built-in commands) -- Add bundled skills section -- Update subagent count and types -- Add new hook events -- Update MCP features list -- Add agent teams as new capability - -### Task 4.2: Update QUICK_REFERENCE.md - -- Add new commands to cheat sheet -- Update model names -- Add bundled skills shortcuts -- Add new CLI flags - -### Task 4.3: Update INDEX.md - -- Add any new files created in Phase 3 -- Update file counts and descriptions -- Verify all cross-references - -### Task 4.4: Update LEARNING-ROADMAP.md - -- Add agent teams to advanced topics -- Add scheduled tasks to intermediate topics -- Update feature counts -- Update self-assessment quiz if needed - -### Task 4.5: Update claude_concepts_guide.md - -- Sync all feature descriptions with Phases 1-3 changes -- Update model references -- Add new features to relevant sections - -### Task 4.6: Update resources.md - -- Fix official docs URL -- Add new official doc pages (agent-teams, scheduled-tasks, chrome, keybindings, etc.) -- Verify all external links still work - ---- - -## Phase 5: Validation (Quality Assurance) ✅ COMPLETED - -> **Completed**: 2026-03-13 - -### Task 5.1: Link validation ✅ - -- **Internal links**: 170+ links checked across 193 files — all valid (2 template placeholders in `finding-template.md` and `claude_concepts_guide.md` are intentional) -- **External URLs**: 52 unique URLs verified — all working -- **Fix applied**: Updated `code.claude.com/docs/en/slash-commands` → `/interactive-mode` in `02-memory/README.md` (old URL redirects to skills page) - -### Task 5.2: Mermaid diagram review ✅ - -- **40+ diagrams reviewed** across 13 files — all syntactically valid -- **Fix applied**: Normalized color hex `#e1f5ff` → `#e1f5fe` in `04-subagents/README.md` line 737 - -### Task 5.3: Conflict marker cleanup ✅ - -- No `` markers found -- No git conflict markers (`<<<<<<<`, `=======`, `>>>>>>>`) found -- No leftover TODO/FIXME comments from docs sync process - -### Task 5.4: Consistency check ✅ - -- **Model names**: All consistent (Sonnet 4.6, Opus 4.6, Haiku 4.5) — no outdated references -- **Terminology**: Standardized "Sub-Agents" → "subagents" in CATALOG.md (7 instances) -- **URLs**: All official doc URLs use `code.claude.com/docs/en/` consistently -- **CLAUDE.local.md**: Added legacy caveat to CATALOG.md to match 02-memory/README.md -- **Version numbers**: All consistent across files - ---- - -## Execution Summary - -| Phase | Tasks | Priority | Estimated Effort | -|-------|-------|----------|-----------------| -| **Phase 1** | 8 tasks | ✅ Completed 2026-03-13 | Small edits, 1 subagent batch | -| **Phase 2** | 10 tasks (2 skipped) | ✅ Completed 2026-03-13 | 6 files modified, 2 already complete | -| **Phase 3** | 8 tasks | ✅ Completed 2026-03-13 | 3 files modified, ~612 net lines added | -| **Phase 4** | 6 tasks | Required — cascade reference updates | Medium edits after Phases 1-3 | -| **Phase 5** | 4 tasks | ✅ Completed 2026-03-13 | 3 files modified, 10 fixes applied | - -**Total**: 36 tasks across 5 phases - ---- - -## Notes - -- All changes should preserve the repo's existing style: logo headers, Mermaid diagrams, table formatting, code block language tags, heading hierarchy -- Use `Edit` tool (not `Write`) for modifications to existing files -- Launch parallel subagents per directory for Phase 2-3 efficiency -- Phase 4 must run sequentially after Phases 1-3 since reference docs depend on category content