Initial commit: VoIdeaAI - voice-first AI idea assistant

docs/agent-prompts/patterns.md

@@ -0,0 +1,50 @@
+# Паттерны промптов
+
+## 1. System + User разделение
+
+```python
+system_prompt = "Ты — бизнес-аналитик. Анализируй идеи."
+user_prompt = f"Название: {idea.title}\nОписание: {idea.content}"
+full_prompt = f"{system_prompt}\n\n{user_prompt}"
+```
+
+Используется: `AIProvider.format_prompt()`
+
+## 2. Structured output
+
+```python
+system_prompt = """
+Ты — финансовый консультант.
+Ответ верни ТОЛЬКО в формате JSON:
+{
+    "roi": число,
+    "risk_level": "low|medium|high",
+    "recommendations": [строка, ...]
+}
+"""
+```
+
+## 3. Few-shot (примеры)
+
+```python
+system_prompt = """
+Ты — UI-дизайнер. Анализируй интерфейс.
+
+Пример хорошего анализа:
+Интерфейс: Экран входа
+Проблема: Кнопка "Забыли пароль" не видна
+Рекомендация: Высокий приоритет
+
+Теперь проанализируй:
+"""
+```
+
+## Параметры
+
+| Параметр | Значение | Когда |
+|----------|----------|-------|
+| `temperature: 0.1-0.3` | Низкая | Юридические, финансовые |
+| `temperature: 0.5-0.7` | Средняя | Стандартный анализ |
+| `temperature: 0.8-1.0` | Высокая | Мозговой штурм |
+| `max_tokens: 500` | Короткий | Классификация |
+| `max_tokens: 4000` | Длинный | Детальный анализ |