gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

chore(concepts): append v2.1.139 changelog entry — Deep Links, Agent View, Goal

Browse Source 
Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Shayan Rais
2026-05-12 23:51:17 +05:00
parent c7257504f4
commit 7689cc1ec5
1 changed files with 25 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
changelog/best-practice/concepts/changelog.md
+25
View File
@@ -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 `<Note>` "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 `<Note>` 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) |