From d58615df0719370a60757018ca8085e9f22b2fcd Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:54:40 +0500 Subject: [PATCH 01/21] =?UTF-8?q?chore(claude-settings):=20drift=20refresh?= =?UTF-8?q?=20to=20v2.1.138=20=E2=80=94=20add=207=20settings=20keys=20+=20?= =?UTF-8?q?6=20env=20vars?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Bump report version badge and body header from v2.1.126 → v2.1.138 (12-version gap). Add 7 settings keys: worktree.baseRef (v2.1.133), sandbox.bwrapPath / sandbox.socatPath (v2.1.133, managed Linux/WSL), skillOverrides (v2.1.129), parentSettingsBehavior (v2.1.133) and policyHelper (v2.1.136) in a new "Dynamic & Parent-Tier Policy" subsection under Settings Hierarchy. Extend autoMode description with the hard_deny array (v2.1.136). Add 6 new env vars (CLAUDE_CODE_SESSION_ID, CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN, CLAUDE_CODE_FORCE_SYNC_OUTPUT, CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE, CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY, CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL). Co-Authored-By: Claude --- best-practice/claude-settings.md | 25 ++++++++++++++++++++++--- 1 file changed, 22 insertions(+), 3 deletions(-) diff --git a/best-practice/claude-settings.md b/best-practice/claude-settings.md index b8c5352..e936c73 100644 --- a/best-practice/claude-settings.md +++ b/best-practice/claude-settings.md @@ -1,9 +1,9 @@ # Settings Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-May%2001%2C%202026%203%3A29%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.126-blue?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-May%2009%2C%202026%206%3A58%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.138-blue?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../.claude/settings.json) -A comprehensive guide to all available configuration options in Claude Code's `settings.json` files. As of v2.1.126, Claude Code exposes **60+ settings** and **175+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts). +A comprehensive guide to all available configuration options in Claude Code's `settings.json` files. As of v2.1.138, Claude Code exposes **60+ settings** and **175+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts). @@ -54,6 +54,15 @@ Within the managed tier, precedence is: server-managed > MDM/OS-level policies > > **Note (v2.1.126):** `/config` now persists changes to `~/.claude/settings.json` instead of holding them in memory only. Edits made through the interactive Config UI survive restarts. +### Dynamic & Parent-Tier Policy (Managed Only) + +These keys live in the managed tier and shape how managed settings themselves are computed and merged. They do not appear in user, project, or local settings. + +| Key | Type | Default | Description | +|-----|------|---------|-------------| +| `parentSettingsBehavior` | string | `"first-wins"` | Controls how the SDK `managedSettings` parent tier merges with the local managed file. `"first-wins"` keeps the existing precedence — the first non-empty managed source provides all values. `"merge"` deep-merges the parent tier on top of the local managed file so admins can layer org-wide policy on a managed base (v2.1.133) | +| `policyHelper` | object | - | Managed executable that computes managed settings dynamically at runtime. Object fields: `path` (string — absolute path to the helper binary), `timeoutMs` (number — abort the helper after this many ms), `refreshIntervalMs` (number — re-run the helper after this many ms to refresh policy). Output is parsed as JSON and treated as if it were the contents of `managed-settings.json`. Use to compute org policy from external systems (LDAP groups, asset DB, etc.) without redeploying static files (v2.1.136) | + **Important**: - `deny` rules have highest safety precedence and cannot be overridden by lower-priority allow/ask rules. - Managed settings may lock or override local behavior even if local files specify different values. @@ -87,6 +96,7 @@ Within the managed tier, precedence is: server-managed > MDM/OS-level policies > | `disableDeepLinkRegistration` | string | - | Set to `"disable"` to prevent Claude Code from registering the `claude-cli://` protocol handler with the operating system on startup. Deep links let external tools open a Claude Code session with a pre-filled prompt via `claude-cli://open?q=...`. The `q` parameter supports multi-line prompts using URL-encoded newlines (`%0A`). Useful in environments where protocol handler registration is restricted or managed separately | | `showThinkingSummaries` | boolean | `false` | Show extended thinking summaries in interactive sessions. When unset or `false` (default in interactive mode), thinking blocks are redacted by the API and shown as a collapsed stub. Redaction only changes what you see, not what the model generates — to reduce thinking spend, lower the budget or disable thinking instead. Non-interactive mode (`-p`) and SDK callers always receive summaries regardless of this setting | | `disableSkillShellExecution` | boolean | `false` | Disable inline shell execution for `` !`...` `` and `` ```! `` blocks in skills and custom commands from user, project, plugin, or additional-directory sources. Commands are replaced with `[shell command execution disabled by policy]` instead of being run. Bundled and managed skills are not affected (v2.1.91) | +| `skillOverrides` | string | - | Control automatic skill invocation behavior. Values: `"off"` (skills are not invoked at all), `"user-invocable-only"` (only skills the user explicitly invokes via `/skill-name` run; auto-discovery via skill descriptions is disabled), `"name-only"` (skills are matched by exact name only; description-based auto-discovery is disabled). Use to keep a tighter rein on which skills the model loads or runs (v2.1.129) | | `forceRemoteSettingsRefresh` | boolean | `false` | **(Managed only)** Block CLI startup until remote managed settings are freshly fetched. If the fetch fails, the CLI exits (fail-closed). Use in enterprise environments where policy enforcement must be up-to-date before any session begins (v2.1.92) | | `wslInheritsWindowsSettings` | boolean | `false` | **(Windows managed settings only)** When `true`, Claude Code on WSL reads managed settings from the Windows policy chain (HKLM registry + `C:\Program Files\ClaudeCode\managed-settings.json`) in addition to `/etc/claude-code`, with Windows sources taking priority. Only honored when set in the HKLM registry key or `C:\Program Files\ClaudeCode\managed-settings.json`, both of which require Windows admin to write. For HKCU policy to also apply on WSL, the flag must additionally be set in HKCU itself. Has no effect on native Windows (v2.1.118) | | `tui` | string | `"default"` | Rendering mode: `"fullscreen"` or `"default"`. Set via `/tui fullscreen` for flicker-free alt-screen rendering (v2.1.110) | @@ -131,6 +141,7 @@ Configure how `--worktree` creates and manages git worktrees. Useful for reducin |-----|------|---------|-------------| | `worktree.symlinkDirectories` | array | `[]` | Directories to symlink from the main repository into each worktree to avoid duplicating large directories on disk | | `worktree.sparsePaths` | array | `[]` | Directories to check out in each worktree via git sparse-checkout (cone mode). Only the listed paths are written to disk | +| `worktree.baseRef` | string | `"fresh"` | Branch source for new worktrees: `"fresh"` creates the worktree from a fresh fetch of the main branch HEAD; `"head"` branches from the current HEAD of the calling repository. Use `"head"` when you want the worktree to inherit your in-progress work (v2.1.133) | **Example:** ```json @@ -236,7 +247,7 @@ Control what tools and operations Claude can perform. | `permissions.disableBypassPermissionsMode` | string | Prevent bypass mode activation | | `permissions.skipDangerousModePermissionPrompt` | boolean | Skip the confirmation prompt shown before entering bypass permissions mode via `--dangerously-skip-permissions` or `defaultMode: "bypassPermissions"`. Ignored when set in project settings (`.claude/settings.json`) to prevent untrusted repositories from auto-bypassing the prompt | | `allowManagedPermissionRulesOnly` | boolean | **(Managed only)** Only managed permission rules apply; user/project `allow`, `ask`, `deny` rules are ignored | -| `autoMode` | object | Customize what the [auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) classifier blocks and allows. Contains `environment` (trusted infrastructure descriptions), `allow` (exceptions to block rules), and `soft_deny` (block rules) — all arrays of prose strings. **Not read from shared project settings** (`.claude/settings.json`) to prevent repo injection. Available in user, local, and managed settings. Setting `allow` or `soft_deny` **replaces** the entire default list for that section unless you include the literal string `"$defaults"` in the array — the sentinel inherits the built-in rules at that position so custom entries are added alongside them (v2.1.118). Run `claude auto-mode defaults` to see built-in rules before customizing | +| `autoMode` | object | Customize what the [auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) classifier blocks and allows. Contains `environment` (trusted infrastructure descriptions), `allow` (exceptions to block rules), `soft_deny` (block rules), and `hard_deny` (unconditional block rules — sibling to `soft_deny` but cannot be overridden by `allow` exceptions or the `"$defaults"` sentinel; v2.1.136) — all arrays of prose strings. **Not read from shared project settings** (`.claude/settings.json`) to prevent repo injection. Available in user, local, and managed settings. Setting `allow`, `soft_deny`, or `hard_deny` **replaces** the entire default list for that section unless you include the literal string `"$defaults"` in the array — the sentinel inherits the built-in rules at that position so custom entries are added alongside them (v2.1.118). Run `claude auto-mode defaults` to see built-in rules before customizing | | `disableAutoMode` | string | Set to `"disable"` to prevent [auto mode](https://code.claude.com/docs/en/permission-modes#eliminate-prompts-with-auto-mode) from being activated. Removes `auto` from the `Shift+Tab` cycle and rejects `--permission-mode auto` at startup. Can be set at any settings level; most useful in managed settings where users cannot override it | | `useAutoModeDuringPlan` | boolean | Whether plan mode uses auto mode semantics when auto mode is available. Default: `true`. Not read from shared project settings (`.claude/settings.json`). Appears in `/config` as "Use auto mode during plan" | @@ -418,6 +429,8 @@ Configure bash command sandboxing for security. | `sandbox.filesystem.allowRead` | array | `[]` | Paths to re-allow read access within `denyRead` regions. Takes precedence over `denyRead`. Arrays are merged across all settings scopes. Same path prefix conventions as `allowWrite` | | `sandbox.filesystem.allowManagedReadPathsOnly` | boolean | `false` | **(Managed only)** Only `allowRead` paths from managed settings are respected. `allowRead` entries from user, project, and local settings are ignored | | `sandbox.enableWeakerNetworkIsolation` | boolean | `false` | (macOS only) Allow access to system TLS trust (`com.apple.trustd.agent`); reduces security | +| `sandbox.bwrapPath` | string | - | **(Linux/WSL managed-only)** Custom path to the `bwrap` (bubblewrap) binary used to create the sandbox. Use when `bwrap` is installed at a non-standard location or shipped via a managed image. Honored only from managed settings (v2.1.133) | +| `sandbox.socatPath` | string | - | **(Linux/WSL managed-only)** Custom path to the `socat` binary used by the sandbox network proxy. Use when `socat` is installed at a non-standard location or shipped via a managed image. Honored only from managed settings (v2.1.133) | **Example:** ```json @@ -803,6 +816,7 @@ Set environment variables for all Claude Code sessions. | `ANTHROPIC_DEFAULT_HAIKU_MODEL_DESCRIPTION` | Customize the Haiku entry description in the `/model` picker. Defaults to `Custom model ()` | | `ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTED_CAPABILITIES` | Override capability detection for a pinned Haiku model. Comma-separated values (e.g., `effort,thinking`). Required when the pinned model supports features the auto-detection cannot confirm | | `CLAUDECODE` | Set to `1` in shell environments Claude Code spawns (Bash tool, tmux sessions). Not set in hooks or status line commands. Use to detect when a script is running inside a Claude Code shell | +| `CLAUDE_CODE_SESSION_ID` | Read-only. Set automatically in the Bash subprocess environment to the current Claude Code session's ID. Use from a Bash command, hook, or skill helper to correlate logs, metrics, or telemetry with a specific session without parsing the transcript path (v2.1.132) | | `AI_AGENT` | Set automatically by Claude Code in subprocess environments (Bash tool, hooks, MCP stdio servers). Generic flag identifying the parent process as an AI agent — useful for tools that adapt behavior when invoked from any AI agent rather than checking each agent-specific variable like `CLAUDECODE` *(in v2.1.120 changelog, not yet on official env-vars page)* | | `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Set to `1` to allow fast mode when the organization status check fails due to a network error. Useful when a corporate proxy blocks the status endpoint | | `CLAUDE_CODE_USE_BEDROCK` | Use AWS Bedrock (`1` to enable) | @@ -936,8 +950,13 @@ Set environment variables for all Claude Code sessions. | `CLAUDE_CODE_NO_FLICKER` | Set to `1` to enable flicker-free alt-screen rendering. Eliminates visual flicker during fullscreen redraws (v2.1.88) | | `CLAUDE_CODE_SCROLL_SPEED` | Mouse wheel scroll multiplier for fullscreen rendering. Increase for faster scrolling, decrease for finer control | | `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Set to `1` to disable virtual scrolling in fullscreen rendering and render every message in the transcript. Use if scrolling in fullscreen mode shows blank regions where messages should appear | +| `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` | Set to `1` to opt out of the alternate-screen (fullscreen) renderer entirely and use the classic scrollback renderer. Useful when terminal multiplexers, recording tools, or accessibility tooling do not handle the alt-screen buffer cleanly (v2.1.132) | | `CLAUDE_CODE_DISABLE_MOUSE` | Set to `1` to disable mouse tracking in fullscreen rendering. Useful when mouse events interfere with terminal multiplexers or accessibility tools | | `CLAUDE_CODE_HIDE_CWD` | Set to `1` to hide the current working directory in the Claude Code startup logo banner. Useful in screen recordings, demos, or shared sessions where the CWD path leaks information about the host or project layout (v2.1.119) | +| `CLAUDE_CODE_FORCE_SYNC_OUTPUT` | Set to `1` to force synchronous output flushing for Claude Code's writes to the terminal. Defaults to async/buffered output for performance. Use as a debugging aid when terminal output appears interleaved or out-of-order with subprocess output (v2.1.129) | +| `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` | Control background package-manager-based auto-update checking for Claude Code. Set to `0` to disable the background check (Claude Code will not poll the package manager for newer versions); set to `1` (default) to keep the background check enabled. Independent of `DISABLE_AUTOUPDATER`, which gates the npm-registry auto-updater (v2.1.129) | +| `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` | Set to `1` to opt into fetching the available-models list from the configured LLM gateway (e.g., a corporate proxy in front of Bedrock/Vertex). When enabled, the `/model` picker is populated from the gateway's discovery endpoint instead of the built-in alias list. Use when your gateway exposes a curated subset of models the user should choose from (v2.1.129) | +| `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` | Set to `1` to re-enable the in-session quality survey for OpenTelemetry-enabled enterprises. The survey is suppressed by default when `OTEL_*` env vars or `feedbackSurveyRate` are configured to avoid leaking survey traffic into enterprise telemetry pipelines. Use when admins want sampled survey data despite an OTel deployment (v2.1.136) | | `CLAUDE_CODE_ACCESSIBILITY` | Set to `1` to keep native terminal cursor visible for screen readers and accessibility tools | | `CLAUDE_CODE_SYNTAX_HIGHLIGHT` | Set to `0` to disable syntax highlighting in diff output | | `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Skip automatic IDE extension installation (`1` to skip) | From cdd557059c544b83824cbb77adce0d4284cecd43 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:55:39 +0500 Subject: [PATCH 02/21] chore(claude-settings): append 2026-05-09 v2.1.138 changelog entry Records this run's drift triage: 14 HIGH actions COMPLETE (7 settings + 6 env vars + version bump), 7 MED items ON HOLD (deferred per user scope), 2 INVALID items (false-positive drift claims from agents). Co-Authored-By: Claude --- .../claude-settings/changelog.md | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) diff --git a/changelog/best-practice/claude-settings/changelog.md b/changelog/best-practice/claude-settings/changelog.md index b9d4b05..cfff83f 100644 --- a/changelog/best-practice/claude-settings/changelog.md +++ b/changelog/best-practice/claude-settings/changelog.md @@ -505,4 +505,37 @@ | 11 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ✋ ON HOLD (kept — recurring from 2026-04-16 v2.1.110) | | 12 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` reported `autoSummaryEnabled` as a separate setting from `awaySummaryEnabled` (HIGH-confidence claim). Verified directly against official settings page — `autoSummaryEnabled` does NOT exist; only `awaySummaryEnabled` is documented | ❌ INVALID (agent contradicted by direct doc verification) | | 13 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` claimed `Agent` permission rule syntax should be `Agent(agent:name)` with an `agent:` prefix. Verified against official settings page — only references `Agent` rules without showing the `agent:` prefix syntax. Report's existing `Agent(name)` form matches established convention; no source confirms the prefix variant | ❌ INVALID (no source-verified evidence for `agent:` prefix) | + +--- + +## [2026-05-09 06:58 PM PKT] Claude Code v2.1.138 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Version Bump | Update report version badge from v2.1.126 → v2.1.138 and header "As of v2.1.126" → "As of v2.1.138" | ✅ COMPLETE (badge updated in Phase 2.6; body header line 6 updated to v2.1.138) | +| 2 | HIGH | New Setting | Add `worktree.baseRef` to Worktree Settings — string, values `"fresh"` or `"head"`, controls whether new worktrees branch from a fresh main HEAD or the current HEAD. Confirmed in v2.1.133 changelog | ✅ COMPLETE (added after `worktree.sparsePaths` with default `"fresh"` and v2.1.133 attribution) | +| 3 | HIGH | New Setting | Add `sandbox.bwrapPath` to Sandbox table — string (Linux/WSL managed-only), custom path to `bwrap` (bubblewrap) binary. Confirmed in v2.1.133 changelog | ✅ COMPLETE (added after `sandbox.enableWeakerNetworkIsolation` with managed-only annotation) | +| 4 | HIGH | New Setting | Add `sandbox.socatPath` to Sandbox table — string (Linux/WSL managed-only), custom path to `socat` binary. Confirmed in v2.1.133 changelog | ✅ COMPLETE (added after `sandbox.bwrapPath` with managed-only annotation) | +| 5 | HIGH | Changed Behavior | Update `autoMode` description to document the new `hard_deny` array — auto-mode classifier rules that block unconditionally, sibling to `allow` and `soft_deny`. Confirmed in v2.1.136 changelog | ✅ COMPLETE (description extended with `hard_deny` semantics, sentinel-incompatibility note, and v2.1.136 attribution) | +| 6 | HIGH | New Setting | Add `parentSettingsBehavior` (managed-only) to Settings Hierarchy section — string `"first-wins"` or `"merge"`, controls how SDK `managedSettings` parent tier merges. Confirmed in v2.1.133 changelog | ✅ COMPLETE (added to new "Dynamic & Parent-Tier Policy" subsection under Settings Hierarchy) | +| 7 | HIGH | New Setting | Add `policyHelper` (managed-only) to a managed-policy subsection — object with `path`, `timeoutMs`, `refreshIntervalMs`. Managed executable that computes managed settings dynamically. Confirmed in v2.1.136 changelog | ✅ COMPLETE (added to new "Dynamic & Parent-Tier Policy" subsection with field reference and use-case note) | +| 8 | HIGH | New Setting | Add `skillOverrides` to General Settings — string `"off"` / `"user-invocable-only"` / `"name-only"`, controls automatic skill invocation behavior. Confirmed in v2.1.129 changelog | ✅ COMPLETE (added after `disableSkillShellExecution` with all 3 enum values and v2.1.129 attribution) | +| 9 | HIGH | New Env Var | Add `CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL` to env vars table — re-enables session-quality feedback survey for OpenTelemetry-enabled enterprises. v2.1.136 changelog | ✅ COMPLETE (added in display/UI env vars cluster after `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY`) | +| 10 | HIGH | New Env Var | Add `CLAUDE_CODE_SESSION_ID` to env vars table — current session ID injected into Bash subprocess environment. v2.1.132 changelog | ✅ COMPLETE (added after `CLAUDECODE` with read-only annotation and v2.1.132 attribution) | +| 11 | HIGH | New Env Var | Add `CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN` to env vars table — opt out of fullscreen renderer; use classic scrollback. v2.1.132 changelog | ✅ COMPLETE (added after `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL`) | +| 12 | HIGH | New Env Var | Add `CLAUDE_CODE_FORCE_SYNC_OUTPUT` to env vars table — force synchronous output (debugging aid). v2.1.129 changelog | ✅ COMPLETE (added after `CLAUDE_CODE_HIDE_CWD`) | +| 13 | HIGH | New Env Var | Add `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE` to env vars table — controls background package-manager-auto-update behavior. v2.1.129 changelog | ✅ COMPLETE (added after `CLAUDE_CODE_FORCE_SYNC_OUTPUT` with cross-reference to `DISABLE_AUTOUPDATER`) | +| 14 | HIGH | New Env Var | Add `CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY` to env vars table — opt-in to fetching available models from LLM gateway. v2.1.129 changelog | ✅ COMPLETE (added after `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`) | +| 15 | MED | New Env Var (Hook Input) | Add `$CLAUDE_EFFORT` to env vars table — Bash subprocess and hook input env exposing the active effort level (companion to `CLAUDE_CODE_EFFORT_LEVEL`). Hooks also receive `effort.level` JSON field. v2.1.133 changelog | ✋ ON HOLD (deferred — user scoped this run to HIGH priority items only; will pick up next run) | +| 16 | MED | Plugin Marketplace | Add brief note that plugin marketplace `source: 'settings'` is now supported for inline plugin entries directly in settings.json (v2.1.137 changelog) | ON HOLD (awaiting user approval) | +| 17 | MED | MCP Reserved Name | Add `workspace` to a "Reserved server names" note in MCP Servers section — v2.1.128 reserved this name for the workspace MCP integration | ON HOLD (awaiting user approval) | +| 18 | MED | Missing Setting | Add `disableRemoteControl` to Permissions/Managed-only settings — official permissions docs explicitly note "Remote Control can additionally be disabled per device with the `disableRemoteControl` managed setting" | ON HOLD (awaiting user approval) | +| 19 | MED | Missing Setting | Add `claudeMdExcludes` to Core Configuration — array, skip CLAUDE.md files matching globs. Listed on official settings page | ON HOLD (awaiting user approval) | +| 20 | MED | Missing Setting | Add `autoMemoryEnabled` to Core Configuration — boolean (default `true`), enables auto memory. Currently only `autoMemoryDirectory` is listed | ON HOLD (awaiting user approval) | +| 21 | MED | Example Update | Update Quick Reference example to showcase v2.1.129–v2.1.138 features — `worktree.baseRef`, `autoMode.hard_deny`, `skillOverrides`, plus a new env var | ON HOLD (awaiting user approval) | +| 22 | LOW | Header Count | Update header claim from "60+ settings" → "80+ settings" to better reflect actual official count after additions | ON HOLD (awaiting user approval) | +| 23 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_DETAILS` still "in v2.1.85 changelog, not yet on official env-vars page" after 17+ consecutive runs. Per Rule 10B, deferred pending official docs update | ON HOLD (kept — recurring from 2026-04-14 v2.1.107) | +| 24 | LOW | Suspect Key Recurrence | `OTEL_LOG_TOOL_CONTENT` still changelog-only. Defer per Rule 8A | ON HOLD (kept — recurring from 2026-04-16 v2.1.110) | +| 25 | INVALID | Spurious Drift Claim | `claude-code-guide` agent listed `disableSkillShellExecution` as NEW in v2.1.137. Verified against current report (line 89) — already documented in General Settings table | ❌ INVALID (already in report; pre-existing key) | +| 26 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` flagged `syntaxHighlightingDisabled` as missing settings.json key. Could not confirm it as a `settings.json` key on official docs (the env var `CLAUDE_CODE_SYNTAX_HIGHLIGHT` is documented, the settings-key form was not source-verified). Per Rule 8A | ❌ INVALID (no source-verified evidence the settings.json key exists) | | 14 | INVALID | Spurious Drift Claim | `workflow-claude-settings-agent` flagged `model` default (`"default"`) and `language` default (`"english"`) in Core Configuration as cosmetically wrong because the official docs show `-`. The report's values are descriptive placeholders explaining behavior when unset; flipping to `-` would lose information without any user-facing benefit | ❌ INVALID (cosmetic re-verification with no user-facing benefit) | From 9826dcb0790d703fb38bf0ff2cd4a7e4833ecda1 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:00 +0500 Subject: [PATCH 03/21] =?UTF-8?q?chore(readme):=20refresh=20tables=20?= =?UTF-8?q?=E2=80=94=20workflows=20star+command=20updates,=20skill=20colle?= =?UTF-8?q?ctions=20rerank,=20badge=20to=20v2.1.138?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit DEVELOPMENT WORKFLOWS table: Superpowers (175k→184k, agents 5→0 after v5.1.0 removed superpowers:code-reviewer, +verification-before-completion step), ECC (171k→176k, commands 143→71, skills 230→182, replaced chain with PRP-prefix family), Spec Kit (92k→94k, dropped clarify, added checklist+taskstoissues), gstack (88k→92k, skills 43→56, renamed implement→autoplan, +devex-review and canary), GSD (59k→61k, +map-codebase entry and new-milestone final), Matt Pocock (51k→67k, skills 22→13 from plugin.json manifest, rerank to row 5), BMAD (46k→47k, agents 0→6 persona-skills, interleaved chain), OpenSpec (45k→47k, +explore/verify/sync), oh-my-claudecode (32k→33k, commands 0→27 shim files, replaced with v4.13.x flow), Compound Engineering (skills 39→38, new strategy/debug/doc-review/product-pulse), HumanLayer (+research/describe-pr/ handoff). SKILL COLLECTIONS table: anthropics 127k→131k, mattpocock 51k→68k (skills 18→19), wshobson skills 152→153, addyosmani 27k→37k (skills 21→22, promoted to row 3), scientific 134→137, VoltAgent 20k→21k (curated 930+→938, promoted to row 5). Badge to v2.1.138 / May 09 2026 7:06 PM PKT. Co-Authored-By: Claude --- README.md | 36 ++++++++++++++++++------------------ 1 file changed, 18 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 5bebd57..a4e73be 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # claude-code-best-practice from vibe coding to agentic engineering - practice makes claude perfect -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.128%20(May%2008%2C%202026%208%3A46%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2009%2C%202026%207%3A06%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
= Agents · = Commands · = Skills @@ -103,18 +103,18 @@ All major workflows converge on the same architectural pattern: **Research → P | Name | ★ | Workflow | | | | |------|---|----------|---|---|---| -| [Superpowers](https://github.com/obra/superpowers) | 175k | brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → test-driven-development → requesting-code-review → finishing-a-development-branch | 5 | 3 | 14 | -| [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | 171k | /ecc:plan → /tdd → /code-review → /security-scan → /e2e → merge | 48 | 143 | 230 | -| [Spec Kit](https://github.com/github/spec-kit) | 92k | /speckit.constitution → /speckit.clarify → /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement | 0 | 9 | 0 | -| [gstack](https://github.com/garrytan/gstack) | 88k | /office-hours → /plan-ceo-review → /plan-eng-review → /plan-design-review → implement → /review → /qa → /ship → /land-and-deploy | 0 | 0 | 43 | -| [Get Shit Done](https://github.com/gsd-build/get-shit-done) | 59k | /gsd-new-project → /gsd-discuss-phase → /gsd-plan-phase → /gsd-execute-phase → /gsd-verify-work → /gsd-ship → /gsd-complete-milestone | 33 | 65 | 0 | -| [Matt Pocock Skills](https://github.com/mattpocock/skills) | 51k | /grill-with-docs → /to-prd → /to-issues → /triage → /tdd → /diagnose → /improve-codebase-architecture → /zoom-out | 0 | 0 | 22 | -| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | 46k | bmad-product-brief → bmad-create-prd → bmad-create-architecture → bmad-create-epics-and-stories → bmad-sprint-planning → bmad-create-story → bmad-dev-story → bmad-code-review → bmad-retrospective | 0 | 0 | 40 | -| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | 45k | /opsx:propose → /opsx:apply → /opsx:archive | 0 | 11 | 0 | -| [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) | 32k | /deep-interview → /team → team-plan → team-prd → team-exec → team-verify → team-fix → /ralph → merge | 19 | 0 | 38 | +| [Superpowers](https://github.com/obra/superpowers) | 184k | brainstorming → using-git-worktrees → writing-plans → subagent-driven-development → test-driven-development → requesting-code-review → verification-before-completion → finishing-a-development-branch | 0 | 0 | 14 | +| [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | 176k | prp-prd → prp-plan → prp-implement → build-fix → code-review → quality-gate → prp-commit → prp-pr | 48 | 71 | 182 | +| [Spec Kit](https://github.com/github/spec-kit) | 94k | /speckit.constitution → /speckit.specify → /speckit.plan → /speckit.tasks → /speckit.implement → /speckit.checklist → /speckit.taskstoissues | 0 | 9 | 0 | +| [gstack](https://github.com/garrytan/gstack) | 92k | /office-hours → /plan-ceo-review → /plan-eng-review → /plan-design-review → /plan-devex-review → /autoplan → /review → /qa → /ship → /land-and-deploy → /canary | 0 | 0 | 56 | +| [Matt Pocock Skills](https://github.com/mattpocock/skills) | 67k | /grill-with-docs → /to-prd → /tdd → /diagnose → /zoom-out → /improve-codebase-architecture → /to-issues → /triage | 0 | 0 | 13 | +| [Get Shit Done](https://github.com/gsd-build/get-shit-done) | 61k | /gsd-map-codebase → /gsd-new-project → /gsd-discuss-phase → /gsd-plan-phase → /gsd-execute-phase → /gsd-verify-work → /gsd-ship → /gsd-complete-milestone → /gsd-new-milestone | 33 | 66 | 0 | +| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | 47k | bmad-agent-analyst → bmad-prfaq → bmad-agent-pm → bmad-create-prd → bmad-agent-ux-designer → bmad-agent-architect → bmad-create-architecture → bmad-create-epics-and-stories → bmad-agent-dev → bmad-dev-story → bmad-code-review → bmad-retrospective | 6 | 0 | 40 | +| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | 47k | /opsx:explore → /opsx:propose → /opsx:apply → /opsx:verify → /opsx:sync → /opsx:archive | 0 | 11 | 0 | +| [oh-my-claudecode](https://github.com/Yeachan-Heo/oh-my-claudecode) | 33k | /omc-setup → /deepinit → /plan → /autopilot → /ultrawork → /verify → /ultraqa → /release | 19 | 27 | 38 | | [agent-skills](https://github.com/addyosmani/agent-skills) | 27k | /spec → /plan → /build → /test → /review → /ship | 3 | 7 | 21 | -| [Compound Engineering](https://github.com/EveryInc/compound-engineering-plugin) | 16k | /ce-ideate → /ce-brainstorm → /ce-plan → /ce-work → /ce-code-review → /ce-debug → /ce-optimize → /ce-compound → /ce-compound-refresh | 49 | 4 | 39 | -| [HumanLayer](https://github.com/humanlayer/humanlayer) | 11k | /create_plan → /validate_plan → /implement_plan → /iterate_plan → /local_review → /commit | 6 | 27 | 0 | +| [Compound Engineering](https://github.com/EveryInc/compound-engineering-plugin) | 16k | /ce-strategy → /ce-ideate → /ce-brainstorm → /ce-plan → /ce-work → /ce-debug → /ce-code-review → /ce-doc-review → /ce-compound → /ce-product-pulse | 49 | 4 | 38 | +| [HumanLayer](https://github.com/humanlayer/humanlayer) | 11k | /research_codebase → /create_plan → /validate_plan → /iterate_plan → /implement_plan → /local_review → /describe_pr → /commit → /create_handoff | 6 | 27 | 0 | > *Note: yellow tags are sub-loops — steps that repeat inside a parent step (e.g. per task, per story, or until a verify condition passes).* @@ -137,12 +137,12 @@ Repos primarily known as curated libraries of `SKILL.md` files (distinct from fu | Name | ★ | | |------|---|---| -| [anthropics/skills](https://github.com/anthropics/skills) | 127k | 17 | -| [mattpocock/skills](https://github.com/mattpocock/skills) | 51k | 18 | -| [wshobson/agents](https://github.com/wshobson/agents) | 35k | 152 | -| [agent-skills](https://github.com/addyosmani/agent-skills) | 27k | 21 | -| [scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) | 20k | 134 | -| [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) | 20k | 930+ (curated list) | +| [anthropics/skills](https://github.com/anthropics/skills) | 131k | 17 | +| [mattpocock/skills](https://github.com/mattpocock/skills) | 68k | 19 | +| [agent-skills](https://github.com/addyosmani/agent-skills) | 37k | 22 | +| [wshobson/agents](https://github.com/wshobson/agents) | 35k | 153 | +| [awesome-agent-skills](https://github.com/VoltAgent/awesome-agent-skills) | 21k | 938 (curated list) | +| [scientific-agent-skills](https://github.com/K-Dense-AI/scientific-agent-skills) | 20k | 137 |

section divider From 6902a5df3ff4e7563125e40fc0e4e200c3a8a119 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:10 +0500 Subject: [PATCH 04/21] chore(claude-commands): add /radio + /rewind, refine /clear /review /context signatures, bump to v2.1.138 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Insert /radio under Config tag (#12) — opens Claude FM lo-fi radio in browser, prints stream URL when no browser is available; not on Bedrock/Vertex/Foundry. Add /rewind under Session tag (#76) — checkpointing alias for /checkpoint and /undo. Update three signatures with optional arguments: /clear → /clear [name] (label previous conversation in /resume picker), /review → /review [PR] (accept optional PR), /context → /context [all] (expand per-item breakdown). Total grows 75 → 76 with renumbering. Badge to v2.1.138 / May 09 2026 6:58 PM PKT. Co-Authored-By: Claude --- best-practice/claude-commands.md | 133 ++++++++++++++++--------------- 1 file changed, 67 insertions(+), 66 deletions(-) diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md index 8070385..a6569e9 100644 --- a/best-practice/claude-commands.md +++ b/best-practice/claude-commands.md @@ -1,6 +1,6 @@ # Commands Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-May%2001%2C%202026%203%3A31%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.126-blue?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-May%2009%2C%202026%206%3A58%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.138-blue?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-commands-implementation.md) Claude Code commands — frontmatter fields and official built-in slash commands. @@ -36,7 +36,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands --- -## ![Official](../!/tags/official.svg) **(75)** +## ![Official](../!/tags/official.svg) **(76)** | # | Command | Tag | Description | |---|---------|-----|-------------| @@ -51,70 +51,71 @@ Claude Code commands — frontmatter fields and official built-in slash commands | 9 | `/keybindings` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Open or create your keybindings configuration file | | 10 | `/permissions` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Manage allow, ask, and deny rules for tool permissions. Opens an interactive dialog where you can view rules by scope, add or remove rules, manage working directories, and review recent auto mode denials. Alias: `/allowed-tools` | | 11 | `/privacy-settings` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | View and update your privacy settings. Only available for Pro and Max plan subscribers | -| 12 | `/sandbox` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Toggle sandbox mode. Available on supported platforms only | -| 13 | `/statusline` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Configure Claude Code's status line. Describe what you want, or run without arguments to auto-configure from your shell prompt | -| 14 | `/stickers` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Order Claude Code stickers | -| 15 | `/terminal-setup` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Cursor, Windsurf, Alacritty, or Zed | -| 16 | `/theme` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Change the color theme. Includes light and dark variants, colorblind-accessible (daltonized) themes, ANSI themes that use your terminal's color palette, an "Auto (match terminal)" option that follows your terminal's light/dark mode, and custom themes loaded from `~/.claude/themes/` or plugins. Select "New custom theme…" to create your own | -| 17 | `/tui [default\|fullscreen]` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Set the terminal UI renderer and relaunch Claude Code with the current conversation intact. `default` uses inline rendering; `fullscreen` uses an alt-screen TUI | -| 18 | `/voice [hold\|tap\|off]` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Toggle voice dictation, or enable it in a specific mode. Requires a Claude.ai account | -| 19 | `/context` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings | -| 20 | `/cost` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Alias for `/usage` | -| 21 | `/extra-usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Configure extra usage to keep working when rate limits are hit | -| 22 | `/insights` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points | -| 23 | `/stats` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Alias for `/usage`. Opens on the Stats tab | -| 24 | `/status` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Open the Settings interface (Status tab) showing version, model, account, and connectivity. Works while Claude is responding, without waiting for the current response to finish | -| 25 | `/usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show session cost, plan usage limits, and activity stats. `/cost` and `/stats` are aliases | -| 26 | `/doctor` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press `f` to have Claude fix any reported issues | -| 27 | `/feedback [report]` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Submit feedback about Claude Code. Alias: `/bug` | -| 28 | `/heapdump` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Write a JavaScript heap snapshot and memory breakdown to `~/Desktop` for diagnosing high memory usage. Useful when filing bug reports about memory growth | -| 29 | `/help` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Show help and available commands | -| 30 | `/powerup` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Discover Claude Code features through quick interactive lessons with animated demos | -| 31 | `/release-notes` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | View the changelog in an interactive version picker. Select a specific version to see its release notes, or choose to show all versions | -| 32 | `/tasks` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | List and manage background tasks. Alias: `/bashes` | -| 33 | `/copy [N]` | ![Export](https://img.shields.io/badge/Export-7F8C8D?style=flat) | Copy the last assistant response to clipboard. Pass a number `N` to copy the Nth-latest response: `/copy 2` copies the second-to-last. When code blocks are present, shows an interactive picker to select individual blocks or the full response. Press `w` in the picker to write the selection to a file instead of the clipboard, which is useful over SSH | -| 34 | `/export [filename]` | ![Export](https://img.shields.io/badge/Export-7F8C8D?style=flat) | Export the current conversation as plain text. With a filename, writes directly to that file. Without, opens a dialog to copy to clipboard or save to a file | -| 35 | `/agents` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage agent configurations | -| 36 | `/chrome` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Configure Claude in Chrome settings | -| 37 | `/hooks` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | View hook configurations for tool events | -| 38 | `/ide` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage IDE integrations and show status | -| 39 | `/mcp` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage MCP server connections and OAuth authentication | -| 40 | `/plugin` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage Claude Code plugins | -| 41 | `/reload-plugins` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors | -| 42 | `/skills` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | List available skills. Press `t` to sort by token count | -| 43 | `/memory` | ![Memory](https://img.shields.io/badge/Memory-3498DB?style=flat) | Edit `CLAUDE.md` memory files, enable or disable auto-memory, and view auto-memory entries | -| 44 | `/effort [low\|medium\|high\|xhigh\|max\|auto]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Set the model effort level. Available levels depend on the model and include `low`, `medium`, `high`, `xhigh`, and `max` (session-only). Without an argument, opens an interactive slider to pick the level. `auto` resets to the model default. Takes effect immediately without waiting for the current response to finish | -| 45 | `/fast [on\|off]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Toggle fast mode on or off | -| 46 | `/model [model]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Select or change the AI model. For models that support it, use left/right arrows to adjust effort level. The change takes effect immediately without waiting for the current response to finish. When switching mid-conversation after prior output, Claude warns before applying the change | -| 47 | `/passes` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Share a free week of Claude Code with friends. Only visible if your account is eligible | -| 48 | `/plan [description]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Enter plan mode directly from the prompt. Pass an optional description to enter plan mode and immediately start with that task, for example `/plan fix the auth bug` | -| 49 | `/ultraplan ` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Draft a plan in an ultraplan session, review it in your browser, then execute remotely or send it back to your terminal | -| 50 | `/add-dir ` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Add a working directory for file access during the current session. Most `.claude/` configuration is not discovered from the added directory | -| 51 | `/diff` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use left/right arrows to switch between the current git diff and individual Claude turns, and up/down to browse files | -| 52 | `/init` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Initialize project with a `CLAUDE.md` guide. Set `CLAUDE_CODE_NEW_INIT=1` for an interactive flow that also walks through skills, hooks, and personal memory files | -| 53 | `/review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review a pull request locally in your current session. For a deeper cloud-based review, see `/ultrareview` | -| 54 | `/security-review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Analyze pending changes on the current branch for security vulnerabilities. Reviews the git diff and identifies risks like injection, auth issues, and data exposure | -| 55 | `/team-onboarding` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Generate a team onboarding guide from your Claude Code usage history. Analyzes sessions, commands, and MCP server usage from the past 30 days | -| 56 | `/ultrareview [PR]` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Run a deep, multi-agent code review of the given pull request in a cloud sandbox. Produces a structured review with prioritized findings; complements the local `/review` command | -| 57 | `/autofix-pr [prompt]` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Spawn a Claude Code on the web session that watches the current branch's PR and pushes fixes when CI fails or reviewers leave comments. Detects the open PR from your checked-out branch with `gh pr view`; to watch a different PR, check out its branch first. Requires the `gh` CLI and access to Claude Code on the web | -| 58 | `/desktop` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: `/app` | -| 59 | `/install-github-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration | -| 60 | `/install-slack-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Install the Claude Slack app. Opens a browser to complete the OAuth flow | -| 61 | `/mobile` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Show QR code to download the Claude mobile app. Aliases: `/ios`, `/android` | -| 62 | `/remote-control` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Make this session available for remote control from claude.ai. Alias: `/rc` | -| 63 | `/remote-env` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Configure the default remote environment for web sessions started with `--remote` | -| 64 | `/schedule [description]` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Create, update, list, or run routines. Claude walks you through the setup conversationally. Alias: `/routines` | -| 65 | `/teleport` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Pull a Claude Code on the web session into this terminal: opens a picker, then fetches the branch and conversation. Also available as `/tp`. Requires a claude.ai subscription | -| 66 | `/web-setup` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Connect your GitHub account to Claude Code on the web using your local `gh` CLI credentials. `/schedule` prompts for this automatically if GitHub is not connected | -| 67 | `/branch [name]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Create a branch of the current conversation at this point. Alias: `/fork`. When `CLAUDE_CODE_FORK_SUBAGENT` is set, `/fork` instead spawns a forked subagent and is no longer an alias for this command | -| 68 | `/btw ` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Ask a quick side question without adding to the conversation | -| 69 | `/clear` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Start a new conversation with empty context. The previous conversation stays available in `/resume`. To free up context while continuing the same conversation, use `/compact` instead. Aliases: `/reset`, `/new` | -| 70 | `/compact [instructions]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Compact conversation with optional focus instructions | -| 71 | `/exit` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Exit the CLI. Alias: `/quit` | -| 72 | `/recap` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Generate a one-line summary of the current session on demand, without affecting the ongoing conversation | -| 73 | `/rename [name]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history | -| 74 | `/resume [session]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Resume a conversation by ID or name, or open the session picker. Alias: `/continue` | -| 75 | `/rewind` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rewind the conversation and/or code to a previous point, or summarize from a selected message. See checkpointing. Alias: `/checkpoint`, `/undo` | +| 12 | `/radio` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Open Claude FM lo-fi radio in your browser. Prints the stream URL when no browser is available. Not available on Bedrock, Vertex, or Foundry | +| 13 | `/sandbox` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Toggle sandbox mode. Available on supported platforms only | +| 14 | `/statusline` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Configure Claude Code's status line. Describe what you want, or run without arguments to auto-configure from your shell prompt | +| 15 | `/stickers` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Order Claude Code stickers | +| 16 | `/terminal-setup` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Cursor, Windsurf, Alacritty, or Zed | +| 17 | `/theme` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Change the color theme. Includes light and dark variants, colorblind-accessible (daltonized) themes, ANSI themes that use your terminal's color palette, an "Auto (match terminal)" option that follows your terminal's light/dark mode, and custom themes loaded from `~/.claude/themes/` or plugins. Select "New custom theme…" to create your own | +| 18 | `/tui [default\|fullscreen]` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Set the terminal UI renderer and relaunch Claude Code with the current conversation intact. `default` uses inline rendering; `fullscreen` uses an alt-screen TUI | +| 19 | `/voice [hold\|tap\|off]` | ![Config](https://img.shields.io/badge/Config-F39C12?style=flat) | Toggle voice dictation, or enable it in a specific mode. Requires a Claude.ai account | +| 20 | `/context [all]` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings. Pass `all` to expand the per-item breakdown in fullscreen | +| 21 | `/cost` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Alias for `/usage` | +| 22 | `/extra-usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Configure extra usage to keep working when rate limits are hit | +| 23 | `/insights` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points | +| 24 | `/stats` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Alias for `/usage`. Opens on the Stats tab | +| 25 | `/status` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Open the Settings interface (Status tab) showing version, model, account, and connectivity. Works while Claude is responding, without waiting for the current response to finish | +| 26 | `/usage` | ![Context](https://img.shields.io/badge/Context-8E44AD?style=flat) | Show session cost, plan usage limits, and activity stats. `/cost` and `/stats` are aliases | +| 27 | `/doctor` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Diagnose and verify your Claude Code installation and settings. Results show with status icons. Press `f` to have Claude fix any reported issues | +| 28 | `/feedback [report]` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Submit feedback about Claude Code. Alias: `/bug` | +| 29 | `/heapdump` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Write a JavaScript heap snapshot and memory breakdown to `~/Desktop` for diagnosing high memory usage. Useful when filing bug reports about memory growth | +| 30 | `/help` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Show help and available commands | +| 31 | `/powerup` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | Discover Claude Code features through quick interactive lessons with animated demos | +| 32 | `/release-notes` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | View the changelog in an interactive version picker. Select a specific version to see its release notes, or choose to show all versions | +| 33 | `/tasks` | ![Debug](https://img.shields.io/badge/Debug-E74C3C?style=flat) | List and manage background tasks. Alias: `/bashes` | +| 34 | `/copy [N]` | ![Export](https://img.shields.io/badge/Export-7F8C8D?style=flat) | Copy the last assistant response to clipboard. Pass a number `N` to copy the Nth-latest response: `/copy 2` copies the second-to-last. When code blocks are present, shows an interactive picker to select individual blocks or the full response. Press `w` in the picker to write the selection to a file instead of the clipboard, which is useful over SSH | +| 35 | `/export [filename]` | ![Export](https://img.shields.io/badge/Export-7F8C8D?style=flat) | Export the current conversation as plain text. With a filename, writes directly to that file. Without, opens a dialog to copy to clipboard or save to a file | +| 36 | `/agents` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage agent configurations | +| 37 | `/chrome` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Configure Claude in Chrome settings | +| 38 | `/hooks` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | View hook configurations for tool events | +| 39 | `/ide` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage IDE integrations and show status | +| 40 | `/mcp` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage MCP server connections and OAuth authentication | +| 41 | `/plugin` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Manage Claude Code plugins | +| 42 | `/reload-plugins` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors | +| 43 | `/skills` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | List available skills. Press `t` to sort by token count | +| 44 | `/memory` | ![Memory](https://img.shields.io/badge/Memory-3498DB?style=flat) | Edit `CLAUDE.md` memory files, enable or disable auto-memory, and view auto-memory entries | +| 45 | `/effort [low\|medium\|high\|xhigh\|max\|auto]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Set the model effort level. Available levels depend on the model and include `low`, `medium`, `high`, `xhigh`, and `max` (session-only). Without an argument, opens an interactive slider to pick the level. `auto` resets to the model default. Takes effect immediately without waiting for the current response to finish | +| 46 | `/fast [on\|off]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Toggle fast mode on or off | +| 47 | `/model [model]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Select or change the AI model. For models that support it, use left/right arrows to adjust effort level. The change takes effect immediately without waiting for the current response to finish. When switching mid-conversation after prior output, Claude warns before applying the change | +| 48 | `/passes` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Share a free week of Claude Code with friends. Only visible if your account is eligible | +| 49 | `/plan [description]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Enter plan mode directly from the prompt. Pass an optional description to enter plan mode and immediately start with that task, for example `/plan fix the auth bug` | +| 50 | `/ultraplan ` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Draft a plan in an ultraplan session, review it in your browser, then execute remotely or send it back to your terminal | +| 51 | `/add-dir ` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Add a working directory for file access during the current session. Most `.claude/` configuration is not discovered from the added directory | +| 52 | `/diff` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use left/right arrows to switch between the current git diff and individual Claude turns, and up/down to browse files | +| 53 | `/init` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Initialize project with a `CLAUDE.md` guide. Set `CLAUDE_CODE_NEW_INIT=1` for an interactive flow that also walks through skills, hooks, and personal memory files | +| 54 | `/review [PR]` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Review a pull request locally in your current session. Pass an optional PR number or URL to target a specific PR. For a deeper cloud-based review, see `/ultrareview` | +| 55 | `/security-review` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Analyze pending changes on the current branch for security vulnerabilities. Reviews the git diff and identifies risks like injection, auth issues, and data exposure | +| 56 | `/team-onboarding` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Generate a team onboarding guide from your Claude Code usage history. Analyzes sessions, commands, and MCP server usage from the past 30 days | +| 57 | `/ultrareview [PR]` | ![Project](https://img.shields.io/badge/Project-27AE60?style=flat) | Run a deep, multi-agent code review of the given pull request in a cloud sandbox. Produces a structured review with prioritized findings; complements the local `/review` command | +| 58 | `/autofix-pr [prompt]` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Spawn a Claude Code on the web session that watches the current branch's PR and pushes fixes when CI fails or reviewers leave comments. Detects the open PR from your checked-out branch with `gh pr view`; to watch a different PR, check out its branch first. Requires the `gh` CLI and access to Claude Code on the web | +| 59 | `/desktop` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: `/app` | +| 60 | `/install-github-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration | +| 61 | `/install-slack-app` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Install the Claude Slack app. Opens a browser to complete the OAuth flow | +| 62 | `/mobile` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Show QR code to download the Claude mobile app. Aliases: `/ios`, `/android` | +| 63 | `/remote-control` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Make this session available for remote control from claude.ai. Alias: `/rc` | +| 64 | `/remote-env` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Configure the default remote environment for web sessions started with `--remote` | +| 65 | `/schedule [description]` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Create, update, list, or run routines. Claude walks you through the setup conversationally. Alias: `/routines` | +| 66 | `/teleport` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Pull a Claude Code on the web session into this terminal: opens a picker, then fetches the branch and conversation. Also available as `/tp`. Requires a claude.ai subscription | +| 67 | `/web-setup` | ![Remote](https://img.shields.io/badge/Remote-5D6D7E?style=flat) | Connect your GitHub account to Claude Code on the web using your local `gh` CLI credentials. `/schedule` prompts for this automatically if GitHub is not connected | +| 68 | `/branch [name]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Create a branch of the current conversation at this point. Alias: `/fork`. When `CLAUDE_CODE_FORK_SUBAGENT` is set, `/fork` instead spawns a forked subagent and is no longer an alias for this command | +| 69 | `/btw ` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Ask a quick side question without adding to the conversation | +| 70 | `/clear [name]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Start a new conversation with empty context. Pass an optional name to label the previous conversation in the `/resume` picker. The previous conversation stays available in `/resume`. To free up context while continuing the same conversation, use `/compact` instead. Aliases: `/reset`, `/new` | +| 71 | `/compact [instructions]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Compact conversation with optional focus instructions | +| 72 | `/exit` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Exit the CLI. Alias: `/quit` | +| 73 | `/recap` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Generate a one-line summary of the current session on demand, without affecting the ongoing conversation | +| 74 | `/rename [name]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history | +| 75 | `/resume [session]` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Resume a conversation by ID or name, or open the session picker. Alias: `/continue` | +| 76 | `/rewind` | ![Session](https://img.shields.io/badge/Session-4A90D9?style=flat) | Rewind the conversation and/or code to a previous point, or summarize from a selected message. See checkpointing. Alias: `/checkpoint`, `/undo` | Bundled skills such as `/debug` can also appear in the slash-command menu, but they are not built-in commands. From 296418438a91aca80cfa61b6382cb9fd23891915 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:14 +0500 Subject: [PATCH 05/21] chore(claude-skills): bump version badge to v2.1.138 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit No drift detected — frontmatter fields (15) and bundled skills (6) remain fully synchronized with official docs across the v2.1.126 → v2.1.138 window. Badge timestamp refreshed to May 09 2026 6:58 PM PKT. Co-Authored-By: Claude --- best-practice/claude-skills.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/best-practice/claude-skills.md b/best-practice/claude-skills.md index adc3005..380e3b2 100644 --- a/best-practice/claude-skills.md +++ b/best-practice/claude-skills.md @@ -1,6 +1,6 @@ # Skills Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-May%2001%2C%202026%203%3A30%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.126-blue?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-May%2009%2C%202026%206%3A58%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.138-blue?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-skills-implementation.md) Claude Code skills — frontmatter fields and official bundled skills. From da6a99b6cb554d71ca5dbd67d4d3874e5b5d8dd0 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:18 +0500 Subject: [PATCH 06/21] chore(claude-subagents): bump version badge to v2.1.138 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit No drift detected on the two tracked dimensions — all 16 frontmatter fields and 5 built-in agent types match official docs across the 12-version window. Badge timestamp refreshed to May 09 2026 6:58 PM PKT. Co-Authored-By: Claude --- best-practice/claude-subagents.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/best-practice/claude-subagents.md b/best-practice/claude-subagents.md index c9f4ed4..39fed3e 100644 --- a/best-practice/claude-subagents.md +++ b/best-practice/claude-subagents.md @@ -1,6 +1,6 @@ # Sub-agents Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-May%2001%2C%202026%203%3A30%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.126-blue?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-May%2009%2C%202026%206%3A58%20PM%20PKT-white?style=flat&labelColor=555) ![Version](https://img.shields.io/badge/Claude_Code-v2.1.138-blue?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-subagents-implementation.md) Claude Code subagents — frontmatter fields and official built-in agent types. From d57bffb5513d6257967f081802b51d83a3be9fd2 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:26 +0500 Subject: [PATCH 07/21] chore(agent-collections): append 2026-05-09 changelog entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Records msitarzewski/agency-agents 185→186 oscillation as INVALID (within ±1 margin per prior 184–186 oscillation policy; per-directory enumeration sums to 172 vs Python crawl's 186, agent confidence 0.93). VoltAgent 144 confirmed as real (per-category sum exact, prior 144↔145 oscillation resolved as content change rather than pagination artifact). Star counts unchanged (msitarzewski 95k, VoltAgent 19k); sort order preserved. Co-Authored-By: Claude --- changelog/agent-collections/changelog.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/changelog/agent-collections/changelog.md b/changelog/agent-collections/changelog.md index a691bd4..569bbae 100644 --- a/changelog/agent-collections/changelog.md +++ b/changelog/agent-collections/changelog.md @@ -10,6 +10,18 @@ Tracks updates to the AGENT COLLECTIONS table in `README.md`. --- +## [2026-05-09 06:57 PM PKT] Agent Collections Update + +| # | Priority | Type | Action | Status | +|---|----------|-------|---------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------| +| 1 | LOW | Count | Update msitarzewski/agency-agents agents from 185 to 186 | INVALID (within ±1 margin of error — Python crawl reported 186 but per-directory enumeration summed to 172; agent confidence 0.93; consistent with prior 184–186 oscillation policy) | +| 2 | LOW | Star | msitarzewski/agency-agents ★ unchanged (95k = 95,253) | INVALID (no change required) | +| 3 | LOW | Star | VoltAgent/awesome-claude-code-subagents ★ unchanged (19k = 19,433) | INVALID (no change required) | +| 4 | LOW | Count | VoltAgent/awesome-claude-code-subagents agents unchanged (144) | COMPLETE (tree not truncated; per-category sum exactly 144 across 10 dirs; prior 144↔145 oscillation definitively resolved as real content change, not pagination artifact) | +| 5 | LOW | Sort | Verify sort order (stars descending) | COMPLETE (msitarzewski 95k > VoltAgent 19k — order preserved) | + +--- + ## [2026-05-08 08:46 PM PKT] Agent Collections Update | # | Priority | Type | Action | Status | From 278fde59da8c0a8877680e7f3935912fe0cf7985 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:31 +0500 Subject: [PATCH 08/21] chore(claude-commands): append 2026-05-09 v2.1.138 changelog entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Records four COMPLETE actions: 1 HIGH (added /radio at Config #12, count 75→76 with renumbering), 3 MED (signature refinements for /clear [name], /review [PR], /context [all]). Co-Authored-By: Claude --- changelog/best-practice/claude-commands/changelog.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/changelog/best-practice/claude-commands/changelog.md b/changelog/best-practice/claude-commands/changelog.md index e27b88f..5f601f5 100644 --- a/changelog/best-practice/claude-commands/changelog.md +++ b/changelog/best-practice/claude-commands/changelog.md @@ -288,3 +288,14 @@ No priority action items — report is fully in sync with official documentation ## [2026-05-01 03:31 PM PKT] Claude Code v2.1.126 No priority action items — report is fully in sync with official documentation (15 frontmatter fields, 75 built-in commands). + +--- + +## [2026-05-09 06:58 PM PKT] Claude Code v2.1.138 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | New Command | Add `/radio` to Config tag — Open Claude FM lo-fi radio in your browser. Prints stream URL when no browser is available. Not available on Bedrock, Vertex, or Foundry | ✅ COMPLETE (added as #12 in Config tag, alphabetical position between `/privacy-settings` and `/sandbox`; count updated 75 → 76; rows #12–75 renumbered to #13–76) | +| 2 | MED | Changed Argument | Update `/clear` → `/clear [name]` — accepts optional name to label the previous conversation in the `/resume` picker | ✅ COMPLETE (signature updated at #70 in Session tag; description expanded to mention the optional name argument) | +| 3 | MED | Changed Argument | Update `/review` → `/review [PR]` — accepts optional PR argument | ✅ COMPLETE (signature updated at #54 in Project tag; description expanded to mention the optional PR argument) | +| 4 | MED | Changed Argument | Update `/context` → `/context [all]` — accepts `all` to expand per-item breakdown in fullscreen | ✅ COMPLETE (signature updated at #20 in Context tag; description expanded to mention the `all` argument) | From 7dbc6d95acfdb80b9f5786bbbc1e325ac91b4535 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:36 +0500 Subject: [PATCH 09/21] chore(claude-skills): append 2026-05-09 v2.1.138 no-drift changelog entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Frontmatter fields (15) and bundled skills (6) fully synchronized with official docs across the v2.1.126 → v2.1.138 window. No actionable drift. Co-Authored-By: Claude --- changelog/best-practice/claude-skills/changelog.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/changelog/best-practice/claude-skills/changelog.md b/changelog/best-practice/claude-skills/changelog.md index d925dd6..f79fdc5 100644 --- a/changelog/best-practice/claude-skills/changelog.md +++ b/changelog/best-practice/claude-skills/changelog.md @@ -189,3 +189,9 @@ No drift detected — frontmatter fields (15) and bundled skills (5) are fully s ## [2026-05-01 03:30 PM PKT] Claude Code v2.1.126 No drift detected — frontmatter fields (15) and bundled skills (6) are fully synchronized with official docs. + +--- + +## [2026-05-09 06:58 PM PKT] Claude Code v2.1.138 + +No drift detected — frontmatter fields (15) and bundled skills (6) are fully synchronized with official docs. From cf2035b4d03915bfed5439c0734cb1515500684f Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:40 +0500 Subject: [PATCH 10/21] chore(claude-subagents): append 2026-05-09 v2.1.138 no-drift changelog entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit All 16 frontmatter fields and 5 built-in agents match across the 12-version window (v2.1.126 → v2.1.138). No add/remove changes to subagent surfaces. Co-Authored-By: Claude --- changelog/best-practice/claude-subagents/changelog.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/changelog/best-practice/claude-subagents/changelog.md b/changelog/best-practice/claude-subagents/changelog.md index 082baba..6767649 100644 --- a/changelog/best-practice/claude-subagents/changelog.md +++ b/changelog/best-practice/claude-subagents/changelog.md @@ -225,3 +225,9 @@ No drift detected on the two tracked dimensions — all 16 frontmatter fields an ## [2026-05-01 03:30 PM PKT] Claude Code v2.1.126 No drift detected on the two tracked dimensions — all 16 frontmatter fields and 5 built-in agents match. + +--- + +## [2026-05-09 06:58 PM PKT] Claude Code v2.1.138 + +No drift detected on the two tracked dimensions — all 16 frontmatter fields and 5 built-in agents match. Report jumped 12 versions (v2.1.126 → v2.1.138); no add/remove changes to subagent surfaces in that range. From 138156ae114270f8ab9bf151ecd282e655d9e006 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:49 +0500 Subject: [PATCH 11/21] chore(concepts): append 2026-05-09 v2.1.138 changelog entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit One HIGH COMPLETE (badge bumped to v2.1.138 / May 09 2026 7:02 PM PKT). Four ON HOLD (worktree.baseRef, parentSettingsBehavior, --plugin-url, hard_deny — deferred as compact rows or admin-tier fields not warranting CONCEPTS surface). Eight INVALID (recurring-style /slash-commands redirect, missing standalone rows for Output Styles/Sandboxing/Permission Modes/Headless/etc, Effort Levels, Workflows row critique — all per established user policy). Five LOW verifications confirmed all 35+ external URLs and 21 local file paths still resolve. Co-Authored-By: Claude --- changelog/best-practice/concepts/changelog.md | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md index c66bf6d..b30b9a6 100644 --- a/changelog/best-practice/concepts/changelog.md +++ b/changelog/best-practice/concepts/changelog.md @@ -509,3 +509,30 @@ Tracks drift between the README CONCEPTS table and official Claude Code document | 15 | LOW | Verification | Bundled Skills anchor `#bundled-skills` — stable since v2.1.113 | ✅ COMPLETE (stable) | | 16 | LOW | Verification | Ultrareview anchor `#track-a-running-review` — stable since v2.1.118 | ✅ COMPLETE (stable) | | 17 | LOW | Verification | claude-code-guide cross-check — independent research surfaced same v2.1.122–126 changes (`claude project purge`, gateway model picker, `--from-pr` expansion); also re-surfaced long-standing platform-surface concepts (Desktop, IDE Integration, Bedrock/Vertex/Foundry) which are RECURRING INVALID per user policy; no contradictions | ✅ COMPLETE (both agents aligned) | + +--- + +## [2026-05-09 07:02 PM PKT] Claude Code v2.1.138 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Stale Version | README badge pinned at v2.1.128 (May 08) — latest is v2.1.138 (May 09); 10 versions behind | ✅ COMPLETE (badge bumped to v2.1.138 May 09 2026 7:02 PM PKT) | +| 2 | MED | Changed Description | Git Worktrees row (line 68) doesn't surface `worktree.baseRef` setting (`fresh` vs `head`) added in v2.1.133 — controls whether new worktrees branch from `origin/` for clean tree, or local `HEAD` to preserve unpushed commits | ✋ ON HOLD (deferred — already-busy row; worktree behavior is functional today, not a drift bug; revisit if user wants to surface the new knob) | +| 3 | MED | Changed Description | Settings row (line 33) doesn't mention `parentSettingsBehavior` (v2.1.133) — admin merge-rule for managed-settings interaction with programmatically-supplied settings | ✋ ON HOLD (deferred — niche admin/managed-settings field; not a user-facing concept warranting a sub-link in CONCEPTS) | +| 4 | LOW | Changed Description | Plugins row (line 32) doesn't mention `--plugin-url` flag and `.zip` archive support (v2.1.128/v2.1.129) — expands install sources beyond marketplaces | ✋ ON HOLD (deferred — Plugins row is intentionally compact; install-source flags are CLI surface, not concept-level) | +| 5 | LOW | Changed Description | Auto Mode row (line 50) doesn't mention `hard_deny` classifier rules (v2.1.136) — admin-side stronger deny semantics | ✋ ON HOLD (deferred — admin-classifier field, not a user-facing concept) | +| 6 | LOW | Missing Inline Link | Agent SDK row (line 54) could surface `reports/claude-agent-sdk-vs-cli-system-prompts.md` as an inline link — local report exists but is not linked from CONCEPTS | ❌ INVALID (RECURRING-style — workflow-concepts-agent flagged as 0.95-confidence "easy win"; user has historically declined cross-linking SDK comparison reports from the Hot table; if desired, can be re-raised in a future run) | +| 7 | LOW | Cosmetic | Memory row (line 35) uses `` placeholder while `reports/claude-global-vs-project-settings.md` uses `` | ❌ INVALID (cosmetic; `` is the conventional placeholder name in the README and is internally consistent across other rows; no functional drift) | +| 8 | HIGH | Stale URL | Commands URL `/slash-commands` not in official sitemap — redirects to `/skills`; canonical commands reference is `/en/commands` | ❌ INVALID (RECURRING from 2026-03-10; URL still resolves via redirect; user has chosen to keep as-is across 22+ runs) | +| 9 | MED | Missing Concept (recurring) | Dedicated agent re-flagged Output Styles, Sandboxing, Permission Modes, Headless Mode, Tools Reference, Context Window, Cloud Providers (Bedrock/Vertex/Foundry), IDE Integration, Deep Links as missing standalone rows | ❌ INVALID (RECURRING from 2026-03-10/2026-03-17/2026-04-08/2026-04-09/2026-05-01; user considers all platform surfaces or covered as Settings sub-links — not standalone concepts) | +| 10 | MED | Missing Concept (recurring) | Dedicated agent flagged Effort Levels (`/effort`, `effort:` frontmatter, `${CLAUDE_EFFORT}`) as missing Hot row — formalized in v2.1.120/v2.1.133 | ❌ INVALID (Effort is a model-config field, not a standalone concept; documented under `/en/model-config#adjust-effort-level` which is already linked via Settings row's Model Config sub-link) | +| 11 | MED | Workflows Row Critique | Dedicated agent flagged Workflows row Location column points to single `weather-orchestrator.md` — should point to `/en/common-workflows` patterns | ❌ INVALID (already RESOLVED on 2026-04-24 — description filled with official-docs-sourced text; the Location column intentionally points to local orchestration example as the canonical implementation, with the official `/en/common-workflows` link covered by the row title) | +| 12 | LOW | Verification | All 35+ external CONCEPTS docs URLs spot-validated — Skills (`/en/skills`, bundled-skills anchor + `${CLAUDE_EFFORT}` confirmed), Permission Modes (`#eliminate-prompts-with-auto-mode` anchor confirmed), Settings (`worktree.baseRef` and `parentSettingsBehavior` v2.1.133 confirmed); only the recurring `/slash-commands` redirect flagged | ✅ COMPLETE (no NEW broken URLs) | +| 13 | LOW | Verification | All 21 local badge file paths validated — `best-practice/` (8 files), `implementation/` (5 files), `reports/` (4 files), `.claude/settings.json`, `.mcp.json`, `CLAUDE.md` all exist on filesystem | ✅ COMPLETE (no missing local files) | +| 14 | LOW | Verification | Beta badge currency (rule #7) — Auto Mode `/en/permission-modes` page confirms "research preview" wording with v2.1.83+ requirement; README beta badge accurate | ✅ COMPLETE (no demotions warranted) | +| 15 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` — stable since v2.1.113 | ✅ COMPLETE (stable) | +| 16 | LOW | Verification | Git Worktrees anchor `#run-parallel-claude-code-sessions-with-git-worktrees` — stable since v2.1.113 | ✅ COMPLETE (stable) | +| 17 | LOW | Verification | Auto Mode anchor `#eliminate-prompts-with-auto-mode` — stable since v2.1.113 | ✅ COMPLETE (stable) | +| 18 | LOW | Verification | Bundled Skills anchor `#bundled-skills` — stable since v2.1.113 | ✅ COMPLETE (stable) | +| 19 | LOW | Verification | Ultrareview anchor `#track-a-running-review` — stable since v2.1.118 | ✅ COMPLETE (stable) | +| 20 | LOW | Verification | claude-code-guide cross-check — independent research surfaced 21 features (matched dedicated agent), corroborated v2.1.127–v2.1.138 changes (`worktree.baseRef`, `parentSettingsBehavior`, `/effort`, `${CLAUDE_EFFORT}`, sandbox.bwrapPath, `--plugin-url`, `.zip` archives, `hard_deny`); also re-surfaced long-standing platform-surface concepts (Output Styles, Sandboxing, Headless, IDE Integration, Cloud Providers) which are RECURRING INVALID per user policy; no contradictions | ✅ COMPLETE (both agents aligned) | From 9951de59f30aafe6b1510818ae201d8e6fc474f9 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:56:58 +0500 Subject: [PATCH 12/21] chore(development-workflows): append 2026-05-09 changelog entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 29 actions across 11 workflow repos, all COMPLETE: star bumps for Superpowers (175k→184k), ECC (171k→176k), Spec Kit (92k→94k), gstack (88k→92k), GSD (59k→61k), Matt Pocock (51k→67k, +16k single-run jump), BMAD (46k→47k), OpenSpec (45k→47k), oh-my-claudecode (32k→33k). Material chain rewrites for ECC (PRP-prefix family), Matt Pocock (rerank to row 5), BMAD (interleaved agent-persona+task-skill chain), oh-my-claudecode (v4.13.x flow). Notable methodology call-outs: ECC counts use README values despite 8th consecutive directory-enumeration mismatch; Matt Pocock skills 22→13 from canonical plugin.json install manifest excluding deprecated/in-progress. Co-Authored-By: Claude --- changelog/development-workflows/changelog.md | 36 ++++++++++++++++++++ 1 file changed, 36 insertions(+) diff --git a/changelog/development-workflows/changelog.md b/changelog/development-workflows/changelog.md index 0c72e7a..829c411 100644 --- a/changelog/development-workflows/changelog.md +++ b/changelog/development-workflows/changelog.md @@ -505,3 +505,39 @@ |---|----------|------|--------|--------| | 1 | HIGH | Add | Added addyosmani/agent-skills (27k stars / 3 agents / 7 commands / 21 skills) at row 10, between oh-my-claudecode (32k) and Compound Engineering (16k); workflow chain `/spec → /plan → /build → /test → /review → /ship` (DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP lifecycle); user-requested manual addition | COMPLETE (inserted into DEVELOPMENT WORKFLOWS table) | | 2 | LOW | Note | Repo also ships parallel `.gemini/commands/` equivalents and a `.claude-plugin/` marketplace entry (multi-agent-IDE); cross-listed in SKILL COLLECTIONS table for its 21 SKILL.md library | COMPLETE (cross-referenced) | + +--- + +## [2026-05-09 07:06 PM PKT] Development Workflows Update + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Star Update | Update Superpowers ★ from 175k to 184k (184,031 actual) | COMPLETE (updated README table) | +| 2 | HIGH | Count Update | Update Superpowers agents from 5 to 0 (v5.1.0 released 2026-05-04 removed superpowers:code-reviewer; all subagent dispatches now general-purpose) | COMPLETE (updated README table) | +| 3 | HIGH | Workflow | Add verification-before-completion(sub) between requesting-code-review(sub) and finishing-a-development-branch in Superpowers chain | COMPLETE (updated README table) | +| 4 | HIGH | Star Update | Update ECC ★ from 171k to 176k (176,362 actual) | COMPLETE (updated README table) | +| 5 | HIGH | Count Update | Update ECC commands 143→71, skills 230→182 (8th consecutive run with directory-enumeration giving lower counts; v2.0.0-rc.1 README self-reports match) | COMPLETE (updated to README values, methodology dispute persists) | +| 6 | HIGH | Workflow | Replace ECC chain with prp-prd → prp-plan → prp-implement(sub) → build-fix(sub) → code-review → quality-gate → prp-commit → prp-pr (v2.0.0-rc.1 PRP-prefix family) | COMPLETE (updated README table) | +| 7 | HIGH | Star Update | Update Spec Kit ★ from 92k to 94k (94,034 actual — v0.8.7 active patch cadence) | COMPLETE (updated README table) | +| 8 | HIGH | Workflow | Spec Kit: drop /speckit.clarify, add checklist(sub) and taskstoissues to chain | COMPLETE (updated README table) | +| 9 | HIGH | Star Update | Update gstack ★ from 88k to 92k (92,123 actual — v1.29.0.0 worktree-aware gbrain) | COMPLETE (updated README table) | +| 10 | HIGH | Count Update | Update gstack skills from 43 to 56 (systematic root-dir audit confirmed 56 SKILL.md folders) | COMPLETE (updated README table) | +| 11 | HIGH | Workflow | gstack: rename /implement → autoplan; add /plan-devex-review(sub) and /canary | COMPLETE (updated README table) | +| 12 | HIGH | Star Update | Update GSD ★ from 59k to 61k (61,074 actual — v1.42.0-rc1 5 commits today) | COMPLETE (updated README table) | +| 13 | MED | Count Update | Update GSD commands from 65 to 66 | COMPLETE (updated README table) | +| 14 | HIGH | Workflow | GSD: add gsd-map-codebase as entry, gsd-new-milestone as final step | COMPLETE (updated README table) | +| 15 | HIGH | Star Update | Update Matt Pocock Skills ★ from 51k to 67k (67,568 actual — +16k, largest single-run jump this run) | COMPLETE (updated README table) | +| 16 | HIGH | Count Update | Update Matt Pocock skills from 22 to 13 (active per plugin.json: 10 engineering + 3 productivity; 27 total folders includes deprecated/in-progress) | COMPLETE (using plugin.json canonical install manifest) | +| 17 | HIGH | Workflow | Matt Pocock: rearrange to grill-with-docs → to-prd → tdd(sub) → diagnose(sub) → zoom-out → improve-codebase-architecture → to-issues → triage | COMPLETE (updated README table) | +| 18 | HIGH | Sort Order | Move Matt Pocock from row 6 (51k) to row 5 (67k, above GSD 61k) | COMPLETE (updated README table) | +| 19 | HIGH | Star Update | Update BMAD ★ from 46k to 47k (46,722 actual) | COMPLETE (updated README table) | +| 20 | HIGH | Count Update | Update BMAD agents from 0 to 6 (agent-persona skills in src/bmm-skills/: bmad-agent-analyst, pm, ux-designer, architect, dev, tech-writer — counted per workflow rules) | COMPLETE (updated README table) | +| 21 | HIGH | Workflow | BMAD: rewrite chain to interleave agent-persona steps with task-skills (analyst → prfaq(sub) → pm → create-prd(sub) → ux-designer(sub) → architect → ...) | COMPLETE (updated README table) | +| 22 | HIGH | Star Update | Update OpenSpec ★ from 45k to 47k (46,515 actual) | COMPLETE (updated README table) | +| 23 | HIGH | Workflow | OpenSpec: expand chain — opsx:explore → opsx:propose → opsx:apply(sub) → opsx:verify(sub) → opsx:sync → opsx:archive | COMPLETE (updated README table) | +| 24 | MED | Star Update | Update oh-my-claudecode ★ from 32k to 33k (33,170 actual — v4.13.7) | COMPLETE (updated README table) | +| 25 | MED | Count Update | Update oh-my-claudecode commands from 0 to 27 (compatibility shim .md files in commands/ that forward to skills — counted per actual file presence) | COMPLETE (updated README table) | +| 26 | HIGH | Workflow | oh-my-claudecode: replace v4.13.x flow — omc-setup → deepinit → plan → autopilot(sub) → ultrawork(sub) → verify(sub) → ultraqa(sub) → release | COMPLETE (updated README table) | +| 27 | MED | Count Update | Update Compound Engineering skills from 39 to 38 (37 in compound-engineering + 1 in coding-tutor) | COMPLETE (updated README table) | +| 28 | MED | Workflow | Compound Engineering: restructure to ce-strategy → ce-ideate → ce-brainstorm → ce-plan → ce-work(sub) → ce-debug(sub) → ce-code-review → ce-doc-review(sub) → ce-compound → ce-product-pulse | COMPLETE (updated README table) | +| 29 | MED | Workflow | HumanLayer: expand chain to research_codebase → create_plan → validate_plan(sub) → iterate_plan(sub) → implement_plan → local_review → describe_pr → commit → create_handoff | COMPLETE (updated README table) | From f4e9c1d805d43b94885261c8503f3cec6aa205bf Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 19:57:06 +0500 Subject: [PATCH 13/21] chore(skill-collections): append 2026-05-09 changelog entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Two simultaneous rank swaps in one update — unusual: addyosmani 27k→37k (+10k) overtakes wshobson (35k flat) for row 3; VoltAgent 20,933 overtakes scientific 20,478 for row 5. Star surges: anthropics 127k→131k, mattpocock 51k→68k (+15k+ second consecutive surge — sustained external amplification). Skill counts: mattpocock 18→19 (handoff/prototype promoted from in-progress), wshobson 152→153 (brand-landingpage), addyosmani 21→22 (doubt-driven- development), scientific 134→137 (+3 PRs), VoltAgent curated 930+→938. Co-Authored-By: Claude --- changelog/skill-collections/changelog.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/changelog/skill-collections/changelog.md b/changelog/skill-collections/changelog.md index bb3e37e..deec20b 100644 --- a/changelog/skill-collections/changelog.md +++ b/changelog/skill-collections/changelog.md @@ -50,3 +50,22 @@ |---|----------|------|--------|--------| | 1 | HIGH | Add | Added addyosmani/agent-skills (27k stars / 21 SKILL.md files) at row 4, between wshobson/agents (35k) and scientific-agent-skills (20k); user-requested manual addition | COMPLETE (inserted into SKILL COLLECTIONS table) | | 2 | LOW | Note | Repo is dual-classified — also added to DEVELOPMENT WORKFLOWS table because it ships a full /spec → /plan → /build → /test → /review → /ship lifecycle, not just a SKILL.md library | COMPLETE (cross-referenced) | + +--- + +## [2026-05-09 07:00 PM PKT] Skill Collections Update + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | MEDIUM | Star | Update anthropics/skills ★ from 127k to 131k (130,952 exact) | NEW | +| 2 | HIGH | Star | Update mattpocock/skills ★ from 51k to 68k (67,568 exact — second consecutive +15k+ surge over ~8 days, sustained external amplification) | RECURRING | +| 3 | LOW | Count | Update mattpocock/skills skills from 18 to 19 (handoff and prototype skills moved from in-progress/ into engineering/ around May 6; deprecated/ 4 + in-progress/ 4 still excluded from active count) | NEW | +| 4 | LOW | Count | Update wshobson/agents skills from 152 to 153 (brand-landingpage plugin added 2026-05-02; star count flat at 35k) | NEW | +| 5 | HIGH | Star | Update addyosmani/agent-skills ★ from 27k to 37k (36,941 exact — +10k surge in ~8 days) | NEW | +| 6 | LOW | Count | Update addyosmani/agent-skills skills from 21 to 22 (doubt-driven-development merged 2026-05-09 via PR #139) | NEW | +| 7 | LOW | Count | Update scientific-agent-skills skills from 134 to 137 (+3: exa-search PR #143 on 2026-05-06, autoskill PR #141 on 2026-05-03, plus one prior; star count flat at 20k) | NEW | +| 8 | LOW | Star | Update VoltAgent/awesome-agent-skills ★ from 20k to 21k (20,933 exact) | NEW | +| 9 | LOW | Count | Update VoltAgent/awesome-agent-skills curated count from 930+ to 938 (verified bullet count from README parse; badge still claims 1100+) | NEW | +| 10 | MEDIUM | Sort | Move addyosmani/agent-skills (37k) above wshobson/agents (35k) — new row 3, wshobson drops to row 4 | NEW | +| 11 | MEDIUM | Sort | Move VoltAgent/awesome-agent-skills (20,933) above scientific-agent-skills (20,478) — new row 5, scientific drops to row 6 | NEW | +| 12 | LOW | Note | Two simultaneous rank swaps in one update is unusual; driven by mattpocock+addyosmani sustained star surges combined with wshobson/scientific staying flat | COMPLETE (recorded for trend tracking) | From db88ca0375490ae32c755f708b1aeb07da306a11 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 20:07:30 +0500 Subject: [PATCH 14/21] chore(readme): refresh Last Updated badge timestamp to 2026-05-09 7:58 PM PKT MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Same-day timestamp refresh after the second concepts drift workflow run. No table content changes — version still v2.1.138. Co-Authored-By: Claude --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index a4e73be..739b958 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # claude-code-best-practice from vibe coding to agentic engineering - practice makes claude perfect -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2009%2C%202026%207%3A06%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2009%2C%202026%207%3A58%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
= Agents · = Commands · = Skills From d86d1b070e69ffc32c138daa08c019f76b90a3a7 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 20:07:37 +0500 Subject: [PATCH 15/21] chore(concepts): append 2026-05-09 7:58 PM same-day re-run entry MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Records second v2.1.138 audit run within the day. README CONCEPTS table unchanged between runs (no commits touched lines 22–68). Findings entirely INVALID or ON HOLD: 1 spurious drift claim verified false (Tasks `/tasks` command is real per claude-commands.md:75); 6 RECURRING-INVALID findings re-flagged per durable user policy (platform surfaces, SDK-scoped pages, sibling beta inconsistency); 1 ON HOLD (Voice Dictation page no longer reads as beta but tag persists conservatively); 4 verifications COMPLETE. No CONCEPTS table edits applied. Co-Authored-By: Claude --- changelog/best-practice/concepts/changelog.md | 21 +++++++++++++++++++ 1 file changed, 21 insertions(+) diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md index b30b9a6..5c3d7fe 100644 --- a/changelog/best-practice/concepts/changelog.md +++ b/changelog/best-practice/concepts/changelog.md @@ -536,3 +536,24 @@ Tracks drift between the README CONCEPTS table and official Claude Code document | 18 | LOW | Verification | Bundled Skills anchor `#bundled-skills` — stable since v2.1.113 | ✅ COMPLETE (stable) | | 19 | LOW | Verification | Ultrareview anchor `#track-a-running-review` — stable since v2.1.118 | ✅ COMPLETE (stable) | | 20 | LOW | Verification | claude-code-guide cross-check — independent research surfaced 21 features (matched dedicated agent), corroborated v2.1.127–v2.1.138 changes (`worktree.baseRef`, `parentSettingsBehavior`, `/effort`, `${CLAUDE_EFFORT}`, sandbox.bwrapPath, `--plugin-url`, `.zip` archives, `hard_deny`); also re-surfaced long-standing platform-surface concepts (Output Styles, Sandboxing, Headless, IDE Integration, Cloud Providers) which are RECURRING INVALID per user policy; no contradictions | ✅ COMPLETE (both agents aligned) | + +--- + +## [2026-05-09 07:58 PM PKT] Claude Code v2.1.138 + +> **Note:** Same-day re-run of the 7:02 PM v2.1.138 audit. README CONCEPTS table did not change between runs (no commits touched lines 22–68). Findings are largely identical; this entry records the badge refresh, the new direct-URL spot-checks, and one new INVALID claim worth verifying. + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Spurious Drift Claim | `workflow-concepts-agent` flagged Tasks row's `/tasks` slash command as possibly nonexistent (0.70 confidence) — suggested replacing with `TaskCreate`/`TaskList`/etc. tool names. Verified against `best-practice/claude-commands.md` line 75 — `/tasks` IS a real command (Debug tag, alias `/bashes`, "List and manage background tasks"). Row description is correct as written | ❌ INVALID (verified `/tasks` exists in current commands report) | +| 2 | MED | New Missing Concept | `claude-code-guide` agent surfaced **Tool Search** (`/en/agent-sdk/tool-search`) as missing — "Scale to many tools with tool search" page in Agent SDK section | ❌ INVALID (SDK-scoped concept, not main CONCEPTS-table material; consistent with prior INVALID rulings on platform-surface and SDK-only pages) | +| 3 | MED | New Behavioral Drift | `workflow-concepts-agent` flagged subagent skill discovery via Skill tool (v2.1.133 changelog) as a behavioral interaction not surfaced by either Subagents or Skills row descriptions | ❌ INVALID (cross-cutting interaction; current row descriptions correctly point to canonical official pages where this is documented; CONCEPTS rows aren't the right surface for behavioral interactions between concepts) | +| 4 | HIGH | Stale URL (recurring) | Commands URL `/en/slash-commands` now confirmed via direct fetch to actually resolve to `/en/skills` page (title: "Extend Claude with skills"); canonical commands page is `/en/commands` per inline note inside the resolved page | ❌ INVALID (RECURRING from 2026-03-10 across 23+ runs; URL still resolves via redirect; user policy is to keep as-is) | +| 5 | MED | Missing Concept (recurring) | Both agents re-flagged Desktop App, IDE Integrations (VS Code/JetBrains), Deep Links, Output Styles, Sandboxing, Permissions, Keybindings, Model Configuration, Auto Memory, Headless Mode, Tools Reference as missing standalone rows | ❌ INVALID (RECURRING from 2026-03-10/2026-03-17/2026-04-08/2026-04-09/2026-05-01/2026-05-09 7:02 PM; user policy: platform surfaces and Settings sub-links are not standalone concepts) | +| 6 | MED | Beta Badge Currency | `workflow-concepts-agent` raised beta-tag-consistency concern — Routines has beta tag but Scheduled Tasks does not, despite shared scheduling infrastructure; Tasks lacks beta despite Agent Teams' explicit experimental status | ❌ INVALID (different upstream pages have different beta-status copy; rule #7 verifies tag matches docs page, not internal consistency between sibling rows; tags are accurate per their own pages) | +| 7 | LOW | Verification (Rule #1) | Spot-fetched 6 external URLs this run (`/en/slash-commands`, `/en/voice-dictation`, `/en/desktop`, `/en/vs-code`, `/en/jetbrains`, `/en/deep-links`) — all returned 200; full 35+ URL validation done in prior 7:02 PM run, no new breakage detected | ✅ COMPLETE (no new broken URLs) | +| 8 | LOW | Verification (Rule #4) | Local badge paths re-confirmed via prior-run validation (`best-practice/`, `implementation/`, `reports/`, `.claude/settings.json`, `.mcp.json`, `CLAUDE.md` all exist) — README CONCEPTS table unchanged since 7:02 PM | ✅ COMPLETE (paths intact) | +| 9 | LOW | Verification (Rule #2) | All previously-validated anchor fragments (`#organize-rules-with-clauderules`, `#run-parallel-claude-code-sessions-with-git-worktrees`, `#eliminate-prompts-with-auto-mode`, `#bundled-skills`, `#track-a-running-review`) still resolve per prior run; no anchor renames in the last hour | ✅ COMPLETE (anchors stable) | +| 10 | LOW | Verification (Rule #6) | TIPS section URL consistency — no CONCEPTS URL was changed this run; no TIPS-section sweep needed | ✅ COMPLETE (no propagation work required) | +| 11 | LOW | Verification (Rule #7) | Beta-badge currency — directly fetched `/en/voice-dictation` this run; page does not read as beta/research-preview but README badge persists per user pattern of keeping beta tags conservative for non-GA features | ✋ ON HOLD (kept — may revisit when official voice-dictation page adds GA marker) | +| 12 | LOW | Spurious Drift Claim | `workflow-concepts-agent` suggested 7 of the 13 main-table rows have empty Description columns that could be filled (Checkpointing, Devcontainers, Ultraplan, Fast Mode, Slack, etc.) | ❌ INVALID (intentional minimalism — empty Description column means no badges/sub-links beyond the title link; not drift) | From 95809f8a32630bacf77165ca03f2dc847e2e6a81 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sat, 9 May 2026 20:56:47 +0500 Subject: [PATCH 16/21] chore(agent-collections): scheduled refresh --- README.md | 6 +++--- changelog/agent-collections/changelog.md | 12 ++++++++++++ 2 files changed, 15 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 739b958..c503f77 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # claude-code-best-practice from vibe coding to agentic engineering - practice makes claude perfect -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2009%2C%202026%207%3A58%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2009%2C%202026%208%3A46%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
= Agents · = Commands · = Skills @@ -155,7 +155,7 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age | Name | ★ | | |------|---|---| | [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) | 95k | 185 | -| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 19k | 144 | +| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 19k | 145 |

section divider @@ -358,7 +358,7 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age ## 🎬 VIDEOS / PODCASTS | Video / Podcast | Source | YouTube | -|-----------------|--------|---------| +|-----------------|--------|--------| | From Vibe Coding to Agentic Engineering (Andrej) \| 02 May 2026 \| AI Engineer | [![Karpathy](!/tags/community-karpathy.svg)](https://x.com/karpathy) | [YouTube](https://www.youtube.com/watch?v=96jN2OCOfLs) | | Full Walkthrough: Workflow for AI Coding (Matt) \| 24 Apr 2026 \| Matt Pocock | [![Matt](!/tags/community-matt.svg)](https://x.com/mattpocockuk) | [YouTube](https://youtu.be/-QFHIoCo-Ko) | | Everything We Got Wrong About Research-Plan-Implement (Dex) \| 24 Mar 2026 \| MLOps Community | [![Dex](!/tags/community-dex.svg)](https://x.com/daborhyde) | [YouTube](https://youtu.be/YwZR6tc7qYg) | diff --git a/changelog/agent-collections/changelog.md b/changelog/agent-collections/changelog.md index 569bbae..32643b7 100644 --- a/changelog/agent-collections/changelog.md +++ b/changelog/agent-collections/changelog.md @@ -10,6 +10,18 @@ Tracks updates to the AGENT COLLECTIONS table in `README.md`. --- +## [2026-05-09 08:46 PM PKT] Agent Collections Update + +| # | Priority | Type | Action | Status | +|---|----------|-------|---------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------| +| 1 | LOW | Count | Update VoltAgent/awesome-claude-code-subagents agents from 144 to 145 | COMPLETE (per-category enumeration across all 10 dirs: 145 .md files, conf 0.87; RECURRING 144↔145 oscillation — this is the 6th consecutive flip) | +| 2 | LOW | Star | msitarzewski/agency-agents ★ unchanged (95k = ~95,300) | INVALID (no change required) | +| 3 | LOW | Star | VoltAgent/awesome-claude-code-subagents ★ unchanged (19k = ~19,400) | INVALID (no change required) | +| 4 | LOW | Count | msitarzewski/agency-agents agents 185 vs reported 184 (−1) | INVALID (within ±1 margin of error; RECURRING oscillation; project-management/ truncation hint noted — 1-2 files may be missing from 184 count; no change) | +| 5 | LOW | Sort | Verify sort order (stars descending) | COMPLETE (msitarzewski 95k > VoltAgent 19k — order preserved) | + +--- + ## [2026-05-09 06:57 PM PKT] Agent Collections Update | # | Priority | Type | Action | Status | From c42f38d668f9912e08c33894faf0a68fcbcc7c16 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sun, 10 May 2026 21:03:50 +0500 Subject: [PATCH 17/21] =?UTF-8?q?chore(agent-collections):=20append=202026?= =?UTF-8?q?-05-10=208:47=20PM=20PKT=20changelog=20=E2=80=94=20msitarzewski?= =?UTF-8?q?=20=E2=98=85=2095k=E2=86=9296k,=20VoltAgent=20=E2=98=85=2019k?= =?UTF-8?q?=E2=86=9220k?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- changelog/agent-collections/changelog.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/changelog/agent-collections/changelog.md b/changelog/agent-collections/changelog.md index 32643b7..0ce23ba 100644 --- a/changelog/agent-collections/changelog.md +++ b/changelog/agent-collections/changelog.md @@ -10,6 +10,18 @@ Tracks updates to the AGENT COLLECTIONS table in `README.md`. --- +## [2026-05-10 08:47 PM PKT] Agent Collections Update + +| # | Priority | Type | Action | Status | +|---|----------|-------|----------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------| +| 1 | MED | Star | Update msitarzewski/agency-agents ★ from 95k to 96k | COMPLETE (HTML scrape ~95,700; crosses k-boundary; prev 95,300 → ~95,700; ~400 star increase) | +| 2 | MED | Star | Update VoltAgent/awesome-claude-code-subagents ★ from 19k to 20k | COMPLETE (HTML scrape ~19,500; crosses k-boundary; prev 19,433 → ~19,500; borderline half-k rounding applied) | +| 3 | LOW | Count | msitarzewski/agency-agents agents 185 → 175 (methodology diff) | INVALID (agent excluded strategy/playbooks(7)/runbooks(4)/coordination(2)/examples(5); different methodology from prior runs; RECURRING methodological variation; no change applied) | +| 4 | LOW | Count | VoltAgent/awesome-claude-code-subagents agents 145 → 144 | INVALID (RECURRING ±1 oscillation — 7th consecutive flip; per-category sum 144 unique (wordpress-master duplicate excluded); policy: no change at ±1) | +| 5 | LOW | Sort | Verify sort order (stars descending) | COMPLETE (msitarzewski 96k > VoltAgent 20k — order preserved) | + +--- + ## [2026-05-09 08:46 PM PKT] Agent Collections Update | # | Priority | Type | Action | Status | From 8430d237e2fe05642f2b6bce9ac3b9c50af8e36f Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sun, 10 May 2026 21:10:30 +0500 Subject: [PATCH 18/21] =?UTF-8?q?chore(agent-collections):=20update=20READ?= =?UTF-8?q?ME=20=E2=80=94=20badge=20to=20May=2010=208:47=20PM=20PKT;=20age?= =?UTF-8?q?nt=20table=20=E2=98=85=20msitarzewski=2095k=E2=86=9296k,=20Volt?= =?UTF-8?q?Agent=2019k=E2=86=9220k?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index c503f77..c579196 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # claude-code-best-practice from vibe coding to agentic engineering - practice makes claude perfect -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2009%2C%202026%208%3A46%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2010%2C%202026%208%3A47%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
= Agents · = Commands · = Skills @@ -154,8 +154,8 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age | Name | ★ | | |------|---|---| -| [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) | 95k | 185 | -| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 19k | 145 | +| [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) | 96k | 185 | +| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 20k | 145 |

section divider From 3a13ceaaef1921d1b907300e18e5b8ff235cac6f Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Sun, 10 May 2026 23:27:06 +0500 Subject: [PATCH 19/21] chore(readme): refresh Last Updated badge timestamp to 2026-05-10 11:26 PM PKT Co-Authored-By: Claude --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index c579196..4578786 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # claude-code-best-practice from vibe coding to agentic engineering - practice makes claude perfect -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2010%2C%202026%208%3A47%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2010%2C%202026%2011%3A26%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
= Agents · = Commands · = Skills From 4527f4d4e749acd3609329be47b984f668f40052 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Mon, 11 May 2026 10:37:35 +0500 Subject: [PATCH 20/21] chore(readme): refresh Last Updated badge timestamp to 2026-05-11 10:36 AM PKT Co-Authored-By: Claude --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 4578786..addd3db 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # claude-code-best-practice from vibe coding to agentic engineering - practice makes claude perfect -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2010%2C%202026%2011%3A26%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2011%2C%202026%2010%3A36%20AM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
= Agents · = Commands · = Skills From 1f001b277c9e857b3b0bf2dc949b92eeb3740506 Mon Sep 17 00:00:00 2001 From: Shayan Rais Date: Tue, 12 May 2026 20:57:01 +0500 Subject: [PATCH 21/21] chore(agent-collections): scheduled refresh MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - README badge: May 12, 2026 8:47 PM PKT - AGENT COLLECTIONS table: msitarzewski 185→198, VoltAgent 145→189 - Changelog: 2026-05-12 08:47 PM PKT entry appended https://claude.ai/code/session_01FaX9yzRQMqaoKgsLZBW1HU --- README.md | 6 +++--- changelog/agent-collections/changelog.md | 10 ++++++++++ 2 files changed, 13 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index addd3db..feda9b4 100644 --- a/README.md +++ b/README.md @@ -1,7 +1,7 @@ # claude-code-best-practice from vibe coding to agentic engineering - practice makes claude perfect -![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2011%2C%202026%2010%3A36%20AM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
+![updated with Claude Code](https://img.shields.io/badge/updated_with_Claude_Code-v2.1.138%20(May%2012%2C%202026%208%3A47%20PM%20PKT)-white?style=flat&labelColor=555) GitHub Stars
[![Best Practice](!/tags/best-practice.svg)](best-practice/) [![Implemented](!/tags/implemented.svg)](implementation/) [![Orchestration Workflow](!/tags/orchestration-workflow.svg)](orchestration-workflow/orchestration-workflow.md) [![Claude](!/tags/claude.svg)](https://code.claude.com/docs) [![Boris](!/tags/boris-cherny.svg)](#-tips-and-tricks) [![Community](!/tags/community.svg)](#-subscribe) ![Click on these badges below to see the actual sources](!/tags/click-badges.svg)
= Agents · = Commands · = Skills @@ -154,8 +154,8 @@ Repos primarily known as curated libraries of subagent definitions (`.claude/age | Name | ★ | | |------|---|---| -| [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) | 96k | 185 | -| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 20k | 145 | +| [msitarzewski/agency-agents](https://github.com/msitarzewski/agency-agents) | 96k | 198 | +| [VoltAgent/awesome-claude-code-subagents](https://github.com/VoltAgent/awesome-claude-code-subagents) | 20k | 189 |

section divider diff --git a/changelog/agent-collections/changelog.md b/changelog/agent-collections/changelog.md index 0ce23ba..9853c1a 100644 --- a/changelog/agent-collections/changelog.md +++ b/changelog/agent-collections/changelog.md @@ -10,6 +10,16 @@ Tracks updates to the AGENT COLLECTIONS table in `README.md`. --- +## [2026-05-12 08:47 PM PKT] Agent Collections Update + +| # | Priority | Type | Action | Status | +|---|----------|-------|-----------------------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------| +| 1 | HIGH | Count | Update msitarzewski/agency-agents agents from 185 to 198 | COMPLETE (recursive tree scan: 198 agent .md files across 19 category dirs; +13 from 185; recent additions in specialized/ dir; NEW) | +| 2 | HIGH | Count | Update VoltAgent/awesome-claude-code-subagents agents from 145 to 189 | COMPLETE (recursive tree scan: 189 .md files under categories/, 10 READMEs excluded from 199 raw; +44 from 145; sustained PR activity ~5-8 agents/wk; NEW) | +| 3 | LOW | Sort | Verify sort order (stars descending) | COMPLETE (msitarzewski 96k > VoltAgent 20k — order preserved; RECURRING) | + +--- + ## [2026-05-10 08:47 PM PKT] Agent Collections Update | # | Priority | Type | Action | Status |