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

Log v2.1.119 README CONCEPTS table updates

Browse Source 
Append v2.1.119 entry recording 17 actions: Tasks row URL retargeted to
local report, Scheduled Tasks description disambiguated into 3 surfaces
(loop/schedule/desktop), Fast Mode added as Hot row (with Settings
side-link removed to avoid duplication), Auto Memory Deep-dive and Skills
for Mono-repos inline links added, plus 8 verification rows confirming
all CONCEPTS URLs/anchors stable. INVALID rows cover the recurring
/slash-commands redirect (kept by user) and incorrect agent reads of beta
status / minor concept additions.

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Shayan Rais
2026-04-26 15:43:25 +05:00
parent db3cb7cfd3
commit 93864e482d
1 changed files with 24 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
changelog/best-practice/concepts/changelog.md
+24
View File
@@ -440,3 +440,27 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
| 11 | LOW | Verification | Auto Mode anchor `#eliminate-prompts-with-auto-mode` — stable since v2.1.113 | ✅ COMPLETE (stable) |
| 12 | LOW | Verification | Bundled Skills anchor `#bundled-skills` — stable since v2.1.113 | ✅ COMPLETE (stable) |
| 13 | LOW | Verification | claude-code-guide agent cross-check — no contradictions with dedicated agent; surfaced /recap (v2.1.108), /usage (v2.1.118), MCP-tool hooks (v2.1.118) as corroborating evidence | ✅ COMPLETE (both agents aligned) |
---
## [2026-04-26 01:10 PM PKT] Claude Code v2.1.119
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | Stale URL | Commands URL `/slash-commands` not in official sitemap (139 pages) — 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 19+ runs) |
| 2 | HIGH | Wrong Target URL | Tasks row (line 62) primary URL points to `/ultrareview#track-a-running-review` — anchor is valid but target is the ultrareview tracking section, not the broader Tasks system; canonical home is the local report `reports/claude-global-vs-project-settings.md#tasks-system` | ✅ COMPLETE (primary URL updated to `reports/claude-global-vs-project-settings.md#tasks-system`; ultrareview tracking anchor preserved as inline link "Ultrareview tracking" at end of description) |
| 3 | MED | Beta Badge Currency | Routines / No Flicker Mode / Computer Use / Code Review have `![beta]` in README but their docs pages no longer mark them as beta — re-evaluate and demote where appropriate | ❌ INVALID (verification fetched all 4 docs pages — Routines: "in research preview"; Fullscreen: "research preview"; Computer Use: "research preview on macOS"; Code Review: "in research preview" — README beta badges are accurate; the agent's 0.6-confidence read of body content was contradicted by `<Note>` banner text) |
| 4 | MED | Description Disambiguation | Scheduled Tasks row (line 61) description conflates `/loop` (local, session-scoped, 7-day expiry) and `/schedule` (cloud Routines on Anthropic infrastructure) — official `/en/scheduled-tasks` page now formally distinguishes Cloud / Desktop / Loop as three surfaces | ✅ COMPLETE (description now explicitly names "Three surfaces" with `/loop` local, `/schedule` cloud Routines, and Desktop scheduled tasks called out separately) |
| 5 | LOW | Missing Concept (optional) | Fast Mode is currently only a side-link inside Settings (line 31) — has its own dedicated `/en/fast-mode` page with `↯` indicator and `/fast` toggle (v2.1.36+); could be a Hot row | ✅ COMPLETE (Hot row inserted between Power-ups and Computer Use with beta badge; removed redundant Fast Mode side-link from Settings to prevent duplication) |
| 6 | LOW | Missing Inline Link | Memory row could surface `reports/claude-agent-memory.md` as an inline link — auto-memory is referenced but the local deep-dive isn't linked from CONCEPTS | ✅ COMPLETE ("Auto Memory Deep-dive" inline link added between Auto Memory docs and Rules in the Memory row) |
| 7 | LOW | Missing Inline Link | Skills row could surface `reports/claude-skills-for-larger-mono-repos.md` as an inline link — exists locally but only referenced from TIPS | ✅ COMPLETE ("Skills for Mono-repos" inline link appended after Official Skills in the Skills row) |
| 8 | LOW | Optional Concept | Vim visual mode (v2.1.118), Theme Customization (`~/.claude/themes/`, v2.1.118), and PowerShell tool (v2.1.111) could be Settings side-links — minor concepts surfaced by claude-code-guide cross-check | ❌ INVALID (Vim mode is covered by existing Keybindings side-link; Themes have no dedicated docs page distinct from Settings; PowerShell tool has no dedicated docs page — no concrete sub-link target warrants addition) |
| 9 | LOW | Verification | All 35+ external CONCEPTS docs URLs validated against llms.txt sitemap (139 pages) — only the recurring `/slash-commands` redirect flagged; all other URLs resolve to expected pages | ✅ COMPLETE (no NEW broken URLs) |
| 10 | LOW | Verification | All local badge file paths validated — all 20+ `best-practice/`, `implementation/`, and `reports/` targets exist on filesystem | ✅ COMPLETE (no missing local files) |
| 11 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` confirmed on `/en/memory` page | ✅ COMPLETE (stable since v2.1.113) |
| 12 | LOW | Verification | Git Worktrees anchor `#run-parallel-claude-code-sessions-with-git-worktrees` confirmed on `/en/common-workflows` page | ✅ COMPLETE (stable) |
| 13 | LOW | Verification | Auto Mode anchor `#eliminate-prompts-with-auto-mode` confirmed on `/en/permission-modes` page | ✅ COMPLETE (stable) |
| 14 | LOW | Verification | Bundled Skills anchor `#bundled-skills` confirmed on `/en/skills` page | ✅ COMPLETE (stable) |
| 15 | LOW | Verification | Ultrareview anchor `#track-a-running-review` confirmed on `/en/ultrareview` page | ✅ COMPLETE (stable since v2.1.118) |
| 16 | LOW | Verification | claude-code-guide cross-check — corroborated dedicated agent's findings on Vim mode (v2.1.118), Theme (v2.1.118), Effort xhigh (v2.1.111+ Opus 4.7), Worktrees (v2.1.105+); no contradictions | ✅ COMPLETE (both agents aligned) |
| 17 | LOW | Verification Checklist Update | Added new rule (#7) "Beta Badge Currency" to verification-checklist.md — covers re-evaluating beta badges against upstream docs page lifecycle | ✅ COMPLETE (rule added) |