diff --git a/README.md b/README.md
index 93e1d30..efd9be9 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
# claude-code-best-practice
practice makes claude perfect
- 
+-white?style=flat&labelColor=555)
[](best-practice/) *Click on this badge to show the latest best practice*
[](implementation/) *Click on this badge to show implementation in this repo*
@@ -25,7 +25,7 @@ practice makes claude perfect
| [**Subagents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/.md` | [](best-practice/claude-subagents.md) [](implementation/claude-subagents-implementation.md) Autonomous actor in fresh isolated context — custom tools, permissions, model, memory, and persistent identity |
| [**Skills**](https://code.claude.com/docs/en/skills) | `.claude/skills//SKILL.md` | [](best-practice/claude-skills.md) [](implementation/claude-skills-implementation.md) Knowledge injected into existing context — configurable, preloadable, auto-discoverable, with context forking and progressive disclosure · [Official Skills](https://github.com/anthropics/skills/tree/main/skills) |
| [**Workflows**](https://code.claude.com/docs/en/common-workflows) | [`.claude/commands/weather-orchestrator.md`](.claude/commands/weather-orchestrator.md) | [](orchestration-workflow/orchestration-workflow.md) |
-| [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [](https://github.com/shanraisshan/claude-code-voice-hooks) [](https://github.com/shanraisshan/claude-code-voice-hooks) Deterministic scripts that run outside the agentic loop on specific events |
+| [**Hooks**](https://code.claude.com/docs/en/hooks) | `.claude/hooks/` | [](https://github.com/shanraisshan/claude-code-voice-hooks) [](https://github.com/shanraisshan/claude-code-voice-hooks) User-defined handlers (scripts, HTTP, prompts, agents) that run outside the agentic loop on specific events · [Guide](https://code.claude.com/docs/en/hooks-guide) |
| [**MCP Servers**](https://code.claude.com/docs/en/mcp) | `.claude/settings.json`, `.mcp.json` | [](best-practice/claude-mcp.md) [](.mcp.json) Model Context Protocol connections to external tools, databases, and APIs |
| [**Plugins**](https://code.claude.com/docs/en/plugins) | distributable packages | Bundles of skills, subagents, hooks, and MCP servers · [Marketplaces](https://code.claude.com/docs/en/discover-plugins) |
| [**Settings**](https://code.claude.com/docs/en/settings) | `.claude/settings.json` | [](best-practice/claude-settings.md) [](.claude/settings.json) Hierarchical configuration system · [Permissions](https://code.claude.com/docs/en/permissions) · [Model Config](https://code.claude.com/docs/en/model-config) · [Output Styles](https://code.claude.com/docs/en/output-styles) · [Sandboxing](https://code.claude.com/docs/en/sandboxing) · [Keybindings](https://code.claude.com/docs/en/keybindings) · [Fast Mode](https://code.claude.com/docs/en/fast-mode) |
diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md
index ed95305..52d35a0 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.
@@ -33,7 +33,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| 2 | `/logout` |  | Log out from Claude Code |
| 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 |
-| 5 | `/config` |  | Open the interactive settings interface with search |
+| 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 |
| 8 | `/privacy-settings` |  | Manage privacy and telemetry preferences |
@@ -55,7 +55,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| 24 | `/help` |  | Show slash-command help |
| 25 | `/release-notes` |  | Show recent Claude Code release notes |
| 26 | `/tasks` |  | List and manage background tasks |
-| 27 | `/copy` |  | Copy the last assistant response to the clipboard |
+| 27 | `/copy` |  | Copy the last assistant response to clipboard. Shows interactive picker for code blocks |
| 28 | `/export [filename]` |  | Export the current conversation to a file or clipboard |
| 29 | `/agents` |  | Manage custom subagents — view, create, edit, delete |
| 30 | `/chrome` |  | Manage Claude in Chrome browser integration |
@@ -65,32 +65,32 @@ Claude Code commands — frontmatter fields and official built-in slash commands
| 34 | `/plugin` |  | Manage Claude Code plugins |
| 35 | `/reload-plugins` |  | Reload installed plugins without restarting |
| 36 | `/skills` |  | List available skills |
-| 37 | `/memory` |  | View and edit memory files |
+| 37 | `/memory` |  | Edit CLAUDE.md memory files, enable or disable auto-memory, and view auto-memory entries |
| 38 | `/effort [low\|medium\|high\|max\|auto]` |  | Set the model effort level |
| 39 | `/fast` |  | Toggle fast mode — same Opus 4.6 model with faster output |
| 40 | `/model` |  | Switch models (haiku, sonnet, opus) and adjust effort level |
| 41 | `/passes [number]` |  | Share a free week of Claude Code with friends. Only visible if your account is eligible |
| 42 | `/plan` |  | Enter read-only planning mode — suggests approaches without making changes |
| 43 | `/add-dir` |  | Add additional working directories to the current session |
-| 44 | `/diff` |  | Review the current git diff in the active repo |
+| 44 | `/diff` |  | Open an interactive diff viewer showing uncommitted changes and per-turn diffs |
| 45 | `/init` |  | Initialize a new project with a CLAUDE.md guide |
| 46 | `/pr-comments` |  | Review or reply to pull-request comments |
| 47 | `/review` |  | Deprecated — install the `code-review` plugin instead |
| 48 | `/security-review` |  | Run a focused security review on current changes |
-| 49 | `/desktop` |  | Continue the current session in the Claude Code Desktop app. macOS and Windows only. |
+| 49 | `/desktop` |  | Continue the current session in the Claude Code Desktop app. macOS and Windows only. Alias: `/app` |
| 50 | `/install-github-app` |  | Install the GitHub app for PR-linked workflows |
| 51 | `/install-slack-app` |  | Install the Slack app for notifications and sharing |
-| 52 | `/mobile` |  | Connect to or manage the mobile companion app |
-| 53 | `/remote-control` |  | Continue the current session from another device |
+| 52 | `/mobile` |  | Show QR code to download the Claude mobile app. Aliases: `/ios`, `/android` |
+| 53 | `/remote-control` |  | Make this session available for remote control from claude.ai. Alias: `/rc` |
| 54 | `/remote-env` |  | Inspect or copy the remote-control environment setup |
| 55 | `/btw ` |  | Ask a quick side question without adding to the conversation |
-| 56 | `/clear` |  | Clear conversation history and start fresh |
+| 56 | `/clear` |  | Clear conversation history and free up context. Aliases: `/reset`, `/new` |
| 57 | `/compact [prompt]` |  | Compress conversation to free context window. Optional prompt focuses the compaction |
-| 58 | `/exit` |  | Exit the REPL |
-| 59 | `/fork` |  | Fork the current conversation into a new session |
+| 58 | `/exit` |  | Exit the CLI. Alias: `/quit` |
+| 59 | `/fork` |  | Fork the current conversation into a new session. Alias: `/branch` |
| 60 | `/rename ` |  | Rename the current session for easier identification |
-| 61 | `/resume [session]` |  | Resume a previous conversation by ID or name, or open the session picker |
-| 62 | `/rewind` |  | Rewind conversation and/or code to an earlier point |
+| 61 | `/resume [session]` |  | Resume a previous conversation by ID or name, or open the session picker. Alias: `/continue` |
+| 62 | `/rewind` |  | Rewind the conversation and/or code to a previous point, or summarize from a selected message. 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 3612edf..3461ec9 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.76, Claude Code exposes **60+ settings** and **160+ 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.77, Claude Code exposes **60+ settings** and **100+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts).
@@ -70,7 +70,7 @@ Within the managed tier, precedence is: server-managed > MDM/OS-level policies >
| `cleanupPeriodDays` | number | `30` | Sessions inactive longer than this are deleted at startup. Setting to `0` deletes all existing transcripts and disables session persistence entirely (no `.jsonl` files written, `/resume` shows no conversations, hooks receive an empty `transcript_path`) |
| `autoUpdatesChannel` | string | `"latest"` | Release channel: `"stable"` or `"latest"` |
| `alwaysThinkingEnabled` | boolean | `false` | Enable extended thinking by default for all sessions |
-| `skipWebFetchPreflight` | boolean | `false` | Skip WebFetch blocklist check before fetching URLs |
+| `skipWebFetchPreflight` | boolean | `false` | Skip WebFetch blocklist check before fetching URLs *(in JSON schema, not on official settings page)* |
| `availableModels` | array | - | Restrict which models users can select via `/model`, `--model`, or `ANTHROPIC_MODEL`. Does not affect the Default option. Example: `["sonnet", "haiku"]` |
| `fastModePerSessionOptIn` | boolean | `false` | Require users to opt in to fast mode each session |
| `teammateMode` | string | `"auto"` | Agent team display mode: `"auto"` (split panes in tmux/iTerm2, in-process otherwise), `"in-process"`, or `"tmux"` |
@@ -218,7 +218,7 @@ Control what tools and operations Claude can perform.
| `permissions.defaultMode` | string | Default permission mode. In Remote environments, only `acceptEdits` and `plan` are honored (v2.1.70+) |
| `permissions.disableBypassPermissionsMode` | string | Prevent bypass mode activation |
| `allowManagedPermissionRulesOnly` | boolean | **(Managed only)** Only managed permission rules apply; user/project `allow`, `ask`, `deny` rules are ignored |
-| `allow_remote_sessions` | boolean | **(Managed only)** Allow users to start Remote Control and web sessions. Defaults to `true`. Set to `false` to prevent remote session access |
+| `allow_remote_sessions` | boolean | **(Managed only)** Allow users to start Remote Control and web sessions. Defaults to `true`. Set to `false` to prevent remote session access *(not in official docs — unverified)* |
### Permission Modes
@@ -359,19 +359,20 @@ Configure bash command sandboxing for security.
| `sandbox.autoAllowBashIfSandboxed` | boolean | `true` | Auto-approve bash when sandboxed |
| `sandbox.excludedCommands` | array | `[]` | Commands to run outside sandbox |
| `sandbox.allowUnsandboxedCommands` | boolean | `true` | Allow `dangerouslyDisableSandbox` |
-| `sandbox.ignoreViolations` | object | `{}` | Map of command patterns to path arrays — suppress violation warnings |
+| `sandbox.ignoreViolations` | object | `{}` | Map of command patterns to path arrays — suppress violation warnings *(in JSON schema, not on official settings page)* |
| `sandbox.enableWeakerNestedSandbox` | boolean | `false` | Weaker sandbox for Docker (reduces security) |
| `sandbox.network.allowUnixSockets` | array | `[]` | Specific Unix socket paths accessible in sandbox |
| `sandbox.network.allowAllUnixSockets` | boolean | `false` | Allow all Unix sockets (overrides allowUnixSockets) |
| `sandbox.network.allowLocalBinding` | boolean | `false` | Allow binding to localhost ports (macOS) |
| `sandbox.network.allowedDomains` | array | `[]` | Network domain allowlist for sandbox |
-| `sandbox.network.deniedDomains` | array | `[]` | Network domain denylist for sandbox |
+| `sandbox.network.deniedDomains` | array | `[]` | Network domain denylist for sandbox *(not in official docs — unverified)* |
| `sandbox.network.httpProxyPort` | number | - | HTTP proxy port 1-65535 (custom proxy) |
| `sandbox.network.socksProxyPort` | number | - | SOCKS5 proxy port 1-65535 (custom proxy) |
| `sandbox.network.allowManagedDomainsOnly` | boolean | `false` | Only allow domains in managed allowlist (managed settings) |
| `sandbox.filesystem.allowWrite` | array | `[]` | Path prefixes where write is allowed. Prefix: `//` (absolute), `~/` (home), `/` (project root), `./` (cwd) |
| `sandbox.filesystem.denyWrite` | array | `[]` | Path prefixes where write is denied |
| `sandbox.filesystem.denyRead` | array | `[]` | Path prefixes where read is denied |
+| `sandbox.filesystem.allowRead` | array | `[]` | Path prefixes to re-allow read access within `denyRead` regions. Use to carve out exceptions inside broadly denied paths |
| `sandbox.enableWeakerNetworkIsolation` | boolean | `false` | (macOS only) Allow access to system TLS trust (`com.apple.trustd.agent`); reduces security |
**Example:**
@@ -403,9 +404,9 @@ Configure Claude Code plugins and marketplaces.
| `enabledPlugins` | object | Any | Enable/disable specific plugins |
| `extraKnownMarketplaces` | object | Project | Add custom plugin marketplaces (team sharing via `.claude/settings.json`) |
| `strictKnownMarketplaces` | array | Managed only | Allowlist of permitted marketplaces |
-| `skippedMarketplaces` | array | Any | Marketplaces user declined to install |
-| `skippedPlugins` | array | Any | Plugins user declined to install |
-| `pluginConfigs` | object | Any | Per-plugin MCP server configs (keyed by `plugin@marketplace`) |
+| `skippedMarketplaces` | array | Any | Marketplaces user declined to install *(in JSON schema, not on official settings page)* |
+| `skippedPlugins` | array | Any | Plugins user declined to install *(in JSON schema, not on official settings page)* |
+| `pluginConfigs` | object | Any | Per-plugin MCP server configs (keyed by `plugin@marketplace`) *(in JSON schema, not on official settings page)* |
| `blockedMarketplaces` | array | Managed only | Block specific plugin marketplaces |
| `pluginTrustMessage` | string | Managed only | Custom message displayed when prompting users to trust plugins |
@@ -636,6 +637,10 @@ Set environment variables for all Claude Code sessions.
| `ANTHROPIC_API_KEY` | API key for authentication |
| `ANTHROPIC_AUTH_TOKEN` | OAuth token |
| `ANTHROPIC_BASE_URL` | Custom API endpoint |
+| `ANTHROPIC_MODEL` | Name of the model to use. Accepts aliases (`sonnet`, `opus`, `haiku`) or full model IDs. Overrides the `model` setting |
+| `ANTHROPIC_DEFAULT_HAIKU_MODEL` | Override the Haiku model alias with a custom model ID (e.g., for third-party deployments) |
+| `CLAUDECODE` | Set to `1` in shell environments Claude Code spawns (Bash tool, tmux sessions). Not set in hooks or status line commands. Use to detect when a script is running inside a Claude Code shell |
+| `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` | Set to `1` to allow fast mode when the organization status check fails due to a network error. Useful when a corporate proxy blocks the status endpoint |
| `CLAUDE_CODE_USE_BEDROCK` | Use AWS Bedrock (`1` to enable) |
| `CLAUDE_CODE_USE_VERTEX` | Use Google Vertex AI (`1` to enable) |
| `CLAUDE_CODE_USE_FOUNDRY` | Use Microsoft Foundry (`1` to enable) |
@@ -671,7 +676,7 @@ Set environment variables for all Claude Code sessions.
| `CLAUDE_CODE_PROMPT_CACHING_ENABLED` | Override prompt caching behavior *(not in official docs — unverified)* |
| `CLAUDE_CODE_DISABLE_TOOLS` | Comma-separated list of tools to disable *(not in official docs — unverified)* |
| `CLAUDE_CODE_DISABLE_MCP` | Disable all MCP servers (`1` to disable) *(not in official docs — unverified)* |
-| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Max output tokens per response (default: 32000, max: 64000) |
+| `CLAUDE_CODE_MAX_OUTPUT_TOKENS` | Max output tokens per response. Default: 32,000 (64,000 for Opus 4.6 as of v2.1.77). Upper bound: 64,000 (128,000 for Opus 4.6 and Sonnet 4.6 as of v2.1.77) |
| `CLAUDE_CODE_DISABLE_FAST_MODE` | Disable fast mode entirely (`1` to disable) |
| `CLAUDE_CODE_DISABLE_AUTO_MEMORY` | Disable auto memory (`1` to disable) |
| `CLAUDE_CODE_USER_EMAIL` | Provide user email synchronously for authentication |
diff --git a/best-practice/claude-skills.md b/best-practice/claude-skills.md
index 8417bf9..edf4b26 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/best-practice/claude-subagents.md b/best-practice/claude-subagents.md
index 2ee575c..1877e9c 100644
--- a/best-practice/claude-subagents.md
+++ b/best-practice/claude-subagents.md
@@ -1,6 +1,6 @@
# Sub-agents Best Practice
-
+
[](../implementation/claude-subagents-implementation.md)
Claude Code subagents — frontmatter fields and official built-in agent types.
diff --git a/changelog/best-practice/claude-commands/changelog.md b/changelog/best-practice/claude-commands/changelog.md
index e2e0a13..bbe6686 100644
--- a/changelog/best-practice/claude-commands/changelog.md
+++ b/changelog/best-practice/claude-commands/changelog.md
@@ -43,3 +43,18 @@
| 3 | MED | Changed Description | Update `/status` — now "Open the Settings interface (Status tab)" instead of "Show a concise session status summary" | ✅ COMPLETE (updated description at #20 in Context tag) |
| 4 | MED | Changed Description | Update `/desktop` — now "Continue the current session in the Claude Code Desktop app. macOS and Windows only." | ✅ COMPLETE (updated description at #49 in Remote tag) |
| 5 | LOW | Changed Argument | Update `/init` — official docs dropped `[prompt]` argument hint | ✅ COMPLETE (removed [prompt] hint at #45 in Project tag) |
+
+---
+
+## [2026-03-17 12:45 PM PKT] Claude Code v2.1.77
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | HIGH | New Alias | Add `Alias: /branch` to `/fork` entry (v2.1.77 renamed fork→branch) | ✅ COMPLETE (added "Alias: /branch" to /fork at #59 in Session tag) |
+| 2 | HIGH | New Aliases | Add aliases to 8 commands: `/clear` (+/reset, /new), `/config` (+/settings), `/desktop` (+/app), `/exit` (+/quit), `/rewind` (+/checkpoint), `/resume` (+/continue), `/remote-control` (+/rc), `/mobile` (+/ios, /android) | ✅ COMPLETE (added alias notations to all 8 command descriptions) |
+| 3 | MED | Changed Description | Update `/diff` — "Open an interactive diff viewer showing uncommitted changes and per-turn diffs" | ✅ COMPLETE (updated description at #44 in Project tag) |
+| 4 | MED | Changed Description | Update `/memory` — "Edit CLAUDE.md memory files, enable or disable auto-memory, and view auto-memory entries" | ✅ COMPLETE (updated description at #37 in Memory tag) |
+| 5 | MED | Changed Description | Update `/copy` — "Copy the last assistant response to clipboard. Shows interactive picker for code blocks" | ✅ COMPLETE (updated description at #27 in Export tag) |
+| 6 | MED | Changed Description | Update `/mobile` — "Show QR code to download the Claude mobile app" | ✅ COMPLETE (updated description + aliases at #52 in Remote tag) |
+| 7 | MED | Changed Description | Update `/remote-control` — "Make this session available for remote control from claude.ai" | ✅ COMPLETE (updated description + alias at #53 in Remote tag) |
+| 8 | LOW | Frontmatter Scope | 6 skill-only fields still absent from report (intentional scoping) | ❌ INVALID (skill-only fields — same determination as v2.1.74 run) |
diff --git a/changelog/best-practice/claude-settings/changelog.md b/changelog/best-practice/claude-settings/changelog.md
index 1c13c67..29709bf 100644
--- a/changelog/best-practice/claude-settings/changelog.md
+++ b/changelog/best-practice/claude-settings/changelog.md
@@ -119,3 +119,20 @@
| 10 | MED | Example Update | Update Quick Reference example to include `effortLevel` and `worktree` settings | ✅ COMPLETE (added effortLevel and worktree block to example) |
| 11 | LOW | Suspect Keys | `sandbox.ignoreViolations`, `sandbox.network.deniedDomains` still not in official docs sandbox table | ✋ ON HOLD (kept in report pending verification — recurring from 2026-03-05) |
| 12 | LOW | Suspect Keys | `skipWebFetchPreflight`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` — still in JSON schema but not on official settings page | ✋ ON HOLD (kept in report — valid per schema, recurring from 2026-03-05) |
+
+---
+
+## [2026-03-17 12:54 PM PKT] Claude Code v2.1.77
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | HIGH | New Setting | Add `sandbox.filesystem.allowRead` to Sandbox Settings table — re-allows read access within `denyRead` regions (array, default `[]`). Confirmed in v2.1.77 changelog | ✅ COMPLETE (added to Sandbox Settings table after denyRead row) |
+| 2 | HIGH | Changed Description | Update `CLAUDE_CODE_MAX_OUTPUT_TOKENS` description: default for Opus 4.6 increased to 64k, upper bound for Opus 4.6 and Sonnet 4.6 increased to 128k (v2.1.77 changelog) | ✅ COMPLETE (description updated with model-specific defaults and bounds) |
+| 3 | HIGH | Missing Env Var | Add `CLAUDECODE` to Common Environment Variables table — set to `1` in spawned shell environments. Confirmed on official /en/env-vars page | ✅ COMPLETE (added to env var table) |
+| 4 | HIGH | Missing Env Var | Add `CLAUDE_CODE_SKIP_FAST_MODE_NETWORK_ERRORS` to Common Environment Variables table — allows fast mode when org status check fails. Confirmed on official /en/env-vars page | ✅ COMPLETE (added to env var table) |
+| 5 | MED | Env Var Table | Move `ANTHROPIC_MODEL` and `ANTHROPIC_DEFAULT_HAIKU_MODEL` from code-block-only to Common Environment Variables table. Both confirmed on official /en/env-vars page | ✅ COMPLETE (added both to env var table near other ANTHROPIC_ vars) |
+| 6 | MED | Suspect Key Escalation | `sandbox.network.deniedDomains` — 8 consecutive ON HOLD runs (since 2026-03-05). NOT in official docs page or JSON schema. Per Rule 10B: mark as "not in official docs — unverified" | ✅ COMPLETE (added unverified annotation to description) |
+| 7 | MED | Suspect Key Escalation | `allow_remote_sessions` — NOT in official docs page or JSON schema. Mark as "not in official docs — unverified" | ✅ COMPLETE (added unverified annotation to description) |
+| 8 | LOW | Suspect Key Resolution | `sandbox.ignoreViolations` — 8 consecutive ON HOLD runs. Confirmed in JSON schema. Annotate: "in JSON schema, not on official settings page" | ✅ COMPLETE (added schema annotation to description) |
+| 9 | LOW | Suspect Key Resolution | `skipWebFetchPreflight`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` — 8 consecutive ON HOLD runs. All confirmed in JSON schema. Annotate: "in JSON schema, not on official settings page" | ✅ COMPLETE (added schema annotation to all 4 descriptions) |
+| 10 | LOW | Header Count | Update header env var count from "160+" to "100+" — actual table has 97 env vars | ✅ COMPLETE (header updated to "100+ environment variables", version to v2.1.77) |
\ 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 3890222..85725c5 100644
--- a/changelog/best-practice/claude-skills/changelog.md
+++ b/changelog/best-practice/claude-skills/changelog.md
@@ -23,3 +23,9 @@
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | LOW | Field Accuracy | `name` field Required column reads "Recommended" in local report but official docs now list it as "No" (optional) — update to match | ✅ COMPLETE (updated `name` Required from "Recommended" to "No" to match official docs) |
+
+---
+
+## [2026-03-17 12:42 PM PKT] Claude Code v2.1.77
+
+No drift detected — frontmatter fields (10) and bundled skills (5) are fully synchronized with official docs.
diff --git a/changelog/best-practice/claude-subagents/changelog.md b/changelog/best-practice/claude-subagents/changelog.md
index 817e438..f2cbe02 100644
--- a/changelog/best-practice/claude-subagents/changelog.md
+++ b/changelog/best-practice/claude-subagents/changelog.md
@@ -56,3 +56,9 @@ No drift detected — report is fully in sync with official docs. All 13 frontma
## [2026-03-15 12:50 PM PKT] Claude Code v2.1.76
No drift detected — report is fully in sync with official docs. All 13 frontmatter fields and 6 built-in agents match.
+
+---
+
+## [2026-03-17 12:42 PM PKT] Claude Code v2.1.77
+
+No drift detected — report is fully in sync with official docs. All 13 frontmatter fields and 6 built-in agents match.
diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md
index 28cd6b3..09a0465 100644
--- a/changelog/best-practice/concepts/changelog.md
+++ b/changelog/best-practice/concepts/changelog.md
@@ -98,3 +98,18 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
| 5 | LOW | Verification | All local badge file paths validated — no missing files | ✅ COMPLETE (all badge targets exist on filesystem) |
| 6 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` confirmed on /memory page | ✅ COMPLETE (section heading exists) |
| 7 | LOW | Verification | All CONCEPTS descriptions checked against official docs — no drift detected | ✅ COMPLETE (descriptions accurate for all 13 CONCEPTS + 9 Hot rows) |
+
+---
+
+## [2026-03-17 12:46 PM PKT] Claude Code v2.1.77
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | HIGH | Stale URL | Commands URL `/slash-commands` serves Skills page — docs say "commands merged into skills" | ❌ INVALID (RECURRING from 2026-03-10; URL still resolves; user chose to keep as-is) |
+| 2 | HIGH | Changed Description | Hooks description says "Deterministic scripts" but hooks now include 4 types: command, HTTP, prompt, and agent — only command hooks are deterministic | ✅ COMPLETE (updated to "User-defined handlers (scripts, HTTP, prompts, agents)" in CONCEPTS table) |
+| 3 | MED | Missing Concept | Desktop App has dedicated docs page at `/desktop` — not in CONCEPTS or Hot table | ❌ INVALID (user chose to skip — Desktop is a platform surface, not a configuration concept) |
+| 4 | MED | Changed URL | Hooks docs now split into Guide (`/hooks-guide`) and Reference (`/hooks`) — CONCEPTS links only to Reference | ✅ COMPLETE (Guide link added as inline link in Hooks row description) |
+| 5 | LOW | Verification | All 28 external docs URLs validated — no broken links found | ✅ COMPLETE (all URLs return valid pages including /slash-commands redirect) |
+| 6 | LOW | Verification | All local badge file paths validated — no missing files | ✅ COMPLETE (all 20 badge targets exist on filesystem) |
+| 7 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` confirmed on /memory page | ✅ COMPLETE (section heading exists) |
+| 8 | LOW | Verification | All CONCEPTS descriptions checked against official docs | ✅ COMPLETE (Hooks description drift detected — see #2) |