MSP-1 Specification
interpretiveFrame
The interpretiveFrame term declares the contextual lens, orientation, assumptions, or boundaries through which an MSP-1 resource should be understood.
1. Purpose
The interpretiveFrame term provides declarative context for interpreting a resource. It is useful when a page, section, site, intent, description, or resource could be misunderstood if read without its intended lens.
Interpretive framing helps reduce ambiguity by identifying the relevant orientation, boundary, or contextual stance. It does not command agent behavior, guarantee trust, create ranking value, or enforce a result.
2. Definition
An interpretiveFrame is a string or structured object that declares how a resource should be contextualized.
- String form — a concise natural-language statement describing the interpretive lens or contextual frame.
- Object form — a structured declaration with a required
framefield and optional supporting fields.
3. Accepted forms
String form
The string form should be used when one concise statement is sufficient.
{
"interpretiveFrame": "This guide should be interpreted from a practical, real-world photography workflow perspective."
}
Object form
The object form should be used when additional framing metadata is useful.
{
"interpretiveFrame": {
"frame": "Technical documentation lens for MSP-1 implementation guidance.",
"category": "instructional",
"tone": "neutral",
"perspective": "developer implementation context",
"scope": "page"
}
}
4. Structured fields
When interpretiveFrame is expressed as an object, the following fields are defined.
- frame — required. The primary interpretive frame expressed as a concise human-readable statement.
- category — optional. Classification describing the type of interpretive framing being used.
- tone — optional. A high-level descriptor of tone, such as neutral, objective, supportive, critical, or satirical.
- perspective — optional. Description of the viewpoint or stance behind the content.
- scope — optional. Description of what part of the content or resource the interpretive frame applies to.
- appliesToIntent — optional. Indicates whether the interpretive frame specifically qualifies or modifies the declared intent.
- notes — optional. Free-form elaboration or clarifying details for the interpretive frame.
- lastUpdated — optional. Date the interpretive frame was last reviewed or updated.
5. Usage guidance
- The interpretive frame should clearly name the relevant lens, context, or orientation.
- The frame should describe how the resource should be read in context rather than issuing instructions to agents.
- The frame should identify relevant limits or assumptions when needed.
- The frame should align with declared
description,intent,type, and the resource content. - The frame should not be treated as a command, trust guarantee, security control, ranking signal, or enforcement mechanism.
6. Relationship to related MSP-1 terms
- intent declares what the resource is for;
interpretiveFramedeclares how it should be contextualized. - description summarizes what the resource is about;
interpretiveFrameprovides the contextual lens for reading it. - type classifies the resource and may help support the interpretive frame.
- section may carry its own interpretive frame when a subsection requires distinct context.
- provenance documents origin and contributor context, which may help explain why a particular frame is appropriate.
7. Validation guidance
An interpretiveFrame declaration should be either a non-empty string or a structured object with a non-empty frame field.
Validators should flag empty, contradictory, overly broad, coercive, or content-misaligned frames as non-ideal clarity conditions. A missing interpretiveFrame may reduce contextual clarity but should not alone invalidate an otherwise interpretable MSP-1 declaration.