Ksenia Ha⚡️UX.UI.AI

## 🔬 Research Guide — как делать ресёрчи

### Принципы

1. **Все инструменты достаточно умные.** Parallel, Claude Code, Perplexity — внутри агенты. Не надо им объяснять КАК искать или ГДЕ искать. Им нужно понять ЧТО мы ищем и ЗАЧЕМ.

2. **Максимум контекста.** Чем больше нашего контекста мы даём агенту — тем лучше результат. Описывай ситуацию, что уже есть, что пробовали, почему это важно. Не бойся длинных промптов.

3. **Перед формулировкой промпта — собери контекст.** Прочитай релевантные файлы (vault, memory, конфиги), чтобы дать агенту реальную картину, а не абстракцию.

4. **Не формальные запросы.** Пиши как умному человеку. Формальные структурированные запросы → формальные дженерик ответы. Живой контекст + живой вопрос → интересные находки.

5. **Если непонятно намерение — спроси.** Если после сбора контекста не до конца ясно, какая мета-цель стоит за вопросом, лучше сначала уточнить у пользователя, чем отправлять размытый запрос.

### Структура промпта

- **Намерение:** ради чего делаем ресёрч, какое решение принимаем
- **Желаемый результат:** что конкретно хотим получить
- **Контекст:** наша ситуация, что уже есть, что пробовали (без чувствительных данных без согласования)
- **Почему важно:** чтобы агент мог копнуть глубже, увидев связи

### Дефолтный фрейм: "как делается X"

> **Когда Сева просит узнать, как что-то делается или решается — это означает:**
> Ищем в первую очередь кейсы живых пользователей, их истории, как именно они решали подобную задачу, что у них сработало, что не сработало, плюсы, минусы, подводные камни. У кого и как в итоге получилось решить задачу, что реально сработало на практике, и что важно учесть, решая эту задачу.

Этот фрейм применяется когда звучит "проведи ресёрч", "проведи дип-ресёрч", "узнай как делается X" — любой запрос на глубокое исследование, а не бытовой вопрос для web_search.

### Правило: показывать промпты

**При КАЖДОМ запуске research/Claude Code/любого инструмента — ОБЯЗАТЕЛЬНО показать Севе полный дословный промпт от начала до конца, который отправляется в инструмент. Без сокращений.**

### Инструменты для ресёрча

#### Deep Research (Parallel, Perplexity и т.п.)
Глубокий multi-source ресёрч. Структурированные отчёты, много источников, citations. Формат более формальный.

#### Claude Code
Полноценный AI-агент с web search, file access и deep reasoning. Отлично подходит для deep research если правильно запромптить. По умолчанию в print mode (-p) склонен "поговорить" — предложить план, спросить разрешения. Для research-задач обязательно начинать промпт с:

You are being used as a Deep Research Tool. Your job is to EXECUTE the research below — search the web thoroughly, read pages, and compile findings into a comprehensive report. Do NOT ask for permission, do NOT propose a plan, do NOT ask clarifying questions. Just DO the research and return the full detailed findings.

OUTPUT FORMAT: Return a comprehensive research report with all findings, organized by topic. Include specific quotes, links, and concrete examples.

RESEARCH TASK:

[далее сам промпт с контекстом по принципам Research Guide выше]

#### web_search
Быстрый lookup. Мгновенный, бесплатно. Для простых вопросов, не для глубоких ресёрчей.

#### web_fetch
Прочитать конкретную страницу. Точная информация, одна страница за раз.