From 5850da9a14cfbefab4625567dd2316c2bc6be261 Mon Sep 17 00:00:00 2001 From: Luong NGUYEN Date: Tue, 26 May 2026 08:58:44 +0200 Subject: [PATCH] docs: sync to Claude Code v2.1.150 (#127) * docs: sync to Claude Code v2.1.150 * fix(README): bump stale version prose to v2.1.150 --- 01-slash-commands/README.md | 6 +- 02-memory/README.md | 4 +- 03-skills/README.md | 16 +++-- .../SKILL.md | 0 .../scripts/analyze-metrics.py | 0 .../scripts/compare-complexity.py | 0 .../templates/finding-template.md | 0 .../templates/review-checklist.md | 0 04-subagents/README.md | 4 +- 05-mcp/README.md | 5 +- 06-hooks/README.md | 10 +-- 07-plugins/README.md | 4 +- 08-checkpoints/README.md | 4 +- 09-advanced-features/README.md | 6 +- 10-cli/README.md | 6 +- CATALOG.md | 10 +-- CHANGELOG.md | 71 +++++++++++++++++++ INDEX.md | 14 ++-- LEARNING-ROADMAP.md | 8 +-- QUICK_REFERENCE.md | 16 ++--- README.md | 22 +++--- STYLE_GUIDE.md | 8 +-- claude_concepts_guide.md | 12 ++-- resources.md | 5 +- 24 files changed, 150 insertions(+), 81 deletions(-) rename 03-skills/{code-review => code-review-specialist}/SKILL.md (100%) rename 03-skills/{code-review => code-review-specialist}/scripts/analyze-metrics.py (100%) rename 03-skills/{code-review => code-review-specialist}/scripts/compare-complexity.py (100%) rename 03-skills/{code-review => code-review-specialist}/templates/finding-template.md (100%) rename 03-skills/{code-review => code-review-specialist}/templates/review-checklist.md (100%) diff --git a/01-slash-commands/README.md b/01-slash-commands/README.md index 9721282..8ace119 100644 --- a/01-slash-commands/README.md +++ b/01-slash-commands/README.md @@ -107,7 +107,7 @@ These skills ship with Claude Code and are invoked like slash commands: | `/claude-api` | Load Claude API reference for project language | | `/debug [description]` | Enable debug logging | | `/loop [interval] ` | Run prompt repeatedly on interval | -| `/simplify [focus]` | Review changed files for code quality | +| `/code-review [effort]` | Review the current diff for correctness bugs at a chosen effort level (e.g. `/code-review high`); renamed from `/simplify` in v2.1.146 | ### Deprecated Commands @@ -620,8 +620,8 @@ If both exist with the same name, the **skill takes precedence**. Remove one or --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/slash-commands - https://code.claude.com/docs/en/interactive-mode diff --git a/02-memory/README.md b/02-memory/README.md index 0f98d02..b1288fd 100644 --- a/02-memory/README.md +++ b/02-memory/README.md @@ -1198,8 +1198,8 @@ For the most up-to-date information, refer to the official Claude Code documenta - [Official Memory Docs](https://code.claude.com/docs/en/memory) - Anthropic documentation --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/memory - https://code.claude.com/docs/en/settings diff --git a/03-skills/README.md b/03-skills/README.md index 195d24d..0c388ab 100644 --- a/03-skills/README.md +++ b/03-skills/README.md @@ -75,7 +75,7 @@ sequenceDiagram Claude->>System: Check available skills (metadata) System-->>Claude: Skill descriptions loaded at startup Claude->>Claude: Match request to skill description - Claude->>SkillInst: Read code-review/SKILL.md + Claude->>SkillInst: Read code-review-specialist/SKILL.md SkillInst-->>Claude: Level 2: Instructions loaded Claude->>Claude: Determine: Need templates? Claude->>SkillRes: Read templates/checklist.md @@ -334,7 +334,7 @@ Research $ARGUMENTS thoroughly: **Directory Structure:** ``` -~/.claude/skills/code-review/ +~/.claude/skills/code-review-specialist/ ├── SKILL.md ├── templates/ │ ├── review-checklist.md @@ -344,7 +344,7 @@ Research $ARGUMENTS thoroughly: └── compare-complexity.py ``` -**File:** `~/.claude/skills/code-review/SKILL.md` +**File:** `~/.claude/skills/code-review-specialist/SKILL.md` ```yaml --- @@ -616,9 +616,11 @@ Can you help me review this code for security issues? **Or invoke it directly** with the skill name: ``` -/code-review src/auth/login.ts +/code-review-specialist src/auth/login.ts ``` +> **Note**: This local skill is installed as `code-review-specialist` so it does **not** collide with the built-in `/code-review` command (the renamed `/simplify`, shipped in Claude Code v2.1.146). If you copy it to `~/.claude/skills/code-review/` instead, it will shadow the built-in — keep the `-specialist` suffix to avoid that. + ### Updating a Skill Edit the `SKILL.md` file directly. Changes take effect on next Claude Code startup. @@ -805,7 +807,7 @@ Claude Code ships with nine built-in skills that are always available without in | `/loop [interval] ` | Run prompt repeatedly on interval (e.g., `/loop 5m check the deploy`) | | `/run` *(v2.1.145+)* | Launch this project's app to see a change running — looks for a project skill, otherwise falls back to built-in patterns per project type | | `/run-skill-generator` *(v2.1.145+)* | Teach `/run`/`/verify` how to handle a specific project by generating a per-project skill | -| `/simplify` | Review changed files for reuse, quality, and efficiency; spawns 3 parallel review agents | +| `/code-review [effort]` | Review the current diff for correctness bugs at a chosen effort level (e.g. `/code-review high`); pass `--comment` to post findings as inline PR comments. Renamed from `/simplify` in v2.1.146 | | `/verify` *(v2.1.145+)* | Build, run, and observe the app to confirm a fix works (not just that tests pass) | These skills are available out-of-the-box and do not need to be installed or configured. They follow the same SKILL.md format as custom skills. @@ -852,8 +854,8 @@ Once you start building skills seriously, two things become essential: a library - [Hooks Guide](../06-hooks/) - Event-driven automation --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/skills - https://code.claude.com/docs/en/settings diff --git a/03-skills/code-review/SKILL.md b/03-skills/code-review-specialist/SKILL.md similarity index 100% rename from 03-skills/code-review/SKILL.md rename to 03-skills/code-review-specialist/SKILL.md diff --git a/03-skills/code-review/scripts/analyze-metrics.py b/03-skills/code-review-specialist/scripts/analyze-metrics.py similarity index 100% rename from 03-skills/code-review/scripts/analyze-metrics.py rename to 03-skills/code-review-specialist/scripts/analyze-metrics.py diff --git a/03-skills/code-review/scripts/compare-complexity.py b/03-skills/code-review-specialist/scripts/compare-complexity.py similarity index 100% rename from 03-skills/code-review/scripts/compare-complexity.py rename to 03-skills/code-review-specialist/scripts/compare-complexity.py diff --git a/03-skills/code-review/templates/finding-template.md b/03-skills/code-review-specialist/templates/finding-template.md similarity index 100% rename from 03-skills/code-review/templates/finding-template.md rename to 03-skills/code-review-specialist/templates/finding-template.md diff --git a/03-skills/code-review/templates/review-checklist.md b/03-skills/code-review-specialist/templates/review-checklist.md similarity index 100% rename from 03-skills/code-review/templates/review-checklist.md rename to 03-skills/code-review-specialist/templates/review-checklist.md diff --git a/04-subagents/README.md b/04-subagents/README.md index b368475..a70d42a 100644 --- a/04-subagents/README.md +++ b/04-subagents/README.md @@ -1238,8 +1238,8 @@ See the OpenTelemetry section in [Advanced Features → Telemetry](../09-advance --- -**Last Updated**: May 19, 2026 -**Claude Code Version**: 2.1.143 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/sub-agents - https://code.claude.com/docs/en/agent-teams diff --git a/05-mcp/README.md b/05-mcp/README.md index 8e16937..66c8aec 100644 --- a/05-mcp/README.md +++ b/05-mcp/README.md @@ -695,6 +695,7 @@ For enterprise deployments, IT administrators can enforce MCP server policies th **Features:** - `allowedMcpServers` -- whitelist of permitted servers - `deniedMcpServers` -- blocklist of prohibited servers +- `allowAllClaudeAiMcps` -- managed setting that permits loading claude.ai cloud MCP connectors organization-wide (v2.1.149+) - Supports matching by server name, command, and URL patterns - Organization-wide MCP policies enforced before user configuration - Prevents unauthorized server connections @@ -1167,8 +1168,8 @@ export GITHUB_TOKEN="your_token" --- -**Last Updated**: May 19, 2026 -**Claude Code Version**: 2.1.143 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/mcp - https://code.claude.com/docs/en/changelog diff --git a/06-hooks/README.md b/06-hooks/README.md index 91fc5d6..78becf8 100644 --- a/06-hooks/README.md +++ b/06-hooks/README.md @@ -348,12 +348,6 @@ Run when Claude finishes responding (Stop) or a subagent completes (SubagentStop **Additional input field:** Both `Stop` and `SubagentStop` hooks receive a `last_assistant_message` field in their JSON input, containing the final message from Claude or the subagent before stopping. This is useful for evaluating task completion. -**v2.1.145 additions:** The `Stop` and `SubagentStop` hook inputs now also include two arrays: -- `background_tasks` — any background tasks the session has spawned (handy for blocking stop until work finishes). -- `session_crons` — any cron jobs (`/schedule`) created during the session. - -Hook authors can read these to decide whether to block stop — for example, "don't stop while a background test run or scheduled task is still pending." - **Configuration:** ```json { @@ -1440,8 +1434,8 @@ Edit `~/.claude/settings.json` or `.claude/settings.json` with the hook configur --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/hooks - https://code.claude.com/docs/en/changelog diff --git a/07-plugins/README.md b/07-plugins/README.md index c566980..0414e50 100644 --- a/07-plugins/README.md +++ b/07-plugins/README.md @@ -1105,8 +1105,8 @@ The following Claude Code features work together with plugins: --- -**Last Updated**: May 19, 2026 -**Claude Code Version**: 2.1.143 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/plugins - https://code.claude.com/docs/en/plugin-marketplaces diff --git a/08-checkpoints/README.md b/08-checkpoints/README.md index 7287b9d..762b361 100644 --- a/08-checkpoints/README.md +++ b/08-checkpoints/README.md @@ -325,8 +325,8 @@ Remember: checkpoints are not a replacement for git. Use checkpoints for rapid e --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/checkpointing - https://code.claude.com/docs/en/settings diff --git a/09-advanced-features/README.md b/09-advanced-features/README.md index b53cf8a..fede3fb 100644 --- a/09-advanced-features/README.md +++ b/09-advanced-features/README.md @@ -1649,7 +1649,7 @@ Transfer your current CLI session to the Desktop App: | **PR monitoring** | GitHub CLI integration with auto-fix CI failures and auto-merge when checks pass | | **Parallel sessions** | Multiple sessions in the sidebar with automatic Git worktree isolation | | **Scheduled tasks** | Recurring tasks (hourly, daily, weekdays, weekly) that run while the app is open | -| **Rich rendering** | Code, markdown, and diagram rendering with syntax highlighting | +| **Rich rendering** | Code, markdown, and diagram rendering with syntax highlighting; GitHub-Flavored-Markdown task-list checkboxes (`- [ ]` / `- [x]`) render as checkboxes (v2.1.149+) | ### App preview configuration @@ -2267,8 +2267,8 @@ For more information about Claude Code and related features: --- -**Last Updated**: May 19, 2026 -**Claude Code Version**: 2.1.143 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/permission-modes - https://code.claude.com/docs/en/interactive-mode diff --git a/10-cli/README.md b/10-cli/README.md index 065585c..36b74c2 100644 --- a/10-cli/README.md +++ b/10-cli/README.md @@ -490,6 +490,8 @@ When you dispatch a session from the view (or via `claude --bg `), you c Sessions that finish their work but leave a background shell open move from "Working" to "Completed" (v2.1.141 fix). Within an attached agent session, `Shift+Tab` cycles through permission modes including auto mode (v2.1.143). +**Pin a session** — press `Ctrl+T` on a session in `claude agents` to pin it (v2.1.147). Pinned background sessions stay alive when idle, are restarted in place to apply Claude Code updates, and are shed under memory pressure only after non-pinned sessions. (This `Ctrl+T` is scoped to the Agent View; in the main session it toggles the task list view.) + --- ## High-Value Use Cases @@ -939,8 +941,8 @@ claude -p --output-format json "query" --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/cli-reference - https://code.claude.com/docs/en/settings diff --git a/CATALOG.md b/CATALOG.md index f8851b6..3b39f0e 100644 --- a/CATALOG.md +++ b/CATALOG.md @@ -80,7 +80,7 @@ Commands are user-invoked shortcuts that execute specific actions. | `/teleport` | Transfer session to another machine | Continue work remotely | | `/desktop` | Open Claude Desktop app | Switch to desktop interface | | `/theme` | Change color theme; v2.1.118 added custom named themes via `~/.claude/themes/.json` (plugins can ship a `themes/` dir) | Customize appearance | -| `/usage` | Canonical command for usage/cost/stats — merged `/cost` and `/stats` into a single tabbed view (v2.1.118) | Monitor quota and costs | +| `/usage` | Canonical command for usage/cost/stats — merged `/cost` and `/stats` into a single tabbed view (v2.1.118); as of v2.1.149 the cost view breaks spending down by category (skills, subagents, plugins, per-MCP-server) | Monitor quota and costs | | `/focus` | Toggle focus view (distraction-free output display) | Reduce visual noise during long tasks | | `/fork` | Fork current conversation | Explore alternatives | | `/stats` | Shortcut alias that opens the stats tab of `/usage` (v2.1.118+) | Review session metrics | @@ -200,7 +200,7 @@ Auto-invoked capabilities with instructions, scripts, and templates. | Skill | Description | When Auto-Invoked | Scope | Installation | |-------|-------------|-------------------|-------|--------------| -| `code-review` | Comprehensive code review | "Review this code", "Check quality" | Project | `cp -r 03-skills/code-review .claude/skills/` | +| `code-review-specialist` | Comprehensive code review | "Review this code", "Check quality" | Project | `cp -r 03-skills/code-review-specialist .claude/skills/` | | `brand-voice` | Brand consistency checker | Writing marketing copy | Project | `cp -r 03-skills/brand-voice .claude/skills/` | | `doc-generator` | API documentation generator | "Generate docs", "Document API" | Project | `cp -r 03-skills/doc-generator .claude/skills/` | | `refactor` | Systematic code refactoring (Martin Fowler) | "Refactor this", "Clean up code" | User | `cp -r 03-skills/refactor ~/.claude/skills/` | @@ -246,7 +246,7 @@ cp -r 03-skills/* ~/.claude/skills/ | `/loop` | Run prompts on interval | Recurring tasks | | `/run` *(v2.1.145+)* | Launch this project's app to see a change running | Verifying a change in the real app | | `/run-skill-generator` *(v2.1.145+)* | Teach `/run`/`/verify` how to handle a specific project | First-time project setup for `/run` | -| `/simplify` | Review code for quality | After writing code | +| `/code-review` *(renamed from `/simplify` in v2.1.146)* | Review the current diff for correctness bugs at a chosen effort level (e.g. `/code-review high`); pass `--comment` to post findings as inline PR comments | After writing code, before landing a PR | | `/verify` *(v2.1.145+)* | Build, run, and observe the app to confirm a fix works | Validating a fix end-to-end | --- @@ -538,8 +538,8 @@ chmod +x ~/.claude/hooks/*.sh --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/commands diff --git a/CHANGELOG.md b/CHANGELOG.md index 2ae2e2f..e459713 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,76 @@ # Changelog +## [v2.1.150] — 2026-05-25 + +### Synced to Claude Code v2.1.150 + +Bumps tutorial coverage from Claude Code v2.1.145 → v2.1.150 (May 23, 2026 +release). Anthropic shipped five patches (v2.1.146 through v2.1.150) since the +last sync. The headline change is the **rename of the bundled `/simplify` +skill to `/code-review`** (v2.1.146) — a pure rename with **no alias**, so the +old name no longer works. Because this repo also ships its own local +code-review skill, the directory was renamed to `code-review-specialist` to +avoid shadowing the new built-in. Other highlights: `/usage` now breaks costs +down per category, background sessions can be pinned with `Ctrl+T`, the +markdown renderer supports GFM task-list checkboxes, and a new +`allowAllClaudeAiMcps` managed setting was added. This sync also catches up +four module READMEs (`04-subagents`, `05-mcp`, `07-plugins`, +`09-advanced-features`) that were still pinned to v2.1.143. + +### Behavior changes + +- **`/simplify` renamed to `/code-review` (v2.1.146)**: the bundled review + skill is now invoked as `/code-review` and takes an optional effort level + (e.g. `/code-review high`); pass `--comment` to post findings as inline + GitHub PR comments (v2.1.147). The old `/simplify` name no longer works — + there is no alias. Updated in `01-slash-commands/README.md`, + `03-skills/README.md`, `CATALOG.md`, `QUICK_REFERENCE.md`, and + `claude_concepts_guide.md`. + +### Changed + +- **Renamed the repo's local `code-review` skill to `code-review-specialist`** + to avoid colliding with the new built-in `/code-review`. The directory + `03-skills/code-review/` → `03-skills/code-review-specialist/`, and all + install commands, directory trees, and cross-references were updated in + `README.md`, `QUICK_REFERENCE.md`, `INDEX.md`, `CATALOG.md`, + `LEARNING-ROADMAP.md`, `claude_concepts_guide.md`, and `03-skills/README.md`. + Added a note explaining the collision and how to avoid shadowing the + built-in. + +### Added + +- **`/usage` per-category cost breakdown (v2.1.149)** — the cost view now + breaks spending down by category (skills, subagents, plugins, and + per-MCP-server costs). Documented in `CATALOG.md` and + `claude_concepts_guide.md`. +- **Pinned background sessions — `Ctrl+T` (v2.1.147)** — pinning a session in + `claude agents` keeps it alive when idle, restarts it in place to apply + Claude Code updates, and sheds it under memory pressure only after + non-pinned sessions. Documented in `10-cli/README.md`. +- **GFM task-list checkbox rendering (v2.1.149)** — the markdown renderer now + renders `- [ ]` / `- [x]` as checkboxes. Documented in + `09-advanced-features/README.md`. +- **`allowAllClaudeAiMcps` managed setting (v2.1.149)** — permits loading + claude.ai cloud MCP connectors organization-wide. Documented in + `05-mcp/README.md`. + +### Removed + +- **Stop/SubagentStop hook input fields `background_tasks` and `session_crons`** + — removed from `06-hooks/README.md` and `resources.md`. These were added from + the v2.1.145 release notes but are not enumerated in the official hooks + reference page; removed to keep the docs aligned with the published + reference. + +### Documentation + +- Caught up four module READMEs from v2.1.143 to v2.1.150: + `04-subagents/README.md`, `05-mcp/README.md`, `07-plugins/README.md`, + `09-advanced-features/README.md`. +- Bumped every English doc's metadata footer to **v2.1.150 / May 25, 2026** for + a consistent sync. + ## [v2.1.145] — 2026-05-20 ### Synced to Claude Code v2.1.145 diff --git a/INDEX.md b/INDEX.md index 7eb95e4..185f217 100644 --- a/INDEX.md +++ b/INDEX.md @@ -66,7 +66,7 @@ Auto-invoked capabilities with scripts and templates. ### Code Review Skill (5 files) ``` -code-review/ +code-review-specialist/ ├── SKILL.md # Skill definition ├── scripts/ │ ├── analyze-metrics.py # Code metrics analyzer @@ -515,7 +515,7 @@ claude-howto/ │ └── README.md │ ├── 03-skills/ # Skills -│ ├── code-review/ +│ ├── code-review-specialist/ │ │ ├── SKILL.md │ │ ├── scripts/ │ │ │ ├── analyze-metrics.py @@ -666,7 +666,7 @@ cp 01-slash-commands/optimize.md .claude/commands/ cp 04-subagents/code-reviewer.md .claude/agents/ # Install skill -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Or install complete plugin /plugin install pr-review @@ -808,12 +808,12 @@ Run tests in background ### Performance - `01-slash-commands/optimize.md` - Performance analysis - `04-subagents/code-reviewer.md` - Performance review -- `03-skills/code-review/` - Performance metrics +- `03-skills/code-review-specialist/` - Performance metrics - `07-plugins/pr-review/agents/performance-analyzer.md` - Performance specialist ### Security - `04-subagents/secure-reviewer.md` - Security review -- `03-skills/code-review/` - Security analysis +- `03-skills/code-review-specialist/` - Security analysis - `07-plugins/pr-review/` - Security checks ### Testing @@ -874,8 +874,8 @@ Want to add more examples? Follow the structure: --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks diff --git a/LEARNING-ROADMAP.md b/LEARNING-ROADMAP.md index 955a657..87e926c 100644 --- a/LEARNING-ROADMAP.md +++ b/LEARNING-ROADMAP.md @@ -244,7 +244,7 @@ Before starting Level 2, make sure you're comfortable with these Level 1 concept ```bash # Exercise 1: Install a skill -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Exercise 2: Set up hooks mkdir -p ~/.claude/hooks @@ -543,7 +543,7 @@ This repository includes two interactive skills you can use anytime in Claude Co 1. **Slash commands** (15 min): Copy and test `/optimize` and `/pr` 2. **Project memory** (15 min): Create CLAUDE.md with your project standards -3. **Install a skill** (15 min): Set up code-review skill +3. **Install a skill** (15 min): Set up code-review-specialist skill 4. **Try them together** (15 min): See how they work in harmony **Outcome**: Basic productivity boost with commands, memory, and auto-skills @@ -738,8 +738,8 @@ Once you've completed all milestones: --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks diff --git a/QUICK_REFERENCE.md b/QUICK_REFERENCE.md index ac635eb..3c3ccae 100644 --- a/QUICK_REFERENCE.md +++ b/QUICK_REFERENCE.md @@ -28,10 +28,10 @@ cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md ### Skills ```bash # Personal skills -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Project skills -cp -r 03-skills/code-review .claude/skills/ +cp -r 03-skills/code-review-specialist .claude/skills/ ``` ### Subagents @@ -130,7 +130,7 @@ claude -r "session" # Resume session by name/ID | **Git Worktrees** | Built-in | `/worktree` | | **Auto Memory** | Built-in | Auto-saves to CLAUDE.md | | **Task List** | Built-in | `/task list` | -| **Bundled Skills (9)** | Built-in | `/batch`, `/claude-api`, `/debug`, `/fewer-permission-prompts`, `/loop`, `/run` *(v2.1.145+)*, `/run-skill-generator` *(v2.1.145+)*, `/simplify`, `/verify` *(v2.1.145+)* | +| **Bundled Skills (9)** | Built-in | `/batch`, `/claude-api`, `/code-review` *(renamed from `/simplify` in v2.1.146)*, `/debug`, `/fewer-permission-prompts`, `/loop`, `/run` *(v2.1.145+)*, `/run-skill-generator` *(v2.1.145+)*, `/verify` *(v2.1.145+)* | --- @@ -147,7 +147,7 @@ cp 04-subagents/code-reviewer.md .claude/agents/ # Use: Auto-delegated # Method 3: Skill -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Use: Auto-invoked # Method 4: Plugin (best) @@ -363,7 +363,7 @@ cp 05-mcp/github-mcp.json .mcp.json ### Week 2 ```bash # Install skill -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Let it auto-invoke # Just say: "Review this code for issues" @@ -445,7 +445,7 @@ echo $GITHUB_TOKEN |------|----------|---------| | Quick shortcut | Slash Command (60+) | `01-slash-commands/optimize.md` | | Team standards | Memory | `02-memory/project-CLAUDE.md` | -| Auto workflow | Skill | `03-skills/code-review/` | +| Auto workflow | Skill | `03-skills/code-review-specialist/` | | Specialized task | Subagent | `04-subagents/code-reviewer.md` | | External data | MCP (+ Elicitation) | `05-mcp/github-mcp.json` | | Event automation | Hook (29 events, 5 types) | `06-hooks/pre-commit.sh` | @@ -508,8 +508,8 @@ Getting started checklist: **This Card**: Keep it handy for quick reference! --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks diff --git a/README.md b/README.md index 44bf482..12a7e88 100644 --- a/README.md +++ b/README.md @@ -102,7 +102,7 @@ Run `/lesson-quiz [topic]` after each module. The quiz pinpoints what you missed - **GitHub stars** from developers who use Claude Code daily - **Forks** from teams adapting this guide for their own workflows -- **Actively maintained** — synced with every Claude Code release (latest: v2.1.145, May 2026) +- **Actively maintained** — synced with every Claude Code release (latest: v2.1.150, May 2026) - **Community-driven** — contributions from developers who share their real-world configurations [![Star History Chart](https://api.star-history.com/svg?repos=luongnv89/claude-howto&type=Date)](https://star-history.com/#luongnv89/claude-howto&Date) @@ -158,7 +158,7 @@ cp 01-slash-commands/optimize.md /path/to/your-project/.claude/commands/ cp 02-memory/project-CLAUDE.md /path/to/your-project/CLAUDE.md # 5. Install a skill: -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ ``` Want the full setup? Here's the **1-hour essential setup**: @@ -171,7 +171,7 @@ cp 01-slash-commands/*.md .claude/commands/ cp 02-memory/project-CLAUDE.md ./CLAUDE.md # Install a skill (15 min) -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Weekend goal: add hooks, subagents, MCP, and plugins # Follow the learning path for guided setup @@ -201,7 +201,7 @@ cp -r 03-skills/code-review ~/.claude/skills/ Yes. MIT licensed, free forever. Use it in personal projects, at work, in your team — no restrictions beyond including the license notice. **Is this maintained?** -Actively. The guide is synced with every Claude Code release. Current version: v2.1.145 (May 2026), compatible with Claude Code 2.1+. +Actively. The guide is synced with every Claude Code release. Current version: v2.1.150 (May 2026), compatible with Claude Code 2.1+. **How is this different from the official docs?** The official docs are a feature reference. This guide is a tutorial with diagrams, production-ready templates, and a progressive learning path. They complement each other — start here to learn, reference the docs when you need specifics. @@ -280,7 +280,7 @@ cp 01-slash-commands/*.md .claude/commands/ cp 02-memory/project-CLAUDE.md ./CLAUDE.md # Skills -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Subagents cp 04-subagents/*.md .claude/agents/ @@ -373,17 +373,17 @@ cp 02-memory/personal-CLAUDE.md ~/.claude/CLAUDE.md **What**: Reusable, auto-invoked capabilities with instructions and scripts **Examples**: -- `code-review/` - Comprehensive code review with scripts +- `code-review-specialist/` - Comprehensive code review with scripts - `brand-voice/` - Brand voice consistency checker - `doc-generator/` - API documentation generator **Installation**: ```bash # Personal skills -cp -r 03-skills/code-review ~/.claude/skills/ +cp -r 03-skills/code-review-specialist ~/.claude/skills/ # Project skills -cp -r 03-skills/code-review /path/to/project/.claude/skills/ +cp -r 03-skills/code-review-specialist /path/to/project/.claude/skills/ ``` **Usage**: Automatically invoked when relevant @@ -664,7 +664,7 @@ Claude: │ ├── personal-CLAUDE.md │ └── README.md ├── 03-skills/ -│ ├── code-review/ +│ ├── code-review-specialist/ │ │ ├── SKILL.md │ │ ├── scripts/ │ │ └── templates/ @@ -871,8 +871,8 @@ MIT License - see [LICENSE](LICENSE). Free to use, modify, and distribute. The o --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog diff --git a/STYLE_GUIDE.md b/STYLE_GUIDE.md index 5331035..af46921 100644 --- a/STYLE_GUIDE.md +++ b/STYLE_GUIDE.md @@ -597,8 +597,8 @@ Lesson READMEs end with a metadata block: ```markdown --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Compatible Models**: Claude Sonnet 4.6, Claude Opus 4.7, Claude Haiku 4.5 ``` @@ -631,8 +631,8 @@ Before submitting content, verify: --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog diff --git a/claude_concepts_guide.md b/claude_concepts_guide.md index 925b12d..6fca89e 100644 --- a/claude_concepts_guide.md +++ b/claude_concepts_guide.md @@ -1312,7 +1312,7 @@ Claude Code now includes 5 bundled skills available out of the box: | Skill | Command | Purpose | |-------|---------|---------| -| **Simplify** | `/simplify` | Simplify complex code or explanations | +| **Code Review** | `/code-review` | Review the current diff for correctness bugs at a chosen effort level (renamed from `/simplify` in v2.1.146) | | **Batch** | `/batch` | Run operations across multiple files or items | | **Debug** | `/debug` | Systematic debugging of issues with root cause analysis | | **Loop** | `/loop` | Schedule recurring tasks on a timer | @@ -1327,7 +1327,7 @@ These bundled skills are always available and do not require installation or con **Directory Structure:** ``` -~/.claude/skills/code-review/ +~/.claude/skills/code-review-specialist/ ├── SKILL.md ├── templates/ │ ├── review-checklist.md @@ -1337,7 +1337,7 @@ These bundled skills are always available and do not require installation or con └── compare-complexity.py ``` -**File:** `~/.claude/skills/code-review/SKILL.md` +**File:** `~/.claude/skills/code-review-specialist/SKILL.md` ```yaml --- @@ -3133,7 +3133,7 @@ Claude Code supports three models with adaptive reasoning effort: > **Note**: v2.1.117 fixed a bug where Opus 4.7 sessions computed `/context` against 200K instead of the native 1M window — upgrade to v2.1.117 or later to actually get the 1M context on Opus 4.7. -> **Note**: `/cost` and `/stats` merged into `/usage` in v2.1.118. `/usage` is now the canonical command with tabs for cost/stats/etc.; `/cost` and `/stats` remain as shortcut aliases that open the corresponding tab. +> **Note**: `/cost` and `/stats` merged into `/usage` in v2.1.118. `/usage` is now the canonical command with tabs for cost/stats/etc.; `/cost` and `/stats` remain as shortcut aliases that open the corresponding tab. As of v2.1.149, the cost view also breaks spending down by category (skills, subagents, plugins, and per-MCP-server costs). ## Resources @@ -3143,8 +3143,8 @@ Claude Code supports three models with adaptive reasoning effort: - [Anthropic Cookbook](https://github.com/anthropics/anthropic-cookbook) --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/hooks diff --git a/resources.md b/resources.md index c66e8dd..14d8992 100644 --- a/resources.md +++ b/resources.md @@ -250,11 +250,10 @@ These steps capture the core recommendations for smooth workflows with Claude Co | **/goal mode** | Register a session-level completion condition; Claude keeps working until met (v2.1.139+) | [Slash Commands](01-slash-commands/) | | **claude agents (Agent View)** | List, inspect, and resume background agents from the terminal; `--json` for machine-readable output (v2.1.139+, `--json` added v2.1.145) | [code.claude.com/docs/en/agent-view](https://code.claude.com/docs/en/agent-view) | | **/run, /verify, /run-skill-generator** | Bundled skills to launch your project, confirm a fix works, and generate per-project run/verify skills (v2.1.145+) | [Skills Guide](03-skills/) | -| **Stop/SubagentStop hook fields** | Stop and SubagentStop hook inputs now include `background_tasks` and `session_crons` (v2.1.145+) | [Hooks Guide](06-hooks/) | --- -**Last Updated**: May 20, 2026 -**Claude Code Version**: 2.1.145 +**Last Updated**: May 25, 2026 +**Claude Code Version**: 2.1.150 **Sources**: - https://code.claude.com/docs/en/overview - https://code.claude.com/docs/en/changelog