release: v3.23.4 - Agent Anti-Patterns & Scope-Focused Refactoring

Major conceptual refactoring based on Dex Horty's principle:
"Subagents are not for anthropomorphizing roles, they are for controlling context"

### Added (1 new section)
- Agent Anti-Patterns section (§9.17, line 3662)
  - Wrong vs Right table (anthropomorphizing vs context control)
  - When to use agents (context isolation, parallel processing, scope limitation)
  - When NOT to use agents (fake teams, roleplaying, mimicking org structure)

### Changed (18 files, 200+ lines)
- Section rename: "Split-Role Sub-Agents" → "Scope-Focused Agents"
- Agent definitions: "Specialized role" → "Context isolation tool"
- 8 custom agent examples refactored (guide + examples/agents/)
- 10+ prompt examples with explicit scope boundaries
- 4 workflow files updated (agent-teams, TDD, iterative refinement)
- Terminology replacements:
  * "Specialized agents" → "Scope-focused agents"
  * "Expert personas" → "Context boundaries"
  * "Multi-domain expertise" → "Multi-scope analysis"

### Fixed
- Methodologies: Clarification note for BMAD role-based naming

Breaking change: Conceptual shift from role-based to scope-based agent usage.
All examples now demonstrate context isolation instead of persona simulation.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

machine-readable/reference.yaml

@@ -3,7 +3,7 @@
 # Source: guide/ultimate-guide.md
 # Purpose: Condensed index for LLMs to quickly answer user questions about Claude Code
 
-version: "3.23.2"
+version: "3.23.4"
 updated: "2026-02-09"
 
 # ════════════════════════════════════════════════════════════════
@@ -173,7 +173,7 @@ deep_dive:
   third_party_toad: "https://github.com/batrachianai/toad"
   third_party_conductor: "https://docs.conductor.build"
   # Configuration Management & Backup (Added 2026-02-02)
-  config_management_guide: "guide/ultimate-guide.md:4085"  # Section 3.23.2
+  config_management_guide: "guide/ultimate-guide.md:4085"  # Section 3.23.4
   config_hierarchy: "guide/ultimate-guide.md:4095"  # Global → Project → Local precedence
   config_git_strategy_project: "guide/ultimate-guide.md:4110"  # What to commit in .claude/
   config_git_strategy_global: "guide/ultimate-guide.md:4133"  # Version control ~/.claude/
@@ -618,8 +618,10 @@ deep_dive:
   # Advanced Plan Mode Patterns
   rev_the_engine: 2323
   mechanic_stacking: 2371
-  # Sub-Agent Patterns
-  split_role_sub_agents: 3546
+  # Sub-Agent Patterns (Refactored 2026-02-09)
+  agent_anti_patterns: 3662  # Critical: Roles vs Context Control (Dex Horty principle)
+  scope_focused_agents: 3709  # Formerly "Split-Role Sub-Agents", refactored for context isolation
+  teammatetool_experimental: 3606  # Multi-agent orchestration parent section
   # Task Management Diagnostic
   task_lists_diagnostic: 3398
   # Mental Model
@@ -1125,7 +1127,7 @@ ecosystem:
       - "Cross-links modified → Update all 4 repos"
     history:
       - date: "2026-01-20"
-        event: "Code Landing sync v3.23.2, 66 templates, cross-links"
+        event: "Code Landing sync v3.23.4, 66 templates, cross-links"
         commit: "5b5ce62"
       - date: "2026-01-20"
         event: "Cowork Landing fix (paths, README, UI badges)"
@@ -1137,7 +1139,7 @@ ecosystem:
 onboarding_matrix_meta:
   version: "2.0.0"
   last_updated: "2026-02-05"
-  aligned_with_guide: "3.23.2"
+  aligned_with_guide: "3.23.4"
   changelog:
     - version: "2.0.0"
       date: "2026-02-05"
@@ -1165,7 +1167,7 @@ onboarding_matrix:
       core: [rules, sandbox_native_guide, commands]
       time_budget: "5 min"
       topics_max: 3
-      note: "SECURITY FIRST - sandbox before commands (v3.23.2 critical fix)"
+      note: "SECURITY FIRST - sandbox before commands (v3.23.4 critical fix)"
 
     beginner_15min:
       core: [rules, sandbox_native_guide, workflow, essential_commands]
@@ -1250,7 +1252,7 @@ onboarding_matrix:
         - default: agent_validation_checklist
       time_budget: "60 min"
       topics_max: 6
-      note: "Dual-instance pattern for quality workflows (v3.23.2)"
+      note: "Dual-instance pattern for quality workflows (v3.23.4)"
 
   learn_security:
     intermediate_30min:
@@ -1261,7 +1263,7 @@ onboarding_matrix:
         - default: permission_modes
       time_budget: "30 min"
       topics_max: 4
-      note: "NEW goal (v3.23.2) - Security-focused learning path"
+      note: "NEW goal (v3.23.4) - Security-focused learning path"
 
     power_60min:
       core: [sandbox_native_guide, mcp_secrets_management, security_hardening]
@@ -1286,7 +1288,7 @@ onboarding_matrix:
       core: [rules, sandbox_native_guide, workflow, essential_commands, context_management, plan_mode]
       time_budget: "60 min"
       topics_max: 6
-      note: "Security foundation + core workflow (v3.23.2 sandbox added)"
+      note: "Security foundation + core workflow (v3.23.4 sandbox added)"
 
     intermediate_120min:
       core: [plan_mode, agents, skills, config_hierarchy, git_mcp_guide, hooks, mcp_servers]