/f5-agent

description: Manage AI agents, personas, and get smart suggestions
argument-hint: <list|invoke|persona|suggest> [options]

/f5-agent - Unified AI Agent Command

**Consolidated command** that replaces:

• `/f5-persona` → `/f5-agent persona`
• `/f5-suggest` → `/f5-agent suggest`

ARGUMENTS

$ARGUMENTS

MODE DETECTION

| Pattern | Mode | Description | |---------|------|-------------| | `persona <action>` | PERSONA | Persona management | | `suggest [topic]` | SUGGEST | Smart suggestions | | `<other>` (default) | AGENT | Agent invocation |

---

MODE: PERSONA (from /f5-persona)

`/f5-agent persona <action>`

Manage and activate specialized personas.

| Action | Description | |--------|-------------| | `list` | List all available personas | | `show <name>` | Show persona details | | `activate <name>` | Activate a persona | | `deactivate` | Return to default | | `auto [on\|off]` | Toggle auto-activation | | `chain <task>` | Chain personas for task | | `status` | Show current status |

**Available Personas:** | Persona | Emoji | Focus | |---------|-------|-------| | architect | 🏗️ | System design | | backend | ⚙️ | APIs, services | | frontend | 🎨 | UI/UX, components | | database | 🗄️ | Schema, queries | | security | 🔒 | OWASP, auth | | qa | 🧪 | Testing, coverage | | performance | ⚡ | Optimization | | reviewer | 👀 | Code review | | devops | 🚀 | CI/CD, infra | | analyst | 📊 | Requirements | | developer | 💻 | General dev (default) |

**Examples:**

/f5-agent persona list
/f5-agent persona activate security
/f5-agent persona chain "build auth system"

---

MODE: SUGGEST (from /f5-suggest)

`/f5-agent suggest [topic]`

Get context-aware command suggestions.

| Action | Description | |--------|-------------| | (default) | Suggestions for current phase | | `<topic>` | Suggestions for specific topic | | `next` | Suggest next action | | `chains` | Show command chains |

**Options:**

• `--all` - Show all command levels
• `--v{1-5}` - Verbosity level

**Examples:**

/f5-agent suggest
/f5-agent suggest api
/f5-agent suggest next
/f5-agent suggest chains

---

MODE: AGENT (Default)

Invoke specialized agents for specific tasks.

OVERVIEW

SPECIALIZED AGENTS
═══════════════════════════════════════════════════════════════════

  Agents are task-specific AI assistants:

  ⚡ code_generator     │ 🧪 test_writer      │ 👀 code_reviewer
  🔧 refactorer         │ 📝 documenter       │ 🐛 debugger
  🔄 migrator           │ 🛡️ security_scanner │ 📊 performance_analyzer
  🌐 api_designer       │ 🏗️ system_architect

═══════════════════════════════════════════════════════════════════

SUBCOMMANDS

| Command | Description | |---------|-------------| | `list` | List all agents | | `invoke <agent> [input]` | Invoke an agent | | `pipeline <name>` | Run agent pipeline | | `status` | Show active agents | | `help <agent>` | Show agent details |

---

QUICK INVOCATION

Instead of using the full command, you can invoke agents directly using the `@f5:` pattern:

Direct Pattern

@f5:security "review authentication flow"
@f5:architect "design payment system"
@f5:qa "generate tests for PaymentService"
@f5:debug "fix TypeError in OrderController"

Multi-Agent

@f5:security @f5:architect "review and redesign auth system"

With Options

@f5:qa --coverage 90 "test all services"
@f5:security --deep "full security audit"

Available Aliases

| Short | Full | Agent | |-------|------|-------| | @f5:sec | @f5:security | security_scanner | | @f5:arch | @f5:architect | system_architect | | @f5:be | @f5:backend | code_generator | | @f5:fe | @f5:frontend | code_generator | | @f5:qa | @f5:test | test_writer | | @f5:bug | @f5:debug | debugger | | @f5:doc | @f5:docs | documenter | | @f5:perf | @f5:performance | performance_analyzer | | @f5:ref | @f5:refactor | refactorer | | @f5:api | - | api_designer |

Supported Options

| Option | Description | |--------|-------------| | `--deep` | Thorough analysis | | `--quick` | Fast check | | `--coverage <n>` | Target coverage percentage | | `--fix` | Auto-fix issues if possible | | `--verbose` | Detailed output |

---

ACTION: LIST_AGENTS

`/f5-agent list`

## 🤖 Available Agents

### Code Agents
| Agent | Emoji | Purpose |
|-------|-------|---------|
| code_generator | ⚡ | Generate production code |
| refactorer | 🔧 | Improve code quality |
| migrator | 🔄 | Handle migrations |

### Quality Agents
| Agent | Emoji | Purpose |
|-------|-------|---------|
| test_writer | 🧪 | Generate test suites |
| code_reviewer | 👀 | Review code quality |
| security_scanner | 🛡️ | Find vulnerabilities |
| performance_analyzer | 📊 | Analyze performance |

### Support Agents
| Agent | Emoji | Purpose |
|-------|-------|---------|
| debugger | 🐛 | Diagnose and fix bugs |
| documenter | 📝 | Generate documentation |
| api_designer | 🌐 | Design APIs |

### Quick Invoke
```bash
/f5-agent invoke code_generator "user registration service"

---

## ACTION: INVOKE_AGENT

### `/f5-agent invoke <agent> [input]`

Invoke a specific agent with input:

```markdown
## ⚡ Agent Invoked: code_generator

### Input
> "user registration service"

### Agent Processing

1. Analyzing requirements... 2. Loading project patterns... 3. Generating code...

### Output

```typescript
// src/user/user-registration.service.ts
import { Injectable, ConflictException } from '@nestjs/common';
import { InjectRepository } from '@nestjs/typeorm';
import { Repository } from 'typeorm';
import { User } from './entities/user.entity';
import { RegisterDto } from './dto/register.dto';
import * as bcrypt from 'bcrypt';

@Injectable()
export class UserRegistrationService {
  constructor(
    @InjectRepository(User)
    private readonly userRepo: Repository<User>,
  ) {}

  async register(dto: RegisterDto): Promise<User> {
    // Check duplicate
    const existing = await this.userRepo.findOne({
      where: { em