MSP-1 Specification

section

The section term defines the structural and semantic subdivisions of a page. Sections represent the smallest meaningful content units that can possess their own metadata, enabling precise AI interpretation, improved navigation, and fine-grained intent mapping.

Category: Content structure, intent & addressing

Status: Normative

Version: MSP-1.0.x

1. Purpose

MSP-1 uses sections to break complex pages into meaningful, interpretable units. This helps AI agents:

  • Understand the internal structure of a page.
  • Assign intent, description, and metadata at a more granular level.
  • Anchor interpretations to specific subsections rather than the entire page.
  • Navigate content more efficiently for instruction following or summarization.

Sections enable precise semantic targeting—critical for AEO/AIO optimization.

2. Normative definition

A section is a content unit within a page that has a stable identity and may include its own metadata fields. A section MUST:

  • Belong to exactly one page (via the parent term).
  • Have a unique section-level id.
  • Represent a semantically coherent block of content.
  • Be addressable — either via anchor or structural identification.

Sections are not standalone pages unless explicitly promoted to page-level status.

3. Required fields

  • id — stable identifier for the section.

Recommended metadata fields include:

  • name — title of the section.
  • description — summary of content within the section.
  • intent — purpose behind the section.
  • interpretiveFrame — local context or assumptions.
  • parent — ID of the page containing the section.
  • order — optional numeric order for rendering and navigation.

Sections MAY contain nested subsections if the hierarchy remains unambiguous.

4. AI interpretation rules

  • AI agents MUST treat sections as semantically distinct units.
  • Section-level metadata SHOULD override page-level metadata when more specific.
  • AI SHOULD use section ids to target answers to precise content areas.
  • Missing section metadata SHOULD trigger fallback to page-level context.
  • Conflicting metadata across sections MUST be treated as structural anomalies.

Sections provide fine-grained interpretive fidelity, especially for long-form content.

5. Relationship to related MSP-1 terms

  • page — the parent container for all sections.
  • parent — links sections to their page.
  • name / description / intent — define the semantics of each section.
  • interpretiveFrame — contextualizes how the section should be understood.
  • id — uniquely identifies each section.

6. Examples

Minimal section declaration:

{
  "section": {
    "id": "introduction"
  }
}

Section with expanded metadata:

{
  "section": {
    "id": "lighting-basics",
    "name": "Lighting Basics",
    "description": "Introduction to natural and artificial lighting principles.",
    "intent": "Provide foundational understanding for new photographers.",
    "parent": { "id": "lighting-guide" },
    "order": 1
  }
}

Nested subsections example:

{
  "sections": [
    {
      "id": "studio-lighting",
      "name": "Studio Lighting",
      "parent": { "id": "lighting-guide" }
    },
    {
      "id": "studio-modifiers",
      "name": "Lighting Modifiers",
      "parent": { "id": "studio-lighting" }
    }
  ]
}

7. Conformance

A resource conforms to the MSP-1 section specification when:

  • Each section includes a stable, unique identifier.
  • Sections clearly belong to a single page.
  • Section metadata is coherent and non-conflicting.
  • The structure maintains clear semantic boundaries.
  • All normative rules for section semantics are followed.