Briefs and drafts

What is in a brief?

Everything a writer or developer needs to build the page without seeing the research: title, meta description, keywords, audience, the angle, an outline with notes, questions to answer, what to beat in each top result, internal links and a word count.

Last updated Oct 21, 2026, 12:00 AM

Every page the plan says to build or improve gets a brief, up to ten per run, in plan order. It sits inline on the page view under The brief, and downloads as Markdown from Download Brief.

The sections

  • Title and meta description. Ready to use, within the usual length limits.
  • Target keywords. The group's keywords the page should carry.
  • Audience. Who is searching and what situation they are in.
  • The angle. The one thing this page does that the current results do not. This is the brief's center; everything else serves it.
  • Outline. Headings at two levels, each with a note on what the section must contain and why.
  • Questions to answer. Taken from what people ask around the topic and from what the ranking pages leave open.
  • Must include. Facts and elements from the gap analysis that the page cannot skip.
  • Beat each competitor. For each competing top result, one line on how to be better than it.
  • Internal links. Pages on your site the new page should link to. For a planned site, the other planned pages.
  • Word count. A range appropriate to the page type.
  • Notes. Anything else the writer should know.

A map page's brief

A page written from the topical map gets everything above and more, because the map knows where the page sits:

  • Macro context. One sentence: what the whole page is about. Anything outside it belongs to another page.
  • Contextual vector. The angle as a chain from the representative context to the specific one.
  • Heading vector. The headings in order, the definition first, then the context, then the information. For each heading: the one question it answers, the answer format (a paragraph, a definition then a list, a table only where there is data, steps, a comparison), the direct answer that opens the section in about forty words, the entities it must name, and the units the question implies.
  • Anchors to place. The planned links with their exact anchor text, target and placement: main text, the closing section, or a list. Never in the first paragraph.
  • Images. The featured image and one per list or comparison, with a slug and alt text.
  • The closing section. What it covers and which pages of the map it links to.
  • Sources to cite. Authorities to name before statements.

See How do I write the pages of a map in batches?.

Grounding

Every element in the brief comes from the research: the gaps from the page reviews, the questions from the results, the links from the site's page inventory. A brief never asks for a fact the research did not find; where one is needed, it says so, and the draft takes it from your business's own facts or from a named public source, or asks you for it beside the draft. See Where do the numbers in a draft come from?.

Handing it over

Download the Markdown, or share the plan link so the writer can read the brief with the evidence beside it. See How do I export a brief?.

Was this helpful?

Still stuck?

Tell us what you were trying to do and which site or page it concerns. A person replies from help@legiit.com, usually within one business day.