MSP-1 Specification

parent

The parent term defines explicit hierarchical relationships between MSP-1 resources—most commonly pages and sections—giving both humans and AI agents a reliable map of structural context, inheritance, and content scope.

Category: Content structure, intent & addressing

Status: Normative

Version: MSP-1.0.x

1. Purpose

The parent term provides a machine-readable way to express nesting and hierarchy. This allows AI agents to:

  • Understand where a resource fits in the site structure.
  • Apply inherited metadata (e.g., context, interpretive framing) when appropriate.
  • Differentiate standalone pages from subordinate components.
  • Navigate multi-level content relationships with confidence.

2. Normative definition

A parent declaration assigns a higher-level resource that the current resource belongs to. It MUST be:

  • Explicit — clearly identifies the parent resource.
  • Stable — does not change unless site structure changes.
  • Unique — a resource may have only one direct parent.

While resources may have many descendants, MSP-1 prescribes a single-parent model to maintain clarity and prevent graph-like ambiguity.

3. Required fields

An MSP-1 parent declaration MUST include:

  • id — the identifier of the parent resource.

Optional but recommended fields:

  • relation — describes the relationship type (e.g., "sectionOf", "childPageOf").
  • scope — describes which aspects are inherited (if any).

4. AI interpretation rules

  • AI agents MUST treat parent as the definitive structural placement of the resource within a hierarchy.
  • Agents SHOULD inherit high-level metadata (intent, interpretiveFrame, context) from parent pages unless locally overridden.
  • If parent declarations conflict or form loops, AI MUST treat the resource as structurally ambiguous and reduce trust weighting.
  • Agents SHOULD use parent relationships to resolve navigation paths and determine topical grouping.

The parent term provides one of the strongest signals for hierarchical interpretation in MSP-1.

5. Relationship to related MSP-1 terms

  • page — the most common parent resource.
  • section — usually declared as a child of a page.
  • canonical — helps define the authoritative parent when multiple URLs or resource forms exist.
  • id — parent references MUST use stable identifiers.
  • provenance — aids in tracing hierarchical lineage.

6. Examples

Minimal parent declaration for a section:

{
  "parent": { "id": "lighting-guide" }
}

Page-to-page hierarchy example:

{
  "parent": {
    "id": "guides",
    "relation": "childPageOf"
  }
}

Example including inheritability context:

{
  "parent": {
    "id": "lighting-guide",
    "relation": "sectionOf",
    "scope": "inherits-context"
  }
}

7. Conformance

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

  • It declares at most one parent.
  • It references a valid, stable parent identifier.
  • It avoids loops or contradictory hierarchies.
  • It follows all normative structural rules defined in this specification.