level-3-citations.memory.json

{
  "@context": [
    "https://mif-spec.dev/schema/context.jsonld",
    {
      "prov": "http://www.w3.org/ns/prov#",
      "dc": "http://purl.org/dc/terms/",
      "schema": "https://schema.org/"
    }
  ],
  "@type": ["Memory", "prov:Entity"],
  "@id": "urn:mif:a1b2c3d4-5e6f-7a8b-9c0d-1e2f3a4b5c6d",

  "content": "# Adopt MIF for AI Memory Interchange\n\n## Context\n\nOur AI systems currently use proprietary memory formats that are incompatible across different providers (Mem0, Zep, Letta, Subcog). This creates vendor lock-in and prevents memory portability when switching or combining AI memory systems.\n\n## Decision\n\nWe will adopt the **Memory Interchange Format (MIF)** as our standard for AI memory representation and interchange.\n\n### Key Factors\n\n1. **Dual Representation**: MIF provides both human-readable Markdown and machine-processable JSON-LD formats\n2. **Obsidian Compatibility**: Direct integration with our existing knowledge management workflows\n3. **Semantic Web Support**: JSON-LD enables RDF tooling and semantic queries\n4. **Local-First**: No cloud dependencies, full data ownership\n5. **Extensibility**: Custom properties without breaking compatibility\n\n## Consequences\n\n### Positive\n\n- Memories portable between AI providers\n- Human-readable format for manual review and editing\n- Compatible with existing Obsidian vaults\n- Future-proof with semantic web standards\n\n### Negative\n\n- Migration effort for existing memory stores\n- Team training on new format\n- Tooling development for format conversion\n\n## Implementation Plan\n\n1. **Phase 1**: Implement MIF export from current Subcog format\n2. **Phase 2**: Build import adapters for Mem0, Zep, Letta\n3. **Phase 3**: Native MIF storage in new projects\n4. **Phase 4**: Deprecate proprietary formats",
  "memoryType": "semantic",
  "title": "Adopt MIF for AI Memory Interchange",

  "created": "2026-01-20T10:00:00Z",
  "modified": "2026-01-22T15:30:00Z",

  "namespace": "_semantic/decisions",
  "tags": ["architecture", "memory-systems", "integration", "ai"],
  "aliases": ["MIF Adoption Decision", "Memory Format Choice"],

  "entities": [
    {
      "@type": "EntityReference",
      "entity": { "@id": "urn:mif:entity:technology:mif" },
      "entityType": "Technology",
      "name": "MIF"
    },
    {
      "@type": "EntityReference",
      "entity": { "@id": "urn:mif:entity:technology:subcog" },
      "entityType": "Technology",
      "name": "Subcog"
    },
    {
      "@type": "EntityReference",
      "entity": { "@id": "urn:mif:entity:technology:obsidian" },
      "entityType": "Technology",
      "name": "Obsidian"
    },
    {
      "@type": "EntityReference",
      "entity": { "@id": "urn:mif:entity:technology:json-ld" },
      "entityType": "Technology",
      "name": "JSON-LD"
    },
    {
      "@type": "EntityReference",
      "entity": {
        "@id": "urn:mif:entity:organization:engineering-architecture-team"
      },
      "entityType": "Organization",
      "name": "Engineering Architecture Team"
    }
  ],

  "relationships": [
    {
      "@type": "Relationship",
      "relationshipType": "Supersedes",
      "target": { "@id": "urn:mif:memory:proprietary-memory-format-2024" }
    },
    {
      "@type": "Relationship",
      "relationshipType": "RelatesTo",
      "target": { "@id": "urn:mif:memory:ai-infrastructure-standards" }
    },
    {
      "@type": "Relationship",
      "relationshipType": "PartOf",
      "target": { "@id": "urn:mif:memory:platform-architecture-decisions" }
    },
    {
      "@type": "Relationship",
      "relationshipType": "Implements",
      "target": { "@id": "urn:mif:memory:memory-portability-requirement" }
    }
  ],

  "temporal": {
    "@type": "TemporalMetadata",
    "validFrom": "2026-01-20T00:00:00Z",
    "validUntil": null,
    "recordedAt": "2026-01-20T10:00:00Z",
    "ttl": "P730D",
    "decay": {
      "model": "none",
      "currentStrength": 1.0
    },
    "accessCount": 12,
    "lastAccessed": "2026-01-22T15:30:00Z"
  },

  "provenance": {
    "@type": "prov:Entity",
    "sourceType": "user_explicit",
    "prov:wasGeneratedBy": {
      "@type": "prov:Activity",
      "prov:wasAssociatedWith": {
        "@id": "urn:mif:agent:claude-3-opus",
        "@type": "prov:SoftwareAgent",
        "schema:version": "20240229"
      }
    },
    "prov:wasDerivedFrom": {
      "@id": "urn:mif:meeting:arch-review-2026-01-20"
    },
    "confidence": 0.98,
    "trustLevel": "verified"
  },

  "embedding": {
    "@type": "EmbeddingReference",
    "model": "text-embedding-3-small",
    "modelVersion": "2024-01",
    "dimensions": 1536,
    "sourceText": "Decision to adopt MIF Memory Interchange Format for portable AI memory representation",
    "normalized": true
  },

  "citations": [
    {
      "@type": "Citation",
      "citationType": "specification",
      "citationRole": "source",
      "title": "Memory Interchange Format (MIF) Specification",
      "url": "https://github.com/zircote/subcog/blob/main/SPECIFICATION.md",
      "author": {
        "@type": "EntityReference",
        "entity": { "@id": "urn:mif:entity:person:robert-allen" },
        "entityType": "Person",
        "name": "Robert Allen"
      },
      "date": "2026-01-23",
      "accessed": "2026-01-20",
      "relevance": 1.0,
      "note": "Primary specification document defining the format we are adopting"
    },
    {
      "@type": "Citation",
      "citationType": "article",
      "citationRole": "supports",
      "title": "The Case for Portable AI Memory",
      "url": "https://example.com/ai-memory-portability",
      "author": [
        {
          "@type": "EntityReference",
          "entity": { "@id": "urn:mif:entity:person:jane-smith" },
          "entityType": "Person",
          "name": "Jane Smith"
        },
        {
          "@type": "EntityReference",
          "entity": { "@id": "urn:mif:entity:person:john-doe" },
          "entityType": "Person",
          "name": "John Doe"
        }
      ],
      "date": "2025-11-15",
      "accessed": "2026-01-18",
      "relevance": 0.92,
      "note": "Research article supporting vendor-neutral memory formats"
    },
    {
      "@type": "Citation",
      "citationType": "documentation",
      "citationRole": "background",
      "title": "Obsidian Help Documentation",
      "url": "https://help.obsidian.md/",
      "author": {
        "@type": "EntityReference",
        "entity": { "@id": "urn:mif:entity:organization:obsidian-team" },
        "entityType": "Organization",
        "name": "Obsidian Team"
      },
      "accessed": "2026-01-19",
      "relevance": 0.85
    },
    {
      "@type": "Citation",
      "citationType": "paper",
      "citationRole": "methodology",
      "title": "Bi-temporal Data Models in Knowledge Systems",
      "url": "https://arxiv.org/abs/2024.54321",
      "author": {
        "@type": "EntityReference",
        "entity": { "@id": "urn:mif:entity:organization:research-group" },
        "entityType": "Organization",
        "name": "Research Group"
      },
      "date": "2024-08-20",
      "relevance": 0.78,
      "note": "Theoretical foundation for MIF's temporal model"
    },
    {
      "@type": "Citation",
      "citationType": "repository",
      "citationRole": "extends",
      "title": "Subcog Memory System",
      "url": "https://github.com/zircote/subcog",
      "author": {
        "@type": "EntityReference",
        "entity": { "@id": "urn:mif:entity:person:robert-allen" },
        "entityType": "Person",
        "name": "Robert Allen"
      },
      "accessed": "2026-01-20",
      "relevance": 0.88
    }
  ],

  "extensions": {
    "subcog:domain": "architecture",
    "subcog:hash": "sha256:7d8e9f0a1b2c3d4e5f6a7b8c9d0e1f2a"
  }
}