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.
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.