| name | mb-skill-brief-draft |
| tier | skill |
| calls | [] |
| description | Compose a site brief from offer.md + audience.md + voice.md + research files + the operator's dial / archetype picks. Used by /mb-site as the brief-drafting step. Loadable independently for /mb-ads, /mb-organic, or sales-video workflows if they want to share the same brief shape. |
| loops | ["sense","ship"] |
skill-brief-draft
A composable skill for drafting a site / campaign brief. /mb-site calls this in Step 2 of the minisite flow. /mb-ads, /mb-organic, or sales-video workflows may call it later; for now it is only used by /mb-site.
Inputs
offer.md, audience.md, voice.md (resolved via mb resolve)research/*.md produced earlier in the flow- Operator picks:
dial, archetype (optional), audience_current_archetype (optional)
- Picked headline formulas (2-3 from
references/headline-formulas.md)
Outputs
A single markdown artifact: decisions/YYYY-MM-DD-minisite-brief-<slug>.md with the v0.1 schema:
---
type: brief
date: YYYY-MM-DD
slug: <offer-slug>
status: proposed
dial: convert | story | brand
conversion_mechanism: lead_form | book_call | purchase | other
takes_calls: true | false
archetype: ...
audience_current_archetype: ...
copy_framework_tag: ...
headline_formulas_picked: [...]
do_not_state: [...]
four_forces: {push, pull, habit, anxiety}
voice_anchor_lines: {use: [...], avoid: [...]}
---
conversion_mechanism and takes_calls are operator-stated facts, not guesses — see the gate in Flow step 0.
Plus the body sections: headline + subhead, value prop, mechanism summary, picked supporting pages, conversion endpoint, adjacency map.
Flow
- Conversion-mechanism gate (before any copy). Pin what the visitor does
to convert — submit a lead form, book a call, buy — and specifically whether
the operator takes calls. This is an operator-stated fact: if it is not
already recorded (in
offer.md, a prior decision, or the operator's own
words this session), STOP and ask before drafting. Never assume a model —
the headline, value prop, and mechanism summary are all shaped by it, so a
wrong guess rewrites the whole brief. A real business we built lost a full
day when an agent invented a call-booking flow the operator never chose.
Record the answer in conversion_mechanism + takes_calls.
- Read inputs. Resolve offer/audience/voice; load picked archetype detail file.
- Compose schema header. Fill in fields from operator picks, including the
gated
conversion_mechanism + takes_calls.
- Draft headline + subhead. Apply one of the picked formulas. Aim for ≤ 2 lines.
- Draft value prop. 3 short reasons OR one extended argument. Match the dial.
- Draft mechanism summary. For the how-it-works page.
- Pick supporting pages. 2-4 from proof / pricing / faq / about.
- Build adjacency map. Per Hughes paired-imagery rule, name two images per section.
- Hand off to skill-review with the dial.
Cross-references
