diff --git a/README.md b/README.md
index 038b549..a2ddc31 100644
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
# claude-code-best-practice
practice makes claude perfect
--white?style=flat&labelColor=555) 
+-white?style=flat&labelColor=555)
[](best-practice/) [](implementation/) [](orchestration-workflow/orchestration-workflow.md) [](#-tips-and-tricks) 
= Agents · 
= Commands · 
= Skills
@@ -86,13 +86,13 @@ All major workflows converge on the same architectural pattern: **Research → P
| Name | ★ | Uniqueness | Plan | | | |
|------|---|------------|------|---|---|---|
-| [Superpowers](https://github.com/obra/superpowers) | 100k |    | [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) | 89k |    | [planner](https://github.com/affaan-m/everything-claude-code/blob/main/agents/planner.md) | 25 | 57 | 108+ |
+| [Superpowers](https://github.com/obra/superpowers) | 103k |    | [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) | 93k |    | [planner](https://github.com/affaan-m/everything-claude-code/blob/main/agents/planner.md) | 28 | 59 | 116 |
| [Spec Kit](https://github.com/github/spec-kit) | 79k |    | [speckit.plan](https://github.com/github/spec-kit/blob/main/templates/commands/plan.md) | 0 | 9+ | 0 |
-| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | 41k |    | [bmad-create-prd](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/bmm-skills/2-plan-workflows/bmad-create-prd) | 9 | 0 | 42 |
-| [Get Shit Done](https://github.com/gsd-build/get-shit-done) | 36k |    | [gsd-planner](https://github.com/gsd-build/get-shit-done/blob/main/agents/gsd-planner.md) | 16 | 50 | 0 |
-| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | 32k |    | [opsx:propose](https://github.com/Fission-AI/OpenSpec/blob/main/src/commands/workflow/new-change.ts) | 0 | 11 | 11 |
-| [gstack](https://github.com/garrytan/gstack) | 29k |    | [plan-eng-review](https://github.com/garrytan/gstack/tree/main/plan-eng-review) | 0 | 0 | 21 |
+| [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) | 42k |    | [bmad-create-prd](https://github.com/bmad-code-org/BMAD-METHOD/tree/main/src/bmm-skills/2-plan-workflows/bmad-create-prd) | 0 | 0 | 42 |
+| [Get Shit Done](https://github.com/gsd-build/get-shit-done) | 38k |    | [gsd-planner](https://github.com/gsd-build/get-shit-done/blob/main/agents/gsd-planner.md) | 18 | 52 | 0 |
+| [gstack](https://github.com/garrytan/gstack) | 34k |    | [plan-eng-review](https://github.com/garrytan/gstack/tree/main/plan-eng-review) | 0 | 0 | 21 |
+| [OpenSpec](https://github.com/Fission-AI/OpenSpec) | 33k |    | [opsx:propose](https://github.com/Fission-AI/OpenSpec/blob/main/src/commands/workflow/new-change.ts) | 0 | 11 | 11 |
| [HumanLayer](https://github.com/humanlayer/humanlayer) | 10k |    | [create_plan](https://github.com/humanlayer/humanlayer/blob/main/.claude/commands/create_plan.md) | 6 | 27 | 0 |
### Others
diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md
index d46fc3c..c6325e2 100644
--- a/best-practice/claude-commands.md
+++ b/best-practice/claude-commands.md
@@ -1,6 +1,6 @@
# Commands Best Practice
-
+
[](../implementation/claude-commands-implementation.md)
Claude Code commands — frontmatter fields and official built-in slash commands.
diff --git a/best-practice/claude-settings.md b/best-practice/claude-settings.md
index 472e433..c243f5f 100644
--- a/best-practice/claude-settings.md
+++ b/best-practice/claude-settings.md
@@ -1,8 +1,8 @@
# Claude Code Settings Reference
- 
+ 
-A comprehensive guide to all available configuration options in Claude Code's `settings.json` files. As of v2.1.80, 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.81, Claude Code exposes **60+ settings** and **100+ environment variables** (use the `"env"` field in `settings.json` to avoid wrapper scripts).
@@ -219,7 +219,7 @@ Control what tools and operations Claude can perform.
| `permissions.defaultMode` | string | Default permission mode. In Remote environments, only `acceptEdits` and `plan` are honored (v2.1.70+) |
| `permissions.disableBypassPermissionsMode` | string | Prevent bypass mode activation |
| `allowManagedPermissionRulesOnly` | boolean | **(Managed only)** Only managed permission rules apply; user/project `allow`, `ask`, `deny` rules are ignored |
-| `allow_remote_sessions` | boolean | **(Managed only)** Allow users to start Remote Control and web sessions. Defaults to `true`. Set to `false` to prevent remote session access |
+| `allow_remote_sessions` | boolean | **(Managed only)** Allow users to start Remote Control and web sessions. Defaults to `true`. Set to `false` to prevent remote session access *(not in official docs — official permissions page states "Access to Remote Control and web sessions is not controlled by a managed settings key." On Team and Enterprise plans, admins enable/disable via [Claude Code admin settings](https://claude.ai/admin-settings/claude-code))* |
### Permission Modes
@@ -413,6 +413,8 @@ 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.
+
**Example:**
```json
{
@@ -427,6 +429,18 @@ Configure Claude Code plugins and marketplaces.
"source": "github",
"repo": "acme-corp/claude-plugins"
}
+ },
+ "inline-tools": {
+ "source": {
+ "source": "settings",
+ "name": "inline-tools",
+ "plugins": [
+ {
+ "name": "code-formatter",
+ "source": { "source": "github", "repo": "acme-corp/code-formatter" }
+ }
+ ]
+ }
}
}
}
@@ -530,6 +544,9 @@ These display preferences are stored in `~/.claude.json`, **not** `settings.json
| Key | Type | Default | Description |
|-----|------|---------|-------------|
+| `autoConnectIde` | boolean | `false` | Automatically connect to a running IDE when Claude Code starts from an external terminal. Appears in `/config` as **Auto-connect to IDE (external terminal)** when running outside a VS Code or JetBrains terminal |
+| `autoInstallIdeExtension` | boolean | `true` | Automatically install the Claude Code IDE extension when running from a VS Code terminal. Appears in `/config` as **Auto-install IDE extension**. Can also be disabled via `CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL` env var |
+| `showClearContextOnPlanAccept` | boolean | `false` | When `true`, restores the "clear context" option on plan accept (hidden by default since v2.1.81). *(Source: v2.1.81 changelog — not yet on official settings page; file location unconfirmed)* |
| `showTurnDuration` | boolean | `true` | Show turn duration messages after responses (e.g., "Cooked for 1m 6s"). Edit `~/.claude.json` directly to change |
| `terminalProgressBarEnabled` | boolean | `true` | Show the terminal progress bar in supported terminals (Windows Terminal, iTerm2). Appears in `/config` as **Terminal progress bar** |
@@ -556,6 +573,10 @@ The status line command receives a JSON object on stdin with these notable field
| `context_window.remaining_percentage` | Context window remaining percentage |
| `current_usage` | Current context window token count |
| `exceeds_200k_tokens` | Whether context exceeds 200k tokens |
+| `rate_limits.five_hour.used_percentage` | Five-hour rate limit usage percentage (v2.1.80+) |
+| `rate_limits.five_hour.resets_at` | Five-hour rate limit reset timestamp |
+| `rate_limits.seven_day.used_percentage` | Seven-day rate limit usage percentage |
+| `rate_limits.seven_day.resets_at` | Seven-day rate limit reset timestamp |
### File Suggestion Configuration
diff --git a/best-practice/claude-skills.md b/best-practice/claude-skills.md
index 27431be..2c45812 100644
--- a/best-practice/claude-skills.md
+++ b/best-practice/claude-skills.md
@@ -1,6 +1,6 @@
# Skills Best Practice
-
+
[](../implementation/claude-skills-implementation.md)
Claude Code skills — frontmatter fields and official bundled skills.
diff --git a/best-practice/claude-subagents.md b/best-practice/claude-subagents.md
index b1fea12..de65d91 100644
--- a/best-practice/claude-subagents.md
+++ b/best-practice/claude-subagents.md
@@ -1,6 +1,6 @@
# Sub-agents Best Practice
-
+
[](../implementation/claude-subagents-implementation.md)
Claude Code subagents — frontmatter fields and official built-in agent types.
diff --git a/changelog/best-practice/claude-commands/changelog.md b/changelog/best-practice/claude-commands/changelog.md
index 93c6f7a..165d50c 100644
--- a/changelog/best-practice/claude-commands/changelog.md
+++ b/changelog/best-practice/claude-commands/changelog.md
@@ -88,3 +88,9 @@
| 1 | MED | New Field | Add `effort` to frontmatter table — override model effort level when command is invoked (v2.1.80) | ✅ COMPLETE (added as 5th field, then repositioned to 8th when full field set was added) |
| 2 | HIGH | QA Correction | Add 6 missing fields (`name`, `disable-model-invocation`, `user-invocable`, `context`, `agent`, `hooks`) — official docs state commands support "the same frontmatter" as skills; previous INVALID determinations (v2.1.74–v2.1.79) were incorrect | ✅ COMPLETE (added all 6 fields, count updated 5 → 11, field order matches official docs) |
| 3 | HIGH | Cross-Report Fix | Add `effort` to skills report (`claude-skills.md`) — field was missing there too | ✅ COMPLETE (added as 8th field in skills report, count updated 10 → 11) |
+
+---
+
+## [2026-03-21 09:08 PM PKT] Claude Code v2.1.81
+
+No priority action items — report is fully in sync with official documentation (11 frontmatter fields, 63 built-in commands).
diff --git a/changelog/best-practice/claude-settings/changelog.md b/changelog/best-practice/claude-settings/changelog.md
index a6b0395..db5dacb 100644
--- a/changelog/best-practice/claude-settings/changelog.md
+++ b/changelog/best-practice/claude-settings/changelog.md
@@ -174,4 +174,17 @@
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | New Setting | Add `channelsEnabled` to MCP Settings table — managed-only boolean, controls channel message delivery for Team and Enterprise users. Confirmed on official settings page | ✅ COMPLETE (added to MCP Settings table after allowManagedMcpServersOnly) |
-| 2 | MED | Version Badge | Update report version from v2.1.79 to v2.1.80 | ✅ COMPLETE (badge and header updated) |
\ No newline at end of file
+| 2 | MED | Version Badge | Update report version from v2.1.79 to v2.1.80 | ✅ COMPLETE (badge and header updated) |
+
+---
+
+## [2026-03-21 09:17 PM PKT] Claude Code v2.1.81
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | HIGH | Missing Settings (~/.claude.json) | Add `autoConnectIde` (boolean, default `false`) and `autoInstallIdeExtension` (boolean, default `true`) to Global Config Settings table. Confirmed on official settings page under "Global config settings" | ✅ COMPLETE (added both keys to ~/.claude.json table before showTurnDuration) |
+| 2 | HIGH | Incorrect Setting | `allow_remote_sessions` listed in Permission Keys table as managed-only boolean, but official permissions page states: "Access to Remote Control and web sessions is not controlled by a managed settings key." Mark as unverified or remove | ✅ COMPLETE (re-added unverified annotation with official docs quote and admin UI link) |
+| 3 | MED | Version Bump | Update report version badge from v2.1.80 to v2.1.81 | ✅ COMPLETE (badge, header version, and header text updated) |
+| 4 | MED | New Setting | Add `showClearContextOnPlanAccept` — confirmed in v2.1.81 changelog. When `true`, restores "clear context" option on plan accept (hidden by default). Not yet on official settings page — may be a `~/.claude.json` key | ✅ COMPLETE (added to Global Config Settings table with changelog-source note) |
+| 5 | MED | Plugin Documentation | Document `source: 'settings'` as a marketplace source type in Plugin Settings section. Official settings page lists it as one of 7 source types for `extraKnownMarketplaces` | ✅ COMPLETE (added all 7 source types list, inline marketplace example) |
+| 6 | MED | Status Line Fields | Add `rate_limits` field group to Status Line Input Fields table — includes `five_hour.used_percentage`, `five_hour.resets_at`, `seven_day.used_percentage`, `seven_day.resets_at`. Added in v2.1.80 | ✅ COMPLETE (added 4 rate_limits fields to Status Line Input Fields table) |
\ No newline at end of file
diff --git a/changelog/best-practice/claude-skills/changelog.md b/changelog/best-practice/claude-skills/changelog.md
index ca5f6e0..efe1d83 100644
--- a/changelog/best-practice/claude-skills/changelog.md
+++ b/changelog/best-practice/claude-skills/changelog.md
@@ -47,3 +47,9 @@ No drift detected — frontmatter fields (10) and bundled skills (5) are fully s
## [2026-03-20 08:32 AM PKT] Claude Code v2.1.80
No drift detected — frontmatter fields (10) and bundled skills (5) are fully synchronized with official docs.
+
+---
+
+## [2026-03-21 09:07 PM PKT] Claude Code v2.1.81
+
+No drift detected — frontmatter fields (11) and bundled skills (5) are fully synchronized with official docs.
diff --git a/changelog/best-practice/claude-subagents/changelog.md b/changelog/best-practice/claude-subagents/changelog.md
index fd440a2..dd2db4a 100644
--- a/changelog/best-practice/claude-subagents/changelog.md
+++ b/changelog/best-practice/claude-subagents/changelog.md
@@ -82,3 +82,9 @@ No drift detected — report is fully in sync with official docs. All 13 frontma
| # | Priority | Type | Action | Status |
|---|----------|------|--------|--------|
| 1 | HIGH | New Field | Add `effort` field to Frontmatter Fields table (string, optional — effort level override: `low`, `medium`, `high`, `max`) | ✅ COMPLETE (added between `background` and `isolation`, count updated 14→15) |
+
+---
+
+## [2026-03-21 09:07 PM PKT] Claude Code v2.1.81
+
+No drift detected — report is fully in sync with official docs. All 15 frontmatter fields and 6 built-in agents match.
diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md
index 410ab30..3d8ba7c 100644
--- a/changelog/best-practice/concepts/changelog.md
+++ b/changelog/best-practice/concepts/changelog.md
@@ -153,3 +153,16 @@ Tracks drift between the README CONCEPTS table and official Claude Code document
| 6 | LOW | Verification | All local badge file paths validated — no missing files | ✅ COMPLETE (all 20+ badge targets exist on filesystem) |
| 7 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` confirmed on /memory page | ✅ COMPLETE (section heading exists) |
| 8 | LOW | Verification | All CONCEPTS descriptions checked against official docs — no drift detected | ✅ COMPLETE (all descriptions accurate) |
+
+---
+
+## [2026-03-21 09:12 PM PKT] Claude Code v2.1.81
+
+| # | 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 | LOW | Verification | All 32 external docs URLs validated — no broken links found | ✅ COMPLETE (all URLs return valid pages including /slash-commands redirect) |
+| 3 | LOW | Verification | All local badge file paths validated — no missing files | ✅ COMPLETE (all 20+ badge targets exist on filesystem) |
+| 4 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` confirmed on /memory page | ✅ COMPLETE (section heading exists) |
+| 5 | LOW | Verification | Git Worktrees anchor `#run-parallel-claude-code-sessions-with-git-worktrees` confirmed on /common-workflows page | ✅ COMPLETE (section heading exists) |
+| 6 | LOW | Verification | All CONCEPTS descriptions checked against official docs — no drift detected | ✅ COMPLETE (all descriptions accurate) |
diff --git a/changelog/development-workflows/changelog.md b/changelog/development-workflows/changelog.md
index 9847796..40e5459 100644
--- a/changelog/development-workflows/changelog.md
+++ b/changelog/development-workflows/changelog.md
@@ -54,3 +54,20 @@
| 5 | MED | Star Update | Update gstack ★ from 26k to 29k (28,889 actual — v0.9.0 multi-AI expansion) | COMPLETE (updated README table) |
| 6 | MED | Count Update | Update BMAD-METHOD skills from 43 to 42 (v6.2.0 recount: 30 bmm-skills + 12 core-skills) | COMPLETE (updated README table) |
| 7 | LOW | Sort Order | Reorder table by Plan type groups (commands → agents → skills, stars descending within) | COMPLETE (commands: Spec Kit, OpenSpec, HumanLayer; agents: ECC, GSD; skills: Superpowers, BMAD, gstack) |
+
+---
+
+## [2026-03-21 09:20 PM PKT] Development Workflows Update
+
+| # | Priority | Type | Action | Status |
+|---|----------|------|--------|--------|
+| 1 | HIGH | Star Update | Update Superpowers ★ from 100k to 103k (102,767 actual) | COMPLETE (updated README table) |
+| 2 | HIGH | Star Update | Update Everything Claude Code ★ from 89k to 93k (93,145 actual) | COMPLETE (updated README table) |
+| 3 | HIGH | Count Update | Update ECC agents 25→28, commands 57→59, skills 108+→116 (v1.9.0: selective install, ECC Tools Pro, 12 lang ecosystems) | COMPLETE (updated README table) |
+| 4 | HIGH | Star Update | Update Get Shit Done ★ from 36k to 38k (37,748 actual) | COMPLETE (updated README table) |
+| 5 | HIGH | Count Update | Update GSD agents 16→18, commands 50→52 (v1.27.0: advisor mode, multi-repo workspaces, /gsd:fast, /gsd:review) | COMPLETE (updated README table) |
+| 6 | HIGH | Star Update | Update gstack ★ from 29k to 34k (34,456 actual — v0.9.4 Codex reviews, Windows 11 support) | COMPLETE (updated README table) |
+| 7 | HIGH | Architecture | Update BMAD agents from 9 to 0 (v6.x pure skills rewrite — agent personas now implemented as skills in bmm-skills/) | COMPLETE (updated README table) |
+| 8 | MED | Star Update | Update BMAD ★ from 41k to 42k (41,629 actual) | COMPLETE (updated README table) |
+| 9 | MED | Star Update | Update OpenSpec ★ from 32k to 33k (32,862 actual) | COMPLETE (updated README table) |
+| 10 | MED | Sort Order | Swap gstack (34k) above OpenSpec (33k) — stars descending order | COMPLETE (updated README table) |