diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md index 24f03c4..0e36976 100644 --- a/changelog/best-practice/concepts/changelog.md +++ b/changelog/best-practice/concepts/changelog.md @@ -570,3 +570,21 @@ Tracks drift between the README CONCEPTS table and official Claude Code document | 9 | LOW | Verification Checklist Update | Added rule #9 "Bundled Skill / Command Rename Tracking" — scan CHANGELOG (last N versions) + `/en/commands` + `/skills#bundled-skills` for command/skill renames or removals affecting Location-column command names | ✅ COMPLETE (rule added; origin: `/simplify`→`/code-review` rename was changelog-only, missed by docs-page-listing checks) | | 10 | LOW | Verification | Anchors stable since v2.1.113/v2.1.139 (`#organize-rules-with-clauderules`, `#run-parallel-...-worktrees`, `#eliminate-prompts-with-auto-mode`, `#bundled-skills`, `#track-a-running-review`) | ✅ COMPLETE (stable) | | 11 | LOW | Verification | claude-code-guide cross-check — independent 95-concept sweep corroborated coverage but **missed the `/simplify`→`/code-review` rename** (changelog-only event invisible to docs-page listing; dedicated agent caught it via raw CHANGELOG); re-surfaced platform surfaces (RECURRING INVALID); version numbers fuzzy, deferred to live CHANGELOG | ✅ COMPLETE (agents aligned on coverage; rename gap noted) | + +--- + +## [2026-06-01 12:03 AM PKT] Claude Code v2.1.158 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Missing Concept (NEW) | Add **Dynamic Workflows** row to Hot table — v2.1.154 introduced script-based orchestration of tens-to-hundreds of subagents (`/workflows`, `workflow` keyword, `/effort ultracode`, `.claude/workflows/`, bundled `/deep-research`). Dedicated `/en/workflows` docs page confirmed live; both agents independently flagged it as the top gap. Distinct from existing "Workflows" row (line 30, `/en/common-workflows` = Research→Plan→Execute patterns) — name it **Dynamic Workflows** to avoid collision | ✅ COMPLETE (user approved; row inserted at line 64 between Deep Links and Agent Teams to cluster the multi-agent orchestration surfaces — Dynamic Workflows → Agent Teams → Agent View — with `![beta]` badge and `[Deep Research]` link; table re-verified 3-column consistent) | +| 2 | MED | Beta Badge Currency (rule #7) | Concepts-agent doubted Auto Mode `![beta]` badge (0.5) citing "no longer requires opt-in" (v2.1.152) | ❌ INVALID (live `/en/permission-modes` `` confirms *"Auto mode is a research preview"* — badge accurate, no demotion; agent's body-text read contradicted by banner, same pattern as 2026-04-26) | +| 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 25+ runs) | +| 4 | MED | Missing Concept (recurring) | Dedicated + claude-code-guide agents re-flagged Sessions, IDE Integration, Desktop App, Output Styles, Permissions, Sandboxing, Headless Mode, Context Window as missing standalone rows | ❌ INVALID (RECURRING from 2026-03-10/03-17/04-08/05-01/05-12/05-21/05-25; user considers all platform/runtime surfaces or covered as Settings/Memory sub-links — not standalone concepts) | +| 5 | LOW | Model Freshness (out of scope) | Concepts-agent flagged TIPS section references "Opus 4.7" while Opus 4.8 is now default (v2.1.154) | ✋ ON HOLD (TIPS-section content, outside the CONCEPTS-table scope of this workflow; deferred to user — not a CONCEPTS-table action item) | +| 6 | LOW | Verification | Latest version confirmed v2.1.158 via raw CHANGELOG.md (blob URL returns no body — used raw.githubusercontent.com per documented workaround); v2.1.155–158 add thinking-block fix (2.1.156), `.claude/skills` plugin auto-load (2.1.157), auto mode on Bedrock/Vertex/Foundry (2.1.158) — nothing CONCEPTS-worthy beyond #1 | ✅ COMPLETE (version verified; badge bumped v2.1.150 → v2.1.158 in Phase 2.6) | +| 7 | LOW | Verification | `/en/workflows` fetched live — `` "Dynamic workflows are in research preview… require Claude Code v2.1.154 or later"; `#run-a-bundled-workflow` anchor confirmed; Location claims (`/workflows`, `workflow` keyword, `/effort ultracode`, `.claude/workflows/`) all verified against page body | ✅ COMPLETE (NEW URL returns expected canonical page; rules #1/#2/#8 satisfied for the new row) | +| 8 | LOW | Verification | Beta Badge Currency (rule #7) — both Auto Mode and the proposed Dynamic Workflows row confirmed research preview via live ``/`` banners | ✅ COMPLETE (Dynamic Workflows beta badge warranted; Auto Mode badge accurate) | +| 9 | LOW | Verification | Local badge/link target files validated via filesystem check — `best-practice/`, `implementation/`, `reports/` targets exist; `implementation/claude-tasks-implementation.md` is **absent**, so concepts-agent's "add Tasks Implemented badge" suggestion is not actionable (no file to link) | ✅ COMPLETE (no missing local files among linked targets; Tasks-badge suggestion INVALID for lack of target) | +| 10 | LOW | Verification | Command rename scan (rule #9) — changelog top 10 shows no NEW renames affecting Location-column command names; `/code-review`,`/batch` in Bundled Skills row still accurate; `/deep-research` is a new bundled workflow command surfaced under the proposed Dynamic Workflows row | ✅ COMPLETE (no rename drift; `/reload-skills` v2.1.152 is a new command, not a rename) | +| 11 | LOW | Verification | claude-code-guide cross-check — independent 99-concept sweep corroborated Dynamic Workflows (v2.1.154), Opus 4.8, Ultracode; re-surfaced platform surfaces (RECURRING INVALID); flagged a docs/changelog lag — changelog 2.1.158 says auto mode reached Bedrock/Vertex/Foundry while `/en/permission-modes` still reads "Anthropic API only" (not CONCEPTS-actionable; Auto Mode row makes no provider claim) | ✅ COMPLETE (agents aligned on the NEW finding; lag noted, no action) |