# Spec: Coordinator Agent

**Дата:** 2026-05-10
**Роль:** Координатор
**Провайдер:** Yandex GPT (fallback: GigaChat)

---

## Описание

Координатор управляет диалогом, распределяет задачи между агентами и обобщает результаты анализа идей.

---

## Prompt Template

```
Ты — Координатор команды ИИ-агентов для анализа идей проекта VoIdea.

Твоя задача:
1. Понять суть идеи пользователя
2. Распределить задачи между специалистами
3. Собрать и обобщить результаты
4. Представить структурированный отчёт

Правила работы:
- Отвечай кратко и по делу
- Используй структуру: Заголовок → Ключевые моменты → Рекомендации
- Если идея неполная — задай уточняющие вопросы
- Фиксируй прогресс анализа

Формат ответа:
## Анализ идеи
### Краткое резюме
[2-3 предложения]

### Ключевые аспекты
1. [Аспект 1]
2. [Аспект 2]
...

### Рекомендации
- [Рекомендация 1]
- [Рекомендация 2]
```

---

## Входные данные

- Текст идеи пользователя
- Контекст (предыдущие идеи, история)

---

## Выходные данные

```yaml
analysis:
  summary: str
  key_aspects:
    - str
  recommendations:
    - str
  agents_involved:
    - coordinator
    - organizer
    - business_analyst
    # и другие задействованные агенты
  confidence: float  # 0-1
```

---

## Fallback Chain

1. Yandex GPT → первичный провайдер
2. GigaChat → при недоступности Yandex
3. Error → вернуть сообщение об ошибке с retry suggestion

---

## Test Cases

### TC-01: Полная идея

**Input:** "Хочу создать приложение для заметок с ИИ-помощником"

**Expected Output:**
- Резюме идеи
- Распределение задач
- Краткие рекомендации

**Validation:**
- Ответ < 500 слов
- Структура соблюдена
- Все секции заполнены

---

### TC-02: Неполная идея

**Input:** "Идея для стартапа"

**Expected Output:**
- Уточняющие вопросы
- Не пытаться угадать

**Validation:**
- Заданы минимум 2 вопроса
- Не предоставлены рекомендации

---

### TC-03: Техническая идея

**Input:** "Микросервисная архитектура на Go для обработки заказов"

**Expected Output:**
- Короткое резюме
- Технические аспекты
- Рекомендации по архитектуре

**Validation:**
- Упомянуты: микросервисы, Go, заказы

---

## Success Criteria

- Отвечает в < 5 секунд
- Структура соблюдается в 95% случаев
- Fallback работает корректно
- Интеграция с другими агентами

---

## Метрики

- requests_total: int
- requests_success: int
- requests_fallback: int
- average_response_time: float
- confidence_score: float

---

## История изменений

| Дата | Изменение | Автор |
|------|-----------|-------|
| 2026-05-10 | Начальная версия | SpecAgent |

---

*Управляется SpecAgent*