Разведка

Модуль 01-intelligence собирает внешнюю разведку аккаунта в одно место: конкурентов, карту ниши, тренды, воронки конкурентов и подборку виральных постов из общей базы (viral-db). Это вход для /plan-week — стратегия и план не строятся без понимания контекста снаружи.

/intelligence-onboard

Wizard-онбординг нового аккаунта в разведку: собирает твои посты и посты конкурентов, разбирает что залетает, складывает всё в общую базу как сырьё для стратегии.

Когда использовать. Запускаешь один раз в начале работы с аккаунтом (или когда решил основательно обновить контекст ниши). Это первый шаг, который наполняет базу — без него /trend-watch и стратегия работать не с чем.

Как вызвать

/intelligence-onboard <slug> [--niche <ниша>] [--debug]

<slug> — идентификатор аккаунта. Во flat-движке (студенческая установка, один аккаунт на движок) slug не нужен, команда вызывается без аргумента.
--niche <ниша> — опционально, если ниша ещё не заполнена в identity.
--debug — подробная построчная индикация сбора по каждому хэндлу; без флага — короткая сводка на стадию.

Что на входе / на выходе

Читает: identity/ аккаунта (аккаунты в IG/TG, нишу — если не заполнено, спросит) и viral-db (глобальную базу).
Пишет: конкурентов и виральные рефы в viral-db, а также intelligence/competitor-funnels.md, intelligence/niche-research.md аккаунта. Дальше это читает стратегия (/plan-week, 04-strategy).

Пример

/intelligence-onboard max-tors --niche "ai контент"

Пройдёт по своим аккаунтам и нише из identity, спросит про конкурентов, соберёт топ-контент (свой + конкурентов), разберёт что заходит, спросит — добавлять ли найденные паттерны в голос — и в конце пришлёт ссылки на результат в админке.

Гейты/апрувы

Identity не заполнен → сначала задаст вопросы по недостающим темам, дальше не пойдёт.
После разбора твоего собственного контента спросит: добавить найденные winning-паттерны в identity/voice? Дефолт — нет.
Перед поиском новых конкурентов по ключевым словам (discover) — внутренний узел суждения релевантности кандидатов, непропускаемый.

Связанные: /plan-week, 00-setup, 04-strategy

/trend-watch

Ручной прогон по уже отслеживаемым аккаунтам: подтягивает новый контент, обновляет метрики, фиксирует новые темы и собирает датированный дайджест трендов.

Когда использовать. Периодически (руками, без расписания), когда хочешь освежить картину по конкурентам без полного повторного онбординга — узнать, что нового залетело и какие темы всплывают.

Как вызвать

/trend-watch <account_slug> [--handles <h1,h2,...>]

<account_slug> — идентификатор аккаунта.
--handles — опционально, ограничить прогон конкретными хэндлами. Без флага — прогон по всем отслеживаемым source-аккаунтам.

Что на входе / на выходе

Читает: список отслеживаемых аккаунтов и уже собранный контент в viral-db.
Пишет: новые карточки и обновлённые метрики в viral-db, новые темы (time-series) туда же, дайджест в intelligence/trends/<date>.md.

Пример

/trend-watch max-tors
/trend-watch max-tors --handles photozen_studio,brandcraft_co

Первый вызов пройдётся по всем отслеживаемым аккаунтам, второй — только по двум указанным.

Гейты/апрувы

Явных вопросов оператору команда не задаёт — прогон механический (обновление данных). Уже проанализированный контент повторно не разбирается.

Связанные: /intelligence-onboard, 05-planner

/add-viral

Добавляет ОДИН конкретный виральный пост (карусель или рилс) по shortcode или ссылке в общую базу как реф.

Когда использовать. Наткнулся на конкретный виральный пост в IG и хочешь: закинуть именно его в базу как референс, при желании подхватить весь аккаунт-владельца в отслеживание и/или сразу собрать по этому рефу свой контент. В отличие от /intelligence-onboard//trend-watch (которые работают по аккаунту), эта команда — про один конкретный пост.

Как вызвать

/add-viral <shortcode|instagram-url> [--type carousel|reel]

<shortcode|instagram-url> — голый код поста или ссылка вида .../p/<sc>/ / .../reel/<sc>/.
--type carousel|reel — опционально; без флага — автоопределение (видео → reel, стрелка «дальше» → carousel, иначе post).
Только Instagram (IG only).

Что на входе / на выходе

Читает: страницу поста в Instagram (через залогиненный браузер).
Пишет: карточку поста с метриками (лайки/комменты/просмотры, ER) в viral-db, разбор-файлы в viral-db/{carousels,reels}-parsed/<sc>/; опционально — карточки всего аккаунта-владельца в viral-db (если согласишься на шаге 3).

Пример

/add-viral DXqvNgdgAHr
/add-viral https://www.instagram.com/reel/DXqvNgdgAHr/
/add-viral DXqvNgdgAHr --type carousel

Команда пройдёт 4 шага: (1) добавит карточку с метриками, (2) разберёт пост (mini-глубина), (3) спросит — добавить ли аккаунт-владельца в отслеживание, (4) спросит — сделать ли контент по этому рефу прямо сейчас.

Гейты/апрувы

Шаг 3: «Добавить аккаунт @owner в базу (полный сбор топ-постов)?» — да/нет. Пропускается тихо, если владелец уже отслеживается или это твой собственный аккаунт.
Шаг 4: «Сделать контент по этому рефу сейчас?» — да/нет. При «да» роутит в /carousel или /reel (через /create-viral-carousel//create-viral-reel --ref <sc>).
Владельца поста не удалось разрешить (закрытый профиль/сессия) → честный блокер, карточка не пишется.

Связанные: 06-carousel, 08-reel, /trend-watch