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:
@@ -51,7 +51,7 @@ SuperClaude is a collection of `.md` instruction files that Claude Code reads to
|
||||
**IMPORTANT**: SuperClaude is NOT a CLI tool or executable software. When you see `/sc:` commands in documentation, these are **context trigger patterns** you type in Claude Code conversations, not terminal commands.
|
||||
|
||||
### Agent Context Files
|
||||
Specialized instruction sets that provide domain expertise when activated by `@agents-[name]` or automatically by keywords.
|
||||
Specialized instruction sets that provide domain expertise when activated by `@agent-[name]` or automatically by keywords.
|
||||
|
||||
### Command Context Files
|
||||
Workflow patterns triggered by `/sc:[command]` **context patterns** (not CLI commands) that guide Claude Code through structured development tasks when you type them in Claude Code conversations.
|
||||
|
||||
@@ -50,7 +50,7 @@ This guide documents how SuperClaude's Context-Oriented Configuration Framework
|
||||
| File Type | Purpose | Activation | Example |
|
||||
|-----------|---------|------------|---------|
|
||||
| **Commands** | Define workflow patterns | `/sc:[command]` (context trigger) | User types `/sc:implement` → reads `implement.md` |
|
||||
| **Agents** | Provide domain expertise | `@agents-[name]` or auto | `@agents-security` → reads `security-engineer.md` |
|
||||
| **Agents** | Provide domain expertise | `@agent-[name]` or auto | `@agent-security` → reads `security-engineer.md` |
|
||||
| **Modes** | Modify interaction style | Flags or triggers | `--brainstorm` → activates brainstorming mode |
|
||||
| **Core** | Set fundamental rules | Always active | `RULES.md` always loaded |
|
||||
|
||||
@@ -113,7 +113,7 @@ Core philosophy and approach
|
||||
|
||||
### Agent Activation Logic
|
||||
|
||||
- **Manual**: User types `@agents-python-expert "task"`
|
||||
- **Manual**: User types `@agent-python-expert "task"`
|
||||
- **Automatic**: Keywords in request trigger agent loading
|
||||
- **Contextual**: File types or patterns activate relevant agents
|
||||
|
||||
@@ -231,7 +231,7 @@ User Input (in Claude Code): "/sc:analyze src/ --focus security"
|
||||
### Context Priority
|
||||
|
||||
1. **Explicit Commands**: `/sc:` commands take precedence
|
||||
2. **Manual Agents**: `@agents-` override auto-activation
|
||||
2. **Manual Agents**: `@agent-` override auto-activation
|
||||
3. **Flags**: Modify behavior of commands/agents
|
||||
4. **Auto-Activation**: Based on keywords/context
|
||||
5. **Default Behavior**: Standard Claude Code
|
||||
|
||||
@@ -164,7 +164,7 @@ PYTHONPATH=/path/to/SuperClaude_Framework python3 -m setup install --components
|
||||
|
||||
### Issue: Agents Not Activating
|
||||
|
||||
**Symptom**: `@agents-` invocations don't work in Claude Code
|
||||
**Symptom**: `@agent-` invocations don't work in Claude Code
|
||||
|
||||
**Verification**:
|
||||
```bash
|
||||
|
||||
Reference in New Issue
Block a user