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,40 @@
+# Управление промптами агентов
+
+## Принцип
+
+Промпты — это код. Они версионируются, хранятся в репозитории и проходят code review. Никаких hardcoded промптов в Python-коде.
+
+## Где хранить
+
+В VoIdea используется **два формата** с fallback:
+
+| Формат | Расположение | Назначение |
+|--------|-------------|------------|
+| YAML | `docs/agent_prompts.yaml` | Настройки провайдера, температуры, токенов |
+| Markdown | `docs/specs/agents/<role>.md` | Детальные промпты с примерами |
+
+`PromptLoader` пробует YAML первым, если не нашёл — падает на MD-спецификацию.
+
+## Структура YAML
+
+```yaml
+coordinator:
+  provider: yandex_gpt       # yandex_gpt | gigachat
+  temperature: 0.7            # 0.0-1.0
+  max_tokens: 2000            # макс. длина ответа
+```
+
+## Структура MD
+
+```markdown
+# Роль
+
+**Провайдер:** Yandex GPT
+**Температура:** 0.7
+**Макс. токенов:** 2000
+
+## Prompt Template
+```
+Ты — {role}. Описание.
+```
+```