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