chore(release): v2.1.0

This commit is contained in:
Luong NGUYEN
2026-03-13 09:06:56 +01:00
parent 00bbe4c6ea
commit 384a335fda
5 changed files with 100 additions and 290 deletions

View File

@@ -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".
---

75
CHANGELOG.md Normal file
View File

@@ -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

View File

@@ -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

View File

@@ -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

View File

@@ -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 JanMar 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 `<!-- DOCS-SYNC CONFLICT -->` 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