diff --git a/README.md b/README.md
index cad0e27..1bd843c 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
# claude-code-best-practice
practice makes claude perfect
--white?style=flat&labelColor=555) 
+-white?style=flat&labelColor=555)
[](best-practice/) [](implementation/) [](orchestration-workflow/orchestration-workflow.md) [](#-tips-and-tricks) 
= Agents · 
= Commands · 
= Skills
@@ -90,13 +90,13 @@ All major workflows converge on the same architectural pattern: **Research → P
| Name | ★ | Uniqueness | Plan | | | |
|------|---|------------|------|---|---|---|
-| [Superpowers](https://github.com/obra/superpowers) | 122k |    | [writing-plans](https://github.com/obra/superpowers/tree/main/skills/writing-plans) | 5 | 3 | 14 |
-| [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | 116k |    | [planner](https://github.com/affaan-m/everything-claude-code/blob/main/agents/planner.md) | 30 | 63 | 135 |
-| [Spec Kit](https://github.com/github/spec-kit) | 83k |    | [speckit.plan](https://github.com/github/spec-kit/blob/main/templates/commands/plan.md) | 0 | 9+ | 0 |
-| [gstack](https://github.com/garrytan/gstack) | 55k |    | [autoplan](https://github.com/garrytan/gstack/tree/main/autoplan) | 0 | 0 | 28 |
-| [Get Shit Done](https://github.com/gsd-build/get-shit-done) | 44k |    | [gsd-planner](https://github.com/gsd-build/get-shit-done/blob/main/agents/gsd-planner.md) | 18 | 57 | 0 |
-| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | 43k |    | [bmad-create-prd](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/bmm-skills/2-plan-workflows/bmad-create-prd) | 0 | 0 | 40 |
-| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | 35k |    | [opsx:propose](https://github.com/Fission-AI/OpenSpec/blob/main/src/commands/workflow/new-change.ts) | 0 | 11 | 0 |
+| [Superpowers](https://github.com/obra/superpowers) | 127k |    | [writing-plans](https://github.com/obra/superpowers/tree/main/skills/writing-plans) | 5 | 3 | 14 |
+| [Everything Claude Code](https://github.com/affaan-m/everything-claude-code) | 124k |    | [planner](https://github.com/affaan-m/everything-claude-code/blob/main/agents/planner.md) | 30 | 63 | 135 |
+| [Spec Kit](https://github.com/github/spec-kit) | 84k |    | [speckit.plan](https://github.com/github/spec-kit/blob/main/templates/commands/plan.md) | 0 | 9+ | 0 |
+| [gstack](https://github.com/garrytan/gstack) | 59k |    | [autoplan](https://github.com/garrytan/gstack/tree/main/autoplan) | 0 | 0 | 32 |
+| [Get Shit Done](https://github.com/gsd-build/get-shit-done) | 46k |    | [gsd-planner](https://github.com/gsd-build/get-shit-done/blob/main/agents/gsd-planner.md) | 18 | 57 | 0 |
+| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | 43k |    | [bmad-create-prd](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/bmm-skills/2-plan-workflows/bmad-create-prd) | 0 | 0 | 43 |
+| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | 36k |    | [opsx:propose](https://github.com/Fission-AI/OpenSpec/blob/main/src/commands/workflow/new-change.ts) | 0 | 11 | 0 |
| [Compound Engineering](https://github.com/EveryInc/compound-engineering-plugin) | 12k |    | [ce-plan](https://github.com/EveryInc/compound-engineering-plugin/tree/main/plugins/compound-engineering/skills/ce-plan) | 48 | 4 | 42 |
| [HumanLayer](https://github.com/humanlayer/humanlayer) | 10k |    | [create_plan](https://github.com/humanlayer/humanlayer/blob/main/.claude/commands/create_plan.md) | 6 | 27 | 0 |
diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md
index fa76374..96b264c 100644
--- a/best-practice/claude-commands.md
+++ b/best-practice/claude-commands.md
@@ -1,6 +1,6 @@
# Commands Best Practice
-
+
[](../implementation/claude-commands-implementation.md)
Claude Code commands — frontmatter fields and official built-in slash commands.
@@ -38,70 +38,70 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| # | Command | Tag | Description |
|---|---------|-----|-------------|
-| 1 | `/login` |  | Authenticate with Claude Code via OAuth |
-| 2 | `/logout` |  | Log out from Claude Code |
+| 1 | `/login` |  | Sign in to your Anthropic account |
+| 2 | `/logout` |  | Sign out from your Anthropic account |
| 3 | `/upgrade` |  | Open the upgrade page to switch to a higher plan tier |
-| 4 | `/color [color\|default]` |  | Set the prompt bar color for the current session |
+| 4 | `/color [color\|default]` |  | Set the prompt bar color for the current session. Available colors: `red`, `blue`, `green`, `yellow`, `purple`, `orange`, `pink`, `cyan`. Use `default` to reset |
| 5 | `/config` |  | Open the Settings interface to adjust theme, model, output style, and other preferences. Alias: `/settings` |
-| 6 | `/keybindings` |  | Customize keyboard shortcuts per context and create chord sequences |
-| 7 | `/permissions` |  | View or update tool permissions. Alias: `/allowed-tools` |
-| 8 | `/privacy-settings` |  | Manage privacy and telemetry preferences |
-| 9 | `/sandbox` |  | Configure sandboxing with dependency status |
-| 10 | `/statusline` |  | Set up Claude Code's status line UI |
+| 6 | `/keybindings` |  | Open or create your keybindings configuration file |
+| 7 | `/permissions` |  | View or update permissions. Alias: `/allowed-tools` |
+| 8 | `/privacy-settings` |  | View and update your privacy settings. Only available for Pro and Max plan subscribers |
+| 9 | `/sandbox` |  | Toggle sandbox mode. Available on supported platforms only |
+| 10 | `/statusline` |  | Configure Claude Code's status line. Describe what you want, or run without arguments to auto-configure from your shell prompt |
| 11 | `/stickers` |  | Order Claude Code stickers |
-| 12 | `/terminal-setup` |  | Enable shift+enter for newlines in IDE terminals |
-| 13 | `/theme` |  | Change the color theme |
-| 14 | `/vim` |  | Enable vim-style editing mode |
+| 12 | `/terminal-setup` |  | Configure terminal keybindings for Shift+Enter and other shortcuts. Only visible in terminals that need it, like VS Code, Alacritty, or Warp |
+| 13 | `/theme` |  | Change the color theme. Includes light and dark variants, colorblind-accessible (daltonized) themes, and ANSI themes that use your terminal's color palette |
+| 14 | `/vim` |  | Toggle between Vim and Normal editing modes |
| 15 | `/voice` |  | Toggle push-to-talk voice dictation. Requires a Claude.ai account |
-| 16 | `/context` |  | Visualize current context usage as a colored grid with token counts |
-| 17 | `/cost` |  | Show token usage statistics for the current session |
-| 18 | `/extra-usage` |  | Configure pay-as-you-go overflow billing for subscription plans |
+| 16 | `/context` |  | Visualize current context usage as a colored grid. Shows optimization suggestions for context-heavy tools, memory bloat, and capacity warnings |
+| 17 | `/cost` |  | Show token usage statistics. See cost tracking guide for subscription-specific details |
+| 18 | `/extra-usage` |  | Configure extra usage to keep working when rate limits are hit |
| 19 | `/insights` |  | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points |
| 20 | `/stats` |  | Visualize daily usage, session history, streaks, and model preferences |
-| 21 | `/status` |  | Open the Settings interface (Status tab) showing version, model, account, and connectivity |
-| 22 | `/usage` |  | Show plan usage limits and rate limit status (subscription plans only) |
-| 23 | `/doctor` |  | Check the health of your Claude Code installation |
+| 21 | `/status` |  | Open the Settings interface (Status tab) showing version, model, account, and connectivity. Works while Claude is responding, without waiting for the current response to finish |
+| 22 | `/usage` |  | Show plan usage limits and rate limit status |
+| 23 | `/doctor` |  | Diagnose and verify your Claude Code installation and settings |
| 24 | `/feedback [report]` |  | Submit feedback about Claude Code. Alias: `/bug` |
-| 25 | `/help` |  | Show slash-command help |
-| 26 | `/release-notes` |  | Show recent Claude Code release notes |
+| 25 | `/help` |  | Show help and available commands |
+| 26 | `/release-notes` |  | View the full changelog, with the most recent version closest to your prompt |
| 27 | `/tasks` |  | List and manage background tasks |
-| 28 | `/copy [N]` |  | Copy the last (or Nth-latest) assistant response to clipboard. Shows interactive picker for code blocks |
-| 29 | `/export [filename]` |  | Export the current conversation to a file or clipboard |
-| 30 | `/agents` |  | Manage custom subagents — view, create, edit, delete |
-| 31 | `/chrome` |  | Manage Claude in Chrome browser integration |
-| 32 | `/hooks` |  | Manage hook configurations for tool events |
-| 33 | `/ide` |  | Connect to IDE integration |
-| 34 | `/mcp` |  | Manage MCP server connections |
+| 28 | `/copy [N]` |  | Copy the last assistant response to clipboard. Pass a number `N` to copy the Nth-latest response: `/copy 2` copies the second-to-last. When code blocks are present, shows an interactive picker to select individual blocks or the full response. Press `w` in the picker to write the selection to a file instead of the clipboard, which is useful over SSH |
+| 29 | `/export [filename]` |  | Export the current conversation as plain text. With a filename, writes directly to that file. Without, opens a dialog to copy to clipboard or save to a file |
+| 30 | `/agents` |  | Manage agent configurations |
+| 31 | `/chrome` |  | Configure Claude in Chrome settings |
+| 32 | `/hooks` |  | View hook configurations for tool events |
+| 33 | `/ide` |  | Manage IDE integrations and show status |
+| 34 | `/mcp` |  | Manage MCP server connections and OAuth authentication |
| 35 | `/plugin` |  | Manage Claude Code plugins |
-| 36 | `/reload-plugins` |  | Reload installed plugins without restarting |
+| 36 | `/reload-plugins` |  | Reload all active plugins to apply pending changes without restarting. Reports counts for each reloaded component and flags any load errors |
| 37 | `/skills` |  | List available skills |
-| 38 | `/memory` |  | Edit CLAUDE.md memory files, enable or disable auto-memory, and view auto-memory entries |
-| 39 | `/effort [low\|medium\|high\|max\|auto]` |  | Set the model effort level |
-| 40 | `/fast [on\|off]` |  | Toggle fast mode — same Opus 4.6 model with faster output |
-| 41 | `/model [model]` |  | Select or change the AI model |
+| 38 | `/memory` |  | Edit `CLAUDE.md` memory files, enable or disable auto-memory, and view auto-memory entries |
+| 39 | `/effort [low\|medium\|high\|max\|auto]` |  | Set the model effort level. `low`, `medium`, and `high` persist across sessions. `max` applies to the current session only and requires Opus 4.6. `auto` resets to the model default. Without an argument, shows the current level. Takes effect immediately without waiting for the current response to finish |
+| 40 | `/fast [on\|off]` |  | Toggle fast mode on or off |
+| 41 | `/model [model]` |  | Select or change the AI model. For models that support it, use left/right arrows to adjust effort level. The change takes effect immediately without waiting for the current response to finish |
| 42 | `/passes` |  | Share a free week of Claude Code with friends. Only visible if your account is eligible |
-| 43 | `/plan [description]` |  | Enter plan mode directly from the prompt. Pass an optional description to start immediately with that task |
+| 43 | `/plan [description]` |  | Enter plan mode directly from the prompt. Pass an optional description to enter plan mode and immediately start with that task, for example `/plan fix the auth bug` |
| 44 | `/add-dir ` |  | Add a new working directory to the current session |
-| 45 | `/diff` |  | Open an interactive diff viewer showing uncommitted changes and per-turn diffs |
-| 46 | `/init` |  | Initialize a new project with a CLAUDE.md guide |
-| 47 | `/pr-comments [PR]` |  | Fetch and display comments from a GitHub pull request. Auto-detects PR for current branch, or pass a PR URL or number |
-| 48 | `/review` |  | Deprecated — install the `code-review` plugin instead |
-| 49 | `/security-review` |  | Run a focused security review on current changes |
+| 45 | `/diff` |  | Open an interactive diff viewer showing uncommitted changes and per-turn diffs. Use left/right arrows to switch between the current git diff and individual Claude turns, and up/down to browse files |
+| 46 | `/init` |  | Initialize project with a `CLAUDE.md` guide. Set `CLAUDE_CODE_NEW_INIT=true` for an interactive flow that also walks through skills, hooks, and personal memory files |
+| 47 | `/pr-comments [PR]` |  | Fetch and display comments from a GitHub pull request. Automatically detects the PR for the current branch, or pass a PR URL or number. Requires the `gh` CLI |
+| 48 | `/review` |  | Deprecated. Install the `code-review` plugin instead: `claude plugin install code-review@claude-plugins-official` |
+| 49 | `/security-review` |  | Analyze pending changes on the current branch for security vulnerabilities. Reviews the git diff and identifies risks like injection, auth issues, and data exposure |
| 50 | `/desktop` |  | Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: `/app` |
-| 51 | `/install-github-app` |  | Install the GitHub app for PR-linked workflows |
-| 52 | `/install-slack-app` |  | Install the Slack app for notifications and sharing |
+| 51 | `/install-github-app` |  | Set up the Claude GitHub Actions app for a repository. Walks you through selecting a repo and configuring the integration |
+| 52 | `/install-slack-app` |  | Install the Claude Slack app. Opens a browser to complete the OAuth flow |
| 53 | `/mobile` |  | Show QR code to download the Claude mobile app. Aliases: `/ios`, `/android` |
| 54 | `/remote-control` |  | Make this session available for remote control from claude.ai. Alias: `/rc` |
-| 55 | `/remote-env` |  | Inspect or copy the remote-control environment setup |
+| 55 | `/remote-env` |  | Configure the default remote environment for web sessions started with `--remote` |
| 56 | `/schedule [description]` |  | Create, update, list, or run Cloud scheduled tasks. Claude walks you through the setup conversationally |
| 57 | `/branch [name]` |  | Create a branch of the current conversation at this point. Alias: `/fork` |
| 58 | `/btw ` |  | Ask a quick side question without adding to the conversation |
| 59 | `/clear` |  | Clear conversation history and free up context. Aliases: `/reset`, `/new` |
| 60 | `/compact [instructions]` |  | Compact conversation with optional focus instructions |
| 61 | `/exit` |  | Exit the CLI. Alias: `/quit` |
-| 62 | `/rename [name]` |  | Rename the current session. Without a name, auto-generates one from conversation history |
-| 63 | `/resume [session]` |  | Resume a previous conversation by ID or name, or open the session picker. Alias: `/continue` |
-| 64 | `/rewind` |  | Rewind the conversation and/or code to a previous point, or summarize from a selected message. Alias: `/checkpoint` |
+| 62 | `/rename [name]` |  | Rename the current session and show the name on the prompt bar. Without a name, auto-generates one from conversation history |
+| 63 | `/resume [session]` |  | Resume a conversation by ID or name, or open the session picker. Alias: `/continue` |
+| 64 | `/rewind` |  | Rewind the conversation and/or code to a previous point, or summarize from a selected message. See checkpointing. Alias: `/checkpoint` |
Bundled skills such as `/debug` can also appear in the slash-command menu, but they are not built-in commands.
diff --git a/best-practice/claude-settings.md b/best-practice/claude-settings.md
index 4363c9c..a05ad68 100644
--- a/best-practice/claude-settings.md
+++ b/best-practice/claude-settings.md
@@ -1,8 +1,8 @@
# Claude Code Settings Reference
- 
+ 
-A comprehensive guide to all available configuration options in Claude Code's `settings.json` files. As of v2.1.86, Claude Code exposes **60+ settings** and **100+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts).
+A comprehensive guide to all available configuration options in Claude Code's `settings.json` files. As of v2.1.88, Claude Code exposes **60+ settings** and **100+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts).
@@ -44,7 +44,7 @@ Settings apply in order of precedence (highest to lowest):
- **Server-managed** settings (remote delivery)
- **MDM profiles** — macOS plist at `com.anthropic.claudecode`
- **Registry policies** — Windows `HKLM\SOFTWARE\Policies\ClaudeCode` (admin) and `HKCU\SOFTWARE\Policies\ClaudeCode` (user-level, lowest policy priority)
-- **File** — `managed-settings.json` (macOS: `/Library/Application Support/ClaudeCode/`, Linux/WSL: `/etc/claude-code/`, Windows: `C:\Program Files\ClaudeCode\`)
+- **File** — `managed-settings.json` and `managed-mcp.json` (macOS: `/Library/Application Support/ClaudeCode/`, Linux/WSL: `/etc/claude-code/`, Windows: `C:\Program Files\ClaudeCode\`)
- **Drop-in directory** — `managed-settings.d/` alongside `managed-settings.json` for independent policy fragments (v2.1.83). Following the systemd convention, `managed-settings.json` is merged first as the base, then all `*.json` files in the drop-in directory are sorted alphabetically and merged on top. Later files override earlier ones for scalar values; arrays are concatenated and de-duplicated; objects are deep-merged. Hidden files starting with `.` are ignored. Use numeric prefixes to control merge order (e.g., `10-telemetry.json`, `20-security.json`)
Within the managed tier, precedence is: server-managed > MDM/OS-level policies > file-based (`managed-settings.d/*.json` + `managed-settings.json`) > HKCU registry (Windows only). Only one managed source is used; sources do not merge across tiers. Within the file-based tier, drop-in files and the base file are merged together.
@@ -422,7 +422,7 @@ Configure Claude Code plugins and marketplaces.
| `blockedMarketplaces` | array | Managed only | Block specific plugin marketplaces |
| `pluginTrustMessage` | string | Managed only | Custom message displayed when prompting users to trust plugins |
-**Marketplace source types:** `github`, `git`, `directory`, `hostPattern`, `settings`, `url`, `npm`, `file`. Use `source: 'settings'` to declare a small set of plugins inline without setting up a hosted marketplace repository.
+**Marketplace source types:** `github`, `git`, `directory`, `hostPattern`, `settings`, `url` *(not in official docs — unverified)*, `npm` *(not in official docs — unverified)*, `file` *(not in official docs — unverified)*. Use `source: 'settings'` to declare a small set of plugins inline without setting up a hosted marketplace repository.
**Example:**
```json
@@ -761,6 +761,9 @@ Set environment variables for all Claude Code sessions.
| `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` | SessionEnd hook timeout in ms (replaces hard 1.5s limit) |
| `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY` | Disable feedback survey prompts (`1` to disable) |
| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Disable terminal title updates (`1` to disable) |
+| `CLAUDE_CODE_NO_FLICKER` | Set to `1` to enable flicker-free alt-screen rendering. Eliminates visual flicker during fullscreen redraws (v2.1.88) |
+| `CLAUDE_CODE_SCROLL_SPEED` | Mouse wheel scroll multiplier for fullscreen rendering. Increase for faster scrolling, decrease for finer control |
+| `CLAUDE_CODE_DISABLE_MOUSE` | Set to `1` to disable mouse tracking in fullscreen rendering. Useful when mouse events interfere with terminal multiplexers or accessibility tools |
| `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` | Skip automatic IDE extension installation (`1` to skip) |
| `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | Debounce interval in ms for OTel headers helper script |
| `CLAUDE_STREAM_IDLE_TIMEOUT_MS` | Timeout in ms before the streaming idle watchdog closes a stalled connection. Default: `90000` (90 seconds). Increase if long-running tools or slow networks cause premature timeout errors |
@@ -912,7 +915,6 @@ Set environment variables for all Claude Code sessions.
- [Claude Code Settings JSON Schema](https://json.schemastore.org/claude-code-settings.json)
- [Claude Code Changelog](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md)
- [Claude Code GitHub Settings Examples](https://github.com/feiskyer/claude-code-settings)
-- [Eesel AI - Developer's Guide to settings.json](https://www.eesel.ai/blog/settings-json-claude-code)
- [Shipyard - Claude Code CLI Cheatsheet](https://shipyard.build/blog/claude-code-cheat-sheet/)
- [Claude Code Environment Variables Reference](https://code.claude.com/docs/en/env-vars)
- [Claude Code Permissions Reference](https://code.claude.com/docs/en/permissions)
diff --git a/best-practice/claude-skills.md b/best-practice/claude-skills.md
index 0340422..cd4a48b 100644
--- a/best-practice/claude-skills.md
+++ b/best-practice/claude-skills.md
@@ -1,6 +1,6 @@
# Skills Best Practice
-
+
[](../implementation/claude-skills-implementation.md)
Claude Code skills — frontmatter fields and official bundled skills.
diff --git a/changelog/best-practice/claude-commands/changelog.md b/changelog/best-practice/claude-commands/changelog.md
index b29f242..b94d9c2 100644
--- a/changelog/best-practice/claude-commands/changelog.md
+++ b/changelog/best-practice/claude-commands/changelog.md
@@ -141,3 +141,11 @@ No priority action items — report is fully in sync with official documentation
| 7 | MED | Changed Argument | Update `/rename` — change from `` (required) to `[name]` (optional) per official docs | ✅ COMPLETE (updated at #62 in Session tag) |
| 8 | LOW | Changed Argument | Update `/compact` — change argument label from `[prompt]` to `[instructions]` per official docs | ✅ COMPLETE (updated at #60 in Session tag) |
| 9 | LOW | Changed Argument | Update `/feedback` — change argument label from `[description]` to `[report]` per official docs | ✅ COMPLETE (updated at #24 in Debug tag) |
+
+---
+
+## [2026-03-31 06:55 PM PKT] Claude Code v2.1.88
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | MED | Description Sync | Synced all 43 command descriptions to match official docs — behavioral clarifications (`/vim` toggle, `/sandbox` toggle, `/hooks` view), expanded detail (`/effort` persistence, `/copy` SSH write, `/model` effort arrows), and wording alignment across Auth, Config, Context, Debug, Export, Extensions, Model, Project, Remote, and Session tags | ✅ COMPLETE (all 64 descriptions now match official docs at code.claude.com/docs/en/commands) |
diff --git a/changelog/best-practice/claude-settings/changelog.md b/changelog/best-practice/claude-settings/changelog.md
index 7c699f3..f1035f6 100644
--- a/changelog/best-practice/claude-settings/changelog.md
+++ b/changelog/best-practice/claude-settings/changelog.md
@@ -256,4 +256,18 @@
|---|----------|------|--------|--------|
| 1 | HIGH | File Scope | Move `teammateMode` from General Settings (settings.json) to Global Config Settings (~/.claude.json). Official settings page lists it under "Global config settings" — adding to settings.json triggers schema validation error (Rule 1H). Same pattern as v2.1.78 `showTurnDuration` fix | ✅ COMPLETE (removed from General Settings table, added to Global Config Settings table after terminalProgressBarEnabled with agent-teams docs link) |
| 2 | HIGH | Type + Annotation | Fix `disableDeepLinkRegistration`: change type from `boolean` to `string` (value: `"disable"`), update description to match official docs, remove stale "(in changelog, not on official settings page)" annotation. Now confirmed on official settings page (line 169) | ✅ COMPLETE (type changed to string, description updated to match official docs, changelog annotation removed) |
-| 3 | HIGH | Version Bump | Update report version badge from v2.1.85 to v2.1.86 | ✅ COMPLETE (badge and header updated in Phase 2.6) |
\ No newline at end of file
+| 3 | HIGH | Version Bump | Update report version badge from v2.1.85 to v2.1.86 | ✅ COMPLETE (badge and header updated in Phase 2.6) |
+
+---
+
+## [2026-03-31 07:02 PM PKT] Claude Code v2.1.88
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | HIGH | Missing Env Var | Add `CLAUDE_CODE_NO_FLICKER` to Common Environment Variables table — enable flicker-free alt-screen rendering (v2.1.88). Confirmed on official /en/env-vars page | ✅ COMPLETE (added after CLAUDE_CODE_DISABLE_TERMINAL_TITLE) |
+| 2 | HIGH | Missing Env Vars | Add `CLAUDE_CODE_SCROLL_SPEED` and `CLAUDE_CODE_DISABLE_MOUSE` to Common Environment Variables table — fullscreen UI controls. Confirmed on official /en/env-vars page | ✅ COMPLETE (added after CLAUDE_CODE_NO_FLICKER) |
+| 3 | HIGH | Version Bump | Update report version badge from v2.1.86 to v2.1.88 | ✅ COMPLETE (badge, header version, and header text updated in Phase 2.6) |
+| 4 | HIGH | Broken Link | Fix `https://www.eesel.ai/blog/settings-json-claude-code` in Sources — returns CSS-only content, no readable blog post | ✅ COMPLETE (removed broken link from Sources section) |
+| 5 | MED | Settings Hierarchy | Add `managed-mcp.json` to file-based managed delivery methods — official settings page lists it alongside `managed-settings.json` for MCP server configuration | ✅ COMPLETE (added to File delivery method bullet in Settings Hierarchy) |
+| 6 | MED | Plugin Source Types | Annotate `url`, `npm`, `file` marketplace source types as "not in official docs — unverified" (only `github`, `git`, `directory`, `hostPattern`, `settings` confirmed) | ✅ COMPLETE (added unverified annotations to all 3 source types) |
+| 7 | LOW | Header Count | Update header from "60+ settings" to match actual table count after any additions | ❌ INVALID (count is accurate — 60+ settings and 125 env vars, both within stated ranges) |
\ No newline at end of file
diff --git a/changelog/best-practice/claude-skills/changelog.md b/changelog/best-practice/claude-skills/changelog.md
index 75507f4..cfeafd8 100644
--- a/changelog/best-practice/claude-skills/changelog.md
+++ b/changelog/best-practice/claude-skills/changelog.md
@@ -87,3 +87,9 @@ No drift detected — frontmatter fields (11) and bundled skills (5) are fully s
## [2026-03-28 05:59 PM PKT] Claude Code v2.1.86
No drift detected — frontmatter fields (13) and bundled skills (5) are fully synchronized with official docs.
+
+---
+
+## [2026-03-31 06:51 PM PKT] Claude Code v2.1.88
+
+No drift detected — frontmatter fields (13) and bundled skills (5) are fully synchronized with official docs.
diff --git a/changelog/development-workflows/changelog.md b/changelog/development-workflows/changelog.md
index ed04b0e..abeb6f6 100644
--- a/changelog/development-workflows/changelog.md
+++ b/changelog/development-workflows/changelog.md
@@ -178,3 +178,20 @@
| 6 | MED | Count Update | Update BMAD skills from 43 to 40 (recount: 29 bmm-skills + 11 core-skills; consolidation in recent patches) | COMPLETE (updated README table) |
| 7 | MED | Star Update | Update Compound Engineering ★ from 11k to 12k (11,500 actual) | COMPLETE (updated README table) |
| 8 | MED | Count Update | Update Compound Eng agents from 47 to 48 (1 new), skills from 43 to 42 (41 compound-eng + 1 coding-tutor) | COMPLETE (updated README table) |
+
+---
+
+## [2026-03-31 07:43 PM PKT] Development Workflows Update
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | HIGH | Star Update | Update Superpowers ★ from 122k to 127k (127,473 actual) | COMPLETE (updated README table) |
+| 2 | HIGH | Star Update | Update ECC ★ from 116k to 124k (124,279 actual) | COMPLETE (updated README table) |
+| 3 | HIGH | Star Update | Update gstack ★ from 55k to 59k (59,046 actual — v0.14.x Review Army, composable skills, adversarial review) | COMPLETE (updated README table) |
+| 4 | HIGH | Star Update | Update GSD ★ from 44k to 46k (45,773 actual) | COMPLETE (updated README table) |
+| 5 | HIGH | Count Update | Update gstack skills from 28 to 32 (4 new: design-html, sidebar CSS inspector, composable skill resolver, scope drift detection) | COMPLETE (updated README table) |
+| 6 | MED | Star Update | Update Spec Kit ★ from 83k to 84k (84,042 actual) | COMPLETE (updated README table) |
+| 7 | MED | Star Update | Update OpenSpec ★ from 35k to 36k (35,985 actual) | COMPLETE (updated README table) |
+| 8 | MED | Count Update | Update BMAD skills from 40 to 43 (32 bmm-skills + 11 core-skills; 3 new bmm-skills added including PRFAQ) | COMPLETE (updated README table) |
+| 9 | LOW | Count Verify | ECC commands 63→3, skills 135→30 — research agent only checked .claude/ dirs, missed root commands/ and .agents/skills/ breadth | INVALID (agent undercounting — keeping current values 63 commands, 135 skills) |
+| 10 | LOW | Count Verify | Superpowers agents 5→8 — agent counted 1 explicit + 7 implicit sub-agents, but v5.0.6 replaced subagent review loops with inline self-review | ON HOLD (contradictory signals — v5.0.6 reduced review agents while brainstorm added new ones, needs manual verification) |