документация

SUBAGENTS.md

@@ -0,0 +1,73 @@
+# 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
+```