[2026-05-19] psychologist-app: session-design.md — механика вопросов, крючки, закрытие сессии, планировщик

personal/projects/psychologist-app/overview.md

@@ -12,7 +12,7 @@ status: planning
 # AI Psychologist App — Project Overview
 
 > Стартовый документ. Источники: research vault, рыночные данные (May 2026), Reddit feedback, pricing.
-> Связанные: [[ai-psychologist-research]], [[unprejudiced-ai-psychologist]]
+> Связанные: [[ai-psychologist-research]], [[unprejudiced-ai-psychologist]], [[session-design]]
 
 ---
 

personal/projects/psychologist-app/session-design.md

@@ -0,0 +1,170 @@
+---
+created: '2026-05-19'
+updated: '2026-05-19'
+tags:
+  - project
+  - app
+  - psychology
+  - ux
+  - architecture
+---
+# Session Design — AI Psychologist App
+
+> Детальный дизайн сессии: UX-флоу, механика вопросов, открытие/закрытие.
+> Связан с: [[overview]] (раздел 5-6 — базовая структура и архитектура ботов)
+
+---
+
+## 1. Механика вопросов (Question Delivery)
+
+### Pipeline вопросов
+
+```
+Бот 2 (Analyst / "Психолог")
+  → генерирует 1-2 вопроса в 3-м лице ("пользователь избегает...")
+        ↓
+Бот 1 (Narrator / "Посредник")
+  → переформулирует в 1-е лицо ("ты избегаешь?")
+  → на выходе: структурированный массив вопросов для UI
+        ↓
+UI алгоритм (не агент!)
+  → показывает вопросы по одному в карточках
+  → ждёт ответа → следующий
+```
+
+**Ключевой принцип**: раздача вопросов — детерминированный алгоритм, не LLM-вызов.
+Агент генерирует батч вопросов один раз → посредник переформулирует → UI сам управляет порядком.
+
+### Структура данных от агента (JSON для UI)
+
+```json
+{
+  "questions": [
+    {
+      "id": 1,
+      "text": "Ты замечаешь, что откладываешь этот разговор?",
+      "type": "open"
+    },
+    {
+      "id": 2,
+      "text": "Что происходит внутри когда думаешь об этом?",
+      "type": "open"
+    }
+  ],
+  "answered": [],
+  "session_id": "2026-05-19"
+}
+```
+
+### Завершение батча вопросов → подбивка
+
+Когда все вопросы в батче отвечены, UI передаёт агенту нумерованную подбивку:
+
+```
+1. [вопрос] → [ответ пользователя]
+2. [вопрос] → [ответ пользователя]
+```
+
+Это входные данные для следующей итерации диалога (следующий батч вопросов или инсайт).
+
+---
+
+## 2. Открытие сессии
+
+### Структура intro
+
+1. **Персонаж-активация** (анимация, 1-2 сек) — без текста, пауза перед словами
+2. **Короткое введение** (1-2 предложения максимум):
+   - Что происходит сегодня в целом (настроение агента, не диагноз)
+   - Без "Давай начнём с..." — сразу к делу
+3. **"Крючки-активаторы"** из прошлых бесед:
+   - 1-2 элемента из profile.md / последних сессий
+   - Формат: карточка-напоминание ("В прошлый раз ты говорил о...")
+   - **Не перегружать**: максимум 2 крючка, не перечислять всю историю
+   - Если нет прошлых сессий — пропустить этот блок
+4. **Переход к теме** — либо предложение агента, либо выбор пользователя
+
+### Prompt агента для intro
+
+Агент (Analyst) при старте сессии получает:
+- `profile.md` — текущий профиль
+- `sessions/[last 1-2].md` — последние сессии
+- Задача: сформировать intro + max 2 крючка, без перечисления всего
+
+---
+
+## 3. Закрытие сессии
+
+### Последовательность закрытия (3 этапа)
+
+#### Этап 1 — Психолог обновляет документы (backend, не видно пользователю)
+
+После завершения диалогового флоу Analyst:
+- Пишет `sessions/YYYY-MM-DD.md` — запись сессии
+- Обновляет `profile.md` — новые паттерны/наблюдения
+- Формирует structured summary для Посредника
+
+#### Этап 2 — Посредник: человечный итог (видно пользователю)
+
+Посредник в режиме "простого AI-агента" — без аналитики, без психолого-языка:
+- Тёплая, живая фраза от себя (не "подводя итог...")
+- Примерный тон: "И от себя — это больше чем ничего. Ты на верном пути."
+- **Не повторять** то что уже сказал психолог
+- **Не хвалить** избыточно — anti-sycophancy принцип сохраняется
+- Сказать когда следующая сессия: "До встречи в четверг" (из расписания пользователя)
+
+#### Этап 3 — "One last thing" + завершение
+
+- Агент задаёт открытый вопрос с вольным промптом:
+  "Хочешь что-то добавить?"
+- **Визуально**: маленький текстовый input, **не акцентная** кнопка "Завершить"
+- Этот экран не предполагает продолжения полноценной сессии
+- Если пользователь что-то написал → агент может добавить это в заметки сессии, ответить коротко
+- Если нажал "Завершить" без ввода → сессия закрывается
+
+### Сценарий сдвига расписания
+
+Если в "one last thing" (или на любом этапе закрытия) пользователь упоминает сдвиг даты/времени:
+- Детектируется ключевыми словами (перенести, следующий раз, не смогу в четверг, и т.д.)
+- Запускается **сценарий планировщика** (отдельный флоу)
+- Беседа переходит в режим планировщика и **завершается в нём** (не возвращается в сессионный флоу)
+- Результат: обновлённое расписание, подтверждение новой даты
+
+---
+
+## 4. Флоу сессии целиком
+
+```
+ОТКРЫТИЕ
+├── Анимация персонажа (1-2 сек)
+├── Intro: 1-2 предложения + max 2 крючка из истории
+└── Выбор темы (пользователь или AI предлагает)
+
+ДИАЛОГ
+├── Analyst генерирует 1-2 вопроса (3-е лицо)
+├── Narrator переформулирует → JSON карточек (1-е лицо)
+├── UI раздаёт по одному
+├── Пользователь отвечает → нумерованная подбивка
+└── Следующий батч / инсайт
+
+ИНСАЙТ
+├── Analyst кристаллизует наблюдение (3-е лицо)
+└── Narrator переформулирует для пользователя (1-е лицо)
+
+ЗАКРЫТИЕ
+├── [backend] Analyst пишет session summary, обновляет profile.md
+├── Посредник: тёплая фраза + дата следующей сессии
+├── "One last thing" (вольный промпт, неакцентное завершение)
+│   ├── Написал что-то → агент добавляет в заметки, отвечает коротко
+│   ├── Упомянул перенос → сценарий планировщика
+│   └── Завершить (кнопка) → сессия закрыта
+```
+
+---
+
+## 5. Открытые вопросы
+
+- [ ] Как именно Narrator детектирует что вопросы в 3-м лице и нужно переформулировать? Prompt rule или регекс-паттерн?
+- [ ] Сценарий планировщика — отдельный агент или встроен в посредника?
+- [ ] Как хранить расписание сессий: отдельный `schedule.md` в профиле?
+- [ ] Что если "one last thing" раскрывает новую тему — прерывать или кратко зафиксировать?