Metadata
Metadata tells CLEA what a page is supposed to be.
In the sitemap, metadata usually lives in the markdown file frontmatter. The most useful fields are simple: `title`, `description`, and `url`. These fields help the sitemap card show the page clearly. They also help Page Writer understand what it is editing.
Keep metadata plain
Write metadata like a person would read it.
The title should name the page. The description should explain the page in one short sentence. The URL should match the planned path on the website.
--- title: "AI visibility dashboard" description: "A page that explains how the dashboard shows prompts, mentions, and next actions." url: "/ai-visibility-dashboard" ---
Good metadata makes the page easier to inspect before the body is finished. It also reduces the chance that CLEA writes a page for the wrong topic.
Use metadata before writing
Do not wait until the page is finished.
Add metadata when the page is created. This gives the sitemap view a clean card right away. It also gives Page Writer a clear start point.
Metadata is page context
Title, description, URL, and schema fields help CLEA understand the page before writing or checking it.
What metadata cannot do
Metadata does not replace page copy.
It can tell CLEA the page goal, but the body still needs proof, examples, internal links, and review. If a page has only a title and description, treat it as a plan, not as finished content.