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>
This commit is contained in:
Florian BRUNIAUX 2026-02-09 10:29:59 +01:00
parent 94b9ad4f89
commit 191ff42741
15 changed files with 146 additions and 82 deletions

View file

@ -295,12 +295,12 @@ claude --session infra-setup
**Organization**: Fountain (frontline workforce management platform)
**Challenge**: Comprehensive codebase review across multiple concerns (security, API design, frontend)
**Solution**: Deployed hierarchical multi-agent orchestration with specialized sub-agents
**Solution**: Deployed hierarchical multi-agent orchestration with scope-focused sub-agents
**Agent assignment**:
- **Agent 1 (Security)**: Scan for vulnerabilities, auth issues, data exposure
- **Agent 2 (API)**: Review endpoint design, request/response validation, error handling
- **Agent 3 (Frontend)**: Check UI patterns, accessibility, performance
**Agent scopes** (Fountain's approach):
- **Scope 1 (Security)**: Scan for vulnerabilities, auth issues, data exposure
- **Scope 2 (API)**: Review endpoint design, request/response validation, error handling
- **Scope 3 (Frontend)**: Check UI patterns, accessibility, performance
**Results**:
- ✅ **50% faster** candidate screening
@ -314,10 +314,10 @@ claude --session infra-setup
**Example prompt** (team lead):
```
Review this PR comprehensively:
- Security agent: Check for vulnerabilities and auth issues
- API agent: Review endpoint design and error handling
- Frontend agent: Check UI patterns and accessibility
Review this PR comprehensively with scope-focused analysis:
- Security Scope: Check for vulnerabilities and auth issues (context: auth code, input validation)
- API Design Scope: Review endpoint design and error handling (context: API routes, controllers)
- Frontend Scope: Check UI patterns and accessibility (context: components, styles)
PR: https://github.com/company/repo/pull/123
```

View file

@ -370,7 +370,7 @@ Specialized iterative pattern for code review where Claude reviews → fixes →
```
Review this PR with auto-correction:
1. Multi-agent review (3 specialized agents)
1. Multi-agent review (3 scope-focused agents)
2. Fix all 🔴 Must Fix issues
3. Re-review to verify fixes didn't introduce new issues
4. Fix all 🟡 Should Fix issues

View file

@ -183,7 +183,7 @@ post_edit:
### With Sub-Agents
Delegate test writing to specialized agent:
Delegate test writing to scope-focused agent:
```
Use the test-writer agent to create comprehensive tests for