An enhanced entity page gives humans and agents a stable public record for a person, project, product, standard, route, package, model, dataset, organization, or concept. It is not a knowledge graph database; it is a reviewed page with identifiers, claims, relations, source spans, and public-safe limits.
Entity Page Contract
| Section | Required content | Reason |
|---|---|---|
| Identity | Canonical title, stable slug, aliases, disambiguation note, entity type, and canonical URL. | Prevents duplicate pages and ambiguous citations. |
| Public summary | One-paragraph source-backed description with date and scope. | Search and agents need a small, safe routing answer. |
| Claim table | Atomic claims with source status, source span, reviewer, last verified date, and confidence label. | Separates evidence from fluent prose. |
| Relations | Typed relations such as part_of, depends_on, supersedes, contradicts, source_for, implemented_by, related_to. | Makes graph traversal deterministic without requiring a live graph store. |
| Boundaries | What the page does not claim, support, endorse, certify, or expose. | Stops agents and crawlers from overreading the page. |
| Freshness | Last reviewed, last verified, freshness rule, stale triggers, and supersession state. | Protects time-sensitive claims. |
Starter Frontmatter
---
title: "Entity Name"
page_type: entity
entity_type: project | product | standard | route | model | dataset | organization | concept
canonical_url: "https://example.com/entities/entity-name/"
aliases: []
disambiguation: ""
status: reviewed
trust_level: authoritative
source_status: source-linked
last_reviewed: YYYY-MM-DD
last_verified: YYYY-MM-DD
freshness_rule: "review quarterly or when canonical source changes"
claim_ids:
- entity-name-claim-001
typed_relations:
part_of: []
depends_on: []
supersedes: []
superseded_by: []
contradicts: []
source_for: []
non_claims:
- "This page is not an endorsement or certification."
---
Claim Shape
- id: entity-name-claim-001
subject: "Entity Name"
predicate: "has canonical route"
object: "https://example.com/entities/entity-name/"
scope: public
source_span: "source-record.md#canonical-route"
evidence_hash: "sha256:..."
status: reviewed
reviewer: "Publication owner"
last_verified: YYYY-MM-DD
Lint Rules
- Duplicate canonical URLs fail.
- Aliases without disambiguation warn when they collide with another entity.
- Reviewed claims without source spans fail.
- External standards or product claims without canonical source links fail review.
- Pages with time-sensitive fields need
last_verifiedandfreshness_rule. - Generated graph or JSON exports must identify themselves as derived read-only artifacts.