Metadata

Stable

Standard block

Every entity record carries this metadata. On this site the display fields live in page front matter and the relationship fields live in the registry, so that relationships can be checked mechanically without parsing every page.


id: PRJ-001
 
type: project
 
title: Project Title
 
status: active
 
created: 2026-08-31
updated: 2026-08-31
 
research_questions:
  - RQ-001
 
hypotheses:
  - HYP-001
 
thesis_chapters:
  - CH05
 
publications:
  - PUB-001
 
experiments:
  - EXP-001
  - EXP-002
 
datasets:
  - DATA-001
 
artifacts:
  - FIG-001
  - TABLE-001
  - CODE-001
 
tags:
  - topic-1
  - topic-2
 
visibility: confidential

Fields

Field	Required	Meaning
`id`	Yes	Permanent identifier. Never changes.
`type`	Yes	Entity kind, matching the identifier prefix.
`title`	Yes	Human-readable name. May change freely.
`status`	Yes	From the vocabulary for this type.
`created`	Yes	ISO date. Never changes.
`updated`	Yes	ISO date of the last substantive change.
`research_questions`	No	Questions this entity serves.
`hypotheses`	No	Hypotheses this entity tests or supports.
`thesis_chapters`	No	Chapters that report this entity.
`publications`	No	Publications that use it.
`experiments`	No	Experiments belonging to or using it.
`datasets`	No	Datasets it consumes or produces.
`artifacts`	No	Registered artifacts it produces or uses.
`tags`	No	Free-form topic tags. Not a substitute for links.
`visibility`	Yes	One of the visibility levels.

Dates

ISO 8601, YYYY-MM-DD, always. Not locale-formatted, not relative. “Last Tuesday” is unresolvable a year later, and a date written 03/04/2027 is ambiguous to half the world.

created is the date the entity was first recorded and never changes. updated changes only for substantive edits; fixing a typo is not a substantive edit.

Where it is validated

schemas/*.schema.json defines the shape for each entity type, and pnpm validate checks every registry file against the matching schema. A registry entry that does not validate fails the check, which is the point: a metadata convention that is not mechanically enforced is a metadata suggestion.