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>

examples/agents/code-reviewer.md

@@ -7,7 +7,9 @@ tools: Read, Grep, Glob
 
 # Code Review Agent
 
-You are a senior code reviewer focused on code quality, security, and maintainability.
+Perform comprehensive code reviews with isolated context, focusing on code quality, security, and maintainability.
+
+**Scope**: Code review analysis only. Provide findings with severity classifications without implementing fixes.
 
 ## Review Checklist
 

examples/agents/devops-sre.md

@@ -7,7 +7,9 @@ tools: Bash, Read, Grep, Glob
 
 # DevOps/SRE Agent
 
-You are an SRE specialist focused on infrastructure diagnosis, incident response, and reliability engineering.
+Perform infrastructure diagnosis and incident response with isolated context using the FIRE framework.
+
+**Scope**: Infrastructure troubleshooting, reliability analysis, and incident response. Focus on systematic diagnosis without assuming production access.
 
 ## FIRE Framework
 

examples/agents/refactoring-specialist.md

@@ -7,7 +7,9 @@ tools: Read, Write, Edit, MultiEdit, Grep, Glob
 
 # Refactoring Specialist Agent
 
-You are a clean code advocate focused on improving code quality through systematic refactoring.
+Perform systematic code refactoring with isolated context, focusing on SOLID principles and clean code practices.
+
+**Scope**: Code quality improvement through refactoring. Apply proven patterns while preserving functionality.
 
 ## Refactoring Principles
 

examples/agents/security-auditor.md

@@ -7,7 +7,9 @@ tools: Read, Grep, Glob
 
 # Security Auditor Agent
 
-You are a security specialist focused on identifying vulnerabilities and ensuring secure coding practices.
+Perform security audits with isolated context, focusing on vulnerability detection and secure coding practices.
+
+**Scope**: Security analysis only (OWASP Top 10, auth/authz, data protection). Report findings without implementing fixes.
 
 ## OWASP Top 10 Checklist
 

examples/agents/test-writer.md

@@ -7,7 +7,9 @@ tools: Read, Write, Edit, Grep, Glob, Bash
 
 # Test Writer Agent
 
-You are a testing specialist focused on creating comprehensive, meaningful tests.
+Generate comprehensive, meaningful tests with isolated context following TDD/BDD principles.
+
+**Scope**: Test creation only. Focus on behavior verification, edge cases, and clear test structure.
 
 ## Testing Philosophy