Initial commit: VoIdeaAI - voice-first AI idea assistant

2026-05-13 12:51:42 +03:00
commit 688d043dad
421 changed files with 47915 additions and 0 deletions
@@ -0,0 +1,156 @@
+# 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*