Validation Checklists
Per-entity-type checklists. Every file must pass its checklist before being considered complete.
System (variant) card
Frontmatter:
-
type: system -
slug:— matches filename -
title: -
manufacturer: -
modality: -
family:(if part of a multi-variant family) -
aliases: [] -
tags: [system, variant](or[system]if standalone) - Modality-specific schema fields populated where known
Body:
- Overview paragraph — what makes this variant distinct
- Variant-specific considerations section
- Parts section — variant-specific + shared (with links)
- Related section — sibling variants, predecessor, successor, family
System family page
-
type: system-family - Lists every variant as a wikilink
- Shared specs section
- Shared field guide pointer
- Tags:
[system, family]
Part
-
type: part -
fits_systems: [...]lists every variant slug -
typical_failure_mode:populated - Diagnosis section
- Field notes cross-reference
- Tags:
[part]
Field guide
-
type: field-guide -
system:— points to the family or variant - Top failure modes section (numbered)
- Acceptance checklist section
- Tags:
[field-guide]
Glossary term
-
type: glossary - Single-paragraph definition
- "Why buyers care" section
- "Why engineers care" section
- At least 2 wikilinks to systems / other glossary
- Tags:
[glossary]
Modality
-
type: modality - Physics / how-it-works section
- Key specs section
- Systems-in-modality list
- Service reality section
- Tags:
[modality]
Manufacturer
-
type: manufacturer - Company history
- Flagship systems (cross-linked)
- Market position per modality
- Tags:
[manufacturer]
Clinical application
-
type: clinical-application - Typical modalities / systems
- Room time + procedure characteristics
- Specialty + domain
- Tags:
[clinical-application]
Persona
-
type: persona - Daily responsibilities
- What they evaluate
- Decision drivers
- Tags:
[persona]
Never
- Contains fake numbers, fake listings, fake vendor counts, fake install-base totals
- Contains prices
- Lists specific service companies (until opted-in)
- Uses marketing-speak ("cutting-edge", "revolutionary", "seamless", "state-of-the-art")
- Has dangling wikilinks with no target (either create the target or mark "planned")