Marketing Engineer

Скилл строит систему, в которой агенты делают маркетинговую работу на общих знаниях о бизнесе: исследуют рынок, готовят брифы, производят материалы и учатся на результатах. Ты проводишь человека через шесть фаз и на выходе оставляешь рабочее пространство, с которым можно сразу запустить первую задачу.

Три принципа, из которых растут все остальные правила:

1. Начинаем с одной вертикали и одной реальной задачи. Не строим все направления сразу. Лучше одна работающая цепочка, чем пять пустых папок.
2. Агентам нужен один и тот же контекст. Аудитория, оффер, позиционирование, прошлые результаты лежат один раз в общих знаниях, а не копируются по промптам.
3. Факт отделён от предположения. У каждой находки есть источник, дата и метка.

Жёсткие правила

Действуют во всех фазах, без исключений.

• Ничего не публиковать и не отправлять. Не запускать рекламу, не менять бюджеты, не слать письма. Скилл создаёт файлы и черновики, всё необратимое делает человек.
• Ключи API не попадают в файлы и чат. Не проси ключ в переписке. Создавай .env.example с именами переменных; .env заполняет человек, файл в .gitignore.
• У каждой находки источник, дата и метка. [факт] — есть проверяемый источник; [проверить] — источник есть, но сомнительный: один отзыв, старая дата, реклама; [предположение] — источника нет: вывод, мнение владельца, догадка. Открытые вопросы к человеку — не находки: их место в _setup/interview.md и в разделах «Чего мы пока не знаем».
• Не выдумывать цифры, отзывы и цитаты. Нет данных — так и пиши.
• Не перезаписывать существующие файлы. Дополняй или клади рядом *.draft.md. scripts/scaffold.py пропускает то, что уже есть. Файлы, которые создал скрипт, заполняй правкой, а не записью нового файла поверх.
• Факты ищешь сам, решения принимает человек. Не спрашивай то, что можно узнать на сайте компании или в открытых источниках. Спрашивай то, что знает только владелец: цели, ограничения, что уже пробовали, что можно обещать.

Определи режим

Проверь файловую систему, не спрашивай без нужды:

Корень по умолчанию — marketing/ в текущей папке проекта. Если человек указал другой путь, используй его во всех командах вместо marketing/.

Прогресс

Скопируй чеклист в ответ и отмечай по ходу:

- [ ] Фаза 1. Интервью — ответы в _setup/interview.md
- [ ] Фаза 2. Исследование — находки в _setup/research/
- [ ] Фаза 3. Данные — инвентарь в _setup/data-inventory.md
- [ ] Фаза 4. Анализ — _setup/analysis.md + решения человека
- [ ] Фаза 5. Структура и файлы — scaffold.py + заполненные шаблоны
- [ ] Фаза 6. Проверка — check_workspace.py без ошибок + отчёт

Сначала создай каркас, чтобы было куда сохранять ответы и находки. Первый вызов создаёт корень, AGENTS.md, общие знания, data/, ops/ и _setup/ — пока в виде шаблонов с полями {{...}}. Вертикаль и кампанию добавишь в фазе 5.

python scripts/scaffold.py --root marketing --setup-only

Фаза 1. Интервью

Прочитай references/interview.md — там дерево вопросов и формат раундов.

Как вести:

• Раундами. В раунд попадают только вопросы, на которые можно ответить прямо сейчас, не зная ответов на ещё открытые.
• К каждому вопросу — рекомендуемый ответ или варианты. Человеку проще поправить, чем писать с нуля.
• Сначала посмотри сайт, если он назван: оффер, цены, FAQ. Потом спрашивай только то, чего там нет.
• Не больше 7 вопросов в раунде. Больше человек не читает.
• Голосовые и длинные тексты — это хорошо. Если человек надиктовал поток мыслей, разбери его на ответы и уточни пробелы.

Минимум, без которого нельзя идти дальше:

1. Компания и сайт.
2. Продукт и оффер — что продаём, по какой цене, чем отличаемся.
3. Кто клиент и что он пытается решить.
4. Первая задача или кампания, у которой есть срок и тот, кто будет пользоваться результатом.
5. Стартовая вертикаль (одна).
6. Какие данные доступны: реклама, аналитика, CRM, выгрузки.
7. Что требует одобрения человека перед действием.

Сохраняй ответы в marketing/_setup/interview.md по ходу, а не в конце. Интервью окончено, когда минимум закрыт и открытых решений первого уровня нет. Подтверди у человека: «Картина такая: … Всё верно?»

Фаза 2. Исследование

Прочитай references/research.md — источники, формат находки и маркировка.

1. Составь план в _setup/research-log.md: какие вопросы закрываем, какими источниками, что считаем релевантным. Критерии отбора берутся из интервью.
2. Исследуй четыре области:
   • сайт компании и её собственные материалы;
   • 3–5 конкурентов: оффер, цены, обещания, посадочные страницы, заметные кампании;
   • открытые обсуждения: отзывы на картах и площадках, форумы, Telegram и VK, комментарии — какие вопросы задают, на что жалуются, какими словами;
   • спрос: поисковые запросы и темы, если есть доступ к инструментам.
3. Параллель. Если среда умеет запускать субагентов, отдай конкурентов и обсуждения разным субагентам: у каждого свой контекст, общий формат находки.
4. Сохраняй находки в _setup/research/<тема>.md по формату из справочника. В этих файлах каждый заголовок ### — это находка с источником, датой и меткой; проверка требует этого от всех ###. Отброшенное и служебные заметки веди в _setup/research-log.md.
5. Если установлен скилл свежих обсуждений (например, /last30days), используй его для раздела про обсуждения и отметь это в журнале.

Не пиши выводы на этой фазе. Здесь только собранные данные.

Фаза 3. Сбор данных

Прочитай references/data-sources.md.

1. Составь инвентарь в _setup/data-inventory.md: какие источники есть, как к ним попасть (выгрузка, API, нет доступа), насколько свежие, чем связываются записи — ID кампаний, UTM-метки, поле источника в CRM.

2. Выгрузки. Если человек дал CSV из рекламного кабинета, аналитики или CRM, положи их в marketing/data/raw/ и загрузи в локальное хранилище:

   python scripts/load_csv.py "marketing/data/raw/*.csv" --db marketing/data/warehouse.sqlite

   Скрипт сам определяет разделитель и кодировку (в том числе cp1251), пишет манифест и показывает профиль: строки, колонки, диапазон дат, есть ли UTM. XLSX попроси пересохранить в CSV.

3. API. Не подключай сам. Опиши в инвентаре, какой доступ нужен и зачем, добавь имена переменных в .env.example. Разделяй права: чтение данных, создание черновика и публикация — разные уровни доступа.
4. Отметь дыры: нет UTM, CRM не связана с рекламой, данные старше месяца. Дыра — не повод придумывать атрибуцию, а пункт в списке для человека.

Фаза 4. Анализ

Прочитай references/analysis.md. Результат — _setup/analysis.md:

• Аудитория: задачи, боли, возражения, слова клиентов — с ссылками на находки.
• Карта конкурентов: таблица оффер / цена / главное обещание / слабое место.
• Пробелы и возможности: что никто не говорит, какие вопросы остаются без ответа.
• Качество данных: чему можно доверять, чему нет и почему.
• Гипотезы для первой задачи: 3 направления. Для каждого — для кого, на чём основано, чем отличается от того, что уже пробовали, какие допущения.
• Вопросы к человеку: решения, которые нельзя принять за него.

Точка проверки. Покажи человеку короткую выжимку и вопросы. Не переходи к фазе 5, пока он не подтвердил или не поправил направление. Каждое решение с причиной запиши в shared-knowledge/decisions.md.

Фаза 5. Структура и файлы

Добавь к каркасу стартовую вертикаль и кампанию:

python scripts/scaffold.py --root marketing --verticals content --campaign <slug>

• --verticals — стартовая вертикаль из интервью: content, seo-aeo, paid-and-creative, lifecycle-and-cro, outbound или своя латиницей.
• --campaign — латинский слаг первой кампании или задачи; можно не указывать.
• Добавь --dry-run, чтобы сначала посмотреть, что будет создано.

Скрипт кладёт шаблоны с полями {{...}}. Заполни их из интервью, находок и анализа. Что куда — в references/workspace-map.md. Главное:

Правила заполнения:

• Короткие файлы. Агент читает их перед каждой задачей. Детали — в отдельных файлах со ссылками.
• Одобренное отдельно от идей. В approved-claims.md и positioning.md только подтверждённое человеком. Идеи — в анализе с меткой.
• Поле не заполнилось — оставь {{...}}. Проверка покажет, что нужно от человека.
• Workflow описывает шаги, входы, выходы, проверки и точки одобрения, а не «сделай хорошо».

Фаза 6. Проверка и передача

python scripts/check_workspace.py marketing

Скрипт проверяет обязательные файлы, незаполненные поля {{...}}, похожие на ключи строки, находки без источника или даты и битые ссылки между файлами. Ошибки исправь сам. Предупреждения о незаполненных полях — это список вопросов к человеку.

Финальный отчёт человеку:

1. Дерево созданного — два уровня вглубь.
2. Что заполнено, а что ждёт его ответа — списком из проверки.
3. Решения, которые ещё не приняты, — не больше трёх самых важных.
4. Первая цель для запуска — из ops/goal-prompts.md.
5. Как улучшать: запустить workflow на реальной задаче, отмечать, где пришлось вмешаться, и чинить причину по таблице из references/loops-and-tickets.md.

Когда остановиться и спросить

• Нет оффера или он не согласован — бриф и материалы на нём строить нельзя.
• Результаты исследования противоречат словам человека — покажи обе стороны.
• Нужен доступ, которого нет, или ключ — опиши, не проси прислать.
• Одна и та же проверка падает повторно — назови причину, не крути цикл дальше.
• Действие необратимое или внешнее — только с явного подтверждения.

Справочники

• references/interview.md — дерево вопросов и формат раундов
• references/research.md — источники, формат находки, маркировка
• references/data-sources.md — источники данных, связка записей, доступы
• references/analysis.md — как анализировать и что выносить на решение
• references/workspace-map.md — структура пространства и назначение файлов
• references/loops-and-tickets.md — workflow, тикеты, цели, циклы проверки
• references/workflows-catalog.md — примеры workflow для следующих шагов