mirror of
https://github.com/SuperClaude-Org/SuperClaude_Framework.git
synced 2025-12-29 16:16:08 +00:00
🔧 Standardize agent invocation syntax: @agents- → @agent-
## Changes Made - **Agent Syntax Standardization**: Updated all agent invocations from `@agents-` to `@agent-` - **Consistency**: Applied change across all 14 documentation files and 1 source file - **Examples Updated**: All agent invocation examples now use singular `@agent-` format - **Pattern Recognition**: Updated references to trigger pattern documentation ## Files Updated (14 total) ### Documentation - Docs/User-Guide/commands.md - Core command reference - Docs/User-Guide/agents.md - Agent guide with all examples - Docs/README.md - Quick reference updated - Docs/Getting-Started/installation.md & quick-start.md - Setup instructions - Docs/Developer-Guide/ - Technical architecture and testing docs - Docs/Reference/ - All example files and troubleshooting ### Source Files - SuperClaude/Agents/security-engineer.md - Agent context file ## Impact ✅ **Consistent Syntax**: All agent invocations now use `@agent-[name]` format ✅ **User Clarity**: Clear distinction from previous `@agents-` plural form ✅ **Documentation Alignment**: All examples and references updated consistently ✅ **Framework Standards**: Aligns with SuperClaude naming conventions Examples now correctly show: - `@agent-security "review authentication"` - `@agent-python-expert "optimize code"` - `@agent-frontend-architect "design components"` Total replacements: 80+ instances across entire documentation 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
@@ -12,7 +12,7 @@ Before using this guide, verify agent selection works:
|
||||
|
||||
```bash
|
||||
# Test manual agent invocation
|
||||
@agents-python-expert "explain decorators"
|
||||
@agent-python-expert "explain decorators"
|
||||
# Example behavior: Python expert responds with detailed explanation
|
||||
|
||||
# Test security agent auto-activation
|
||||
@@ -29,7 +29,7 @@ Before using this guide, verify agent selection works:
|
||||
|
||||
# Test combining manual and auto
|
||||
/sc:analyze src/
|
||||
@agents-refactoring-expert "suggest improvements"
|
||||
@agent-refactoring-expert "suggest improvements"
|
||||
# Example behavior: Analysis followed by refactoring suggestions
|
||||
```
|
||||
|
||||
@@ -44,12 +44,12 @@ Before using this guide, verify agent selection works:
|
||||
|
||||
### Two Ways to Use Agents
|
||||
|
||||
#### 1. Manual Invocation with @agents- Prefix
|
||||
#### 1. Manual Invocation with @agent- Prefix
|
||||
```bash
|
||||
# Directly invoke a specific agent
|
||||
@agents-security "review authentication implementation"
|
||||
@agents-frontend "design responsive navigation"
|
||||
@agents-architect "plan microservices migration"
|
||||
@agent-security "review authentication implementation"
|
||||
@agent-frontend "design responsive navigation"
|
||||
@agent-architect "plan microservices migration"
|
||||
```
|
||||
|
||||
#### 2. Auto-Activation (Behavioral Routing)
|
||||
@@ -75,7 +75,7 @@ Before using this guide, verify agent selection works:
|
||||
### Agent Selection Rules
|
||||
|
||||
**Priority Hierarchy:**
|
||||
1. **Manual Override** - @agents-[name] takes precedence over auto-activation
|
||||
1. **Manual Override** - @agent-[name] takes precedence over auto-activation
|
||||
2. **Keywords** - Direct domain terminology triggers primary agents
|
||||
3. **File Types** - Extensions activate language/framework specialists
|
||||
4. **Complexity** - Multi-step tasks engage coordination agents
|
||||
@@ -91,7 +91,7 @@ Before using this guide, verify agent selection works:
|
||||
**Selection Decision Tree:**
|
||||
```
|
||||
Task Analysis →
|
||||
├─ Manual @agents-? → Use specified agent
|
||||
├─ Manual @agent-? → Use specified agent
|
||||
├─ Single Domain? → Activate primary agent
|
||||
├─ Multi-Domain? → Coordinate specialist agents
|
||||
├─ Complex System? → Add system-architect oversight
|
||||
@@ -103,11 +103,11 @@ Task Analysis →
|
||||
|
||||
### Manual Agent Invocation
|
||||
```bash
|
||||
# Explicitly call specific agents with @agents- prefix
|
||||
@agents-python-expert "optimize this data processing pipeline"
|
||||
@agents-quality-engineer "create comprehensive test suite"
|
||||
@agents-technical-writer "document this API with examples"
|
||||
@agents-socratic-mentor "explain this design pattern"
|
||||
# Explicitly call specific agents with @agent- prefix
|
||||
@agent-python-expert "optimize this data processing pipeline"
|
||||
@agent-quality-engineer "create comprehensive test suite"
|
||||
@agent-technical-writer "document this API with examples"
|
||||
@agent-socratic-mentor "explain this design pattern"
|
||||
```
|
||||
|
||||
### Automatic Agent Coordination
|
||||
@@ -132,8 +132,8 @@ Task Analysis →
|
||||
/sc:implement "user profile system"
|
||||
|
||||
# Then explicitly add specialist review
|
||||
@agents-security "review the profile system for OWASP compliance"
|
||||
@agents-performance-engineer "optimize database queries"
|
||||
@agent-security "review the profile system for OWASP compliance"
|
||||
@agent-performance-engineer "optimize database queries"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user