# Docs Sync Update Plan

> Generated: 2026-03-13
> Source: Official Claude Code docs at `code.claude.com/docs/en/`
> Repo version: Last updated February 2026
> Latest Claude Code version: 2.1.74 (March 12, 2026)

---

## Phase 1: Critical Updates (Broken/Misleading Content) ✅ COMPLETED

> **Completed**: 2026-03-13 | **Commit**: `8fe4520`

These items were factually wrong or referenced deprecated/removed features.

### Task 1.1: Fix official docs URL ✅

- **Files modified**: `README.md`, `resources.md`, `CATALOG.md`, `02-memory/README.md`, `claude_concepts_guide.md`, `LEARNING-ROADMAP.md`, `STYLE_GUIDE.md`, `.github/ISSUE_TEMPLATE/config.yml`
- **Change**: Replaced 16 instances of `docs.anthropic.com/en/docs/claude-code` URLs with `code.claude.com/docs/en/` equivalents (with correct subpath mapping per page)

### Task 1.2: Mark `/review` as deprecated ✅

- **File**: `01-slash-commands/README.md`
- **Change**: Marked `/review` as **Deprecated** with `code-review` plugin install instructions

### Task 1.3: Mark `/output-style` as deprecated — SKIPPED

- **Reason**: `/output-style` was not present in the repo. No action needed.

### Task 1.4: Fix model name references ✅

- **File**: `01-slash-commands/README.md`
- **Change**: Fixed "Sonnet 4.5" → "Sonnet 4.6" (only outdated instance found)

### Task 1.5: Mark SSE transport as deprecated — SKIPPED

- **Reason**: Already marked as deprecated in `05-mcp/README.md` line 100. No action needed.

### Task 1.6: Fix `Task()` → `Agent()` rename ✅

- **File**: `04-subagents/README.md`
- **Change**: Updated `Task(agent_type)` → `Agent(agent_type)` in description and YAML example. Added backward-compatibility note about v2.1.63 rename.

### Task 1.7: Resolve `/todos` conflict ✅

- **File**: `01-slash-commands/README.md`
- **Change**: Removed `/todos` from built-in commands table. Verified it is not listed in official docs at `code.claude.com/docs/en/interactive-mode`. `/tasks` already covers task management.

### Task 1.8: Resolve memory hierarchy conflict ✅

- **File**: `02-memory/README.md`
- **Change**: Added verification note that `CLAUDE.local.md` is not mentioned in official docs as of March 2026. Kept the entry (may still work as legacy) with recommendation to use `~/.claude/CLAUDE.md` or `.claude/rules/` for new projects.

---

## Phase 2: Missing Commands & Features (Incomplete Content) ✅ COMPLETED

> **Completed**: 2026-03-13

Content existed but was missing significant features that shipped in Jan–Mar 2026.

### Task 2.1: Add missing built-in commands to slash commands table ✅

- **File modified**: `01-slash-commands/README.md`
- **Change**: Added 15 missing commands (`/btw`, `/chrome`, `/diff`, `/extra-usage`, `/feedback`, `/insights`, `/install-slack-app`, `/keybindings`, `/mobile`, `/passes`, `/reload-plugins`, `/remote-control`, `/skills`, `/stickers`, `/upgrade`) in alphabetical order to the built-in commands table

### Task 2.2: Add bundled skills section ✅

- **File modified**: `03-skills/README.md`
- **Change**: Added "Bundled Skills" section documenting 5 built-in skills (`/simplify`, `/batch`, `/debug`, `/loop`, `/claude-api`) between "Skills vs Other Features" and "Sharing Skills" sections

### Task 2.3: Add `${CLAUDE_SKILL_DIR}` to skills substitutions ✅

- **File modified**: `03-skills/README.md`
- **Change**: Added `${CLAUDE_SKILL_DIR}` row to the String Substitutions table

### Task 2.4: Add missing CLI flags — SKIPPED

- **Reason**: All 19 flags were already documented in `10-cli/README.md` across Core Flags, Model & Configuration, Tool & Permission, Workspace & Directory, MCP Configuration, Session Management, and Advanced Features tables. No action needed.

### Task 2.5: Update MCP OAuth documentation ✅

- **File modified**: `05-mcp/README.md`
- **Changes**: Added `oauth.authServerMetadataUrl` config section, `ENABLE_CLAUDEAI_MCP_SERVERS=false` env var, and updated MCP scope terminology (Local/User with old name notes). 4 items (`--callback-port`, `--client-id`/`--client-secret`, env var expansion, Tool Search) were already present.

### Task 2.6: Add missing built-in subagents — SKIPPED

- **Reason**: "Bash" and "Claude Code Guide" subagents were already fully documented in `04-subagents/README.md` with both table entries and detailed subsections. No action needed.

### Task 2.7: Add `autoMemoryDirectory` and auto-memory settings ✅

- **File modified**: `02-memory/README.md`
- **Changes**: Added `autoMemoryDirectory` setting (v2.1.74), v2.1.59+ version requirement note, and `claudeMdExcludes` setting for monorepos. 2 items (`CLAUDE_CODE_DISABLE_AUTO_MEMORY` env var, Windows managed policy path) were already present.

### Task 2.8: Update effort levels ✅

- **File modified**: `09-advanced-features/README.md`
- **Change**: Added visual effort indicators low (○), medium (◐), high (●) in 3 locations. "max" was never mentioned (no removal needed). "ultrathink" note was already present.

### Task 2.9: Update `/context` command description ✅

- **File modified**: `01-slash-commands/README.md`
- **Change**: Updated `/context` description to "Visualize context usage with actionable optimization suggestions" (combined with Task 2.1)

### Task 2.10: Add hook events update ✅

- **File modified**: `06-hooks/README.md`
- **Changes**: Added 2 missing hook events (`InstructionsLoaded`, `Setup`) to events table (updated count 16→18), added HTTP hooks v2.1.63 version note, documented `once: true` in field reference, added `agent_id`/`agent_type`/`worktree` fields to JSON input, added `CLAUDE_CODE_SESSIONEND_HOOKS_TIMEOUT_MS` env var. Items already present: 6 other hook events, `last_assistant_message`, component-scoped hooks.

---

## Phase 3: New Feature Coverage (Content Gaps)

These are significant features that exist in official docs but have no corresponding content in the guide. Each needs a decision: create tutorial content, add a TODO note, or skip.

### Task 3.1: Create Agent Teams tutorial content

- **Directory**: `04-subagents/README.md` (add section) or new file
- **Content needed**:
  - What agent teams are vs. subagents (comparison table)
  - How to enable (`CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`)
  - Starting a team, display modes (in-process vs tmux)
  - Task assignment, teammate messaging, plan approval
  - Architecture: team lead, teammates, shared task list, mailbox
  - Best practices: team size (3-5), task sizing, file conflict avoidance
  - Limitations (experimental, no session resumption, no nested teams)
- **Priority**: High — major new capability
- **Source**: `code.claude.com/docs/en/agent-teams`

### Task 3.2: Create Scheduled Tasks / `/loop` documentation

- **Directory**: `09-advanced-features/README.md` (add section)
- **Content needed**:
  - `/loop [interval] <prompt>` command usage
  - Cron scheduling tools for recurring prompts
  - `CLAUDE_CODE_DISABLE_CRON` env var
  - Use cases: polling deploys, babysitting PRs
- **Priority**: Medium — useful automation feature
- **Source**: `code.claude.com/docs/en/scheduled-tasks`

### Task 3.3: Create Chrome Integration section

- **Directory**: `09-advanced-features/README.md` (add section)
- **Content needed**:
  - `--chrome` / `--no-chrome` flags
  - `/chrome` command for configuration
  - Browser debugging and web testing capabilities
- **Priority**: Medium — beta feature but useful for web developers
- **Source**: `code.claude.com/docs/en/chrome`

### Task 3.4: Create Remote Control section

- **Directory**: `09-advanced-features/README.md` (add section or expand existing)
- **Content needed**:
  - `/remote-control` command (alias `/rc`)
  - `claude remote-control` CLI subcommand
  - Controlling local sessions from claude.ai or Claude app
  - Optional name argument for custom session titles
- **Priority**: Medium — enables mobile/cross-device workflows
- **Source**: `code.claude.com/docs/en/remote-control`

### Task 3.5: Document Plugin Marketplaces

- **File**: `07-plugins/README.md` (add section)
- **Content needed**:
  - Creating and distributing plugin marketplaces
  - Official marketplace submission (claude.ai/settings/plugins/submit)
  - `/plugin marketplace` commands
  - `strictKnownMarketplaces`, `extraKnownMarketplaces` settings
- **Priority**: Medium — plugin ecosystem is maturing
- **Source**: `code.claude.com/docs/en/plugin-marketplaces`, `code.claude.com/docs/en/discover-plugins`

### Task 3.6: Document LSP Servers in Plugins

- **File**: `07-plugins/README.md` (add section)
- **Content needed**:
  - `.lsp.json` configuration format
  - Language server setup for code intelligence
  - Example Go/Python/TypeScript LSP configs
- **Priority**: Low — niche feature, official marketplace covers common languages
- **Source**: `code.claude.com/docs/en/plugins-reference#lsp-servers`

### Task 3.7: Document Keyboard Shortcuts Customization

- **File**: `09-advanced-features/README.md` (add section)
- **Content needed**:
  - `/keybindings` command
  - `~/.claude/keybindings.json` configuration
  - Available keybinding actions (voice:pushToTalk, chat:newline, etc.)
  - Context-aware bindings, chord support
- **Priority**: Low — power user feature
- **Source**: `code.claude.com/docs/en/keybindings`

### Task 3.8: Document Desktop App

- **File**: `09-advanced-features/README.md` (expand existing mention)
- **Content needed**:
  - Download links (macOS, Windows, Windows ARM64)
  - `/desktop` command to hand off session
  - Visual diff review, multiple sessions, cloud session management
- **Priority**: Low — mentioned briefly already, needs expansion
- **Source**: `code.claude.com/docs/en/desktop`, `code.claude.com/docs/en/desktop-quickstart`

---

## Phase 4: Reference Document Updates (Cascading Changes)

After Phases 1-3, these reference documents need updates to reflect all changes.

### Task 4.1: Update CATALOG.md

- Sync all command counts (40 → 55+ built-in commands)
- Add bundled skills section
- Update subagent count and types
- Add new hook events
- Update MCP features list
- Add agent teams as new capability

### Task 4.2: Update QUICK_REFERENCE.md

- Add new commands to cheat sheet
- Update model names
- Add bundled skills shortcuts
- Add new CLI flags

### Task 4.3: Update INDEX.md

- Add any new files created in Phase 3
- Update file counts and descriptions
- Verify all cross-references

### Task 4.4: Update LEARNING-ROADMAP.md

- Add agent teams to advanced topics
- Add scheduled tasks to intermediate topics
- Update feature counts
- Update self-assessment quiz if needed

### Task 4.5: Update claude_concepts_guide.md

- Sync all feature descriptions with Phases 1-3 changes
- Update model references
- Add new features to relevant sections

### Task 4.6: Update resources.md

- Fix official docs URL
- Add new official doc pages (agent-teams, scheduled-tasks, chrome, keybindings, etc.)
- Verify all external links still work

---

## Phase 5: Validation (Quality Assurance)

### Task 5.1: Link validation

- Check all internal cross-references between files
- Verify all external URLs (official docs, GitHub, etc.)
- Fix any broken anchor links

### Task 5.2: Mermaid diagram review

- Verify all Mermaid diagrams still render correctly
- Update any diagrams that reference outdated features/flows

### Task 5.3: Conflict marker cleanup

- Review and resolve all `<!-- DOCS-SYNC CONFLICT -->` markers
- Get user confirmation on ambiguous items

### Task 5.4: Consistency check

- Ensure model names are consistent across all files
- Ensure command names match between tables and examples
- Ensure version numbers are consistent

---

## Execution Summary

| Phase | Tasks | Priority | Estimated Effort |
|-------|-------|----------|-----------------|
| **Phase 1** | 8 tasks | ✅ Completed 2026-03-13 | Small edits, 1 subagent batch |
| **Phase 2** | 10 tasks (2 skipped) | ✅ Completed 2026-03-13 | 6 files modified, 2 already complete |
| **Phase 3** | 8 tasks | Valuable — new feature tutorials | New content creation, 3-4 subagent batches |
| **Phase 4** | 6 tasks | Required — cascade reference updates | Medium edits after Phases 1-3 |
| **Phase 5** | 4 tasks | Required — quality gate before merge | Automated + manual review |

**Total**: 36 tasks across 5 phases

---

## Notes

- All changes should preserve the repo's existing style: logo headers, Mermaid diagrams, table formatting, code block language tags, heading hierarchy
- Use `Edit` tool (not `Write`) for modifications to existing files
- Launch parallel subagents per directory for Phase 2-3 efficiency
- Phase 4 must run sequentially after Phases 1-3 since reference docs depend on category content