Skip to content

Appendices

Appendix A: YAML Frontmatter Quick Reference

---
# Required
id: uuid-v4
type: semantic|episodic|procedural
created: ISO-8601-datetime

# Recommended
modified: ISO-8601-datetime
ontology:
  id: ontology-identifier        # Matches ontology.id in definition
  version: "1.0.0"               # Semantic version (optional)
  uri: https://example.com/ont   # Ontology URL (optional)
namespace: hierarchical/path
title: "Human Title"
tags: [tag1, tag2]

# Optional
aliases: ["Alt Name 1", "Alt Name 2"]

temporal:
  valid_from: ISO-8601-datetime
  valid_until: ISO-8601-datetime | null
  recorded_at: ISO-8601-datetime
  ttl: ISO-8601-duration
  decay:
    model: none|linear|exponential|step
    halfLife: ISO-8601-duration
    strength: 0.0-1.0
  access_count: integer
  last_accessed: ISO-8601-datetime

provenance:
  source_type: user_explicit|user_implicit|agent_inferred|external_import|system_generated
  source_ref: uri
  agent: string
  confidence: 0.0-1.0
  trust_level: verified|user_stated|high_confidence|moderate_confidence|low_confidence|uncertain

embedding:
  model: string
  model_version: string
  dimensions: integer
  source_text: string

extensions:
  provider_name:
    custom_field: value
---

Appendix B: Relationship Types Quick Reference

Markdown Syntax	JSON-LD relationshipType	Description
`[[X]]`	`RelatesTo`	General relationship
`[[X\|derived-from]]`	`DerivedFrom`	Created from source
`[[X\|supersedes]]`	`Supersedes`	Replaces older
`[[X\|conflicts-with]]`	`ConflictsWith`	Contradicts
`[[X\|part-of]]`	`PartOf`	Component of
`[[X\|implements]]`	`Implements`	Realizes
`[[X\|uses]]`	`Uses`	Utilizes
`[[X\|created-by]]`	`Created`	Authored by
`[[X\|mentioned-in]]`	`MentionedIn`	Referenced in

Appendix C: Entity Reference Syntax

Markdown	Meaning
`@[[Name]]`	Reference entity by name
`@[[Name\|Person]]`	Reference with explicit type
`@[[Name\|uses]]`	Reference with relationship
`@[[Name\|Technology\|uses]]`	Type and relationship

Appendix D: Citations Quick Reference

Citation Types

Type	Description
`article`	Journal article, blog post
`book`	Published book
`paper`	Conference/research paper
`website`	General website
`documentation`	Technical documentation
`repository`	Code repository
`video`	Video content
`podcast`	Podcast episode
`specification`	Technical specification
`dataset`	Data source
`tool`	Software tool or service
`other`	Miscellaneous source

Citation Roles

Role	Description
`supports`	Provides supporting evidence
`refutes`	Contradicts or disputes
`background`	General context/reference
`methodology`	Method or approach source
`contradicts`	Conflicts with claims
`extends`	Builds upon cited work
`derived`	Direct derivation source
`source`	Primary source material
`example`	Illustrative example
`review`	Critical review/analysis

Frontmatter Syntax

citations:
  - type: article              # REQUIRED
    title: "Citation Title"    # REQUIRED
    url: https://example.com   # REQUIRED
    role: supports             # REQUIRED
    author: "@[[Name|Person]]" # OPTIONAL
    date: 2024-06-15           # OPTIONAL
    accessed: 2026-01-20       # OPTIONAL
    relevance: 0.95            # OPTIONAL (0-1)
    note: "Annotation"         # OPTIONAL

Body Section Syntax

## Citations

- [Title](url) by @[[Author|Person]] (date)
  - **Type**: article
  - **Role**: supports
  - **Relevance**: 0.95
  - Long-form annotation here.

References