Brandedflow marketing-research

<!-- LOCKED — deterministic module v1 -->

install
source · Clone the upstream repo
git clone https://github.com/JenCW/brandedflow
manifest: business-os/sales/research/marketing-research/skill.md
source content
<!-- LOCKED — deterministic module v1 -->

Skill: Marketing research (initiation)

Purpose

First pass of Differentiation Research / initiation: how the market talks, where attention is paid, and which themes repeat — as deterministic JSON (stub stage: no live APIs).

Task

Produce one artifact:

  • File:
    clients/{client_id}/research/initiation/marketing-research.json

Output schema (deterministic)

FieldTypeRules
client_id
stringPath-safe, non-empty.
query
stringNon-empty scope / prompt.
module
stringLiteral
marketing-research
.
channels
object[]≥1; each
name
+
notes
non-empty strings.
audience_segments
object[]≥1; each
label
+
signals
non-empty strings.
themes
object[]≥1; each
theme
+
evidence
non-empty strings.
recommended_actions
string[]≥1 non-empty strings.

Execution flow

  1. Runner — validate input, build payload (deterministic from
    client_id
    +
    query
    ), eval → refine once if needed → write JSON.
  2. Eval — structural validation only.
  3. Refine — fill missing required fields (deterministic).

Rules

  • No external APIs in this module (stub only).
  • Same inputs → same JSON.
  • Outputs only under
    clients/{client_id}/research/initiation/
    .