Update Agent

Updates agent files to align with the latest template structure and applies any specified changes while preserving unique agent characteristics.

🎯 Purpose & Scope

This command systematically updates agent files to maintain consistency with the current template while preserving each agent's unique personality, expertise, and collaboration networks.

What this command does NOT do:

• Create new agent files (use /create-agent instead)
• Delete or remove agent files
• Modify agent core personality or expertise areas
• Change agent role assignments without explicit instruction

When to REJECT:

• No agents exist in the /agents directory
• Template file template:agent is missing or invalid
• Request to modify protected agent characteristics without justification
• Agent files are locked or in active use by running processes

🔄 Workflow

ultrathink: you'd perform the following steps

Step 1: Follow Update Agent Workflow

• Execute update-agent.md

Step 2: Reporting

Output Format:

[✅/❌] Command: update-agent $ARGUMENTS

## Summary
- Agents processed: [count/total]
- Successfully updated: [count]
- Failed updates: [count]
- Template compliance: [PASS/FAIL]

## Actions Taken
1. [Batch processing of agents with results]
2. [Template alignment changes applied]
3. [Custom changes applied (if any)]

## Workflows Applied
- Update Agent Workflow: [Status]

## Updated Agents
- [agent-name]: [Changes applied]
- [agent-name]: [Changes applied]

## Issues Found (if any)
- **Agent**: [agent-name]
  **Issue**: [Description of problem]
  **Resolution**: [Applied fix or manual intervention needed]

📝 Examples

Update All Agents

/update-agent
# Updates all agents in /agents directory to latest template
# Preserves unique characteristics while ensuring template compliance

Update Specific Agent

/update-agent "priya-sharma"
# Updates only the priya-sharma agent file
# Aligns with template while preserving role-specific content

Update with Pattern Matching

/update-agent "*frontend*"
# Updates all agents with 'frontend' in their filename
# Useful for updating agents with similar roles or expertise

Update with Custom Changes

/update-agent --change="Add new security compliance gate"
# Updates all agents and applies additional changes
# Template alignment plus specified modifications

Update Specific Agent with Changes

/update-agent "james-mitchell" --change="Update collaboration network to include new DevOps role"
# Updates specific agent with both template alignment and custom changes
# Preserves agent identity while making requested modifications

Batch Update by Category

/update-agent "*-engineer*" --change="Update tool permissions for new security standards"
# Updates all engineer-type agents with security updates
# Efficient for role-based mass updates

Error Case Handling

/update-agent "non-existent-agent"
# Error: Agent file not found
# Suggestion: Use 'ls agents/' to see available agents
# Alternative: Use '/update-agent' to update all agents

Template Validation

/update-agent --verify
# Validates all agents against current template without making changes
# Reports compliance status and suggests improvements