understand-memory-sync

name	understand-memory-sync
description	Sync knowledge graph entities to Memory MCP for cross-session codebase awareness
argument-hint	["project-path"]

/understand-memory-sync

Sync the most important entities from a project's knowledge graph to the Memory MCP server, enabling cross-session codebase recall without re-analysis.

Instructions

1. Locate the knowledge graph:

   • If $ARGUMENTS contains a path, use that as the project directory
   • Otherwise, use the current working directory
   • Read .understand-anything/knowledge-graph.json
   • If not found, tell the user to run /understand first

2. Extract key entities (top ~50-100 nodes by architectural importance):

   • All module nodes (architectural boundaries)
   • All class nodes tagged as agent, core-module, or governance
   • File nodes with >200 lines (complexity hotspots)
   • Nodes referenced in the tour steps
   • The project node itself

3. Create Memory MCP entities using mcp__memory__create_entities:

   • Entity name: {project}:{node.name} (e.g., CoreMind:CoreMind)
   • Entity type: map node type → Memory entity type (module → Architecture, class → Component, file → File, function → Function)
   • Observations: node summary, tags, layer assignment, line count, file path

4. Create Memory MCP relations using mcp__memory__create_relations:

   • For each imports edge between synced nodes → imports relation
   • For each inherits edge → extends relation
   • For each depends_on edge between modules → depends_on relation
   • For each contains edge (module → key class) → contains relation

5. Add a project-level observation via mcp__memory__add_observations:

   • Entity: CoreMind
   • Observations:
     • "Knowledge graph: {N} nodes, {M} edges, {L} layers"
     • "Analyzed at: {timestamp}, commit: {hash}"
     • "Dashboard: cd ~/Projects/understand-anything/understand-anything-plugin/packages/dashboard && GRAPH_DIR=/path/to/project npx vite --open"

6. Report what was synced:

   Synced to Memory MCP:
   - {N} entities created
   - {M} relations created
   - Key modules: {list}
   - Key components: {list}
   
   These entities are now available across sessions via mcp__memory__search_nodes.
   

When to Re-Sync

Re-sync after running /understand on new changes (incremental update). The skill should check if entities already exist and update observations rather than creating duplicates.