{ "schemaVersion": "rankops-source-mapped-content-brief/v1", "version": "1.0.0", "title": "Source-mapped SEO content brief builder", "language": "en", "correctionPath": "/editorial-policy", "fields": [ { "id": "page_topic", "group": "Reader and intent", "label": "Page topic", "inputKind": "text", "required": true, "description": "The single subject this page will explain or help a reader complete.", "placeholder": "Example: Editorial corrections policy", "owner": "Editor", "sourceClass": "rankops_editorial_design", "sourceIds": [], "sourceLocator": "RankOps design choice: one planning object needs one bounded topic.", "validationMethod": "One concrete topic; no bundled keyword list.", "limitation": "A topic does not prove demand or ranking potential." }, { "id": "primary_reader", "group": "Reader and intent", "label": "Primary reader", "inputKind": "text", "required": true, "description": "The specific person who should find the page useful.", "placeholder": "Example: Managing editor at a small publication", "owner": "Editor", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "Who the content is for; intended audience self-assessment.", "validationMethod": "Names one reader role and relevant context.", "limitation": "This is a planning hypothesis until validated with real users." }, { "id": "reader_task", "group": "Reader and intent", "label": "Reader task", "inputKind": "textarea", "required": true, "description": "What the reader needs to understand, decide, or do after using the page.", "placeholder": "Describe the decision or action in the reader’s words.", "owner": "Editor", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "People-first purpose and whether readers leave with a satisfying result.", "validationMethod": "Starts with an observable reader action or decision.", "limitation": "A stated task does not guarantee the page will satisfy it." }, { "id": "page_goal", "group": "Reader and intent", "label": "Page goal", "inputKind": "textarea", "required": true, "description": "The useful outcome the page should produce for the reader and publisher.", "placeholder": "State the result without a ranking or traffic promise.", "owner": "Content strategist", "sourceClass": "rankops_editorial_design", "sourceIds": [], "sourceLocator": "RankOps design choice: separate the page outcome from the search query.", "validationMethod": "Defines one reader outcome and one editorial outcome.", "limitation": "The brief cannot forecast business or search performance." }, { "id": "search_intent", "group": "Reader and intent", "label": "Search intent hypothesis", "inputKind": "text", "required": true, "description": "The likely reason someone would search for this page.", "placeholder": "Example: Learn how to publish a correction policy", "owner": "SEO editor", "sourceClass": "rankops_editorial_design", "sourceIds": [], "sourceLocator": "RankOps design choice: intent is recorded as an editorial hypothesis.", "validationMethod": "Uses plain language and matches the reader task.", "limitation": "No live SERP analysis is performed or implied." }, { "id": "primary_query", "group": "Reader and intent", "label": "Primary query", "inputKind": "text", "required": false, "description": "One working query used to keep naming and scope consistent.", "placeholder": "Example: editorial corrections policy", "owner": "SEO editor", "sourceClass": "rankops_editorial_design", "sourceIds": [], "sourceLocator": "RankOps design choice: a working query is not an official requirement.", "validationMethod": "Contains one query, not volume, KD, or competitor claims.", "limitation": "The builder does not verify metrics, relevance, or competitiveness." }, { "id": "scope_boundary", "group": "Evidence plan", "label": "Scope boundary", "inputKind": "textarea", "required": true, "description": "What the page covers, excludes, and cannot conclude.", "placeholder": "List the included decisions and explicit exclusions.", "owner": "Editor", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "Clear purpose, sufficient value, and avoiding unsupported expertise.", "validationMethod": "States at least one inclusion and one exclusion.", "limitation": "Boundaries still require editorial and subject-matter review." }, { "id": "key_claims", "group": "Evidence plan", "label": "Claims to support", "inputKind": "textarea", "required": true, "description": "The material claims that need evidence before publication.", "placeholder": "One claim per line; do not write a citation you have not checked.", "owner": "Writer", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "Clear sourcing, expertise, accuracy, and trust self-assessment.", "validationMethod": "Each line is a checkable claim, not a vague theme.", "limitation": "The builder does not fact-check or approve any claim." }, { "id": "source_plan", "group": "Evidence plan", "label": "Admissible source plan", "inputKind": "textarea", "required": true, "description": "Which source classes may support the claims and why they are suitable.", "placeholder": "Example: Current regulator guidance for policy requirements", "owner": "Researcher", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "Sourcing and evidence of expertise or first-hand knowledge.", "validationMethod": "Names source classes, selection reasons, and recency needs.", "limitation": "A planned source is not a verified or accepted citation." }, { "id": "original_contribution", "group": "Evidence plan", "label": "Original contribution", "inputKind": "textarea", "required": true, "description": "The analysis, method, example, or synthesis this page adds.", "placeholder": "Describe what is created here rather than summarized elsewhere.", "owner": "Writer", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "Original information, reporting, research, analysis, or added value.", "validationMethod": "Names a concrete contribution the team can produce.", "limitation": "Originality must be reviewed against the finished page." }, { "id": "first_hand_value", "group": "Evidence plan", "label": "First-hand value", "inputKind": "textarea", "required": false, "description": "Relevant experience, observations, or method evidence available to the team.", "placeholder": "Use “not applicable” when first-hand experience is not needed.", "owner": "Subject owner", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "First-hand expertise and the Who, How, and Why disclosure prompts.", "validationMethod": "Identifies real access or says why it is not applicable.", "limitation": "Do not invent experience, credentials, tests, or observations." }, { "id": "author_review_owner", "group": "Evidence plan", "label": "Author and review owner", "inputKind": "text", "required": true, "description": "Who drafts the page and who is accountable for evidence review.", "placeholder": "Example: Staff editor; policy review by publication lead", "owner": "Managing editor", "sourceClass": "official_source_mapped", "sourceIds": [ "google-helpful-content" ], "sourceLocator": "Who created the content and whether authorship is clear where expected.", "validationMethod": "Names accountable roles without fictional credentials.", "limitation": "A named role does not establish expertise by itself." }, { "id": "citation_plan", "group": "Publication checks", "label": "Citation plan", "inputKind": "textarea", "required": true, "description": "Where checked sources should appear beside the claims they support.", "placeholder": "Map each planned claim to a source owner and citation location.", "owner": "Researcher", "sourceClass": "rankops_editorial_design", "sourceIds": [], "sourceLocator": "RankOps design choice: claim-to-source adjacency is recorded explicitly.", "validationMethod": "Every material claim has a source owner or unresolved marker.", "limitation": "This plan does not create, validate, or certify citations." }, { "id": "structure_notes", "group": "Publication checks", "label": "Structure notes", "inputKind": "textarea", "required": true, "description": "A flexible reading order for answering the task without forcing a full outline.", "placeholder": "List the decisions the page must answer in reader order.", "owner": "Editor", "sourceClass": "rankops_editorial_design", "sourceIds": [], "sourceLocator": "RankOps design choice: the brief stays distinct from a rigid outline.", "validationMethod": "Sections follow the reader task and avoid duplicate jobs.", "limitation": "The writer may change structure when evidence requires it." }, { "id": "title_meta_plan", "group": "Publication checks", "label": "Title and snippet plan", "inputKind": "textarea", "required": true, "description": "A descriptive page title and summary aligned with visible content.", "placeholder": "Draft a descriptive title and a factual summary.", "owner": "SEO editor", "sourceClass": "official_source_mapped", "sourceIds": [ "google-developer-guide" ], "sourceLocator": "Descriptive titles, metadata, and words visible on the page.", "validationMethod": "Title and summary describe the page without unsupported outcomes.", "limitation": "Search engines may display different titles or snippets." }, { "id": "internal_link_plan", "group": "Publication checks", "label": "Internal link plan", "inputKind": "textarea", "required": false, "description": "Useful crawlable links into and out of the planned page.", "placeholder": "List source pages, destination pages, and descriptive anchor intent.", "owner": "Publisher", "sourceClass": "official_source_mapped", "sourceIds": [ "google-developer-guide", "bing-webmaster-guidelines" ], "sourceLocator": "Crawlable links and discoverability guidance.", "validationMethod": "Uses real destinations and descriptive link purposes.", "limitation": "The builder does not crawl the site or verify URLs." }, { "id": "technical_publish_checks", "group": "Publication checks", "label": "Technical publishing checks", "inputKind": "textarea", "required": true, "description": "The page-level checks needed before a publisher makes the URL public.", "placeholder": "Include visible text, crawlable links, canonical intent, and index controls.", "owner": "Publisher", "sourceClass": "official_source_mapped", "sourceIds": [ "google-search-essentials", "google-developer-guide", "bing-webmaster-guidelines" ], "sourceLocator": "Technical requirements, visible content, crawlability, links, and index controls.", "validationMethod": "Checklist has an owner and a verifiable pass condition.", "limitation": "Passing checks cannot guarantee crawling, indexing, or ranking." }, { "id": "limitations_corrections", "group": "Publication checks", "label": "Limitations and corrections", "inputKind": "textarea", "required": true, "description": "Limits readers should know and a route for reporting material errors.", "placeholder": "State what the page cannot establish and how to report a correction.", "owner": "Managing editor", "sourceClass": "rankops_editorial_design", "sourceIds": [], "sourceLocator": "RankOps design choice: limitations and correction ownership stay in the handoff.", "validationMethod": "Names at least one limit and one correction route.", "limitation": "A corrections route does not guarantee factual or legal completeness." } ], "sources": [ { "id": "google-search-essentials", "title": "Google Search Essentials", "publisher": "Google Search Central", "url": "https://developers.google.com/search/docs/essentials", "locator": "Technical requirements, spam policies, and key best practices", "accessedAt": "2026-08-03" }, { "id": "google-helpful-content", "title": "Creating helpful, reliable, people-first content", "publisher": "Google Search Central", "url": "https://developers.google.com/search/docs/fundamentals/creating-helpful-content", "locator": "Self-assessment questions and the Who, How, and Why sections", "accessedAt": "2026-08-03" }, { "id": "google-developer-guide", "title": "SEO Starter Guide for developers", "publisher": "Google Search Central", "url": "https://developers.google.com/search/docs/fundamentals/get-started-developers", "locator": "Links, sitemaps, titles, metadata, visible text, and index controls", "accessedAt": "2026-08-03" }, { "id": "bing-webmaster-guidelines", "title": "Bing Webmaster Guidelines", "publisher": "Microsoft Bing", "url": "https://www.bing.com/webmasters/help/webmaster-guidelines-30fba23a", "locator": "Content, links, crawlability, and abuse guidance", "accessedAt": "2026-08-03" } ], "limitations": [ "This planning tool does not predict rankings, traffic, crawling, or indexing.", "It does not run live keyword research, SERP analysis, competitor analysis, or source verification.", "It does not fact-check user entries or establish legal, editorial, or search-engine compliance.", "Official-source mapping explains why a field is present; it is not Google or Bing approval.", "Editors remain responsible for sources, claims, authorship, publishing decisions, and corrections." ], "evidenceLedger": { "claimId": "claim-brief-fields-need-source-and-validation-map", "evidenceObjectId": "evidence-source-mapped-seo-content-brief-builder", "method": "Generate the worksheet, source map, example, CSV, JSON, and limitations from one versioned 18-field schema.", "scope": "The public v1 builder and its stable downloadable artifacts only.", "version": "1.0.0", "validationStatus": "validated" } }