agent-creator

# Agent Creator

## Agent Workflow (MANDATORY)

Before ANY agent creation, launch in parallel:

1. **fuse-ai-pilot:explore-codebase** - Check existing agents, analyze patterns
2. **fuse-ai-pilot:research-expert** - Fetch latest agent conventions
3. **mcp__context7__query-docs** - Get examples from existing agents

After creation, run **fuse-ai-pilot:sniper** for validation.

---

## Overview

| Action | When to Use |
|--------|-------------|
| **New Agent** | New domain/framework expert needed |
| **Adapt** | Copy from similar agent (Next.js → React) |
| **Update** | Add skills, modify hooks |

---

## Critical Rules

1. **ALL content in English** - Never French or other languages
2. **Frontmatter complete** - name, description, model, tools, skills, hooks
3. **Agent Workflow section** - Always first content section
4. **SOLID rules reference** - Link to solid-[stack] skill
5. **Register in marketplace.json** - Or agent won't load
6. **Hook scripts executable** - `chmod +x`

---

## Architecture

```
plugins/<plugin-name>/
├── agents/
│   └── <agent-name>.md      # Agent definition
├── skills/
│   ├── skill-a/
│   └── solid-[stack]/
├── scripts/
│   └── validate-*.sh        # Hook scripts
└── .claude-plugin/
    └── plugin.json
```

→ See [architecture.md](references/architecture.md) for details

---

## Reference Guide

### Concepts

| Topic | Reference | When to Consult |
|-------|-----------|-----------------|
| **Architecture** | [architecture.md](references/architecture.md) | Understanding agent structure |
| **Frontmatter** | [frontmatter.md](references/frontmatter.md) | YAML configuration |
| **Required Sections** | [required-sections.md](references/required-sections.md) | Mandatory content |
| **Hooks** | [hooks.md](references/hooks.md) | Pre/Post tool validation |
| **Registration** | [registration.md](references/registration.md) | marketplace.json |

### Templates

| Template | When to Use |
|----------|-------------|
| [agent-template.md](references/templ