diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md index cd2871d..89d131f 100644 --- a/changelog/best-practice/concepts/changelog.md +++ b/changelog/best-practice/concepts/changelog.md @@ -534,3 +534,21 @@ Tracks drift between the README CONCEPTS table and official Claude Code document | 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) | + +--- + +## [2026-05-21 12:07 AM PKT] Claude Code v2.1.145 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Wrong Location (NEW) | Checkpointing row (line 36) Location reads `automatic (git-based)` — factually wrong. Live `/en/checkpointing` fetch confirms checkpoints track "all changes made by its file editing tools", explicitly "do not track files modified by bash commands", and are "Not a replacement for version control" — *"Think of checkpoints as 'local undo' and Git as 'permanent history'."* The 2026-04-24 run only checked the (empty) Description column, never the Location, so this slipped through every prior run. Recommend `automatic (file-edit tracking)` | ✅ COMPLETE (user authorized; line 36 Location updated `automatic (git-based)` → `automatic (file-edit tracking)`) | +| 2 | MED | Missing Concept (NEW) | **Sessions** has a dedicated `/en/sessions` page (resume, `/rename`, fork/branch via `--fork-session`) never surfaced in CONCEPTS across any prior run; concepts-agent flagged at 0.6 confidence as possibly a runtime surface rather than an authoring concept | ❌ INVALID (user chose to skip — consistent with the standing "platform/runtime surface, not configuration concept" rejection pattern) | +| 3 | 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 23+ runs) | +| 4 | MED | Missing Concept (recurring) | Dedicated + claude-code-guide agents re-flagged IDE Integration, Desktop App, Output Styles, Permissions, Sandboxing, Headless Mode, .claude Directory, Tools Reference as missing standalone rows | ❌ INVALID (RECURRING from 2026-03-10/2026-03-17/2026-04-08/2026-05-01/2026-05-12; user considers all platform surfaces or covered as Settings/Memory sub-links — not standalone concepts) | +| 5 | LOW | Verification | Fast Mode URL `/en/fast-mode` fetched live — page valid ("Speed up responses with fast mode"), research preview, `/fast` toggle + `"fastMode": true` setting, Opus 4.7 default since v2.1.142; resolves concepts-agent's 0.5-confidence doubt — README Fast Mode row (line 52) is fully accurate | ✅ COMPLETE (row confirmed accurate, no change needed) | +| 6 | LOW | Verification | Latest version confirmed v2.1.145 via raw CHANGELOG.md (blob URL returns no body — used raw.githubusercontent.com per the documented workaround); v2.1.145 adds JSON session listing + OTEL agent identity — nothing CONCEPTS-worthy | ✅ COMPLETE (version verified; badge bumped v2.1.144 → v2.1.145 in Phase 2.6) | +| 7 | LOW | Verification | External CONCEPTS docs URLs spot-validated (`/en/checkpointing`, `/en/fast-mode`, CHANGELOG raw) + remainder stable since v2.1.139 run — only the recurring `/slash-commands` redirect flagged | ✅ COMPLETE (no NEW broken URLs) | +| 8 | LOW | Verification | Local badge file paths — no CONCEPTS table structural changes since v2.1.139; `best-practice/`, `implementation/`, `reports/`, `.claude/`, `.mcp.json`, `CLAUDE.md` targets stable | ✅ COMPLETE (stable since prior run) | +| 9 | LOW | Verification | Beta Badge Currency (rule #7) — `/en/fast-mode` confirms "research preview" `` banner; README `![beta]` on Fast Mode accurate | ✅ COMPLETE (no demotions warranted) | +| 10 | LOW | Verification | Anchors (`#organize-rules-with-clauderules`, `#run-parallel-...-worktrees`, `#eliminate-prompts-with-auto-mode`, `#bundled-skills`, `#track-a-running-review`) — stable since v2.1.113/v2.1.139 | ✅ COMPLETE (stable) | +| 11 | LOW | Verification | claude-code-guide cross-check — independent 80-concept sweep corroborated coverage; surfaced Auto Dream + MCP Tool Search as possible Memory/MCP sub-links and re-surfaced platform surfaces (RECURRING INVALID). Its version numbers were unreliable (e.g. "MCP introduced Dec 2024", fuzzy v-numbers) — deferred to dedicated agent + live fetches for all dates; no contradictions affecting CONCEPTS | ✅ COMPLETE (agents aligned; guide's fuzzy versioning noted, not used) |