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