sysml-memnet-documentation

name	sysml-memnet-documentation
description	MemNet MCP for SysML v2 design memory and model snap: atomised graph (parts, ports, connections, behaviour, locators, rationale), mandatory pin_map before edit, delta write after validate. Also outputs/*.md and system design reports. Triggers: memnet sysml, sysml memnet, model snap, goldfish sysml, memnet outputs, design memory sysml, TSK_model, AGENT-CONTEXT memnet, sysml knowledge graph, read sysml, memnet vs sysml, avoid re-read deploy.
metadata	{"pattern":"pipeline","secondary":"tool-wrapper","domain":"sysml,memnet","version":"1.17","product":"memnet-llm==0.19.3","pairs_with":["sysml-memnet-cache","sysml-modeling-workflow","mcp-memnet","memnet-codebase-snap","sysml-view-doc-sync","mcp-sysml-v2","memnet-format","sysml-gql","memnet-nested-sessions","memnet-multitask"]}
token_guardrails	- Follow the 6-step turn sequence in references/sysml-memnet-snap.md; pin_map before substantive edits. - MUST follow references/sysml-memnet-read-policy.md: topology from warm; <=2 narrow Read windows per turn; no full deploy re-read. - MUST follow references/sysml-memnet-pipeline.md: pipeline step atoms via GQL/openCypher-shaped mutate when MemNet is up; plain Markdown when down (not TOON/TRON). - Use unified labels PRT/POR/BEH with kind prop; MUST NOT write PARTD/PORTD/BEHD/TASK aliases. - Atomise first: one fact per node/rel; short props; never store full .sysml or paragraph prose. - Copy stable ids from pin_map; refresh SYM.line after every validated edit. - satisfy/allocate -> relationships only (SATISFIES, ALLOCATES); SYM only for line locators. - AGENT-CONTEXT.md: catalog session + campaign cue only; topology/backlog live in MemNet. - Nested organisation: memnet-nested-sessions (catalog then one interior per generate). Campaign cue TSK_model_<short> stays the mission anchor. - If MemNet MCP is missing from the catalog, or serve_status false (TCP): skip MemNet read/write; plain Markdown only. - Multitask: MUST NOT in-process MCP (memnet-multitask + memnet-pi).

SysML MemNet (design memory + model snap)

Layout: SKILL.md + references (load order below).

Entry point for "use MemNet as cache": sysml-memnet-cache -- specialist sysml-* skills defer read/write there.

Durable graph memory for SysML v2 projects: symbol index with file/line locators, ports, connections, behaviour, design rationale, and documentation atoms. Complements mcp-sysml-v2 (loaded-file validation, parsing, and symbol navigation).

MemNet stores structure + atomic facts (not full prose). Do not re-read deploy*.sysml for topology when pin_map has PRT/CON -- see sysml-memnet-read-policy.md. Tools: mcp-memnet; GQL wire: memnet-format. Thin SysML bridge: sysml-gql. Nest cuts: memnet-nested-sessions.

Read policy (mandatory)

Discovery: pin_map from a cue -> PRT / CON / SYM / REQ. leftover query_warm / anchor= named leftover.
Edit: Read(path, offset=line-12, limit=35) at SYM.line only.
Forbidden per turn: full deploy read; re-grep names already in warm; multi-file read without warm miss.

Full rules: sysml-memnet-read-policy.md.

Reference load order

1. references/sysml-memnet-snap.md -- mandatory 6-step sequence, grep, delta, .snap
2. references/sysml-memnet-read-policy.md -- when to read .sysml vs warm (anti-patterns, read budget)