# SubAgents

## Структура

```
subagents/                        # В корне репозитория
├── media-agent/
│   ├── SUBAGENT.md               # Метаданные + системный промпт
│   ├── image-gen/                # Skill (формат Deep Agents)
│   │   └── SKILL.md
│   └── meme-maker/
│       └── SKILL.md
└── researcher/
    ├── SUBAGENT.md
    └── web-search/
        └── SKILL.md
```

Папка `subagents/` монтируется в `/subagents/` через `docker-compose`.

## SUBAGENT.md

```markdown
---
name: media-agent
description: Генерирует медиа-контент. Использовать для создания картинок, мемов, видео.
---

Ты субагент для генерации медиа-контента.
Описание задач, инструментов, формата ответа...
```

**Поля:**
- `name` - уникальный ID (используется в `task()`)
- `description` - когда основной агент должен делегировать задачу этому субагенту

Всё после закрывающего `---` улетает в системный промпт.

## SKILL.md (навыки)

```markdown
---
name: image-gen
description: Генерация изображений по текстовому описанию
---

# Image Generation
## When to Use
...
## How to Use
...
```

Каждый навык - отдельная папка с файлом `SKILL.md`. Находятся на одном уровне с `SUBAGENT.md`.
В папке навыка могут находиться дополнительные скрипты.

## Как добавить субагента

1. Создать папку в `subagents/` с именем субагента
2. Добавить `SUBAGENT.md` с YAML frontmatter и промптом
3. (Опционально) добавить папки со скилами
4. Перезапустить контейнер

## Инструменты

Субагенты наследуют все тулзы основного агента (Composio + custom tools).

## Docker Compose

```yaml
volumes:
  - ./subagents:/subagents
```