{
  "schemaVersion": "1.0",
  "item": {
    "slug": "memory-architect",
    "name": "Memory Architect",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/kapslap/memory-architect",
    "canonicalUrl": "https://clawhub.ai/kapslap/memory-architect",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/memory-architect",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory-architect",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "slug": "memory-architect",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T08:20:34.046Z",
      "expiresAt": "2026-05-09T08:20:34.046Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory-architect",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=memory-architect",
        "contentDisposition": "attachment; filename=\"memory-architect-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "memory-architect"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/memory-architect"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/memory-architect",
    "agentPageUrl": "https://openagent3.xyz/skills/memory-architect/agent",
    "manifestUrl": "https://openagent3.xyz/skills/memory-architect/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/memory-architect/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Memory Architect",
        "body": "Split a monolithic MEMORY.md into three tiers plus a structured entity graph."
      },
      {
        "title": "Architecture",
        "body": "MEMORY.md              → Router (30 lines max). Points to tiers.\nmemory/protocols.md    → HOT: Stable workflows, shortcuts, procedures. Read on session start.\nmemory/active.md       → WARM: Current projects, waiting-on, live context. Check before acting.\nmemory/archive.md      → COLD: Completed work, historical reference. Search when needed.\nmemory/ontology/graph.jsonl → Structured entities + relations (JSONL append-only)"
      },
      {
        "title": "1. Analyze the existing MEMORY.md",
        "body": "Read the full file. Classify each section:\n\nContent typeTierExamplesStable workflow / procedureprotocolsEmoji shortcuts, deploy steps, tool usage rulesActive project / waiting-onactiveCurrent builds, pending replies, live URLsCompleted work / reference dataarchiveDone tasks, contact lists, account tables, old decisionsNamed entity with propertiesontologyPeople, orgs, projects, properties, locations"
      },
      {
        "title": "2. Create the tier files",
        "body": "Write each tier file with a header comment explaining its purpose and update frequency.\n\nprotocols.md rules:\n\nOnly procedures that rarely change\nInclude the exact commands (copy-pasteable)\nNo project-specific state\n\nactive.md rules:\n\nOnly things with a next action or pending status\nInclude \"Waiting On\" section at bottom\nPrune completed items to archive on each update\n\narchive.md rules:\n\nCompleted work grouped by date or category\nReference data (contacts, accounts, chat IDs)\nKeep searchable — use headers and tables"
      },
      {
        "title": "3. Extract entities to ontology",
        "body": "For each named person, organization, project, property, or location, create a JSONL entry:\n\n{\"op\":\"create\",\"entity\":{\"id\":\"p_alice\",\"type\":\"Person\",\"properties\":{\"name\":\"Alice\",\"email\":\"alice@example.com\",\"role\":\"Engineer\"}},\"timestamp\":\"2026-01-01T00:00:00Z\"}\n{\"op\":\"relate\",\"from\":\"p_alice\",\"rel\":\"member_of\",\"to\":\"org_acme\",\"timestamp\":\"2026-01-01T00:00:00Z\"}\n\nID conventions:\n\nPeople: p_shortname\nOrganizations: grp_name or org_name\nProjects: proj_name\nProperties/locations: prop_name or loc_name\n\nRelation types: member_of, owns, collaborates_on, interested_in, guides, uses, listed_by, located_at"
      },
      {
        "title": "4. Rewrite MEMORY.md as router",
        "body": "Replace MEMORY.md with a ~25-line index that:\n\nLists the three tiers with one-line descriptions\nNotes the ontology location\nPreserves any system directives (NO_REPLY rules, heartbeat instructions)\nContains zero project-specific content"
      },
      {
        "title": "5. Verify",
        "body": "wc -l MEMORY.md memory/protocols.md memory/active.md memory/archive.md memory/ontology/graph.jsonl\n\nTargets: MEMORY.md under 30, protocols under 100, active under 80, graph = 1 line per entity/relation."
      },
      {
        "title": "On each session",
        "body": "Read memory/protocols.md (always)\nScan memory/active.md (always)\nmemory/archive.md — only on memory_search or explicit request"
      },
      {
        "title": "When adding new information",
        "body": "New procedure → protocols.md\nNew project/active item → active.md\nCompleted item → move active → archive\nNew person/org/project → append to graph.jsonl"
      },
      {
        "title": "Entity queries",
        "body": "grep \"p_forrest\" memory/ontology/graph.jsonl\ngrep '\"type\":\"Project\"' memory/ontology/graph.jsonl\ncat memory/ontology/graph.jsonl | jq -r 'select(.entity?.type==\"Person\") | .entity.properties.name'"
      }
    ],
    "body": "Memory Architect\n\nSplit a monolithic MEMORY.md into three tiers plus a structured entity graph.\n\nArchitecture\nMEMORY.md              → Router (30 lines max). Points to tiers.\nmemory/protocols.md    → HOT: Stable workflows, shortcuts, procedures. Read on session start.\nmemory/active.md       → WARM: Current projects, waiting-on, live context. Check before acting.\nmemory/archive.md      → COLD: Completed work, historical reference. Search when needed.\nmemory/ontology/graph.jsonl → Structured entities + relations (JSONL append-only)\n\nProcess\n1. Analyze the existing MEMORY.md\n\nRead the full file. Classify each section:\n\nContent type\tTier\tExamples\nStable workflow / procedure\tprotocols\tEmoji shortcuts, deploy steps, tool usage rules\nActive project / waiting-on\tactive\tCurrent builds, pending replies, live URLs\nCompleted work / reference data\tarchive\tDone tasks, contact lists, account tables, old decisions\nNamed entity with properties\tontology\tPeople, orgs, projects, properties, locations\n2. Create the tier files\n\nWrite each tier file with a header comment explaining its purpose and update frequency.\n\nprotocols.md rules:\n\nOnly procedures that rarely change\nInclude the exact commands (copy-pasteable)\nNo project-specific state\n\nactive.md rules:\n\nOnly things with a next action or pending status\nInclude \"Waiting On\" section at bottom\nPrune completed items to archive on each update\n\narchive.md rules:\n\nCompleted work grouped by date or category\nReference data (contacts, accounts, chat IDs)\nKeep searchable — use headers and tables\n3. Extract entities to ontology\n\nFor each named person, organization, project, property, or location, create a JSONL entry:\n\n{\"op\":\"create\",\"entity\":{\"id\":\"p_alice\",\"type\":\"Person\",\"properties\":{\"name\":\"Alice\",\"email\":\"alice@example.com\",\"role\":\"Engineer\"}},\"timestamp\":\"2026-01-01T00:00:00Z\"}\n{\"op\":\"relate\",\"from\":\"p_alice\",\"rel\":\"member_of\",\"to\":\"org_acme\",\"timestamp\":\"2026-01-01T00:00:00Z\"}\n\n\nID conventions:\n\nPeople: p_shortname\nOrganizations: grp_name or org_name\nProjects: proj_name\nProperties/locations: prop_name or loc_name\n\nRelation types: member_of, owns, collaborates_on, interested_in, guides, uses, listed_by, located_at\n\n4. Rewrite MEMORY.md as router\n\nReplace MEMORY.md with a ~25-line index that:\n\nLists the three tiers with one-line descriptions\nNotes the ontology location\nPreserves any system directives (NO_REPLY rules, heartbeat instructions)\nContains zero project-specific content\n5. Verify\nwc -l MEMORY.md memory/protocols.md memory/active.md memory/archive.md memory/ontology/graph.jsonl\n\n\nTargets: MEMORY.md under 30, protocols under 100, active under 80, graph = 1 line per entity/relation.\n\nMaintenance\nOn each session\nRead memory/protocols.md (always)\nScan memory/active.md (always)\nmemory/archive.md — only on memory_search or explicit request\nWhen adding new information\nNew procedure → protocols.md\nNew project/active item → active.md\nCompleted item → move active → archive\nNew person/org/project → append to graph.jsonl\nEntity queries\ngrep \"p_forrest\" memory/ontology/graph.jsonl\ngrep '\"type\":\"Project\"' memory/ontology/graph.jsonl\ncat memory/ontology/graph.jsonl | jq -r 'select(.entity?.type==\"Person\") | .entity.properties.name'"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/kapslap/memory-architect",
    "publisherUrl": "https://clawhub.ai/kapslap/memory-architect",
    "owner": "kapslap",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/memory-architect",
    "downloadUrl": "https://openagent3.xyz/downloads/memory-architect",
    "agentUrl": "https://openagent3.xyz/skills/memory-architect/agent",
    "manifestUrl": "https://openagent3.xyz/skills/memory-architect/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/memory-architect/agent.md"
  }
}