Skip to content
MIF

Appendices

Appendix A: YAML Frontmatter Quick Reference

Section titled “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:
  validFrom: ISO-8601-datetime
  validUntil: ISO-8601-datetime | null
  recordedAt: ISO-8601-datetime
  ttl: ISO-8601-duration
  decay:
    model: none|linear|exponential|step
    halfLife: ISO-8601-duration
    strength: 0.0-1.0
  accessCount: integer
  lastAccessed: ISO-8601-datetime


provenance:
  sourceType: user_explicit|user_implicit|agent_inferred|external_import|system_generated
  sourceRef: uri
  agent: string
  confidence: 0.0-1.0
  trustLevel: verified|user_stated|high_confidence|moderate_confidence|low_confidence|uncertain


embedding:
  model: string
  modelVersion: string
  dimensions: integer
  sourceText: string


extensions:
  provider_name:
    custom_field: value
---

Appendix B: Relationship Types Quick Reference

Section titled “Appendix B: Relationship Types Quick Reference”

Relationships appear in a ## Relationships body section as - <type> [Text](/path/target.md), mirroring the authoritative frontmatter relationships[].

Body Markdown Syntax JSON-LD type Description
- relates-to [X](/path/x.md) relates-to General relationship
- derived-from [X](/path/x.md) derived-from Created from source
- supersedes [X](/path/x.md) supersedes Replaces older
- conflicts-with [X](/path/x.md) conflicts-with Contradicts
- part-of [X](/path/x.md) part-of Component of
- implements [X](/path/x.md) implements Realizes
- uses [X](/path/x.md) uses Utilizes
- created-by [X](/path/x.md) created-by Authored by
- mentioned-in [X](/path/x.md) mentioned-in Referenced in

Appendix C: Entity Reference Syntax

Section titled “Appendix C: Entity Reference Syntax”

Entity references are declared in the frontmatter entities[] array as EntityReference objects:

Field Required Meaning
@type REQUIRED Always EntityReference
entity.@id REQUIRED Entity URN (urn:mif:entity:<type>:<slug>)
entityType OPTIONAL Person, Organization, Technology, Concept, File, or a custom ontology type
name OPTIONAL Display name
role OPTIONAL Role in the memory (e.g. author, mentions, uses) 
entities:
  - "@type": EntityReference
    entity: { "@id": urn:mif:entity:person:jane-doe }
    entityType: Person
    name: Jane Doe
    role: mentions

Appendix D: Citations Quick Reference

Section titled “Appendix D: Citations Quick Reference”

Citation Types

Section titled “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

Section titled “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

Section titled “Frontmatter Syntax”
citations:
  - "@type": Citation          # REQUIRED
    citationType: article      # REQUIRED
    title: "Citation Title"    # REQUIRED
    url: https://example.com   # REQUIRED
    citationRole: supports     # REQUIRED
    author: "Author Name"      # OPTIONAL (string, EntityReference, or array of EntityReference)
    date: 2024-06-15           # OPTIONAL
    accessed: 2026-01-20       # OPTIONAL
    relevance: 0.95            # OPTIONAL (0-1)
    note: "Annotation"         # OPTIONAL

Body Section Syntax

Section titled “Body Section Syntax”
## Citations


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

References

Section titled “References”