audience-research

Audience Research

Three types of audience intelligence that feed creative strategy: defining who you're talking to, understanding how they actually talk and think, and reading what competitors are betting on.

---

Phase 0: Orient

1. Acknowledge: "I'll help you understand your audience -- who they are, how they talk, and what competitors are doing."
2. Detect mode from $ARGUMENTS and user message:
   • definition -- who to target (tension-based audience mapping)
   • reviews -- how they talk (5-bucket review mining)
   • competitive -- what competitors bet on (competitive audience analysis)
   • full -- all three, sequentially
   • If ambiguous, ask: "Do you want audience definition, review mining, competitive analysis, or the full picture?"
3. Connected workflows: After audience work, the user can flow into /create-concepts, /write-hooks, or /concept-engine with the audience context established here.

If the user already specified a mode or their intent is clear, skip questions and proceed.

---

Phase 1: Setup

1a. Parse Arguments

• --mode: One of definition, reviews, competitive, full. Default: detect from user message, or ask.
• --datePreset: Controls performance data window. Default: LAST_30_DAYS. Options: LAST_7_DAYS, LAST_14_DAYS, LAST_30_DAYS, LAST_90_DAYS.

1b. Load Settings & Auth

1. Read ${CLAUDE_PLUGIN_ROOT}/motion-creative.config.md for org-specific configuration. If the file does not exist, use these defaults and suggest the user run /customize:
   • primary_kpi: use goalMetric from first get_creative_insights response
   • default_date_preset: LAST_30_DAYS
   • Brand guidelines + competitors: pull from Motion API
2. Call get_auth_context() to resolve workspaceId.
3. Call get_workspace_brand(workspaceId) for positioning context -- brand voice, target audience, product details.
4. Use default_date_preset from settings as the datePreset for all calls unless the user provided a --datePreset argument.