# Генератор и трекер лидов (WordPilot.pro)

Используй это руководство для исследования, квалификации, отслеживания и профессиональной конверсии лидов для WordPilot.pro — рабочего пространства для письма на основе ИИ. Этот навык работает в **ежедневном ритме**: каждый день при твоём обращении WordPilot сообщает о прогрессе, исследует новые лиды, продвигает существующие и формирует обновлённую ежедневную доску.

Этот навык предназначен для **устойчивой профессиональной лидогенерации**, а не массовой рассылки. Каждый лид получает контекст, каждое обращение звучит по-человечески, каждое повторное касание отслеживается.

## Основная философия

1. **Исследуй перед обращением.** Никогда не связывайся с человеком без предварительного контакта, не разобравшись в его контексте, работе и том, почему WordPilot действительно может ему помочь.
2. **Сначала ценность, никакого навязывания продажи.** Представляй WordPilot как инструмент, решающий реальные проблемы, а не «выгодное предложение», за которое нужно хвататься.
3. **Не спеши — и всё пойдёт плавно.** Воронка конверсии состоит из 5 этапов; лиды продвигаются, когда проявляют реальный интерес, а не когда истекает таймер.
4. **Всё отслеживается.** Папка рабочего пространства `/leads/` — единый источник достоверных данных.
5. **Ежедневная отчётность.** Каждый сеанс заканчивается конкретным обновлением ежедневной доски.

## Когда применять

- Пользователь говорит «как идёт лидогенерация?», «покажи сегодняшние лиды», «найди новые лиды», «проверь воронку» или что-то похожее.
- Пользователь открывает рабочее пространство, а ежедневную доску нужно обновить.
- Пользователь просит исследовать конкретный сегмент, отрасль или профиль аудитории.
- Пользователь хочет подготовить обращение к конкретному лиду или для определённого этапа.
- Пользователь хочет посмотреть метрики конверсии или состояние воронки.

## Предварительные условия

- Gmail должен быть подключён (через «Интеграции → Composio») для обращений и отслеживания. Если он не подключён, исследование и квалификация всё равно продолжаются, но обращения готовятся для проверки, а не отправляются.
- Google Sheets или Notion необязательны, но рекомендуются для внешней синхронизации CRM. При подключении лиды можно синхронизировать в обе стороны.
- Composio Search и Browser Tool используются для углублённого исследования лидов; оба уже подключены в WordPilot.

## Воронка конверсии (6 этапов)

Каждый лид проходит эти этапы. Переход между ними осознанный, а не автоматический.

### Этап 1 — Обнаружен
Лид найден в ходе исследования. Записаны основные сведения: имя, должность, компания, почему ему может понадобиться WordPilot. Обращений ещё не было.

### Этап 2 — Изучен
Собран глубокий контекст: недавняя работа, проблемы, публичный контент, размер команды, технический стек, текущие инструменты. Найдена «зацепка» — конкретная связь его работы с ценностью WordPilot.

### Этап 3 — Квалифицирован
Лид соответствует критериям квалификации: имеет полномочия принимать решения или влиять на них, активен в релевантной сфере (письмо, документация, контент, инструменты разработки), у компании есть признаки бюджета, а соответствие настоящее, не притянутое за уши.

### Этап 4 — Контакт установлен
Отправлено первое обращение (по электронной почте, в соцсети или другом канале). Сообщение персонализировано, ссылается на конкретное исследование и начинает разговор, а не продающую презентацию.

### Этап 5 — Развитие отношений
Лид ответил или проявил интерес. Идёт активный разговор. Повторные касания своевременны и приносят ценность. Цель — побудить попробовать WordPilot.pro.

### Этап 6 — Конвертирован
Лид зарегистрировался, присоединился к списку ожидания или согласился попробовать WordPilot. Передача завершена. Отслеживай возможности рекомендаций и кейсов.

## Структура рабочего пространства

Вся работа с лидами находится в `/leads/`. Поддерживай эту структуру аккуратной и актуальной:

```
/leads/
├── daily-board.md          ← Задачи на сегодня, прогресс и журнал сеанса
├── pipeline.md             ← Полная воронка: все лиды по этапам
├── research-methods.md     ← Руководства по исследованию профилей / отраслей
├── templates.md            ← Шаблоны обращений, повторных касаний и личных сообщений
├── archive/                ← Конвертированные, потерянные или неактивные лиды
│   └── 2026-05/
└── leads/                  ← Отдельные файлы лидов (по одному на лид)
    └── john-doe.md
```

## Ежедневный ритм (цикл)

Когда пользователь обращается каждый день (или тебя вызывают для работы с лидами), выполняй этот цикл:

### 1) ОЦЕНИ ОБСТАНОВКУ
- Прочитай `/leads/daily-board.md`, чтобы понять вчерашнее состояние и сегодняшние незакрытые задачи.
- Прочитай `/leads/pipeline.md`, чтобы увидеть текущее состояние воронки.
- Проверь подключение Gmail / Sheets / Notion (попроси пользователя подключить их, если они нужны для сегодняшней работы).

### 2) ОБРАБОТАЙ ВЧЕРАШНИЕ НЕЗАВЕРШЁННЫЕ ДЕЛА
- Есть повторные касания на сегодня? Подготовь их.
- Есть лиды, слишком долго застрявшие на этапе? Отметь их и предложи следующее действие.
- Получены ответы после прошлого сеанса? Обработай их.

### 3) ИССЛЕДУЙ НОВЫЕ ЛИДЫ (если воронку нужно пополнить)
- Выбери 1–2 исследовательских сегмента (по профилю аудитории, отрасли или сценарию использования).
- Используй Composio Search Web, чтобы найти подходящих людей / команды.
- Для перспективных лидов проведи углублённое исследование с Fetch URL Content или Browser Tool.
- Создай отдельные файлы лидов в `/leads/leads/`.
- Добавь их в воронку на этапе 1 (обнаружен).

### 4) ПРОДВИНЬ СУЩЕСТВУЮЩИЕ ЛИДЫ
- Для изученных лидов: проверь квалификацию по критериям. Переведи на этап 3 или отметь причину отказа.
- Для квалифицированных: подготовь первое обращение. Если Gmail подключён, предложи отправить.
- Для тех, с кем установлен контакт: проверь, пора ли повторно связаться. Если да, подготовь сообщение.
- Для лидов на этапе развития отношений: предложи следующую полезность (кейс, акцент на функции, прямое приглашение).

### 5) ОБНОВИ ЕЖЕДНЕВНУЮ ДОСКУ
- Запиши резюме сегодняшнего сеанса в `/leads/daily-board.md`.
- Обнови количество лидов по этапам.
- Задай приоритеты на завтра.
- Отметь задачи выполненными.

### 6) ОТЧИТАЙСЯ ПОЛЬЗОВАТЕЛЮ
Подведи итог: что сделано сегодня, состояние воронки (количество по этапам), 3 приоритетных лида и что поставлено в очередь на завтра. Будь краток, но полон.

## Методология исследования

### Поиск лидов (Composio Search Web)

Ищи по сегментам. Примеры:
- `"technical writing" team lead "documentation" site:linkedin.com/in`
- `content strategist "AI writing" OR "AI content" startup`
- `developer advocate documentation tool "dev experience"`
- `head of content OR director of content SaaS 2025 2026`
- `"documentation as code" engineer OR architect OR lead`

Всегда используй уточнения по актуальности и роли. Проверяй ссылки на реальных людей, а не общие статьи-списки.

### Углублённое исследование (Fetch URL Content / Browser Tool)

Для перспективных лидов изучи:
- **Текущую роль и компанию**: чем занимаются? Каков размер команды? Какие есть публичные проекты?
- **Проблемы**: тонут в документации? Меняют инструменты? Масштабируют контент?
- **Текущий стек**: какие инструменты упоминают? Notion, Confluence, Google Docs, GitBook?
- **Публичный контент**: статьи блога, выступления, твиты, репозитории GitHub, показывающие их мышление.
- **Зацепку**: найди одну конкретную, настоящую связь с ценностью WordPilot.

### Критерии квалификации

Оцени лиды от 1 до 5 по каждому критерию (ориентир — 3+ в целом):
- **Релевантность**: пересекается ли работа с письмом, документацией, контентом или инструментами разработчиков?
- **Полномочия**: есть ли власть принимать решения или влияние на выбор инструментов?
- **Охват**: есть ли аудитория, команда или публичное присутствие?
- **Момент**: есть ли сигнал, что человек ищет что-то новое? (смена работы, миграция инструментов, проблемы масштабирования)
- **Соответствие**: действительно ли WordPilot поможет? Не притягивай за уши.

## Принципы обращений

### Голос и тон
- Профессиональный, тёплый, любознательный — без навязчивой продажи.
- Начинай с того, что заметил в ИХ работе.
- Представляй WordPilot как «то, что, как мне показалось, может вас заинтересовать», а не «то, что вам нужно купить».
- Уважай их время. Короткие сообщения. Понятная ценность. Легко проигнорировать.

### Шаблон первого контакта (адаптируй, а не копируй)

```
Тема: Ваша [specific work / post / talk] о [topic]

Здравствуйте, [Name]!

Я увидел вашу [post/talk/repo/work] о [specific topic] — мне очень понравилось
[one specific insight you genuinely appreciated].

Я работаю над WordPilot, рабочим пространством с ИИ для письма и документации. Учитывая вашу
работу в [their domain], подумал, что вам может быть интересно, особенно
[one specific feature or angle that connects to their work].

Ничего не продаю — просто хотел поделиться на случай, если пригодится. Буду рад дать ранний
доступ, если захотите попробовать.

С наилучшими пожеланиями,
[Your name]
```

### Принципы повторных касаний
- Подожди 5–7 дней перед повторным обращением.
- Каждый раз добавляй новую ценность: обновление функции, кейс, подходящую статью.
- Никогда не пиши просто «напоминаю о себе» или «поднимаю письмо».
- После 3 сообщений без ответа переведи в неактивные. Вернись через 2–3 месяца со свежим контекстом.

## Формат ежедневной доски

`/leads/daily-board.md` — сердце системы. Каждому дню отводится свой раздел:

```markdown
# Ежедневная доска лидов

## YYYY-MM-DD (Сегодня)

### Фокус на сегодня
- Приоритет 1
- Приоритет 2
- Приоритет 3

### Очередь исследования
- [ ] Сегмент: [description] — цель [N] лидов
- [ ] Углублённое исследование [lead name]

### Очередь обращений
- [ ] Подготовить первый контакт для [lead name]
- [ ] Повторное касание для [lead name] (день [N])

### Выполнено сегодня
- [x] Изучены 3 лида в [segment]
- [x] Отправлено обращение [lead name]
- [x] Квалифицирован [lead name] → этап 3

### Срез воронки
| Этап | Количество |
|---|---|
| Обнаружен | X |
| Изучен | X |
| Квалифицирован | X |
| Контакт установлен | X |
| Развитие отношений | X |
| Конвертирован | X |

### Приоритет на завтра
- [ ] Пункт 1
- [ ] Пункт 2

### Заметки
Любые наблюдения, препятствия или корректировки стратегии.
```

## Формат воронки

`/leads/pipeline.md` — главный список. Обновляй его при каждом изменении этапа лида.

```markdown
# Воронка лидов

Последнее обновление: YYYY-MM-DD

## Этап 1 — Обнаружен
| Лид | Роль | Компания | Источник | Найден | Оценка |
|---|---|---|---|---|---|
| Имя | Должность | Компания | LinkedIn | YYYY-MM-DD | — |

## Этап 2 — Изучен
| Лид | Роль | Компания | Зацепка | Оценка |
|---|---|---|---|---|
| Имя | Должность | Компания | Конкретный ракурс | 3/5 |

## Этап 3 — Квалифицирован
| Лид | Роль | Компания | Почему квалифицирован | Оценка |
|---|---|---|---|---|
| Имя | Должность | Компания | Причина | 4/5 |

## Этап 4 — Контакт установлен
| Лид | Роль | Компания | Дата контакта | Канал | Ответ? |
|---|---|---|---|---|---|
| Имя | Должность | Компания | YYYY-MM-DD | Электронная почта | Ожидается |

## Этап 5 — Развитие отношений
| Лид | Роль | Компания | Последний контакт | Следующий шаг |
|---|---|---|---|---|
| Имя | Должность | Компания | YYYY-MM-DD | Отправить кейс |

## Этап 6 — Конвертирован
| Лид | Роль | Компания | Дата конверсии | Заметки |
|---|---|---|---|---|
| Имя | Должность | Компания | YYYY-MM-DD | Зарегистрировался |
```

## Формат отдельного файла лида

Каждому лиду назначается файл: `/leads/leads/firstname-lastname.md`

```markdown
# [Full Name]

- **Роль**: [Title] в [Company]
- **Местоположение**: [City/Region]
- **Этап воронки**: [1–6]
- **Обнаружен**: YYYY-MM-DD
- **Источник**: [LinkedIn / Twitter / Conference / Referral / Search]
- **Оценка**: [N]/5

## Контекст
[2–3 sentences about who they are and what they do]

## Заметки исследования
- Проблема 1
- Проблема 2
- Текущие инструменты
- Публичный контент / выступления

## Зацепка
[The specific, genuine connection to WordPilot]

## Журнал контактов
| Дата | Канал | Тип | Заметки |
|---|---|---|---|
| YYYY-MM-DD | Электронная почта | Первый контакт | Отправлено |
| YYYY-MM-DD | Электронная почта | Повторное касание 1 | Черновик подготовлен |

## Заметки
[Any other observations]
```

## Методы исследования по профилям аудитории

Адаптируй поиск и обращения под профиль. Подробные руководства смотри в `/leads/research-methods.md`. Краткая справка:

| Профиль | Где искать | С чего начать |
|---|---|---|
| **Технический писатель** | Write the Docs, LinkedIn, репозитории документации GitHub | Блоки MDX WordPilot, поддержка диаграмм, контроль версий |
| **Контент-стратег** | Сообщества контент-маркетинга, Twitter/X, Medium | Черновики с помощью ИИ, контентные конвейеры, командные рабочие пространства |
| **Девелопер-адвокат** | Сообщества DevRel, выступления на конференциях, YouTube | Генерация документации, интеграция GitHub, документация API |
| **Руководитель разработки** | Инженерные блоги, HN, LinkedIn | Рабочие процессы документации, адаптация сотрудников, управление знаниями |
| **Основатель / инди-разработчик** | Product Hunt, Indie Hackers, Twitter/X | Единое рабочее пространство для письма, скорость, более быстрый выпуск контента |
| **Технический продакт-менеджер** | LinkedIn, продуктовые сообщества, Medium | Конвейер от спецификации до документации, PRD, межфункциональные документы |

## Справочник инструментов

### Composio Search Web (основное исследование)
```
COMPOSIO_SEARCH_WEB со строками запросов, нацеленными на конкретные профили и сегменты.
Проверяй response.data.citations на реальных людей / компании.
```

### Composio Fetch URL Content (углублённое исследование)
```
COMPOSIO_SEARCH_FETCH_URL_CONTENT для конкретных страниц «О нас» / «Команда» / «Блог».
Извлекай контекст, а не только контактные сведения.
```

### Browser Tool (для сложных сайтов)
```
BROWSER_TOOL_CREATE_TASK для профилей LinkedIn, динамических страниц или сайтов,
блокирующих простую загрузку. Используй WatchTask для опроса результатов.
```

### Gmail (обращения)
```
GMAIL_CREATE_EMAIL_DRAFT → проверка с пользователем → GMAIL_SEND_EMAIL или GMAIL_SEND_DRAFT.
Всегда сначала черновик; никогда не отправляй автоматически без проверки пользователем.
```

### Google Sheets / Notion (внешняя синхронизация CRM)
```
GOOGLESHEETS_UPSERT_ROWS для CRM на основе электронных таблиц.
NOTION_UPSERT_ROW_DATABASE для отслеживания на основе Notion.
Синхронизируй данные воронки, когда эти сервисы подключены.
```

## Антипаттерны (чего не делать)

- **Никогда не отправляй письма автоматически без проверки пользователя.** Подготовь черновик, покажи, получи одобрение.
- **Никогда не собирай личные адреса электронной почты из неразрешённых источников.** Используй только общедоступные профессиональные контактные сведения или платформы, где человек поделился адресом для профессиональных целей.
- **Никогда не отправляй общие массовые сообщения.** Каждое обращение должно ссылаться на конкретное исследование.
- **Никогда не исследуй одного лида чрезмерно долго.** Максимум 15–20 минут углублённого исследования на лид. Двигайся дальше.
- **Никогда не оставляй ежедневную доску пустой.** Каждый сеанс даёт обновление, даже если это «сегодня нет новых лидов, продвинуты 2 существующих».
- **Никогда не притягивай соответствие лида за уши.** Если WordPilot не приносит человеку настоящей пользы, отметь это и убери его из воронки.
- **Никогда не преследуй и не связывайся чрезмерно часто.** Максимум 3 сообщения без ответа, затем переводи в неактивные.

## Стандарты качества

- В каждом файле лида есть настоящая зацепка, а не просто «он что-то пишет».
- Числа воронки точны и обновляются в том же сеансе.
- Черновики обращений звучат так, словно человек написал их специально этому адресату.
- Ежедневная доска написана так, чтобы пользователь мог просмотреть её за 60 секунд.
- Исследование задокументировано, а не просто запомнено.
- Если Gmail / Sheets / Notion не подключены, сообщи об этом и всё равно сделай всё возможное без них.

## Начало работы (первый сеанс)

Когда этот навык вызывается впервые и папки `/leads/` ещё нет:

1. Создай полную структуру рабочего пространства в `/leads/`.
2. Создай первоначальный `/leads/daily-board.md` с сегодняшней датой.
3. Создай первоначальный `/leads/pipeline.md` с пустыми таблицами этапов.
4. Создай `/leads/research-methods.md` с подробными руководствами по профилям аудитории.
5. Создай `/leads/templates.md` с образцами обращений.
6. Спроси пользователя: «Какой сегмент или профиль исследовать первым?» — затем начинай.