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:
parent
94b9ad4f89
commit
191ff42741
15 changed files with 146 additions and 82 deletions
|
|
@ -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
|
||||
```
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
|
|
@ -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
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue