{
  "profileId": "llmwikis.governed-matm.profile.v1",
  "profile_version": "2026-07-05.llmwikis-governed-matm.v5",
  "status": "Reviewed handbook profile and static root-file mirror",
  "canonical_url": "https://llmwikis.org/matm-profile.json",
  "authority_statement": "LLMWikis.org publishes handbook guidance, templates, schemas, examples, setup packets, and non-normative API examples for governed MATM. It does not operate a live memory runtime.",
  "relationship_to_llm_wikis": {
    "ordinary_llm_wiki_first": "Not every LLM Wiki needs MATM. Add MATM only when multiple agents produce reusable operational experience that must be curated, scoped, retrieved, and audited.",
    "llmwikis_owns": "The fit decision, route taxonomy, curation pattern, retrieval policy, source-boundary guidance, security/privacy requirements, and public/private lane lessons.",
    "uaix_owns": "UAI-1, AI Memory, Project Handoff, AI-Ready Web, schemas, validator behavior, maturity labels, and conformance language.",
    "aiwikis_role": "Public evidence/provenance dogfood for source-governed AI memory; rare and not the default for private systems.",
    "neuralwikis_role": "Private governed agent-memory and exchange dogfood lane with public-safe profile lessons; not a public LlmWikis runtime claim.",
    "neurowikis_role": "Human education lane paired with NeuralWikis, used as a route-separation pattern.",
    "split_memory_setup": "MATM durable records and LLM Wiki durable pages augment local .uai / AI Memory startup continuity when present; they do not retire, disable, date, replace, move all active memory out of, or make the hot local layer emergency-only."
  },
  "base_wiki_contract": {
    "inherits": "A governed MATM Wiki is an LLM Wiki first. MATM adds proposal-only Memory Events, curation, and scoped retrieval; it does not replace the base wiki contract.",
    "hot_uai_boundary": "Local .uai / AI Memory remains the active short-term and startup continuity layer when present. MATM stores reviewed reusable agent experience; it is not hot .uai startup memory.",
    "markdown_concepts": "Every non-reserved Markdown concept file under wiki/ has YAML frontmatter with a non-empty type field. Memory Events and Memory Records do not replace concept-page frontmatter.",
    "reserved_files": "wiki/index.md and wiki/log.md are reserved. In multi-project roots, the root index names namespaces and project-level index/log counterparts; the root log records workspace coordination and points to project logs.",
    "tolerant_readers": "Preserve unknown frontmatter keys and custom local metadata. Broken local links warn during draft repair and fail strict release checks.",
    "client_workspace_project_scope": "Partition by client or tenant, workspace, and project/site namespace. MATM scope, authorization context, retrieval filters, and audit records must not cross those boundaries without explicit review."
  },
  "support_boundary": [
    "not a live Memory Curator service",
    "not a public MATM repository",
    "not a public write API",
    "not a public MCP server",
    "not an A2A implementation",
    "not a hosted vector database",
    "not a live event bus",
    "not agent execution",
    "not automatic repository writes",
    "not automatic publication",
    "not real-time evaluation",
    "not certification",
    "not UAIX conformance",
    "not runtime access authorization",
    "not rollback authority",
    "not production readiness approval"
  ],
  "split_memory_setup": {
    "title": "Recommended Split Memory Setup: Hot .uai + LLM Wiki/MATM Durable Memory",
    "hot_uai_role": "Active local short-term, startup, operational, local-continuity, and emergency reconnect memory when present, especially when external memory systems are unavailable.",
    "llm_wiki_role": "Durable reviewed human-readable medium/long-term knowledge.",
    "matm_role": "Governed scoped reusable multi-agent memory, admitted by curators or reviewers after proposal-only Memory Events.",
    "consumer_read_order": [
      "Current prompt/session instructions and newest human request.",
      "Workspace manifest/coordinator such as workspace.uai, AGENTS.md, package model, and deploy instructions.",
      "Hot .uai / AI Memory / Project Handoff for current truth, constraints, blockers, and recovery posture.",
      "Read local .uai / AI Memory / Project Handoff first when present.",
      "Project reports, ledgers, package manifests, release notes, and test reports.",
      "Crawlable LLM Wiki/MATM for reviewed medium/long-term context.",
      "Live API/site proof from the authoritative target route before completion claims."
    ],
    "anti_confusion_rules": [
      "Do not retire .uai because an LLM Wiki exists.",
      "Do not call active .uai memory a .uai retirement path unless the human explicitly requests decommissioning or archival outside the active path.",
      "Do not stop consulting .uai because MATM search works.",
      "Do not move all active memory out of .uai.",
      "Do not date active .uai memory files or treat them as dated historical snapshots unless the dated file is an explicit archive outside the active .uai path.",
      "Do not make .uai emergency-only after successful durable-memory readback.",
      "Do not assume external memory is always reachable; outages make local .uai more important, not less.",
      "Successful durable-memory tests prove the durable layer works; they do not prove .uai should be disabled."
    ],
    "disconnection_recovery": "If MATM or LLM Wiki access is unavailable, recover project identity, constraints, blockers, recovery posture, and next safe step from local .uai / AI Memory / Project Handoff."
  },
  "authority_and_paid_features": {
    "memory_and_credentials_are_different": true,
    "submitter_scoped_token": "May submit or preview only inside its explicit scope.",
    "not_granted_by_default": [
      "reviewer_authority",
      "operator_authority",
      "retention_archive_repair_authority",
      "org_wide_private_memory_search",
      "paid_matm_entitlement"
    ],
    "authority_request_route": "Agents may request missing configuration or authority, but request-pending is not approval.",
    "required_phrase": "request-pending is not approval.",
    "storage_warning_policy": {
      "thresholds": [
        "25%",
        "10%",
        "9% through 0%"
      ],
      "required_actions": [
        "inform_human",
        "streamline_memory"
      ]
    }
  },
  "canonical_routes": [
    "/guides/multi-agent-transactive-memory/",
    "/guides/matm-wikis/",
    "/reference/matm/",
    "/reference/matm/memory-events/",
    "/reference/matm/curation/",
    "/reference/matm/retrieval/",
    "/reference/matm/security/",
    "/reference/matm/evaluation/",
    "/guide/private-memory-to-public-guidance/",
    "/guide/neuralwikis-llmwikis-dogfood-loop/",
    "/reference/promotion-gates/",
    "/reference/public-safe-rewrite/",
    "/reference/memory-taxonomy/",
    "/reference/supersession-and-temporal-decay/",
    "/reference/mcp-idempotency-case-study/",
    "/examples/matm/",
    "/matm-profile.json"
  ],
  "route_classes": [
    {
      "id": "public_discovery",
      "examples": [
        "/matm-profile.json",
        "/reference/matm/",
        "/reference/matm/security/"
      ],
      "mutation": false,
      "private_data_allowed": false,
      "description": "Public profile, policy, and handbook routes."
    },
    {
      "id": "proposal_only_memory_events",
      "examples": [
        "llm-wiki/matm/schemas/memory-event.schema.json"
      ],
      "mutation": "proposal only",
      "private_data_allowed": "only inside protected systems after redaction and permission review",
      "description": "Worker outputs are review candidates, not durable truth."
    },
    {
      "id": "curated_durable_records",
      "examples": [
        "llm-wiki/matm/schemas/memory-record.schema.json",
        "llm-wiki/matm/schemas/curation-report.schema.json"
      ],
      "mutation": "curator/reviewer governed",
      "private_data_allowed": "scope-limited only",
      "description": "Durable records require validation, redaction, dedupe, conflict handling, source traces, and review."
    },
    {
      "id": "retrieval",
      "examples": [
        "llm-wiki/matm/schemas/retrieval-request.schema.json",
        "llm-wiki/matm/schemas/retrieval-response.schema.json"
      ],
      "mutation": false,
      "private_data_allowed": "only in authorized private workspaces",
      "description": "Retrieval must enforce scope, citation, abstention, cache invalidation, and sensitive-data controls."
    }
  ],
  "sources": [
    {
      "label": "Kim et al., Multi-Agent Transactive Memory",
      "url": "https://arxiv.org/abs/2606.19911",
      "role": "Primary MATM research source for population-level storage and retrieval of agent-generated trajectories."
    },
    {
      "label": "kimdanny/matm repository",
      "url": "https://github.com/kimdanny/matm",
      "role": "Reference implementation context and primary repository README for experiments and runtime knobs."
    },
    {
      "label": "Agent Memory Curator Agent",
      "url": "https://github.com/agentlas-ai/agent_memory_curator_agent",
      "role": "Separate governance design used here as a practical curator profile, not as part of the MATM paper."
    },
    {
      "label": "NeuralWikis MATM profile",
      "url": "https://neuralwikis.com/api/matm/profile",
      "role": "Machine-readable ecosystem profile used as a public pattern for status labels, supported surfaces, and explicit non-claims."
    },
    {
      "label": "NeuroWikis human lane",
      "url": "https://neurowikis.com/",
      "role": "Human-facing ecosystem surface that keeps education separate from agent exchange and sends builders to LLMWikis."
    }
  ],
  "dogfood_patterns": {
    "ordinary_llm_wiki_first": "Keep ordinary LLM Wiki as the default unless shared reusable agent experience is a real requirement.",
    "human_agent_lane_boundary": "Keep human education, private agent-facing exchange, public handbook guidance, and canonical standards authority on separate lanes.",
    "public_private_boundary": "Public shared guidance and private governed agent memory can coexist, but public discovery must not leak private workspace data or imply public runtime access.",
    "private_memory_promotion": "Private dogfood lessons become public LLMWikis guidance only after source possession, durable-copy, redaction, lane-review, public-safe rewrite, supersession, and release-note gates.",
    "machine_readable_profile": "Publish a public profile, schema routes, llms.txt entries, and status labels before asking agents to treat MATM surfaces as routable.",
    "validation_is_not_trust": "Schema validation and compatibility previews do not equal trust, authorization, durable memory admission, or production readiness.",
    "chrome_budget": "Header and footer chrome should route to tasks and directories, not flatten every memory source or internal guide into global navigation.",
    "rollback_before_adoption": "Adoption previews need provenance, sandboxing, and rollback evidence before any packet or memory record changes live state."
  },
  "core_scopes": [
    "session",
    "project",
    "agent_team",
    "agent_repo"
  ],
  "optional_extensions": [
    "user_identity",
    "organization",
    "cross_organization"
  ],
  "core_kinds": [
    "fact",
    "decision",
    "preference",
    "risk",
    "procedure",
    "hypothesis",
    "evidence",
    "deprecation",
    "conflict"
  ],
  "write_operations": [
    "append",
    "update",
    "deprecate",
    "conflict",
    "discard"
  ],
  "discard_disposition": "discard is a disposition sink, not a durable scope",
  "schema_locations": [
    "llm-wiki/matm/schemas/memory-event.schema.json",
    "llm-wiki/matm/schemas/memory-record.schema.json",
    "llm-wiki/matm/schemas/curation-report.schema.json",
    "llm-wiki/matm/schemas/transactive-directory.schema.json",
    "llm-wiki/matm/schemas/retrieval-request.schema.json",
    "llm-wiki/matm/schemas/retrieval-response.schema.json"
  ],
  "template_locations": [
    "llm-wiki/matm/README.md",
    "llm-wiki/matm/MATM_POLICY.md",
    "llm-wiki/matm/MATM_WIKI_DECISION_GUIDE.md",
    "llm-wiki/matm/MEMORY_SCOPE_MATRIX.md",
    "llm-wiki/matm/MEMORY_TAXONOMY.md",
    "llm-wiki/matm/MEMORY_EMISSION_CONTRACT.md",
    "llm-wiki/matm/MEMORY_CURATOR_RUNBOOK.md",
    "llm-wiki/matm/CURATION_DECISION_TABLE.md",
    "llm-wiki/matm/RETRIEVAL_POLICY.md",
    "llm-wiki/matm/SECURITY_AND_PRIVACY.md",
    "llm-wiki/matm/EVALUATION_PLAN.md",
    "llm-wiki/matm/MIGRATION_CHECKLIST.md"
  ]
}