build-brief

Build Brief

Produce a production-ready creative brief from a concept — structured so a creative team can execute without follow-up questions. Uses the creative-strategist skill methodology and brief template standards.

Data accuracy: Every performance reference in the brief must cite a specific data point. If the brief references "top-performing hooks," cite which hooks and their metrics. Never include performance claims not grounded in tool data. If a data point is missing (e.g., no demographic data to inform targeting), flag it rather than guessing.

---

Phase 1: Get the Concept

1a. Parse Input

The $ARGUMENTS should contain one of:

• A concept description — freeform text describing what they want to make (e.g., "UGC problem-agitation ad targeting busy moms, hook about the 3pm energy crash")
• A reference to a concept from a previous /create-concepts run — the user might say "brief concept 2" or paste a concept title
• Empty — ask the user what to brief

If empty, use AskUserQuestion:

"What creative concept do you want to brief? You can describe the idea, paste a concept from /create-concepts, or tell me the audience/angle you want to target and I'll build the concept."

1b. Get Auth Context

Call get_auth_context() for workspaceId.

---

Phase 2: Gather Strategic Inputs (Parallel)

The SPEND call must come first (it returns goalMetric and spendThreshold). Then dispatch remaining calls in parallel.

1. get_creative_insights(workspaceId, "SPEND", datePreset="LAST_30_DAYS", limit=5, withAggregatedInsights=true) — spend leaders + account-level aggregates

→ Extract goalMetric and spendThreshold from the response. If goalMetric.isCustomConversion is true, find the matching conversion in the customConversions array and include ["{id}_cost", "{id}_count"] in tableKPIs on all subsequent calls. Use goalMetric for all efficiency-sorted calls.

1. get_workspace_brand(workspaceId) — brand positioning, voice, visual identity, tone constraints
2. get_glossary_values(workspaceId) — creative taxonomy for alignment
3. get_creative_insights(workspaceId, insightType=goalMetric, datePreset="LAST_30_DAYS", limit=5) — efficiency leaders by workspace goal metric for visual reference