updated to 2.1.76
This commit is contained in:
Shayan Rais
@@ -1,7 +1,7 @@
|
||||
# claude-code-best-practice
|
||||
practice makes claude perfect
|
||||
|
||||
 <a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars"></a>
|
||||
 <a href="https://github.com/shanraisshan/claude-code-best-practice/stargazers"><img src="https://img.shields.io/github/stars/shanraisshan/claude-code-best-practice?style=flat&label=%E2%98%85&labelColor=555&color=white" alt="GitHub Stars"></a>
|
||||
|
||||
[](best-practice/) *Click on this badge to show the latest best practice*<br>
|
||||
[](implementation/) *Click on this badge to show implementation in this repo*<br>
|
||||
@@ -22,7 +22,7 @@ practice makes claude perfect
|
||||
| Feature | Location | Description |
|
||||
|---------|----------|-------------|
|
||||
| [**Commands**](https://code.claude.com/docs/en/slash-commands) | `.claude/commands/<name>.md` | [](best-practice/claude-commands.md) [](implementation/claude-commands-implementation.md) Knowledge injected into existing context — simple user-invoked prompt templates for workflow orchestration |
|
||||
| [**Sub-Agents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/<name>.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 |
|
||||
| [**Subagents**](https://code.claude.com/docs/en/sub-agents) | `.claude/agents/<name>.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/<name>/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 |
|
||||
@@ -46,7 +46,7 @@ practice makes claude perfect
|
||||
| [**Voice Mode**](https://x.com/trq212/status/2028628570692890800)  | `/voice` | [](https://x.com/trq212/status/2028628570692890800) speak to prompt - /voice to activate|
|
||||
| [**Simplify & Batch**](https://x.com/bcherny/status/2027534984534544489) | `/simplify`, `/batch` | [](https://x.com/bcherny/status/2027534984534544489) Built-in skills for code quality and bulk operations — simplify refactors for reuse and efficiency, batch runs commands across files |
|
||||
| [**Agent Teams**](https://code.claude.com/docs/en/agent-teams)  | built-in (env var) | [](https://x.com/bcherny/status/2019472394696683904) [](implementation/claude-agent-teams-implementation.md) Multiple agents working in parallel on the same codebase with shared task coordination |
|
||||
| [**Remote Control**](https://code.claude.com/docs/en/remote-control) | `/remote-control`, `/rc` | Continue local sessions from any device — phone, tablet, or browser · [Headless Mode](https://code.claude.com/docs/en/headless) |
|
||||
| [**Remote Control**](https://code.claude.com/docs/en/remote-control) | `/remote-control`, `/rc` | [](https://code.claude.com/docs/en/remote-control) Continue local sessions from any device — phone, tablet, or browser · [Headless Mode](https://code.claude.com/docs/en/headless) |
|
||||
| [**Git Worktrees**](https://code.claude.com/docs/en/common-workflows) | built-in | [](https://x.com/bcherny/status/2025007393290272904) Isolated git branches for parallel development — each agent gets its own working copy |
|
||||
| [**Ralph Wiggum Loop**](https://github.com/anthropics/claude-code/tree/main/plugins/ralph-wiggum) | plugin | [](https://github.com/ghuntley/how-to-ralph-wiggum) [](https://github.com/shanraisshan/novel-llm-26) Autonomous development loop for long-running tasks — iterates until completion |
|
||||
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Commands Best Practice
|
||||
|
||||
<br>
|
||||
<br>
|
||||
[](../implementation/claude-commands-implementation.md)
|
||||
|
||||
Claude Code commands — frontmatter fields and official built-in slash commands.
|
||||
@@ -25,70 +25,72 @@ Claude Code commands — frontmatter fields and official built-in slash commands
|
||||
|
||||
---
|
||||
|
||||
##  **(60)**
|
||||
##  **(62)**
|
||||
|
||||
| # | Command | Tag | Description |
|
||||
|---|---------|-----|-------------|
|
||||
| 1 | `/login` |  | Authenticate with Claude Code via OAuth |
|
||||
| 2 | `/logout` |  | Log out from Claude Code |
|
||||
| 3 | `/upgrade` |  | Open the upgrade page to switch to a higher plan tier |
|
||||
| 4 | `/config` |  | Open the interactive settings interface with search |
|
||||
| 5 | `/keybindings` |  | Customize keyboard shortcuts per context and create chord sequences |
|
||||
| 6 | `/permissions` |  | View or update tool permissions |
|
||||
| 7 | `/privacy-settings` |  | Manage privacy and telemetry preferences |
|
||||
| 8 | `/sandbox` |  | Configure sandboxing with dependency status |
|
||||
| 9 | `/statusline` |  | Set up Claude Code's status line UI |
|
||||
| 10 | `/stickers` |  | Order Claude Code stickers |
|
||||
| 11 | `/terminal-setup` |  | Enable shift+enter for newlines in IDE terminals |
|
||||
| 12 | `/theme` |  | Change the color theme |
|
||||
| 13 | `/vim` |  | Enable vim-style editing mode |
|
||||
| 14 | `/context` |  | Visualize current context usage as a colored grid with token counts |
|
||||
| 15 | `/cost` |  | Show token usage statistics for the current session |
|
||||
| 16 | `/extra-usage` |  | Configure pay-as-you-go overflow billing for subscription plans |
|
||||
| 17 | `/insights` |  | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points |
|
||||
| 18 | `/stats` |  | Visualize daily usage, session history, streaks, and model preferences |
|
||||
| 19 | `/status` |  | Show a concise session status summary |
|
||||
| 20 | `/usage` |  | Show plan usage limits and rate limit status (subscription plans only) |
|
||||
| 21 | `/doctor` |  | Check the health of your Claude Code installation |
|
||||
| 22 | `/feedback [description]` |  | Generate a GitHub issue URL for reporting bugs or feedback. Alias: `/bug` |
|
||||
| 23 | `/help` |  | Show slash-command help |
|
||||
| 24 | `/release-notes` |  | Show recent Claude Code release notes |
|
||||
| 25 | `/tasks` |  | List and manage background tasks |
|
||||
| 26 | `/copy` |  | Copy the last assistant response to the clipboard |
|
||||
| 27 | `/export [filename]` |  | Export the current conversation to a file or clipboard |
|
||||
| 28 | `/agents` |  | Manage custom subagents — view, create, edit, delete |
|
||||
| 29 | `/chrome` |  | Manage Claude in Chrome browser integration |
|
||||
| 30 | `/hooks` |  | Manage hook configurations for tool events |
|
||||
| 31 | `/ide` |  | Connect to IDE integration |
|
||||
| 32 | `/mcp` |  | Manage MCP server connections |
|
||||
| 33 | `/plugin` |  | Manage Claude Code plugins |
|
||||
| 34 | `/reload-plugins` |  | Reload installed plugins without restarting |
|
||||
| 35 | `/skills` |  | List available skills |
|
||||
| 36 | `/memory` |  | View and edit memory files |
|
||||
| 37 | `/fast` |  | Toggle fast mode — same Opus 4.6 model with faster output |
|
||||
| 38 | `/model` |  | Switch models (haiku, sonnet, opus) and adjust effort level |
|
||||
| 39 | `/passes [number]` |  | Share a free week of Claude Code with friends. Only visible if your account is eligible |
|
||||
| 40 | `/plan` |  | Enter read-only planning mode — suggests approaches without making changes |
|
||||
| 41 | `/add-dir` |  | Add additional working directories to the current session |
|
||||
| 42 | `/diff` |  | Review the current git diff in the active repo |
|
||||
| 43 | `/init [prompt]` |  | Initialize a new project with a CLAUDE.md guide |
|
||||
| 44 | `/pr-comments` |  | Review or reply to pull-request comments |
|
||||
| 45 | `/review` |  | Deprecated — install the `code-review` plugin instead |
|
||||
| 46 | `/security-review` |  | Run a focused security review on current changes |
|
||||
| 47 | `/desktop` |  | Connect to or manage the desktop companion app |
|
||||
| 48 | `/install-github-app` |  | Install the GitHub app for PR-linked workflows |
|
||||
| 49 | `/install-slack-app` |  | Install the Slack app for notifications and sharing |
|
||||
| 50 | `/mobile` |  | Connect to or manage the mobile companion app |
|
||||
| 51 | `/remote-control` |  | Continue the current session from another device |
|
||||
| 52 | `/remote-env` |  | Inspect or copy the remote-control environment setup |
|
||||
| 53 | `/btw <question>` |  | Ask a quick side question without adding to the conversation |
|
||||
| 54 | `/clear` |  | Clear conversation history and start fresh |
|
||||
| 55 | `/compact [prompt]` |  | Compress conversation to free context window. Optional prompt focuses the compaction |
|
||||
| 56 | `/exit` |  | Exit the REPL |
|
||||
| 57 | `/fork` |  | Fork the current conversation into a new session |
|
||||
| 58 | `/rename <name>` |  | Rename the current session for easier identification |
|
||||
| 59 | `/resume [session]` |  | Resume a previous conversation by ID or name, or open the session picker |
|
||||
| 60 | `/rewind` |  | Rewind conversation and/or code to an earlier point |
|
||||
| 4 | `/color [color\|default]` |  | Set the prompt bar color for the current session |
|
||||
| 5 | `/config` |  | Open the interactive settings interface with search |
|
||||
| 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 |
|
||||
| 9 | `/sandbox` |  | Configure sandboxing with dependency status |
|
||||
| 10 | `/statusline` |  | Set up Claude Code's status line UI |
|
||||
| 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 |
|
||||
| 15 | `/context` |  | Visualize current context usage as a colored grid with token counts |
|
||||
| 16 | `/cost` |  | Show token usage statistics for the current session |
|
||||
| 17 | `/extra-usage` |  | Configure pay-as-you-go overflow billing for subscription plans |
|
||||
| 18 | `/insights` |  | Generate a report analyzing your Claude Code sessions, including project areas, interaction patterns, and friction points |
|
||||
| 19 | `/stats` |  | Visualize daily usage, session history, streaks, and model preferences |
|
||||
| 20 | `/status` |  | Open the Settings interface (Status tab) showing version, model, account, and connectivity |
|
||||
| 21 | `/usage` |  | Show plan usage limits and rate limit status (subscription plans only) |
|
||||
| 22 | `/doctor` |  | Check the health of your Claude Code installation |
|
||||
| 23 | `/feedback [description]` |  | Generate a GitHub issue URL for reporting bugs or feedback. Alias: `/bug` |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 31 | `/hooks` |  | Manage hook configurations for tool events |
|
||||
| 32 | `/ide` |  | Connect to IDE integration |
|
||||
| 33 | `/mcp` |  | Manage MCP server connections |
|
||||
| 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 |
|
||||
| 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 |
|
||||
| 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. |
|
||||
| 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 |
|
||||
| 54 | `/remote-env` |  | Inspect or copy the remote-control environment setup |
|
||||
| 55 | `/btw <question>` |  | Ask a quick side question without adding to the conversation |
|
||||
| 56 | `/clear` |  | Clear conversation history and start fresh |
|
||||
| 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 |
|
||||
| 60 | `/rename <name>` |  | 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 |
|
||||
|
||||
Bundled skills such as `/debug` can also appear in the slash-command menu, but they are not built-in commands.
|
||||
|
||||
|
||||
@@ -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.75, Claude Code exposes **55+ settings** and **140+ 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.76, Claude Code exposes **55+ settings** and **140+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts).
|
||||
|
||||
<table width="100%">
|
||||
<tr>
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Skills Best Practice
|
||||
|
||||
<br>
|
||||
<br>
|
||||
[](../implementation/claude-skills-implementation.md)
|
||||
|
||||
Claude Code skills — frontmatter fields and official bundled skills.
|
||||
@@ -18,7 +18,7 @@ Claude Code skills — frontmatter fields and official bundled skills.
|
||||
|
||||
| Field | Type | Required | Description |
|
||||
|-------|------|----------|-------------|
|
||||
| `name` | string | Recommended | Display name and `/slash-command` identifier. Defaults to the directory name if omitted |
|
||||
| `name` | string | No | Display name and `/slash-command` identifier. Defaults to the directory name if omitted |
|
||||
| `description` | string | Recommended | What the skill does. Shown in autocomplete and used by Claude for auto-discovery |
|
||||
| `argument-hint` | string | No | Hint shown during autocomplete (e.g., `[issue-number]`, `[filename]`) |
|
||||
| `disable-model-invocation` | boolean | No | Set `true` to prevent Claude from automatically invoking this skill |
|
||||
|
||||
@@ -1,6 +1,6 @@
|
||||
# Sub-agents Best Practice
|
||||
|
||||
<br>
|
||||
<br>
|
||||
[](../implementation/claude-subagents-implementation.md)
|
||||
|
||||
Claude Code subagents — frontmatter fields and official built-in agent types.
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
| Status | Meaning |
|
||||
|--------|---------|
|
||||
| COMPLETE (reason) | Action was taken and resolved successfully |
|
||||
| INVALID (reason) | Finding was incorrect, not applicable, or intentional |
|
||||
| ON HOLD (reason) | Action deferred — waiting on external dependency or user decision |
|
||||
| ✅ `COMPLETE (reason)` | Action was taken and resolved successfully |
|
||||
| ❌ `INVALID (reason)` | Finding was incorrect, not applicable, or intentional |
|
||||
| ✋ `ON HOLD (reason)` | Action deferred — waiting on external dependency or user decision |
|
||||
|
||||
---
|
||||
|
||||
@@ -14,20 +14,32 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | New Field | Add `name` to frontmatter table — display name for the skill | INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 2 | HIGH | New Field | Add `disable-model-invocation` to frontmatter table — prevents auto-loading | INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 3 | HIGH | New Field | Add `user-invocable` to frontmatter table — hides from `/` menu | INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 4 | HIGH | New Field | Add `context` to frontmatter table — fork to run in subagent context | INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 5 | HIGH | New Field | Add `agent` to frontmatter table — subagent type for context: fork | INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 6 | HIGH | New Field | Add `hooks` to frontmatter table — lifecycle hooks scoped to skill | INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 7 | HIGH | New Command | Add `/btw <question>` — ask a quick side question without adding to conversation | COMPLETE (added as #53 in Session tag) |
|
||||
| 8 | HIGH | New Command | Add `/hooks` — manage hook configurations for tool events | COMPLETE (added as #30 in Extensions tag) |
|
||||
| 9 | HIGH | New Command | Add `/insights` — generate session analysis report | COMPLETE (added as #17 in Context tag) |
|
||||
| 10 | HIGH | New Command | Add `/plugin` — manage Claude Code plugins | COMPLETE (added as #33 in Extensions tag) |
|
||||
| 11 | HIGH | New Command | Add `/skills` — list available skills | COMPLETE (added as #35 in Extensions tag) |
|
||||
| 12 | HIGH | New Command | Add `/upgrade` — open upgrade page to switch plan tier | COMPLETE (added as #3 in Auth tag) |
|
||||
| 13 | HIGH | Removed Command | Remove `/output-style` — deprecated in v2.1.73, use `/config` instead | COMPLETE (removed from Config tag) |
|
||||
| 14 | HIGH | Removed Command | Remove `/bug` row — now listed as alias under `/feedback` | COMPLETE (removed row, added "Alias: /bug" to /feedback description) |
|
||||
| 15 | HIGH | Changed Description | Update `/passes` — repurposed from review passes to referral sharing | COMPLETE (updated description, kept in Model tag) |
|
||||
| 16 | HIGH | Changed Description | Update `/review` — deprecated, replaced by `code-review` marketplace plugin | COMPLETE (updated description in Project tag) |
|
||||
| 17 | MED | Changed Description | Update `/stickers` — changed from UI sticker packs to ordering physical stickers | COMPLETE (updated description in Config tag) |
|
||||
| 1 | HIGH | New Field | Add `name` to frontmatter table — display name for the skill | ❌ INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 2 | HIGH | New Field | Add `disable-model-invocation` to frontmatter table — prevents auto-loading | ❌ INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 3 | HIGH | New Field | Add `user-invocable` to frontmatter table — hides from `/` menu | ❌ INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 4 | HIGH | New Field | Add `context` to frontmatter table — fork to run in subagent context | ❌ INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 5 | HIGH | New Field | Add `agent` to frontmatter table — subagent type for context: fork | ❌ INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 6 | HIGH | New Field | Add `hooks` to frontmatter table — lifecycle hooks scoped to skill | ❌ INVALID (skill-only field, not applicable to commands frontmatter) |
|
||||
| 7 | HIGH | New Command | Add `/btw <question>` — ask a quick side question without adding to conversation | ✅ COMPLETE (added as #53 in Session tag) |
|
||||
| 8 | HIGH | New Command | Add `/hooks` — manage hook configurations for tool events | ✅ COMPLETE (added as #30 in Extensions tag) |
|
||||
| 9 | HIGH | New Command | Add `/insights` — generate session analysis report | ✅ COMPLETE (added as #17 in Context tag) |
|
||||
| 10 | HIGH | New Command | Add `/plugin` — manage Claude Code plugins | ✅ COMPLETE (added as #33 in Extensions tag) |
|
||||
| 11 | HIGH | New Command | Add `/skills` — list available skills | ✅ COMPLETE (added as #35 in Extensions tag) |
|
||||
| 12 | HIGH | New Command | Add `/upgrade` — open upgrade page to switch plan tier | ✅ COMPLETE (added as #3 in Auth tag) |
|
||||
| 13 | HIGH | Removed Command | Remove `/output-style` — deprecated in v2.1.73, use `/config` instead | ✅ COMPLETE (removed from Config tag) |
|
||||
| 14 | HIGH | Removed Command | Remove `/bug` row — now listed as alias under `/feedback` | ✅ COMPLETE (removed row, added "Alias: /bug" to /feedback description) |
|
||||
| 15 | HIGH | Changed Description | Update `/passes` — repurposed from review passes to referral sharing | ✅ COMPLETE (updated description, kept in Model tag) |
|
||||
| 16 | HIGH | Changed Description | Update `/review` — deprecated, replaced by `code-review` marketplace plugin | ✅ COMPLETE (updated description in Project tag) |
|
||||
| 17 | MED | Changed Description | Update `/stickers` — changed from UI sticker packs to ordering physical stickers | ✅ COMPLETE (updated description in Config tag) |
|
||||
|
||||
---
|
||||
|
||||
## [2026-03-15 12:50 PM PKT] Claude Code v2.1.76
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | New Command | Add `/color [color\|default]` to Config tag — set prompt bar color for current session | ✅ COMPLETE (added as #4 in Config tag) |
|
||||
| 2 | HIGH | New Command | Add `/effort [low\|medium\|high\|max\|auto]` to Model tag — set model effort level | ✅ COMPLETE (added as #38 in Model tag) |
|
||||
| 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) |
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
| Status | Meaning |
|
||||
|--------|---------|
|
||||
| COMPLETE (reason) | Action was taken and resolved successfully |
|
||||
| INVALID (reason) | Finding was incorrect, not applicable, or intentional |
|
||||
| ON HOLD (reason) | Action deferred — waiting on external dependency or user decision |
|
||||
| ✅ `COMPLETE (reason)` | Action was taken and resolved successfully |
|
||||
| ❌ `INVALID (reason)` | Finding was incorrect, not applicable, or intentional |
|
||||
| ✋ `ON HOLD (reason)` | Action deferred — waiting on external dependency or user decision |
|
||||
|
||||
---
|
||||
|
||||
@@ -14,19 +14,19 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Missing Settings | Add 13 non-hook missing settings keys (`$schema`, `availableModels`, `fastModePerSessionOptIn`, `teammateMode`, `prefersReducedMotion`, `sandbox.filesystem.*`, `sandbox.network.allowManagedDomainsOnly`, `sandbox.enableWeakerNetworkIsolation`, `allowManagedMcpServersOnly`, `blockedMarketplaces`, `includeGitInstructions`, `pluginTrustMessage`, `fileSuggestion` table entry) | COMPLETE (added to report) |
|
||||
| 2 | HIGH | Missing Env Vars | Add missing environment variables including `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`, `CLAUDE_CODE_DISABLE_1M_CONTEXT`, `CLAUDE_CODE_ACCOUNT_UUID`, `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`, `ENABLE_CLAUDEAI_MCP_SERVERS`, and more | COMPLETE (added 13 missing env vars to report) |
|
||||
| 3 | HIGH | Effort Default | Update effort level default from "High" to "Medium" for Max/Team subscribers; add Sonnet 4.6 support (changed v2.1.68) | COMPLETE (updated default and added Sonnet note) |
|
||||
| 4 | MED | Settings Hierarchy | Add managed settings via macOS plist/Windows Registry (v2.1.61/v2.1.69); document array merge behavior across scopes | COMPLETE (added plist/registry and merge note) |
|
||||
| 5 | MED | Sandbox Filesystem | Add `sandbox.filesystem.allowWrite`, `denyWrite`, `denyRead` with path prefix semantics (`//`, `~/`, `/`, `./`) | COMPLETE (added to sandbox table) |
|
||||
| 6 | MED | Permission Syntax | Add `Agent(name)` permission pattern; document `MCP(server:tool)` syntax form | COMPLETE (added to tool syntax table) |
|
||||
| 7 | MED | Plugin Gaps | Add `blockedMarketplaces`, `pluginTrustMessage` | COMPLETE (added to plugins table) |
|
||||
| 8 | MED | Model Config | Add `availableModels` setting | COMPLETE (added to general settings table) |
|
||||
| 9 | MED | Suspect Keys | Verify `sandbox.network.deniedDomains`, `sandbox.ignoreViolations`, `pluginConfigs` — present in report but not in official docs | ON HOLD (kept in report pending verification) |
|
||||
| 10 | LOW | Header Counts | Update header from "38 settings and 84 env vars" to reflect actual counts (~55+ settings, ~110+ env vars) | COMPLETE (updated header) |
|
||||
| 11 | LOW | CLAUDE.md Sync | Update CLAUDE.md configuration hierarchy (add managed/CLI/user levels) | ON HOLD (awaiting user approval) |
|
||||
| 12 | LOW | Example Update | Update Quick Reference example with `$schema`, sandbox filesystem, `Agent(*)`, remove hooks example | COMPLETE (updated example) |
|
||||
| 13 | MED | Hooks Redirect | Replace hooks section with redirect to claude-code-voice-hooks repo | COMPLETE (hooks externalized to dedicated repo) |
|
||||
| 1 | HIGH | Missing Settings | Add 13 non-hook missing settings keys (`$schema`, `availableModels`, `fastModePerSessionOptIn`, `teammateMode`, `prefersReducedMotion`, `sandbox.filesystem.*`, `sandbox.network.allowManagedDomainsOnly`, `sandbox.enableWeakerNetworkIsolation`, `allowManagedMcpServersOnly`, `blockedMarketplaces`, `includeGitInstructions`, `pluginTrustMessage`, `fileSuggestion` table entry) | ✅ COMPLETE (added to report) |
|
||||
| 2 | HIGH | Missing Env Vars | Add missing environment variables including `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING`, `CLAUDE_CODE_DISABLE_1M_CONTEXT`, `CLAUDE_CODE_ACCOUNT_UUID`, `CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`, `ENABLE_CLAUDEAI_MCP_SERVERS`, and more | ✅ COMPLETE (added 13 missing env vars to report) |
|
||||
| 3 | HIGH | Effort Default | Update effort level default from "High" to "Medium" for Max/Team subscribers; add Sonnet 4.6 support (changed v2.1.68) | ✅ COMPLETE (updated default and added Sonnet note) |
|
||||
| 4 | MED | Settings Hierarchy | Add managed settings via macOS plist/Windows Registry (v2.1.61/v2.1.69); document array merge behavior across scopes | ✅ COMPLETE (added plist/registry and merge note) |
|
||||
| 5 | MED | Sandbox Filesystem | Add `sandbox.filesystem.allowWrite`, `denyWrite`, `denyRead` with path prefix semantics (`//`, `~/`, `/`, `./`) | ✅ COMPLETE (added to sandbox table) |
|
||||
| 6 | MED | Permission Syntax | Add `Agent(name)` permission pattern; document `MCP(server:tool)` syntax form | ✅ COMPLETE (added to tool syntax table) |
|
||||
| 7 | MED | Plugin Gaps | Add `blockedMarketplaces`, `pluginTrustMessage` | ✅ COMPLETE (added to plugins table) |
|
||||
| 8 | MED | Model Config | Add `availableModels` setting | ✅ COMPLETE (added to general settings table) |
|
||||
| 9 | MED | Suspect Keys | Verify `sandbox.network.deniedDomains`, `sandbox.ignoreViolations`, `pluginConfigs` — present in report but not in official docs | ✋ ON HOLD (kept in report pending verification) |
|
||||
| 10 | LOW | Header Counts | Update header from "38 settings and 84 env vars" to reflect actual counts (~55+ settings, ~110+ env vars) | ✅ COMPLETE (updated header) |
|
||||
| 11 | LOW | CLAUDE.md Sync | Update CLAUDE.md configuration hierarchy (add managed/CLI/user levels) | ✋ ON HOLD (awaiting user approval) |
|
||||
| 12 | LOW | Example Update | Update Quick Reference example with `$schema`, sandbox filesystem, `Agent(*)`, remove hooks example | ✅ COMPLETE (updated example) |
|
||||
| 13 | MED | Hooks Redirect | Replace hooks section with redirect to claude-code-voice-hooks repo | ✅ COMPLETE (hooks externalized to dedicated repo) |
|
||||
|
||||
---
|
||||
|
||||
@@ -34,16 +34,16 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Changed Behavior | Fix `teammateMode`: type `boolean` → `string`, default `false` → `"auto"`, description → "Agent team display: auto, in-process, tmux" | COMPLETE (type, default, and description updated) |
|
||||
| 2 | HIGH | New Setting | Add `allowManagedPermissionRulesOnly` to Permissions table (boolean, managed only) | COMPLETE (added to Permission Keys table) |
|
||||
| 3 | HIGH | Missing Env Vars | Add ~31 missing env vars including confirmed (`CLAUDE_CODE_MAX_OUTPUT_TOKENS`, `CLAUDE_CODE_DISABLE_FAST_MODE`, `CLAUDE_CODE_DISABLE_AUTO_MEMORY`, `CLAUDE_CODE_USER_EMAIL`, `CLAUDE_CODE_ORGANIZATION_UUID`, `CLAUDE_CONFIG_DIR`) and agent-reported (Foundry, Bedrock, mTLS, shell prefix, etc.) | COMPLETE (added 31 env vars to table) |
|
||||
| 4 | MED | Changed Default | Fix `plansDirectory` default from `.claude/plans/` to `~/.claude/plans` | COMPLETE (default updated) |
|
||||
| 5 | MED | Changed Description | Fix `sandbox.enableWeakerNetworkIsolation` description to "(macOS only) Allow access to system TLS trust; reduces security" | COMPLETE (description updated) |
|
||||
| 6 | MED | Scope Fix | Fix `extraKnownMarketplaces` scope from "Any" to "Project" | COMPLETE (scope and description updated) |
|
||||
| 7 | MED | Boundary Violation | Replace `CLAUDE_CODE_EFFORT_LEVEL` in `claude-cli-startup-flags.md` with cross-reference to settings report | COMPLETE (replaced with link) |
|
||||
| 8 | MED | Version Badge | Update report version from v2.1.69 to v2.1.71 | COMPLETE (badge and header updated) |
|
||||
| 9 | LOW | Suspect Keys | Verify `skipWebFetchPreflight`, `sandbox.ignoreViolations`, `sandbox.network.deniedDomains`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` | ON HOLD (kept in report pending verification — recurring from 2026-03-05) |
|
||||
| 10 | LOW | CLAUDE.md Sync | Update CLAUDE.md configuration hierarchy (3 levels → 5+) | COMPLETE (updated to 5-level hierarchy with managed layer) |
|
||||
| 1 | HIGH | Changed Behavior | Fix `teammateMode`: type `boolean` → `string`, default `false` → `"auto"`, description → "Agent team display: auto, in-process, tmux" | ✅ COMPLETE (type, default, and description updated) |
|
||||
| 2 | HIGH | New Setting | Add `allowManagedPermissionRulesOnly` to Permissions table (boolean, managed only) | ✅ COMPLETE (added to Permission Keys table) |
|
||||
| 3 | HIGH | Missing Env Vars | Add ~31 missing env vars including confirmed (`CLAUDE_CODE_MAX_OUTPUT_TOKENS`, `CLAUDE_CODE_DISABLE_FAST_MODE`, `CLAUDE_CODE_DISABLE_AUTO_MEMORY`, `CLAUDE_CODE_USER_EMAIL`, `CLAUDE_CODE_ORGANIZATION_UUID`, `CLAUDE_CONFIG_DIR`) and agent-reported (Foundry, Bedrock, mTLS, shell prefix, etc.) | ✅ COMPLETE (added 31 env vars to table) |
|
||||
| 4 | MED | Changed Default | Fix `plansDirectory` default from `.claude/plans/` to `~/.claude/plans` | ✅ COMPLETE (default updated) |
|
||||
| 5 | MED | Changed Description | Fix `sandbox.enableWeakerNetworkIsolation` description to "(macOS only) Allow access to system TLS trust; reduces security" | ✅ COMPLETE (description updated) |
|
||||
| 6 | MED | Scope Fix | Fix `extraKnownMarketplaces` scope from "Any" to "Project" | ✅ COMPLETE (scope and description updated) |
|
||||
| 7 | MED | Boundary Violation | Replace `CLAUDE_CODE_EFFORT_LEVEL` in `claude-cli-startup-flags.md` with cross-reference to settings report | ✅ COMPLETE (replaced with link) |
|
||||
| 8 | MED | Version Badge | Update report version from v2.1.69 to v2.1.71 | ✅ COMPLETE (badge and header updated) |
|
||||
| 9 | LOW | Suspect Keys | Verify `skipWebFetchPreflight`, `sandbox.ignoreViolations`, `sandbox.network.deniedDomains`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` | ✋ ON HOLD (kept in report pending verification — recurring from 2026-03-05) |
|
||||
| 10 | LOW | CLAUDE.md Sync | Update CLAUDE.md configuration hierarchy (3 levels → 5+) | ✅ COMPLETE (updated to 5-level hierarchy with managed layer) |
|
||||
|
||||
---
|
||||
|
||||
@@ -51,17 +51,17 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Changed Behavior | Fix `dontAsk` permission mode description: "Auto-accept all tools" → "Auto-denies tools unless pre-approved via `/permissions` or `permissions.allow` rules" | COMPLETE (description corrected per official permissions docs) |
|
||||
| 2 | HIGH | New Setting | Add `modelOverrides` to Model Configuration section (object, maps Anthropic model IDs to provider-specific IDs like Bedrock ARNs) | COMPLETE (added with example and description) |
|
||||
| 3 | HIGH | New Setting | Add `allow_remote_sessions` to managed-only settings list (boolean, defaults `true`, controls Remote Control/web session access) | COMPLETE (added to Permission Keys table) |
|
||||
| 4 | HIGH | Changed Default | Fix `$schema` URL from `https://www.schemastore.org/...` to `https://json.schemastore.org/...` per official docs | COMPLETE (updated in description, example, and Sources) |
|
||||
| 5 | MED | Changed Description | Fix `ANTHROPIC_CUSTOM_HEADERS` format description from "JSON string" to "Name: Value format, newline-separated" | COMPLETE (description updated per official docs) |
|
||||
| 6 | MED | Unverified Modes | `askEdits` and `viewOnly` permission modes not in official docs — only 5 modes documented (default, acceptEdits, plan, dontAsk, bypassPermissions) | COMPLETE (marked as "not in official docs — unverified" in table) |
|
||||
| 7 | MED | Missing Env Vars | Add `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`, `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`, `CLAUDE_CODE_DISABLE_TERMINAL_TITLE`, `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`, `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | COMPLETE (added 5 env vars plus `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`) |
|
||||
| 8 | MED | New Setting | Add `autoMemoryDirectory` to Core Configuration (string, custom auto-memory directory) — version uncertain (agents disagree: v2.1.68 vs v2.1.74), not on settings page | COMPLETE (added near plansDirectory — version unresolved) |
|
||||
| 9 | LOW | Suspect Keys | Verify `skipWebFetchPreflight`, `sandbox.ignoreViolations`, `sandbox.network.deniedDomains`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` — still not in official docs | ON HOLD (kept in report pending verification — recurring from 2026-03-05) |
|
||||
| 10 | LOW | Missing Env Var | Add `CLAUDE_CODE_SUBAGENT_MODEL` to env vars table (already in Model env example block but missing from table) | COMPLETE (added to env vars table) |
|
||||
| 11 | LOW | Example Update | Update Quick Reference example to include `modelOverrides` and corrected `$schema` URL | COMPLETE (example updated with both) |
|
||||
| 1 | HIGH | Changed Behavior | Fix `dontAsk` permission mode description: "Auto-accept all tools" → "Auto-denies tools unless pre-approved via `/permissions` or `permissions.allow` rules" | ✅ COMPLETE (description corrected per official permissions docs) |
|
||||
| 2 | HIGH | New Setting | Add `modelOverrides` to Model Configuration section (object, maps Anthropic model IDs to provider-specific IDs like Bedrock ARNs) | ✅ COMPLETE (added with example and description) |
|
||||
| 3 | HIGH | New Setting | Add `allow_remote_sessions` to managed-only settings list (boolean, defaults `true`, controls Remote Control/web session access) | ✅ COMPLETE (added to Permission Keys table) |
|
||||
| 4 | HIGH | Changed Default | Fix `$schema` URL from `https://www.schemastore.org/...` to `https://json.schemastore.org/...` per official docs | ✅ COMPLETE (updated in description, example, and Sources) |
|
||||
| 5 | MED | Changed Description | Fix `ANTHROPIC_CUSTOM_HEADERS` format description from "JSON string" to "Name: Value format, newline-separated" | ✅ COMPLETE (description updated per official docs) |
|
||||
| 6 | MED | Unverified Modes | `askEdits` and `viewOnly` permission modes not in official docs — only 5 modes documented (default, acceptEdits, plan, dontAsk, bypassPermissions) | ✅ COMPLETE (marked as "not in official docs — unverified" in table) |
|
||||
| 7 | MED | Missing Env Vars | Add `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS`, `CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`, `CLAUDE_CODE_DISABLE_TERMINAL_TITLE`, `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`, `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS` | ✅ COMPLETE (added 5 env vars plus `CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`) |
|
||||
| 8 | MED | New Setting | Add `autoMemoryDirectory` to Core Configuration (string, custom auto-memory directory) — version uncertain (agents disagree: v2.1.68 vs v2.1.74), not on settings page | ✅ COMPLETE (added near plansDirectory — version unresolved) |
|
||||
| 9 | LOW | Suspect Keys | Verify `skipWebFetchPreflight`, `sandbox.ignoreViolations`, `sandbox.network.deniedDomains`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` — still not in official docs | ✋ ON HOLD (kept in report pending verification — recurring from 2026-03-05) |
|
||||
| 10 | LOW | Missing Env Var | Add `CLAUDE_CODE_SUBAGENT_MODEL` to env vars table (already in Model env example block but missing from table) | ✅ COMPLETE (added to env vars table) |
|
||||
| 11 | LOW | Example Update | Update Quick Reference example to include `modelOverrides` and corrected `$schema` URL | ✅ COMPLETE (example updated with both) |
|
||||
|
||||
---
|
||||
|
||||
@@ -69,15 +69,34 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Settings Hierarchy | Restructure to match official 5-level hierarchy: Managed (#1) > CLI args > Local > Project > User. Remove `~/.claude/settings.local.json` row. Add managed-tier internal precedence (server-managed > MDM > file > HKCU). Note Managed "cannot be overridden by any other level, including CLI args" | COMPLETE (restructured table to 5 levels with Managed as #1, added delivery methods, internal precedence, and file paths) |
|
||||
| 2 | HIGH | Changed Behavior | Fix `availableModels` description: change from complex object array (`title`/`modelId`/`effortOptions`) to simple string array `["sonnet", "haiku"]` per official docs | COMPLETE (updated description to match official docs format) |
|
||||
| 3 | HIGH | Changed Behavior | Add `cleanupPeriodDays` `0`-value behavior: "Setting to `0` deletes all existing transcripts at startup and disables session persistence entirely" | COMPLETE (added 0-value behavior to description) |
|
||||
| 4 | HIGH | Permission Syntax | Add evaluation order note to Permissions section: "Rules are evaluated in order: deny rules first, then ask, then allow. The first matching rule wins." | COMPLETE (added evaluation order before Bash wildcard notes) |
|
||||
| 5 | MED | Changed Description | Add `autoMemoryDirectory` scope restriction: "Not accepted in project settings (`.claude/settings.json`). Accepted from policy, local, and user settings" | COMPLETE (added scope restriction to description) |
|
||||
| 6 | MED | Changed Description | Add `permissions.defaultMode` Remote environment note: only `acceptEdits` and `plan` are honored in Remote environments (v2.1.70) | COMPLETE (added Remote restriction to description) |
|
||||
| 7 | MED | Model Config | Add Opus 4.6 1M context default note: as of v2.1.75, 1M context is default for Max/Team/Enterprise plans | COMPLETE (added to Effort Level note) |
|
||||
| 8 | MED | Settings Hierarchy | Add Windows managed path note: v2.1.75 removed deprecated `C:\ProgramData\ClaudeCode\` fallback — use `C:\Program Files\ClaudeCode\managed-settings.json` | COMPLETE (added deprecation note in hierarchy section) |
|
||||
| 9 | MED | Display & UX | Add `fileSuggestion` stdin JSON format (`{"query": "..."}`) and 15-path output limit detail | COMPLETE (added stdin format and output limit to File Suggestion section) |
|
||||
| 10 | MED | Settings Hierarchy | Update array merge note from "merged" to "concatenated and deduplicated" per official docs | COMPLETE (updated wording in hierarchy Important section) |
|
||||
| 11 | LOW | Suspect Keys | `sandbox.ignoreViolations`, `sandbox.network.deniedDomains` still not in official docs or JSON schema top-level | ON HOLD (kept in report pending verification — recurring from 2026-03-05) |
|
||||
| 12 | LOW | Suspect Keys | `skipWebFetchPreflight`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` — confirmed in JSON schema but not on official settings page | ON HOLD (kept in report — valid per schema, recurring from 2026-03-05) |
|
||||
| 1 | HIGH | Settings Hierarchy | Restructure to match official 5-level hierarchy: Managed (#1) > CLI args > Local > Project > User. Remove `~/.claude/settings.local.json` row. Add managed-tier internal precedence (server-managed > MDM > file > HKCU). Note Managed "cannot be overridden by any other level, including CLI args" | ✅ COMPLETE (restructured table to 5 levels with Managed as #1, added delivery methods, internal precedence, and file paths) |
|
||||
| 2 | HIGH | Changed Behavior | Fix `availableModels` description: change from complex object array (`title`/`modelId`/`effortOptions`) to simple string array `["sonnet", "haiku"]` per official docs | ✅ COMPLETE (updated description to match official docs format) |
|
||||
| 3 | HIGH | Changed Behavior | Add `cleanupPeriodDays` `0`-value behavior: "Setting to `0` deletes all existing transcripts at startup and disables session persistence entirely" | ✅ COMPLETE (added 0-value behavior to description) |
|
||||
| 4 | HIGH | Permission Syntax | Add evaluation order note to Permissions section: "Rules are evaluated in order: deny rules first, then ask, then allow. The first matching rule wins." | ✅ COMPLETE (added evaluation order before Bash wildcard notes) |
|
||||
| 5 | MED | Changed Description | Add `autoMemoryDirectory` scope restriction: "Not accepted in project settings (`.claude/settings.json`). Accepted from policy, local, and user settings" | ✅ COMPLETE (added scope restriction to description) |
|
||||
| 6 | MED | Changed Description | Add `permissions.defaultMode` Remote environment note: only `acceptEdits` and `plan` are honored in Remote environments (v2.1.70) | ✅ COMPLETE (added Remote restriction to description) |
|
||||
| 7 | MED | Model Config | Add Opus 4.6 1M context default note: as of v2.1.75, 1M context is default for Max/Team/Enterprise plans | ✅ COMPLETE (added to Effort Level note) |
|
||||
| 8 | MED | Settings Hierarchy | Add Windows managed path note: v2.1.75 removed deprecated `C:\ProgramData\ClaudeCode\` fallback — use `C:\Program Files\ClaudeCode\managed-settings.json` | ✅ COMPLETE (added deprecation note in hierarchy section) |
|
||||
| 9 | MED | Display & UX | Add `fileSuggestion` stdin JSON format (`{"query": "..."}`) and 15-path output limit detail | ✅ COMPLETE (added stdin format and output limit to File Suggestion section) |
|
||||
| 10 | MED | Settings Hierarchy | Update array merge note from "merged" to "concatenated and deduplicated" per official docs | ✅ COMPLETE (updated wording in hierarchy Important section) |
|
||||
| 11 | LOW | Suspect Keys | `sandbox.ignoreViolations`, `sandbox.network.deniedDomains` still not in official docs or JSON schema top-level | ✋ ON HOLD (kept in report pending verification — recurring from 2026-03-05) |
|
||||
| 12 | LOW | Suspect Keys | `skipWebFetchPreflight`, `skippedMarketplaces`, `skippedPlugins`, `pluginConfigs` — confirmed in JSON schema but not on official settings page | ✋ ON HOLD (kept in report — valid per schema, recurring from 2026-03-05) |
|
||||
|
||||
---
|
||||
|
||||
## [2026-03-15 12:52 PM PKT] Claude Code v2.1.76
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | New Setting | Add `effortLevel` to General Settings or Model Configuration — persists effort level across sessions (`"low"`, `"medium"`, `"high"`). Confirmed on official settings page | ✋ ON HOLD (awaiting user approval) |
|
||||
| 2 | HIGH | New Settings | Add Worktree Settings section with `worktree.sparsePaths` (array, sparse-checkout cone mode) and `worktree.symlinkDirectories` (array, symlink dirs to avoid duplication). Confirmed on official settings page | ✋ ON HOLD (awaiting user approval) |
|
||||
| 3 | HIGH | New Setting | Add `feedbackSurveyRate` to General Settings — probability (0-1) for session quality survey. Confirmed on official settings page | ✋ ON HOLD (awaiting user approval) |
|
||||
| 4 | HIGH | Missing Env Vars | Add 20 missing env vars to table: `CLAUDE_CODE_AUTO_COMPACT_WINDOW`, `CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION`, `CLAUDE_CODE_PLAN_MODE_REQUIRED`, `CLAUDE_CODE_TEAM_NAME`, `CLAUDE_CODE_TASK_LIST_ID`, `CLAUDE_ENV_FILE`, `FORCE_AUTOUPDATE_PLUGINS`, `HTTP_PROXY`, `HTTPS_PROXY`, `NO_PROXY`, `MCP_TOOL_TIMEOUT`, `MCP_CLIENT_SECRET`, `MCP_OAUTH_CALLBACK_PORT`, `IS_DEMO`, `SLASH_COMMAND_TOOL_CHAR_BUDGET`, `VERTEX_REGION_CLAUDE_3_5_HAIKU`, `VERTEX_REGION_CLAUDE_3_7_SONNET`, `VERTEX_REGION_CLAUDE_4_0_OPUS`, `VERTEX_REGION_CLAUDE_4_0_SONNET`, `VERTEX_REGION_CLAUDE_4_1_OPUS`. Confirmed on official /en/env-vars page | ✋ ON HOLD (awaiting user approval) |
|
||||
| 5 | HIGH | Missing Env Vars | Move `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `MAX_THINKING_TOKENS` from code-block-only to Common Environment Variables table | ✋ ON HOLD (awaiting user approval) |
|
||||
| 6 | HIGH | Broken Link | Fix `https://claudelog.com/configuration/` — returns ECONNREFUSED. Remove or replace with working source | ✋ ON HOLD (awaiting user approval) |
|
||||
| 7 | MED | Changed Description | Update `cleanupPeriodDays` description to add: "hooks receive an empty `transcript_path`" when set to 0. Per official docs | ✋ ON HOLD (awaiting user approval) |
|
||||
| 8 | MED | Unverified Env Vars | Mark 7 env vars in report but NOT in official docs as unverified: `CLAUDE_CODE_DISABLE_MCP`, `CLAUDE_CODE_DISABLE_TOOLS`, `CLAUDE_CODE_HIDE_ACCOUNT_INFO`, `CLAUDE_CODE_MAX_TURNS`, `CLAUDE_CODE_PROMPT_CACHING_ENABLED`, `CLAUDE_CODE_SKIP_SETTINGS_SETUP`, `DISABLE_NON_ESSENTIAL_MODEL_CALLS` | ✋ ON HOLD (awaiting user approval) |
|
||||
| 9 | MED | New Source | Add `https://code.claude.com/docs/en/env-vars` to Sources section — official env vars reference page | ✋ ON HOLD (awaiting user approval) |
|
||||
| 10 | MED | Example Update | Update Quick Reference example to include `effortLevel` and `worktree` settings | ✋ ON HOLD (awaiting user approval) |
|
||||
| 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) |
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
| Status | Meaning |
|
||||
|--------|---------|
|
||||
| `COMPLETE (reason)` | Action was taken and resolved successfully |
|
||||
| `INVALID (reason)` | Finding was incorrect, not applicable, or intentional |
|
||||
| `ON HOLD (reason)` | Action deferred, waiting on external dependency or user decision |
|
||||
| ✅ `COMPLETE (reason)` | Action was taken and resolved successfully |
|
||||
| ❌ `INVALID (reason)` | Finding was incorrect, not applicable, or intentional |
|
||||
| ✋ `ON HOLD (reason)` | Action deferred — waiting on external dependency or user decision |
|
||||
|
||||
---
|
||||
|
||||
@@ -14,4 +14,12 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | MED | Extra Bundled Skill | `keybindings-help` is in local report but absent from official docs bundled skills list — investigate whether to remove or keep | COMPLETE (removed from bundled skills table — it is a local custom skill in this repo, not an official bundled skill; `/keybindings` is a built-in CLI command) |
|
||||
| 1 | MED | Extra Bundled Skill | `keybindings-help` is in local report but absent from official docs bundled skills list — investigate whether to remove or keep | ✅ COMPLETE (removed from bundled skills table — it is a local custom skill in this repo, not an official bundled skill; `/keybindings` is a built-in CLI command) |
|
||||
|
||||
---
|
||||
|
||||
## [2026-03-15 12:49 PM PKT] Claude Code v2.1.76
|
||||
|
||||
| # | 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) |
|
||||
|
||||
@@ -4,9 +4,9 @@
|
||||
|
||||
| Status | Meaning |
|
||||
|--------|---------|
|
||||
| COMPLETE (reason) | Action was taken and resolved successfully |
|
||||
| INVALID (reason) | Finding was incorrect, not applicable, or intentional |
|
||||
| ON HOLD (reason) | Action deferred — waiting on external dependency or user decision |
|
||||
| ✅ `COMPLETE (reason)` | Action was taken and resolved successfully |
|
||||
| ❌ `INVALID (reason)` | Finding was incorrect, not applicable, or intentional |
|
||||
| ✋ `ON HOLD (reason)` | Action deferred — waiting on external dependency or user decision |
|
||||
|
||||
---
|
||||
|
||||
@@ -14,10 +14,10 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Agents Table | Add `workflow-changelog-claude-agents-frontmatter-agent` to Agents in This Repository table | COMPLETE (added with model: opus, inherits all tools, no skills/memory) |
|
||||
| 2 | HIGH | Agents Table | Fix presentation-curator skills column — add `presentation/` prefix to skill names | COMPLETE (updated to presentation/vibe-to-agentic-framework etc.) |
|
||||
| 3 | MED | Field Documentation | Add note to `color` field that it is functional but absent from official frontmatter table | COMPLETE (added note about unofficial status in description column) |
|
||||
| 4 | MED | Invocation Section | Expand invocation section with --agents CLI flag, /agents command, claude agents CLI, agent resumption | COMPLETE (added invocation methods table with 5 methods) |
|
||||
| 1 | HIGH | Agents Table | Add `workflow-changelog-claude-agents-frontmatter-agent` to Agents in This Repository table | ✅ COMPLETE (added with model: opus, inherits all tools, no skills/memory) |
|
||||
| 2 | HIGH | Agents Table | Fix presentation-curator skills column — add `presentation/` prefix to skill names | ✅ COMPLETE (updated to presentation/vibe-to-agentic-framework etc.) |
|
||||
| 3 | MED | Field Documentation | Add note to `color` field that it is functional but absent from official frontmatter table | ✅ COMPLETE (added note about unofficial status in description column) |
|
||||
| 4 | MED | Invocation Section | Expand invocation section with --agents CLI flag, /agents command, claude agents CLI, agent resumption | ✅ COMPLETE (added invocation methods table with 5 methods) |
|
||||
|
||||
---
|
||||
|
||||
@@ -25,19 +25,19 @@
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Broken Link | Fix agent memory link to `reports/claude-agent-memory.md` | COMPLETE |
|
||||
| 2 | HIGH | Changed Behavior | Update `tools` field description: `Task(agent_type)` → `Agent(agent_type)` (v2.1.63 rename) | COMPLETE |
|
||||
| 3 | HIGH | Changed Behavior | Update invocation section: Task tool → Agent tool (v2.1.63 rename) | COMPLETE (updated heading, code example, and added rename note) |
|
||||
| 4 | HIGH | Example Update | Update full-featured example: `Task(monitor, rollback)` → `Agent(monitor, rollback)` | COMPLETE |
|
||||
| 5 | HIGH | Built-in Agent | Add `Bash` agent to Official Claude Agents table (model: inherit, purpose: terminal commands in separate context) | COMPLETE (added to table) |
|
||||
| 6 | HIGH | Agents Table | Add `workflow-concepts-agent` to Agents in This Repository table (model: opus, color: green) | COMPLETE |
|
||||
| 7 | HIGH | Agents Table | Add `workflow-claude-settings-agent` to Agents in This Repository table (model: opus, color: yellow) | COMPLETE |
|
||||
| 8 | MED | Built-in Agent | Fix `statusline-setup` model: `inherit` → `Sonnet` | COMPLETE |
|
||||
| 9 | MED | Built-in Agent | Fix `claude-code-guide` model: `inherit` → `Haiku` | NOT APPLICABLE (removed from table) |
|
||||
| 10 | MED | Agents Table | Fix `weather-agent` color: `teal` → `green` | COMPLETE |
|
||||
| 11 | MED | Invocation | Add `--agent <name>` CLI flag to invocation methods table | COMPLETE (added as first row in invocation methods table) |
|
||||
| 12 | MED | Changed Behavior | Update line 147 text: "Task tool" → "Agent tool" in Official Claude Agents table header | COMPLETE (user rewrote header text) |
|
||||
| 13 | MED | Cross-File | Update CLAUDE.md: `Task(...)` → `Agent(...)` references (lines 50-53, 61) | COMPLETE (updated orchestration section and tools field description) |
|
||||
| 1 | HIGH | Broken Link | Fix agent memory link to `reports/claude-agent-memory.md` | ✅ COMPLETE |
|
||||
| 2 | HIGH | Changed Behavior | Update `tools` field description: `Task(agent_type)` → `Agent(agent_type)` (v2.1.63 rename) | ✅ COMPLETE |
|
||||
| 3 | HIGH | Changed Behavior | Update invocation section: Task tool → Agent tool (v2.1.63 rename) | ✅ COMPLETE (updated heading, code example, and added rename note) |
|
||||
| 4 | HIGH | Example Update | Update full-featured example: `Task(monitor, rollback)` → `Agent(monitor, rollback)` | ✅ COMPLETE |
|
||||
| 5 | HIGH | Built-in Agent | Add `Bash` agent to Official Claude Agents table (model: inherit, purpose: terminal commands in separate context) | ✅ COMPLETE (added to table) |
|
||||
| 6 | HIGH | Agents Table | Add `workflow-concepts-agent` to Agents in This Repository table (model: opus, color: green) | ✅ COMPLETE |
|
||||
| 7 | HIGH | Agents Table | Add `workflow-claude-settings-agent` to Agents in This Repository table (model: opus, color: yellow) | ✅ COMPLETE |
|
||||
| 8 | MED | Built-in Agent | Fix `statusline-setup` model: `inherit` → `Sonnet` | ✅ COMPLETE |
|
||||
| 9 | MED | Built-in Agent | Fix `claude-code-guide` model: `inherit` → `Haiku` | ❌ NOT APPLICABLE (removed from table) |
|
||||
| 10 | MED | Agents Table | Fix `weather-agent` color: `teal` → `green` | ✅ COMPLETE |
|
||||
| 11 | MED | Invocation | Add `--agent <name>` CLI flag to invocation methods table | ✅ COMPLETE (added as first row in invocation methods table) |
|
||||
| 12 | MED | Changed Behavior | Update line 147 text: "Task tool" → "Agent tool" in Official Claude Agents table header | ✅ COMPLETE (user rewrote header text) |
|
||||
| 13 | MED | Cross-File | Update CLAUDE.md: `Task(...)` → `Agent(...)` references (lines 50-53, 61) | ✅ COMPLETE (updated orchestration section and tools field description) |
|
||||
|
||||
---
|
||||
|
||||
@@ -50,3 +50,9 @@ No drift detected — report is fully in sync with official docs. All 13 frontma
|
||||
## [2026-03-13 04:21 PM PKT] Claude Code v2.1.74
|
||||
|
||||
No drift detected — report is fully in sync with official docs. All 13 frontmatter fields and 6 built-in agents match.
|
||||
|
||||
---
|
||||
|
||||
## [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.
|
||||
|
||||
@@ -6,9 +6,9 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
|
||||
|
||||
| Status | Meaning |
|
||||
|--------|---------|
|
||||
| `COMPLETE (reason)` | Action was taken and resolved successfully |
|
||||
| `INVALID (reason)` | Finding was incorrect, not applicable, or intentional |
|
||||
| `ON HOLD (reason)` | Action deferred, waiting on external dependency or user decision |
|
||||
| ✅ `COMPLETE (reason)` | Action was taken and resolved successfully |
|
||||
| ❌ `INVALID (reason)` | Finding was incorrect, not applicable, or intentional |
|
||||
| ✋ `ON HOLD (reason)` | Action deferred — waiting on external dependency or user decision |
|
||||
|
||||
---
|
||||
|
||||
@@ -16,20 +16,20 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Broken URL | Fix Permissions URL from `/iam` to `/permissions` | COMPLETE (URL updated to /permissions) |
|
||||
| 2 | HIGH | Missing Concept | Add Agent Teams row to CONCEPTS table | COMPLETE (row added with ~\/\.claude\/teams\/ location) |
|
||||
| 3 | HIGH | Missing Concept | Add Keybindings row to CONCEPTS table | COMPLETE (row added with ~\/\.claude\/keybindings\.json location) |
|
||||
| 4 | HIGH | Missing Concept | Add Model Configuration row to CONCEPTS table | COMPLETE (row added with \.claude\/settings\.json location) |
|
||||
| 5 | HIGH | Missing Concept | Add Auto Memory row to CONCEPTS table | COMPLETE (row added with ~\/\.claude\/projects\/<project>\/memory\/ location) |
|
||||
| 6 | HIGH | Stale Anchor | Fix Rules URL anchor from `#modular-rules-with-clauderules` to `#organize-rules-with-clauderules` | COMPLETE (anchor updated) |
|
||||
| 7 | MED | Missing Concept | Add Checkpointing row to CONCEPTS table | COMPLETE (row added with automatic git-based location) |
|
||||
| 8 | MED | Missing Concept | Add Status Line row to CONCEPTS table | COMPLETE (row added with ~\/\.claude\/settings\.json location) |
|
||||
| 9 | MED | Missing Concept | Add Remote Control row to CONCEPTS table | COMPLETE (row added with CLI \/ claude\.ai location) |
|
||||
| 10 | MED | Missing Concept | Add Fast Mode row to CONCEPTS table | COMPLETE (row added with \.claude\/settings\.json location) |
|
||||
| 11 | MED | Missing Concept | Add Headless Mode row to CONCEPTS table | COMPLETE (row added with CLI flag -p location) |
|
||||
| 12 | LOW | Changed Description | Update Memory description to mention auto memory | COMPLETE (description and location updated) |
|
||||
| 13 | LOW | Changed Location | Update MCP Servers location to include `.mcp.json` | COMPLETE (location updated to include .mcp.json) |
|
||||
| 14 | LOW | Missing Badge | Add Implemented badge to Hooks row | COMPLETE (Implemented badge added linking to .claude/hooks/) |
|
||||
| 1 | HIGH | Broken URL | Fix Permissions URL from `/iam` to `/permissions` | ✅ COMPLETE (URL updated to /permissions) |
|
||||
| 2 | HIGH | Missing Concept | Add Agent Teams row to CONCEPTS table | ✅ COMPLETE (row added with ~\/\.claude\/teams\/ location) |
|
||||
| 3 | HIGH | Missing Concept | Add Keybindings row to CONCEPTS table | ✅ COMPLETE (row added with ~\/\.claude\/keybindings\.json location) |
|
||||
| 4 | HIGH | Missing Concept | Add Model Configuration row to CONCEPTS table | ✅ COMPLETE (row added with \.claude\/settings\.json location) |
|
||||
| 5 | HIGH | Missing Concept | Add Auto Memory row to CONCEPTS table | ✅ COMPLETE (row added with ~\/\.claude\/projects\/<project>\/memory\/ location) |
|
||||
| 6 | HIGH | Stale Anchor | Fix Rules URL anchor from `#modular-rules-with-clauderules` to `#organize-rules-with-clauderules` | ✅ COMPLETE (anchor updated) |
|
||||
| 7 | MED | Missing Concept | Add Checkpointing row to CONCEPTS table | ✅ COMPLETE (row added with automatic git-based location) |
|
||||
| 8 | MED | Missing Concept | Add Status Line row to CONCEPTS table | ✅ COMPLETE (row added with ~\/\.claude\/settings\.json location) |
|
||||
| 9 | MED | Missing Concept | Add Remote Control row to CONCEPTS table | ✅ COMPLETE (row added with CLI \/ claude\.ai location) |
|
||||
| 10 | MED | Missing Concept | Add Fast Mode row to CONCEPTS table | ✅ COMPLETE (row added with \.claude\/settings\.json location) |
|
||||
| 11 | MED | Missing Concept | Add Headless Mode row to CONCEPTS table | ✅ COMPLETE (row added with CLI flag -p location) |
|
||||
| 12 | LOW | Changed Description | Update Memory description to mention auto memory | ✅ COMPLETE (description and location updated) |
|
||||
| 13 | LOW | Changed Location | Update MCP Servers location to include `.mcp.json` | ✅ COMPLETE (location updated to include .mcp.json) |
|
||||
| 14 | LOW | Missing Badge | Add Implemented badge to Hooks row | ✅ COMPLETE (Implemented badge added linking to .claude/hooks/) |
|
||||
|
||||
---
|
||||
|
||||
@@ -37,13 +37,13 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Table Consolidation | Consolidate CONCEPTS table from 22 rows to 10 rows — fold related concepts as inline doc links | COMPLETE (22 → 10 rows) |
|
||||
| 2 | MED | Merged Concept | Fold Marketplaces into Plugins row as inline link | COMPLETE (linked to /discover-plugins) |
|
||||
| 3 | MED | Merged Concept | Fold Agent Teams into Sub-Agents row as inline link | COMPLETE (linked to /agent-teams) |
|
||||
| 4 | MED | Merged Concept | Fold Permissions, Model Config, Output Styles, Sandboxing, Keybindings, Status Line, Fast Mode into Settings row as inline links | COMPLETE (7 concepts folded with doc links) |
|
||||
| 5 | MED | Merged Concept | Fold Auto Memory and Rules into Memory row as inline links | COMPLETE (linked to /memory and /memory#organize-rules-with-clauderules) |
|
||||
| 6 | MED | Merged Concept | Fold Headless Mode into Remote Control row as inline link | COMPLETE (linked to /headless) |
|
||||
| 7 | LOW | Reorder | Reorder table by logical grouping: building blocks → extension → config → context → runtime | COMPLETE (grouped by concern, not chronology) |
|
||||
| 1 | HIGH | Table Consolidation | Consolidate CONCEPTS table from 22 rows to 10 rows — fold related concepts as inline doc links | ✅ COMPLETE (22 → 10 rows) |
|
||||
| 2 | MED | Merged Concept | Fold Marketplaces into Plugins row as inline link | ✅ COMPLETE (linked to /discover-plugins) |
|
||||
| 3 | MED | Merged Concept | Fold Agent Teams into Sub-Agents row as inline link | ✅ COMPLETE (linked to /agent-teams) |
|
||||
| 4 | MED | Merged Concept | Fold Permissions, Model Config, Output Styles, Sandboxing, Keybindings, Status Line, Fast Mode into Settings row as inline links | ✅ COMPLETE (7 concepts folded with doc links) |
|
||||
| 5 | MED | Merged Concept | Fold Auto Memory and Rules into Memory row as inline links | ✅ COMPLETE (linked to /memory and /memory#organize-rules-with-clauderules) |
|
||||
| 6 | MED | Merged Concept | Fold Headless Mode into Remote Control row as inline link | ✅ COMPLETE (linked to /headless) |
|
||||
| 7 | LOW | Reorder | Reorder table by logical grouping: building blocks → extension → config → context → runtime | ✅ COMPLETE (grouped by concern, not chronology) |
|
||||
|
||||
---
|
||||
|
||||
@@ -51,12 +51,12 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Broken URL | Fix `context-management` → `interactive-mode` in TIPS (lines 112, 115, 135) | COMPLETE (3 occurrences replaced with interactive-mode) |
|
||||
| 2 | HIGH | Broken URL | Fix `model-configuration` → `model-config` in TIPS (lines 115, 116, 135) | COMPLETE (3 occurrences replaced with model-config) |
|
||||
| 3 | HIGH | Broken URL | Fix `usage-billing` → `costs` in TIPS (line 115) | COMPLETE (replaced with costs) |
|
||||
| 4 | HIGH | Broken URL | Remove `cowork` URL in STARTUPS (line 167) — page does not exist | COMPLETE (hyperlink removed, plain text kept) |
|
||||
| 5 | HIGH | Missing Concept | Add Scheduled Tasks row to CONCEPTS and Hot section (`/loop`, cron tools) | COMPLETE (added by user to both tables + /loop tip + Boris tweet) |
|
||||
| 6 | MED | Changed Location | Update Agent Teams location from `.claude/agents/<name>.md` to `built-in (env var)` | COMPLETE (location updated to built-in env var) |
|
||||
| 1 | HIGH | Broken URL | Fix `context-management` → `interactive-mode` in TIPS (lines 112, 115, 135) | ✅ COMPLETE (3 occurrences replaced with interactive-mode) |
|
||||
| 2 | HIGH | Broken URL | Fix `model-configuration` → `model-config` in TIPS (lines 115, 116, 135) | ✅ COMPLETE (3 occurrences replaced with model-config) |
|
||||
| 3 | HIGH | Broken URL | Fix `usage-billing` → `costs` in TIPS (line 115) | ✅ COMPLETE (replaced with costs) |
|
||||
| 4 | HIGH | Broken URL | Remove `cowork` URL in STARTUPS (line 167) — page does not exist | ✅ COMPLETE (hyperlink removed, plain text kept) |
|
||||
| 5 | HIGH | Missing Concept | Add Scheduled Tasks row to CONCEPTS and Hot section (`/loop`, cron tools) | ✅ COMPLETE (added by user to both tables + /loop tip + Boris tweet) |
|
||||
| 6 | MED | Changed Location | Update Agent Teams location from `.claude/agents/<name>.md` to `built-in (env var)` | ✅ COMPLETE (location updated to built-in env var) |
|
||||
|
||||
---
|
||||
|
||||
@@ -64,14 +64,14 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Broken URL | Fix Commands URL from `/slash-commands` to `/skills` in CONCEPTS table (line 24) — `/slash-commands` serves Skills page content; docs say "commands merged into skills" | INVALID (URL still resolves; user chose to keep as-is) |
|
||||
| 2 | HIGH | Broken URL | Fix Commands URL from `/slash-commands` to `/skills` in TIPS section (line 108) — same stale URL | INVALID (URL still resolves; user chose to keep as-is) |
|
||||
| 3 | MED | Missing Inline Link | Add Interactive Mode (`/interactive-mode`) as inline link to CLI Startup Flags row — covers /compact, /clear, /context, /extra-usage | COMPLETE (inline link added to CLI Startup Flags description) |
|
||||
| 4 | MED | Missing Inline Link | Add Costs (`/costs`) as inline link to Settings row — covers /usage, billing, pay-as-you-go | INVALID (user chose to skip) |
|
||||
| 5 | LOW | Missing Concept | Consider adding IDE Integrations row (VS Code, JetBrains, Desktop App, Web) or inline links to Best Practices | INVALID (user chose to skip — platform surfaces, not configuration concepts) |
|
||||
| 6 | HIGH | Missing Concept | Add Code Review row to Hot table — multi-agent PR analysis (research preview, Teams & Enterprise) | COMPLETE (row added as first Hot entry with blog link and best practice tweet) |
|
||||
| 7 | MED | New Badge | Create `!/tags/beta.svg` tag (yellow, 38x20px) and add to Code Review and Agent Teams in Hot table | COMPLETE (beta.svg created; added to Code Review and Agent Teams rows) |
|
||||
| 8 | MED | Reorder | Sort Hot table by release date (most recent first): Code Review → Scheduled Tasks → Voice Mode → Agent Teams → Remote Control → Git Worktrees → Ralph Wiggum | COMPLETE (Voice Mode and Agent Teams swapped to match chronological order) |
|
||||
| 1 | HIGH | Broken URL | Fix Commands URL from `/slash-commands` to `/skills` in CONCEPTS table (line 24) — `/slash-commands` serves Skills page content; docs say "commands merged into skills" | ❌ INVALID (URL still resolves; user chose to keep as-is) |
|
||||
| 2 | HIGH | Broken URL | Fix Commands URL from `/slash-commands` to `/skills` in TIPS section (line 108) — same stale URL | ❌ INVALID (URL still resolves; user chose to keep as-is) |
|
||||
| 3 | MED | Missing Inline Link | Add Interactive Mode (`/interactive-mode`) as inline link to CLI Startup Flags row — covers /compact, /clear, /context, /extra-usage | ✅ COMPLETE (inline link added to CLI Startup Flags description) |
|
||||
| 4 | MED | Missing Inline Link | Add Costs (`/costs`) as inline link to Settings row — covers /usage, billing, pay-as-you-go | ❌ INVALID (user chose to skip) |
|
||||
| 5 | LOW | Missing Concept | Consider adding IDE Integrations row (VS Code, JetBrains, Desktop App, Web) or inline links to Best Practices | ❌ INVALID (user chose to skip — platform surfaces, not configuration concepts) |
|
||||
| 6 | HIGH | Missing Concept | Add Code Review row to Hot table — multi-agent PR analysis (research preview, Teams & Enterprise) | ✅ COMPLETE (row added as first Hot entry with blog link and best practice tweet) |
|
||||
| 7 | MED | New Badge | Create `!/tags/beta.svg` tag (yellow, 38x20px) and add to Code Review and Agent Teams in Hot table | ✅ COMPLETE (beta.svg created; added to Code Review and Agent Teams rows) |
|
||||
| 8 | MED | Reorder | Sort Hot table by release date (most recent first): Code Review → Scheduled Tasks → Voice Mode → Agent Teams → Remote Control → Git Worktrees → Ralph Wiggum | ✅ COMPLETE (Voice Mode and Agent Teams swapped to match chronological order) |
|
||||
|
||||
---
|
||||
|
||||
@@ -79,8 +79,22 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
|
||||
|
||||
| # | Priority | Type | Action | Status |
|
||||
|---|----------|------|--------|--------|
|
||||
| 1 | HIGH | Broken URL | Fix Commands URL from `/slash-commands` to `/skills` in CONCEPTS table (line 24) — `/slash-commands` redirects to `/skills` page | INVALID (RECURRING from 2026-03-10; URL still resolves; user chose to keep as-is) |
|
||||
| 2 | LOW | Verification | All external docs URLs validated — no broken links found | COMPLETE (all 20+ URLs return valid pages) |
|
||||
| 3 | LOW | Verification | All local badge file paths validated — no missing files | COMPLETE (all badge targets exist on filesystem) |
|
||||
| 4 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` validated on target page | COMPLETE (heading exists on /memory page) |
|
||||
| 5 | LOW | Verification | All CONCEPTS descriptions checked against official docs | COMPLETE (no description drift detected) |
|
||||
| 1 | HIGH | Broken URL | Fix Commands URL from `/slash-commands` to `/skills` in CONCEPTS table (line 24) — `/slash-commands` redirects to `/skills` page | ❌ INVALID (RECURRING from 2026-03-10; URL still resolves; user chose to keep as-is) |
|
||||
| 2 | LOW | Verification | All external docs URLs validated — no broken links found | ✅ COMPLETE (all 20+ URLs return valid pages) |
|
||||
| 3 | LOW | Verification | All local badge file paths validated — no missing files | ✅ COMPLETE (all badge targets exist on filesystem) |
|
||||
| 4 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` validated on target page | ✅ COMPLETE (heading exists on /memory page) |
|
||||
| 5 | LOW | Verification | All CONCEPTS descriptions checked against official docs | ✅ COMPLETE (no description drift detected) |
|
||||
|
||||
---
|
||||
|
||||
## [2026-03-15 12:48 PM PKT] Claude Code v2.1.76
|
||||
|
||||
| # | 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 | MED | Missing Badges | Remote Control (Hot) has zero badges — only Hot item without any BP or Impl badge | ✅ COMPLETE (BP badge added linking to official docs page) |
|
||||
| 3 | LOW | Naming | "Sub-Agents" in README vs "subagents" (one word) in official docs — cosmetic inconsistency | ✅ COMPLETE (renamed to "Subagents" in CONCEPTS table) |
|
||||
| 4 | LOW | Verification | All 27 external docs URLs validated — no broken links found | ✅ COMPLETE (all URLs return valid pages) |
|
||||
| 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) |
|
||||
|
||||
Reference in New Issue
Block a user