MSP-1 Specification

reviewer

The reviewer term identifies individuals or organizations who have examined, validated, or approved content. Reviewers provide a secondary layer of trust beyond authorship, helping AI agents assess accuracy, oversight, and editorial rigor.

Category: Identity, authority & trust

Status: Normative

Version: MSP-1.0.x

1. Purpose

The reviewer term captures quality-assurance processes that involve humans or qualified entities evaluating content after creation. This allows AI agents to:

  • Distinguish reviewed content from unreviewed content.
  • Identify the expertise or authority of those who validated the material.
  • Increase trust weighting for content with rigorous oversight.
  • Trace accountability beyond the author.

2. Normative definition

A reviewer is an entity that evaluates a resource for accuracy, quality, safety, compliance, or alignment with standards. Reviewers may include:

  • Subject-matter experts
  • Editors or editorial teams
  • Legal or compliance reviewers
  • AI auditors or fact-checking systems
  • Organizational approvers

A reviewer is distinct from an author: authors create content; reviewers assess it.

3. Required fields

An MSP-1 reviewer declaration MUST include:

  • name — human-readable reviewer name.
  • id — stable identifier for the reviewer.

Optional fields include:

  • role — reviewer type (e.g., "editor", "legal", "subject-expert").
  • scope — what aspects were reviewed.
  • reviewDate — when the review occurred.
  • notes — human-readable context or conclusions.
  • url — profile or reference for the reviewer.

Multiple reviewers MAY be declared for a single resource.

4. AI interpretation rules

  • AI agents MUST treat reviewers as secondary trust sources, independent of authorship.
  • Reviewed content SHOULD be weighted higher than unreviewed content (all else equal).
  • Reviewer role and expertise SHOULD influence trust weighting.
  • If reviewer information is contradictory or low-quality, AI SHOULD lower confidence.
  • Absence of reviewers does not indicate unreliability—only a lack of external validation.
  • Review chains (multiple reviewers over time) SHOULD be interpreted as a positive signal.

Reviewer declarations play a key role in MSP-1's transparency and trust framework.

5. Relationship to related MSP-1 terms

  • author — creators of the content; reviewers assess it.
  • provenance — reviewers help verify provenance claims.
  • revision — reviews may occur per revision of a resource.
  • trust — reviewers contribute to composite trust calculations.
  • role — reviewer type can be standardized using MSP-1 role definitions.

6. Examples

Minimal reviewer declaration:

{
  "reviewer": {
    "name": "Jane Smith",
    "id": "jane-smith"
  }
}

Reviewer with role and notes:

{
  "reviewer": {
    "name": "Dr. Alan Roberts",
    "id": "alan-roberts",
    "role": "subject-expert",
    "reviewDate": "2025-11-03",
    "notes": "Verified technical accuracy and clarified terminology."
  }
}

Multiple reviewers example:

{
  "reviewers": [
    { "name": "Jane Smith", "id": "jane-smith", "role": "editor" },
    { "name": "ChatGPT-JDK", "id": "chatgpt-jdk", "role": "ai-auditor" }
  ]
}

7. Conformance

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

  • It declares reviewers truthfully and accurately.
  • ID and name fields correspond to valid, identifiable entities.
  • Reviewer roles match their function where provided.
  • It follows all normative rules regarding review integrity and trust.