onboard

name	onboard
description	Builds your entire canonical marketing brief in one guided pass (business, market, customer, competitors, positioning, offer, channels, voice, numbers) and saves it as marketing-brief.md so the whole department loads it into every future session automatically. Use once, first, when setting up.
argument-hint	[company + website, or 'use the notes in this repo']

Onboard — brief the department once

This is the one-command setup. A marketing department is only as good as its shared context, so before anyone writes a hook or sizes a market, the department gets briefed — once. This skill captures the business, market, customer, competitors, positioning, offer, channels, voice, and numbers into a single canonical marketing-brief.md, which the SessionStart hook then loads into every future session. One briefing, 50 specialists on the same page forever.

Inputs

• Company and website, plus any evidence available to paste: won-deal notes, customer quotes or reviews, call notes, competitor names, pricing, current channel numbers: $ARGUMENTS
• If little is provided, ask for the few highest-value inputs first (website, who buys and why in their words, the main competitors, the price) rather than blocking on everything.

Do this — build the brief section by section

Create marketing-brief.md in the project root from marketing-brief.example.md (in this plugin) and fill it in this order, carrying each section forward as context for the next:

1. The business — what is sold, to whom, at what price, delivered how, and the revenue goal marketing is accountable for. One tight paragraph.
2. The customer — ICP (firmographics, qualifiers, disqualifiers from real wins/losses), avatar sketch, top 5 pains and desired outcomes in the buyer's own words, known objections, and a starter language bank from any verbatim material pasted. This is the section copy gets written from — spend the most care here.
3. The competitors — the 3–5 alternatives buyers actually weigh (including "do nothing"), each with offer, claimed position, and exploitable weakness.
4. The market — a working TAM/SAM/SOM (bottom-up, assumptions graded T1 sourced / T2 estimate / T3 guess), the beachhead segment, and the category rules.
5. Positioning & message — the position sentence (for WHO, against ALTERNATIVE, the one DIFFERENCE, the PROOF), core message, three pillars with proof each, and the banned-phrases list.
6. The offer — outcome promised, value stack, price logic, risk reversal, real urgency.
7. Channels & funnel — the one primary channel and why, supporting channels, funnel stages with current numbers where known.
8. Voice — do/don't rules and 2–3 calibration examples if writing samples exist; otherwise mark the section as pending and suggest /marketing:brand-voice.
9. Numbers that matter — north-star metric, drivers, CAC targets, current baseline, all date-stamped.

Grade every section as you go: mark anything built on guesswork T3 so the research backlog is visible in the brief itself.

Output

A complete marketing-brief.md in the project root. Finish with a one-screen readback — the ICP in a line, the top 3 pains, the position sentence, the offer sentence — and ask what to sharpen. Tell the user it now loads automatically every session, and that /marketing:cmo is the next command to run.

Rules

• Evidence over invention at every step. Never fabricate customers, quotes, or metrics to make a section look finished — a thin section marked T3 is more valuable than a confident fiction.
• The buyer's words beat the company's words. Wherever the user pastes verbatim material, harvest it into the language bank.
• Confirm the ICP and the offer with the user before treating the brief as canonical — everything downstream leans on those two.
• If a section deserves deeper work, name the specialist for it (e.g. market sizing → the market-sizer agent, avatar depth → avatar-builder) rather than padding the brief now.