diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md index c66bf6d..cd2871d 100644 --- a/changelog/best-practice/concepts/changelog.md +++ b/changelog/best-practice/concepts/changelog.md @@ -509,3 +509,28 @@ 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-12 11:36 PM PKT] Claude Code v2.1.139 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Stale Version | README badge pinned at v2.1.128 (May 08) — latest is v2.1.139 (May 11); 11 versions behind | ✅ COMPLETE (badge bumped to v2.1.139 May 12 2026 11:36 PM PKT in Phase 2.6) | +| 2 | HIGH | Stale URL/Anchor (NEW) | Git Worktrees row primary URL points to `/common-workflows#run-parallel-claude-code-sessions-with-git-worktrees` — but a dedicated `/en/worktrees` page now exists (covers `--worktree`/`-w` flag, `.worktreeinclude`, WorktreeCreate/Remove hooks, non-git VCS) AND the legacy common-workflows anchor has been renamed to `#run-parallel-sessions-with-worktrees` (word "git" dropped). Both verified live | ✅ COMPLETE (URL switched to `/en/worktrees` dedicated page; Location column expanded with `--worktree`/`-w`, `.worktreeinclude`, `WorktreeCreate`/`WorktreeRemove` hooks per user authorization) | +| 3 | HIGH | Missing Concept (NEW) | v2.1.139 introduced **Agent View** (`claude agents`, `--bg`, `/bg`) — research preview "one screen for many background sessions" with peek/attach/dispatch. Dedicated docs page `/en/agent-view` confirmed live | ✅ COMPLETE (Hot row added after Agent Teams with `![beta]` badge per `` "research preview" banner; description notes supervisor hosting and reboot persistence) | +| 4 | HIGH | Missing Concept (NEW) | v2.1.139 introduced **/goal** command — keep Claude working across turns until a model-evaluated condition holds (session-scoped Stop hook wrapper). Dedicated docs page `/en/goal` confirmed live | ✅ COMPLETE (Hot row added after Tasks; description compares to `/loop` and auto mode per docs framing) | +| 5 | MED | Missing Concept (NEW) | **Deep Links** (`claude-cli://open?repo=…&q=…`) introduced v2.1.91 — custom URL scheme for runbooks/alerts/dashboards. Dedicated docs page `/en/deep-links` confirmed live; never surfaced in CONCEPTS across any prior run | ✅ COMPLETE (Hot row added after Remote Control — both are session-launching surfaces; description mentions runbooks/alerts/dashboards use cases and OS-level handler registration) | +| 6 | LOW | Missing Concept (NEW) | v2.1.139 added `/scroll-speed` command — tunes mouse wheel scroll speed with live preview | ✋ ON HOLD (deferred — minor UX command, no dedicated docs page; would only fit as a CLI Startup Flags sub-link if at all) | +| 7 | HIGH | Stale URL (recurring) | 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) | +| 8 | MED | Missing Concept (recurring) | Dedicated agent re-flagged Output Styles, Permissions, Sandboxing, Headless Mode, Desktop App, IDE Integration, .claude Directory, Tools Reference 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) | +| 9 | MED | Missing Concept (recurring) | Dedicated agent flagged Auto Memory needs its own row separate from Memory | ❌ INVALID (RECURRING — current Memory row already surfaces both `/en/memory#auto-memory` and `reports/claude-agent-memory.md` as inline links; user's chosen pattern) | +| 10 | LOW | Verification | All 4 NEW candidate URLs validated via WebFetch: `/en/worktrees` (live, full dedicated page), `/en/agent-view` (live, research preview banner), `/en/goal` (live, /goal command page), `/en/deep-links` (live, v2.1.91+ banner) | ✅ COMPLETE (all 4 NEW URLs return expected canonical pages) | +| 11 | LOW | Verification | Local badge file paths validated — `best-practice/`, `implementation/`, `reports/`, `.claude/`, `.mcp.json`, `CLAUDE.md` targets exist on filesystem | ✅ COMPLETE (no missing local files) | +| 12 | LOW | Verification | Beta Badge Currency (rule #7) — fetched `/en/agent-view` and confirmed `` banner: "Agent view is a research preview and requires Claude Code v2.1.139 or later" — if added, a beta badge would be accurate | ✅ COMPLETE (badge recommendation noted for action item #3) | +| 13 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` — stable since v2.1.113 | ✅ COMPLETE (stable) | +| 14 | LOW | Verification | Git Worktrees anchor — heading renamed in `/en/common-workflows` from `#run-parallel-claude-code-sessions-with-git-worktrees` to `#run-parallel-sessions-with-worktrees` (word "git" dropped); legacy anchor still resolves but is no longer canonical | ⚠️ FLAGGED (captured under action item #2; treated as part of the stale URL action, not a separate item) | +| 15 | LOW | Verification | Auto Mode anchor `#eliminate-prompts-with-auto-mode` — stable since v2.1.113 | ✅ COMPLETE (stable) | +| 16 | LOW | Verification | Bundled Skills anchor `#bundled-skills` — stable since v2.1.113 | ✅ COMPLETE (stable) | +| 17 | LOW | Verification | Ultrareview anchor `#track-a-running-review` — stable since v2.1.118 | ✅ COMPLETE (stable) | +| 18 | LOW | Verification | claude-code-guide cross-check — independent research corroborated v2.1.139 additions (Agent View, /goal, /scroll-speed) and surfaced same Deep Links page; also re-surfaced long-standing platform-surface concepts (Desktop, IDE Integration, .claude Directory, Tools Reference) which are RECURRING INVALID per user policy; no contradictions | ✅ COMPLETE (both agents aligned on NEW v2.1.139 findings) |