[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-jetbrains-mps-node-editing":3,"mdc-8sp6bw-key":35,"related-repo-jetbrains-mps-node-editing":1380,"related-org-jetbrains-mps-node-editing":1456},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":22,"repoUrl":23,"updatedAt":24,"license":25,"forks":26,"topics":27,"repo":30,"sourceUrl":33,"mdContent":34},"mps-node-editing","edit MPS nodes with JSON blueprints","Add, update, or delete MPS nodes using JSON blueprints — covers the unified blueprint format, staged construction for large subtrees, validation, and reference repair. Use whenever creating, editing, or restructuring nodes in any MPS model (structure, editor, behavior, generator, application code, etc.).",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},"jetbrains","JetBrains","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fjetbrains.png",[12,16,19],{"name":13,"slug":14,"type":15},"Architecture","architecture","tag",{"name":17,"slug":18,"type":15},"Data Modeling","data-modeling",{"name":20,"slug":21,"type":15},"Engineering","engineering",1650,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS","2026-07-20T05:57:03.594766",null,311,[28,29],"domain-specific-language","dsl",{"repoUrl":23,"stars":22,"forks":26,"topics":31,"description":32},[28,29],"JetBrains Meta programming System","https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS\u002Ftree\u002FHEAD\u002Fplugins\u002Fmcp-tools\u002Fresources\u002Fjetbrains\u002Fmps\u002Fagents\u002Fmcp\u002Fskills\u002Fmps-node-editing","---\nname: mps-node-editing\ndescription: Add, update, or delete MPS nodes using JSON blueprints — covers the unified blueprint format, staged construction for large subtrees, validation, and reference repair. Use whenever creating, editing, or restructuring nodes in any MPS model (structure, editor, behavior, generator, application code, etc.).\ntype: reference\n---\n\n# MPS Node Editing\n\nThe core workflow for mutating MPS nodes through MCP tools. JSON blueprints describe the node hierarchy you want; the tools resolve concepts, references, and used languages on insert.\n\n## Critical Directives\n\n- **Always use the fully qualified concept name** in the `concept` field — it is unambiguous and does not require a `conceptReference`.\n- **Resolve before editing** — call `mps_mcp_get_current_editor_root_node` (for the user's focus) or `mps_mcp_search_root_node_by_name` (by name) to lock onto the target. Don't guess refs.\n- **Prefer surgical edits** — `mps_mcp_update_node` (`ADD`\u002F`CHILD` or `SET`\u002F`CHILD`) preserves persistent IDs. `mps_mcp_update_root_node_from_json` rewrites the entire root and is wasteful when only one subtree changed.\n- **Don't delete-and-reinsert** to make a small change — deletion destroys persistent IDs and breaks incoming references.\n- **Cloning an existing node? Use `mps_mcp_alter_nodes` `COPY_NODE`, not a JSON blueprint.** It clones the subtree natively — correct concept, properties, refs, nested structure — as the next sibling (multi-child role) or new root, then tweak with `mps_mcp_update_node`. Reserve JSON blueprints for nodes with no close match to copy from.\n- **Validate frequently** — call `mps_mcp_check_root_node_problems` immediately after inserting or modifying a complex node. `\"ok\": true` from insert does not mean the AST is semantically valid.\n\n## `mps_mcp_update_node` — Unified Node-Mutation Tool\n\nAll child, property, and reference operations on existing nodes go through `mps_mcp_update_node`. The operation is selected via `operation` (`ADD`\u002F`SET`\u002F`DELETE`) × `kind` (`CHILD`\u002F`PROPERTY`\u002F`REFERENCE`).\n\n| operation × kind        | Required parameters                                           | Notes |\n|-------------------------|---------------------------------------------------------------|-------|\n| `ADD` × `CHILD`         | `nodeReference` (parent), `childRole`, `childJson`            | Optional `position` (0-based; null\u002F-1 = append) and `dryRun`. A `position` ≥ the current child count clamps to an append; a negative value other than -1 is rejected. The response's `data.index` reports the actual landing index. |\n| `SET` × `CHILD`         | `childNodeRef`, `childJson`                                   | Replaces an existing child; preserves its position in the role. Optional `dryRun`. |\n| `DELETE` × `CHILD`      | `childNodeRef`                                                | Removes the child from its parent. |\n| `SET` × `PROPERTY`      | `properties` = `[[nodeRef, propertyName, value], …]`          | Batch operation; returns per-row results. |\n| `DELETE` × `PROPERTY`   | `nodeReference`, `propertyName`                               | Clears a single property. |\n| `SET` × `REFERENCE`     | `references` = `[[nodeRef, role, targetRefOrName], …]`        | Batch operation; `targetRefOrName` accepts an `r:...` ref or a plain name. A plain name is resolved within the reference role's search scope; if it cannot be resolved the call fails (`NOT_FOUND`), preserves the previous reference value, and stores no dangling reference. |\n| `DELETE` × `REFERENCE`  | `nodeReference`, `referenceRole`                              | Clears a single reference. |\n\n`ADD` × `PROPERTY` and `ADD` × `REFERENCE` are not valid combinations and return an error envelope.\n\n`mps_mcp_update_node` (PROPERTY \u002F REFERENCE \u002F CHILD) and `mps_mcp_alter_nodes` MOVE_CHILD \u002F MOVE_NODE_TO_PARENT \u002F COPY_NODE also work on nodes inside the **current MPS Console input command** — pass the node's normal persistent reference; no extra parameter is needed. The node must be inside the current unexecuted console input (not history\u002Fstale). MOVE_NODE_TO_PARENT only relocates a node *within* the current console command — moving a node between the console and a project model, or making a console node a root, is refused. Edits to console nodes skip disk-persistence and refresh the console's imports instead. Nodes outside the selected project are rejected as before.\n\n`childJson` accepts either an inline JSON string (max 4 KB) **or** an absolute path to a file containing the JSON blueprint. Use the file form for large blueprints to avoid MCP-transport truncation.\n\n## Prerequisites\n\n- Load the `mps-language-analysis` skill if you do not yet know what concepts the model uses.\n- Resolve the target node (unless creating a brand-new root):\n    - `mps_mcp_get_current_editor_root_node` for the user's focus.\n    - `mps_mcp_search_root_node_by_name` for a known name.\n- Resolve required languages and concepts:\n    - Check used languages of the current model via `mps_mcp_get_project_structure`.\n    - Get concept details using `mps_mcp_get_concept_details` for specific languages.\n    - Use `mps_mcp_search_concepts` for discovery.\n\n## Common Workflow\n\n1. **Identify** the target node (existing) or parent model (new root).\n2. **Choose the right tool**: `mps_mcp_create_root_node` \u002F `mps_mcp_insert_root_node_from_json` for new roots; `mps_mcp_update_node` (`ADD`\u002F`SET`\u002F`DELETE` × `CHILD`\u002F`PROPERTY`\u002F`REFERENCE`) for surgical edits; `mps_mcp_update_root_node_from_json` only for full-root rewrites.\n3. **Author the JSON** following the unified blueprint format.\n4. **Insert** with `dryRun: true` first if the blueprint is large. Check the response: an empty `warnings` array means staging was clean; a non-empty list means the production write will produce dynamic (unresolved) references for the listed targets — resolve those first or expect broken refs.\n5. **Validate** with `mps_mcp_check_root_node_problems`. Reported problems may carry a `quickFixes` array; apply one with `mps_mcp_apply_intention`, or pass `autoApplyQuickFixes=true` for one-shot repair of the auto-applicable ones.\n6. **Repair** broken refs with `mps_mcp_alter_nodes FIX_REFERENCES` if validation surfaces resolvable-but-unresolved targets.\n\n## Related Skills\n\n- **`mps-aspect-structure-concepts`** — defines what concepts exist and what roles they expose.\n- **`mps-baselanguage`** — when the nodes you edit are BaseLanguage \u002F Java.\n- **`mps-quotations`** — embedding inline node literals inside model code.\n- **`mps-language-analysis`** — exploring an unfamiliar language before editing.\n- **`mps-model-manipulation`** — when the edit also requires navigating the tree from model code (`.ancestor\u003CC>`, `.descendants\u003CC>`, siblings, containingRoot).\n\n## JSON Input — File-Path Semantics\n\nThe tools that accept a node JSON blueprint (`mps_mcp_update_node` for `ADD`\u002F`SET` × `CHILD`, `mps_mcp_insert_root_node_from_json`, `mps_mcp_update_root_node_from_json`) all use the same `childJson` \u002F `json` parameter convention:\n\n- The parameter can be **either** a JSON string (max 4 KB) **or** an absolute path to a local file containing the JSON.\n- Files may contain either a **raw node blueprint** or the **full MCP response envelope** produced by `mps_mcp_print_node`; in the latter case the `data` field is used.\n- **Ordinary input files are never deleted.** Only temporary JSON files created by this toolset may be cleaned up after reading (and only when `dryRun=false`).\n- Very large JSON inputs may be truncated by the MCP transport before the tool reads them. If that happens, insert a smaller blueprint first and add children in follow-up calls with `mps_mcp_update_node` (`ADD`\u002F`CHILD` or `SET`\u002F`CHILD`), or pass the JSON as a file path instead of an inline string. See `references\u002Fstaged-construction.md` for the recommended pattern.\n\n## Reference Index\n\n- Open `references\u002Fjson-format.md` when you need the unified JSON blueprint shape — concept\u002Fproperties\u002Fchildren\u002Freferences layout, optional-section rules, and reference-resolution semantics (`r:...` vs name auto-resolution).\n- Open `references\u002Fstaged-construction.md` when the subtree is large (>~4 KB) or its child refs are needed for later edits — the skeleton → validate → incremental-fill → targeted-update → cleanup pattern.\n- Open `references\u002Ftroubleshooting.md` when an insert call fails with `JsonElement.getAsString()` errors or when the JSON shape diverges from the user's textual notation.\n",{"data":36,"body":38},{"name":4,"description":6,"type":37},"reference",{"type":39,"children":40},"root",[41,49,55,62,245,256,323,683,712,744,761,767,857,863,1047,1053,1140,1146,1203,1320,1326],{"type":42,"tag":43,"props":44,"children":45},"element","h1",{"id":4},[46],{"type":47,"value":48},"text","MPS Node Editing",{"type":42,"tag":50,"props":51,"children":52},"p",{},[53],{"type":47,"value":54},"The core workflow for mutating MPS nodes through MCP tools. JSON blueprints describe the node hierarchy you want; the tools resolve concepts, references, and used languages on insert.",{"type":42,"tag":56,"props":57,"children":59},"h2",{"id":58},"critical-directives",[60],{"type":47,"value":61},"Critical Directives",{"type":42,"tag":63,"props":64,"children":65},"ul",{},[66,95,121,177,187,220],{"type":42,"tag":67,"props":68,"children":69},"li",{},[70,76,78,85,87,93],{"type":42,"tag":71,"props":72,"children":73},"strong",{},[74],{"type":47,"value":75},"Always use the fully qualified concept name",{"type":47,"value":77}," in the ",{"type":42,"tag":79,"props":80,"children":82},"code",{"className":81},[],[83],{"type":47,"value":84},"concept",{"type":47,"value":86}," field — it is unambiguous and does not require a ",{"type":42,"tag":79,"props":88,"children":90},{"className":89},[],[91],{"type":47,"value":92},"conceptReference",{"type":47,"value":94},".",{"type":42,"tag":67,"props":96,"children":97},{},[98,103,105,111,113,119],{"type":42,"tag":71,"props":99,"children":100},{},[101],{"type":47,"value":102},"Resolve before editing",{"type":47,"value":104}," — call ",{"type":42,"tag":79,"props":106,"children":108},{"className":107},[],[109],{"type":47,"value":110},"mps_mcp_get_current_editor_root_node",{"type":47,"value":112}," (for the user's focus) or ",{"type":42,"tag":79,"props":114,"children":116},{"className":115},[],[117],{"type":47,"value":118},"mps_mcp_search_root_node_by_name",{"type":47,"value":120}," (by name) to lock onto the target. Don't guess refs.",{"type":42,"tag":67,"props":122,"children":123},{},[124,129,131,137,139,145,147,153,155,161,162,167,169,175],{"type":42,"tag":71,"props":125,"children":126},{},[127],{"type":47,"value":128},"Prefer surgical edits",{"type":47,"value":130}," — ",{"type":42,"tag":79,"props":132,"children":134},{"className":133},[],[135],{"type":47,"value":136},"mps_mcp_update_node",{"type":47,"value":138}," (",{"type":42,"tag":79,"props":140,"children":142},{"className":141},[],[143],{"type":47,"value":144},"ADD",{"type":47,"value":146},"\u002F",{"type":42,"tag":79,"props":148,"children":150},{"className":149},[],[151],{"type":47,"value":152},"CHILD",{"type":47,"value":154}," or ",{"type":42,"tag":79,"props":156,"children":158},{"className":157},[],[159],{"type":47,"value":160},"SET",{"type":47,"value":146},{"type":42,"tag":79,"props":163,"children":165},{"className":164},[],[166],{"type":47,"value":152},{"type":47,"value":168},") preserves persistent IDs. ",{"type":42,"tag":79,"props":170,"children":172},{"className":171},[],[173],{"type":47,"value":174},"mps_mcp_update_root_node_from_json",{"type":47,"value":176}," rewrites the entire root and is wasteful when only one subtree changed.",{"type":42,"tag":67,"props":178,"children":179},{},[180,185],{"type":42,"tag":71,"props":181,"children":182},{},[183],{"type":47,"value":184},"Don't delete-and-reinsert",{"type":47,"value":186}," to make a small change — deletion destroys persistent IDs and breaks incoming references.",{"type":42,"tag":67,"props":188,"children":189},{},[190,211,213,218],{"type":42,"tag":71,"props":191,"children":192},{},[193,195,201,203,209],{"type":47,"value":194},"Cloning an existing node? Use ",{"type":42,"tag":79,"props":196,"children":198},{"className":197},[],[199],{"type":47,"value":200},"mps_mcp_alter_nodes",{"type":47,"value":202}," ",{"type":42,"tag":79,"props":204,"children":206},{"className":205},[],[207],{"type":47,"value":208},"COPY_NODE",{"type":47,"value":210},", not a JSON blueprint.",{"type":47,"value":212}," It clones the subtree natively — correct concept, properties, refs, nested structure — as the next sibling (multi-child role) or new root, then tweak with ",{"type":42,"tag":79,"props":214,"children":216},{"className":215},[],[217],{"type":47,"value":136},{"type":47,"value":219},". Reserve JSON blueprints for nodes with no close match to copy from.",{"type":42,"tag":67,"props":221,"children":222},{},[223,228,229,235,237,243],{"type":42,"tag":71,"props":224,"children":225},{},[226],{"type":47,"value":227},"Validate frequently",{"type":47,"value":104},{"type":42,"tag":79,"props":230,"children":232},{"className":231},[],[233],{"type":47,"value":234},"mps_mcp_check_root_node_problems",{"type":47,"value":236}," immediately after inserting or modifying a complex node. ",{"type":42,"tag":79,"props":238,"children":240},{"className":239},[],[241],{"type":47,"value":242},"\"ok\": true",{"type":47,"value":244}," from insert does not mean the AST is semantically valid.",{"type":42,"tag":56,"props":246,"children":248},{"id":247},"mps_mcp_update_node-unified-node-mutation-tool",[249,254],{"type":42,"tag":79,"props":250,"children":252},{"className":251},[],[253],{"type":47,"value":136},{"type":47,"value":255}," — Unified Node-Mutation Tool",{"type":42,"tag":50,"props":257,"children":258},{},[259,261,266,268,274,275,280,281,286,287,293,295,301,302,307,308,314,315,321],{"type":47,"value":260},"All child, property, and reference operations on existing nodes go through ",{"type":42,"tag":79,"props":262,"children":264},{"className":263},[],[265],{"type":47,"value":136},{"type":47,"value":267},". The operation is selected via ",{"type":42,"tag":79,"props":269,"children":271},{"className":270},[],[272],{"type":47,"value":273},"operation",{"type":47,"value":138},{"type":42,"tag":79,"props":276,"children":278},{"className":277},[],[279],{"type":47,"value":144},{"type":47,"value":146},{"type":42,"tag":79,"props":282,"children":284},{"className":283},[],[285],{"type":47,"value":160},{"type":47,"value":146},{"type":42,"tag":79,"props":288,"children":290},{"className":289},[],[291],{"type":47,"value":292},"DELETE",{"type":47,"value":294},") × ",{"type":42,"tag":79,"props":296,"children":298},{"className":297},[],[299],{"type":47,"value":300},"kind",{"type":47,"value":138},{"type":42,"tag":79,"props":303,"children":305},{"className":304},[],[306],{"type":47,"value":152},{"type":47,"value":146},{"type":42,"tag":79,"props":309,"children":311},{"className":310},[],[312],{"type":47,"value":313},"PROPERTY",{"type":47,"value":146},{"type":42,"tag":79,"props":316,"children":318},{"className":317},[],[319],{"type":47,"value":320},"REFERENCE",{"type":47,"value":322},").",{"type":42,"tag":324,"props":325,"children":326},"table",{},[327,351],{"type":42,"tag":328,"props":329,"children":330},"thead",{},[331],{"type":42,"tag":332,"props":333,"children":334},"tr",{},[335,341,346],{"type":42,"tag":336,"props":337,"children":338},"th",{},[339],{"type":47,"value":340},"operation × kind",{"type":42,"tag":336,"props":342,"children":343},{},[344],{"type":47,"value":345},"Required parameters",{"type":42,"tag":336,"props":347,"children":348},{},[349],{"type":47,"value":350},"Notes",{"type":42,"tag":352,"props":353,"children":354},"tbody",{},[355,435,478,508,547,584,646],{"type":42,"tag":332,"props":356,"children":357},{},[358,374,399],{"type":42,"tag":359,"props":360,"children":361},"td",{},[362,367,369],{"type":42,"tag":79,"props":363,"children":365},{"className":364},[],[366],{"type":47,"value":144},{"type":47,"value":368}," × ",{"type":42,"tag":79,"props":370,"children":372},{"className":371},[],[373],{"type":47,"value":152},{"type":42,"tag":359,"props":375,"children":376},{},[377,383,385,391,393],{"type":42,"tag":79,"props":378,"children":380},{"className":379},[],[381],{"type":47,"value":382},"nodeReference",{"type":47,"value":384}," (parent), ",{"type":42,"tag":79,"props":386,"children":388},{"className":387},[],[389],{"type":47,"value":390},"childRole",{"type":47,"value":392},", ",{"type":42,"tag":79,"props":394,"children":396},{"className":395},[],[397],{"type":47,"value":398},"childJson",{"type":42,"tag":359,"props":400,"children":401},{},[402,404,410,412,418,420,425,427,433],{"type":47,"value":403},"Optional ",{"type":42,"tag":79,"props":405,"children":407},{"className":406},[],[408],{"type":47,"value":409},"position",{"type":47,"value":411}," (0-based; null\u002F-1 = append) and ",{"type":42,"tag":79,"props":413,"children":415},{"className":414},[],[416],{"type":47,"value":417},"dryRun",{"type":47,"value":419},". A ",{"type":42,"tag":79,"props":421,"children":423},{"className":422},[],[424],{"type":47,"value":409},{"type":47,"value":426}," ≥ the current child count clamps to an append; a negative value other than -1 is rejected. The response's ",{"type":42,"tag":79,"props":428,"children":430},{"className":429},[],[431],{"type":47,"value":432},"data.index",{"type":47,"value":434}," reports the actual landing index.",{"type":42,"tag":332,"props":436,"children":437},{},[438,452,467],{"type":42,"tag":359,"props":439,"children":440},{},[441,446,447],{"type":42,"tag":79,"props":442,"children":444},{"className":443},[],[445],{"type":47,"value":160},{"type":47,"value":368},{"type":42,"tag":79,"props":448,"children":450},{"className":449},[],[451],{"type":47,"value":152},{"type":42,"tag":359,"props":453,"children":454},{},[455,461,462],{"type":42,"tag":79,"props":456,"children":458},{"className":457},[],[459],{"type":47,"value":460},"childNodeRef",{"type":47,"value":392},{"type":42,"tag":79,"props":463,"children":465},{"className":464},[],[466],{"type":47,"value":398},{"type":42,"tag":359,"props":468,"children":469},{},[470,472,477],{"type":47,"value":471},"Replaces an existing child; preserves its position in the role. Optional ",{"type":42,"tag":79,"props":473,"children":475},{"className":474},[],[476],{"type":47,"value":417},{"type":47,"value":94},{"type":42,"tag":332,"props":479,"children":480},{},[481,495,503],{"type":42,"tag":359,"props":482,"children":483},{},[484,489,490],{"type":42,"tag":79,"props":485,"children":487},{"className":486},[],[488],{"type":47,"value":292},{"type":47,"value":368},{"type":42,"tag":79,"props":491,"children":493},{"className":492},[],[494],{"type":47,"value":152},{"type":42,"tag":359,"props":496,"children":497},{},[498],{"type":42,"tag":79,"props":499,"children":501},{"className":500},[],[502],{"type":47,"value":460},{"type":42,"tag":359,"props":504,"children":505},{},[506],{"type":47,"value":507},"Removes the child from its parent.",{"type":42,"tag":332,"props":509,"children":510},{},[511,525,542],{"type":42,"tag":359,"props":512,"children":513},{},[514,519,520],{"type":42,"tag":79,"props":515,"children":517},{"className":516},[],[518],{"type":47,"value":160},{"type":47,"value":368},{"type":42,"tag":79,"props":521,"children":523},{"className":522},[],[524],{"type":47,"value":313},{"type":42,"tag":359,"props":526,"children":527},{},[528,534,536],{"type":42,"tag":79,"props":529,"children":531},{"className":530},[],[532],{"type":47,"value":533},"properties",{"type":47,"value":535}," = ",{"type":42,"tag":79,"props":537,"children":539},{"className":538},[],[540],{"type":47,"value":541},"[[nodeRef, propertyName, value], …]",{"type":42,"tag":359,"props":543,"children":544},{},[545],{"type":47,"value":546},"Batch operation; returns per-row results.",{"type":42,"tag":332,"props":548,"children":549},{},[550,564,579],{"type":42,"tag":359,"props":551,"children":552},{},[553,558,559],{"type":42,"tag":79,"props":554,"children":556},{"className":555},[],[557],{"type":47,"value":292},{"type":47,"value":368},{"type":42,"tag":79,"props":560,"children":562},{"className":561},[],[563],{"type":47,"value":313},{"type":42,"tag":359,"props":565,"children":566},{},[567,572,573],{"type":42,"tag":79,"props":568,"children":570},{"className":569},[],[571],{"type":47,"value":382},{"type":47,"value":392},{"type":42,"tag":79,"props":574,"children":576},{"className":575},[],[577],{"type":47,"value":578},"propertyName",{"type":42,"tag":359,"props":580,"children":581},{},[582],{"type":47,"value":583},"Clears a single property.",{"type":42,"tag":332,"props":585,"children":586},{},[587,601,617],{"type":42,"tag":359,"props":588,"children":589},{},[590,595,596],{"type":42,"tag":79,"props":591,"children":593},{"className":592},[],[594],{"type":47,"value":160},{"type":47,"value":368},{"type":42,"tag":79,"props":597,"children":599},{"className":598},[],[600],{"type":47,"value":320},{"type":42,"tag":359,"props":602,"children":603},{},[604,610,611],{"type":42,"tag":79,"props":605,"children":607},{"className":606},[],[608],{"type":47,"value":609},"references",{"type":47,"value":535},{"type":42,"tag":79,"props":612,"children":614},{"className":613},[],[615],{"type":47,"value":616},"[[nodeRef, role, targetRefOrName], …]",{"type":42,"tag":359,"props":618,"children":619},{},[620,622,628,630,636,638,644],{"type":47,"value":621},"Batch operation; ",{"type":42,"tag":79,"props":623,"children":625},{"className":624},[],[626],{"type":47,"value":627},"targetRefOrName",{"type":47,"value":629}," accepts an ",{"type":42,"tag":79,"props":631,"children":633},{"className":632},[],[634],{"type":47,"value":635},"r:...",{"type":47,"value":637}," ref or a plain name. A plain name is resolved within the reference role's search scope; if it cannot be resolved the call fails (",{"type":42,"tag":79,"props":639,"children":641},{"className":640},[],[642],{"type":47,"value":643},"NOT_FOUND",{"type":47,"value":645},"), preserves the previous reference value, and stores no dangling reference.",{"type":42,"tag":332,"props":647,"children":648},{},[649,663,678],{"type":42,"tag":359,"props":650,"children":651},{},[652,657,658],{"type":42,"tag":79,"props":653,"children":655},{"className":654},[],[656],{"type":47,"value":292},{"type":47,"value":368},{"type":42,"tag":79,"props":659,"children":661},{"className":660},[],[662],{"type":47,"value":320},{"type":42,"tag":359,"props":664,"children":665},{},[666,671,672],{"type":42,"tag":79,"props":667,"children":669},{"className":668},[],[670],{"type":47,"value":382},{"type":47,"value":392},{"type":42,"tag":79,"props":673,"children":675},{"className":674},[],[676],{"type":47,"value":677},"referenceRole",{"type":42,"tag":359,"props":679,"children":680},{},[681],{"type":47,"value":682},"Clears a single reference.",{"type":42,"tag":50,"props":684,"children":685},{},[686,691,692,697,699,704,705,710],{"type":42,"tag":79,"props":687,"children":689},{"className":688},[],[690],{"type":47,"value":144},{"type":47,"value":368},{"type":42,"tag":79,"props":693,"children":695},{"className":694},[],[696],{"type":47,"value":313},{"type":47,"value":698}," and ",{"type":42,"tag":79,"props":700,"children":702},{"className":701},[],[703],{"type":47,"value":144},{"type":47,"value":368},{"type":42,"tag":79,"props":706,"children":708},{"className":707},[],[709],{"type":47,"value":320},{"type":47,"value":711}," are not valid combinations and return an error envelope.",{"type":42,"tag":50,"props":713,"children":714},{},[715,720,722,727,729,734,736,742],{"type":42,"tag":79,"props":716,"children":718},{"className":717},[],[719],{"type":47,"value":136},{"type":47,"value":721}," (PROPERTY \u002F REFERENCE \u002F CHILD) and ",{"type":42,"tag":79,"props":723,"children":725},{"className":724},[],[726],{"type":47,"value":200},{"type":47,"value":728}," MOVE_CHILD \u002F MOVE_NODE_TO_PARENT \u002F COPY_NODE also work on nodes inside the ",{"type":42,"tag":71,"props":730,"children":731},{},[732],{"type":47,"value":733},"current MPS Console input command",{"type":47,"value":735}," — pass the node's normal persistent reference; no extra parameter is needed. The node must be inside the current unexecuted console input (not history\u002Fstale). MOVE_NODE_TO_PARENT only relocates a node ",{"type":42,"tag":737,"props":738,"children":739},"em",{},[740],{"type":47,"value":741},"within",{"type":47,"value":743}," the current console command — moving a node between the console and a project model, or making a console node a root, is refused. Edits to console nodes skip disk-persistence and refresh the console's imports instead. Nodes outside the selected project are rejected as before.",{"type":42,"tag":50,"props":745,"children":746},{},[747,752,754,759],{"type":42,"tag":79,"props":748,"children":750},{"className":749},[],[751],{"type":47,"value":398},{"type":47,"value":753}," accepts either an inline JSON string (max 4 KB) ",{"type":42,"tag":71,"props":755,"children":756},{},[757],{"type":47,"value":758},"or",{"type":47,"value":760}," an absolute path to a file containing the JSON blueprint. Use the file form for large blueprints to avoid MCP-transport truncation.",{"type":42,"tag":56,"props":762,"children":764},{"id":763},"prerequisites",[765],{"type":47,"value":766},"Prerequisites",{"type":42,"tag":63,"props":768,"children":769},{},[770,783,811],{"type":42,"tag":67,"props":771,"children":772},{},[773,775,781],{"type":47,"value":774},"Load the ",{"type":42,"tag":79,"props":776,"children":778},{"className":777},[],[779],{"type":47,"value":780},"mps-language-analysis",{"type":47,"value":782}," skill if you do not yet know what concepts the model uses.",{"type":42,"tag":67,"props":784,"children":785},{},[786,788],{"type":47,"value":787},"Resolve the target node (unless creating a brand-new root):\n",{"type":42,"tag":63,"props":789,"children":790},{},[791,801],{"type":42,"tag":67,"props":792,"children":793},{},[794,799],{"type":42,"tag":79,"props":795,"children":797},{"className":796},[],[798],{"type":47,"value":110},{"type":47,"value":800}," for the user's focus.",{"type":42,"tag":67,"props":802,"children":803},{},[804,809],{"type":42,"tag":79,"props":805,"children":807},{"className":806},[],[808],{"type":47,"value":118},{"type":47,"value":810}," for a known name.",{"type":42,"tag":67,"props":812,"children":813},{},[814,816],{"type":47,"value":815},"Resolve required languages and concepts:\n",{"type":42,"tag":63,"props":817,"children":818},{},[819,831,844],{"type":42,"tag":67,"props":820,"children":821},{},[822,824,830],{"type":47,"value":823},"Check used languages of the current model via ",{"type":42,"tag":79,"props":825,"children":827},{"className":826},[],[828],{"type":47,"value":829},"mps_mcp_get_project_structure",{"type":47,"value":94},{"type":42,"tag":67,"props":832,"children":833},{},[834,836,842],{"type":47,"value":835},"Get concept details using ",{"type":42,"tag":79,"props":837,"children":839},{"className":838},[],[840],{"type":47,"value":841},"mps_mcp_get_concept_details",{"type":47,"value":843}," for specific languages.",{"type":42,"tag":67,"props":845,"children":846},{},[847,849,855],{"type":47,"value":848},"Use ",{"type":42,"tag":79,"props":850,"children":852},{"className":851},[],[853],{"type":47,"value":854},"mps_mcp_search_concepts",{"type":47,"value":856}," for discovery.",{"type":42,"tag":56,"props":858,"children":860},{"id":859},"common-workflow",[861],{"type":47,"value":862},"Common Workflow",{"type":42,"tag":864,"props":865,"children":866},"ol",{},[867,877,953,963,989,1029],{"type":42,"tag":67,"props":868,"children":869},{},[870,875],{"type":42,"tag":71,"props":871,"children":872},{},[873],{"type":47,"value":874},"Identify",{"type":47,"value":876}," the target node (existing) or parent model (new root).",{"type":42,"tag":67,"props":878,"children":879},{},[880,885,887,893,895,901,903,908,909,914,915,920,921,926,927,932,933,938,939,944,946,951],{"type":42,"tag":71,"props":881,"children":882},{},[883],{"type":47,"value":884},"Choose the right tool",{"type":47,"value":886},": ",{"type":42,"tag":79,"props":888,"children":890},{"className":889},[],[891],{"type":47,"value":892},"mps_mcp_create_root_node",{"type":47,"value":894}," \u002F ",{"type":42,"tag":79,"props":896,"children":898},{"className":897},[],[899],{"type":47,"value":900},"mps_mcp_insert_root_node_from_json",{"type":47,"value":902}," for new roots; ",{"type":42,"tag":79,"props":904,"children":906},{"className":905},[],[907],{"type":47,"value":136},{"type":47,"value":138},{"type":42,"tag":79,"props":910,"children":912},{"className":911},[],[913],{"type":47,"value":144},{"type":47,"value":146},{"type":42,"tag":79,"props":916,"children":918},{"className":917},[],[919],{"type":47,"value":160},{"type":47,"value":146},{"type":42,"tag":79,"props":922,"children":924},{"className":923},[],[925],{"type":47,"value":292},{"type":47,"value":368},{"type":42,"tag":79,"props":928,"children":930},{"className":929},[],[931],{"type":47,"value":152},{"type":47,"value":146},{"type":42,"tag":79,"props":934,"children":936},{"className":935},[],[937],{"type":47,"value":313},{"type":47,"value":146},{"type":42,"tag":79,"props":940,"children":942},{"className":941},[],[943],{"type":47,"value":320},{"type":47,"value":945},") for surgical edits; ",{"type":42,"tag":79,"props":947,"children":949},{"className":948},[],[950],{"type":47,"value":174},{"type":47,"value":952}," only for full-root rewrites.",{"type":42,"tag":67,"props":954,"children":955},{},[956,961],{"type":42,"tag":71,"props":957,"children":958},{},[959],{"type":47,"value":960},"Author the JSON",{"type":47,"value":962}," following the unified blueprint format.",{"type":42,"tag":67,"props":964,"children":965},{},[966,971,973,979,981,987],{"type":42,"tag":71,"props":967,"children":968},{},[969],{"type":47,"value":970},"Insert",{"type":47,"value":972}," with ",{"type":42,"tag":79,"props":974,"children":976},{"className":975},[],[977],{"type":47,"value":978},"dryRun: true",{"type":47,"value":980}," first if the blueprint is large. Check the response: an empty ",{"type":42,"tag":79,"props":982,"children":984},{"className":983},[],[985],{"type":47,"value":986},"warnings",{"type":47,"value":988}," array means staging was clean; a non-empty list means the production write will produce dynamic (unresolved) references for the listed targets — resolve those first or expect broken refs.",{"type":42,"tag":67,"props":990,"children":991},{},[992,997,998,1003,1005,1011,1013,1019,1021,1027],{"type":42,"tag":71,"props":993,"children":994},{},[995],{"type":47,"value":996},"Validate",{"type":47,"value":972},{"type":42,"tag":79,"props":999,"children":1001},{"className":1000},[],[1002],{"type":47,"value":234},{"type":47,"value":1004},". Reported problems may carry a ",{"type":42,"tag":79,"props":1006,"children":1008},{"className":1007},[],[1009],{"type":47,"value":1010},"quickFixes",{"type":47,"value":1012}," array; apply one with ",{"type":42,"tag":79,"props":1014,"children":1016},{"className":1015},[],[1017],{"type":47,"value":1018},"mps_mcp_apply_intention",{"type":47,"value":1020},", or pass ",{"type":42,"tag":79,"props":1022,"children":1024},{"className":1023},[],[1025],{"type":47,"value":1026},"autoApplyQuickFixes=true",{"type":47,"value":1028}," for one-shot repair of the auto-applicable ones.",{"type":42,"tag":67,"props":1030,"children":1031},{},[1032,1037,1039,1045],{"type":42,"tag":71,"props":1033,"children":1034},{},[1035],{"type":47,"value":1036},"Repair",{"type":47,"value":1038}," broken refs with ",{"type":42,"tag":79,"props":1040,"children":1042},{"className":1041},[],[1043],{"type":47,"value":1044},"mps_mcp_alter_nodes FIX_REFERENCES",{"type":47,"value":1046}," if validation surfaces resolvable-but-unresolved targets.",{"type":42,"tag":56,"props":1048,"children":1050},{"id":1049},"related-skills",[1051],{"type":47,"value":1052},"Related Skills",{"type":42,"tag":63,"props":1054,"children":1055},{},[1056,1070,1084,1098,1111],{"type":42,"tag":67,"props":1057,"children":1058},{},[1059,1068],{"type":42,"tag":71,"props":1060,"children":1061},{},[1062],{"type":42,"tag":79,"props":1063,"children":1065},{"className":1064},[],[1066],{"type":47,"value":1067},"mps-aspect-structure-concepts",{"type":47,"value":1069}," — defines what concepts exist and what roles they expose.",{"type":42,"tag":67,"props":1071,"children":1072},{},[1073,1082],{"type":42,"tag":71,"props":1074,"children":1075},{},[1076],{"type":42,"tag":79,"props":1077,"children":1079},{"className":1078},[],[1080],{"type":47,"value":1081},"mps-baselanguage",{"type":47,"value":1083}," — when the nodes you edit are BaseLanguage \u002F Java.",{"type":42,"tag":67,"props":1085,"children":1086},{},[1087,1096],{"type":42,"tag":71,"props":1088,"children":1089},{},[1090],{"type":42,"tag":79,"props":1091,"children":1093},{"className":1092},[],[1094],{"type":47,"value":1095},"mps-quotations",{"type":47,"value":1097}," — embedding inline node literals inside model code.",{"type":42,"tag":67,"props":1099,"children":1100},{},[1101,1109],{"type":42,"tag":71,"props":1102,"children":1103},{},[1104],{"type":42,"tag":79,"props":1105,"children":1107},{"className":1106},[],[1108],{"type":47,"value":780},{"type":47,"value":1110}," — exploring an unfamiliar language before editing.",{"type":42,"tag":67,"props":1112,"children":1113},{},[1114,1123,1125,1131,1132,1138],{"type":42,"tag":71,"props":1115,"children":1116},{},[1117],{"type":42,"tag":79,"props":1118,"children":1120},{"className":1119},[],[1121],{"type":47,"value":1122},"mps-model-manipulation",{"type":47,"value":1124}," — when the edit also requires navigating the tree from model code (",{"type":42,"tag":79,"props":1126,"children":1128},{"className":1127},[],[1129],{"type":47,"value":1130},".ancestor\u003CC>",{"type":47,"value":392},{"type":42,"tag":79,"props":1133,"children":1135},{"className":1134},[],[1136],{"type":47,"value":1137},".descendants\u003CC>",{"type":47,"value":1139},", siblings, containingRoot).",{"type":42,"tag":56,"props":1141,"children":1143},{"id":1142},"json-input-file-path-semantics",[1144],{"type":47,"value":1145},"JSON Input — File-Path Semantics",{"type":42,"tag":50,"props":1147,"children":1148},{},[1149,1151,1156,1158,1163,1164,1169,1170,1175,1176,1181,1182,1187,1189,1194,1195,1201],{"type":47,"value":1150},"The tools that accept a node JSON blueprint (",{"type":42,"tag":79,"props":1152,"children":1154},{"className":1153},[],[1155],{"type":47,"value":136},{"type":47,"value":1157}," for ",{"type":42,"tag":79,"props":1159,"children":1161},{"className":1160},[],[1162],{"type":47,"value":144},{"type":47,"value":146},{"type":42,"tag":79,"props":1165,"children":1167},{"className":1166},[],[1168],{"type":47,"value":160},{"type":47,"value":368},{"type":42,"tag":79,"props":1171,"children":1173},{"className":1172},[],[1174],{"type":47,"value":152},{"type":47,"value":392},{"type":42,"tag":79,"props":1177,"children":1179},{"className":1178},[],[1180],{"type":47,"value":900},{"type":47,"value":392},{"type":42,"tag":79,"props":1183,"children":1185},{"className":1184},[],[1186],{"type":47,"value":174},{"type":47,"value":1188},") all use the same ",{"type":42,"tag":79,"props":1190,"children":1192},{"className":1191},[],[1193],{"type":47,"value":398},{"type":47,"value":894},{"type":42,"tag":79,"props":1196,"children":1198},{"className":1197},[],[1199],{"type":47,"value":1200},"json",{"type":47,"value":1202}," parameter convention:",{"type":42,"tag":63,"props":1204,"children":1205},{},[1206,1224,1259,1276],{"type":42,"tag":67,"props":1207,"children":1208},{},[1209,1211,1216,1218,1222],{"type":47,"value":1210},"The parameter can be ",{"type":42,"tag":71,"props":1212,"children":1213},{},[1214],{"type":47,"value":1215},"either",{"type":47,"value":1217}," a JSON string (max 4 KB) ",{"type":42,"tag":71,"props":1219,"children":1220},{},[1221],{"type":47,"value":758},{"type":47,"value":1223}," an absolute path to a local file containing the JSON.",{"type":42,"tag":67,"props":1225,"children":1226},{},[1227,1229,1234,1236,1241,1243,1249,1251,1257],{"type":47,"value":1228},"Files may contain either a ",{"type":42,"tag":71,"props":1230,"children":1231},{},[1232],{"type":47,"value":1233},"raw node blueprint",{"type":47,"value":1235}," or the ",{"type":42,"tag":71,"props":1237,"children":1238},{},[1239],{"type":47,"value":1240},"full MCP response envelope",{"type":47,"value":1242}," produced by ",{"type":42,"tag":79,"props":1244,"children":1246},{"className":1245},[],[1247],{"type":47,"value":1248},"mps_mcp_print_node",{"type":47,"value":1250},"; in the latter case the ",{"type":42,"tag":79,"props":1252,"children":1254},{"className":1253},[],[1255],{"type":47,"value":1256},"data",{"type":47,"value":1258}," field is used.",{"type":42,"tag":67,"props":1260,"children":1261},{},[1262,1267,1269,1275],{"type":42,"tag":71,"props":1263,"children":1264},{},[1265],{"type":47,"value":1266},"Ordinary input files are never deleted.",{"type":47,"value":1268}," Only temporary JSON files created by this toolset may be cleaned up after reading (and only when ",{"type":42,"tag":79,"props":1270,"children":1272},{"className":1271},[],[1273],{"type":47,"value":1274},"dryRun=false",{"type":47,"value":322},{"type":42,"tag":67,"props":1277,"children":1278},{},[1279,1281,1286,1287,1292,1293,1298,1299,1304,1305,1310,1312,1318],{"type":47,"value":1280},"Very large JSON inputs may be truncated by the MCP transport before the tool reads them. If that happens, insert a smaller blueprint first and add children in follow-up calls with ",{"type":42,"tag":79,"props":1282,"children":1284},{"className":1283},[],[1285],{"type":47,"value":136},{"type":47,"value":138},{"type":42,"tag":79,"props":1288,"children":1290},{"className":1289},[],[1291],{"type":47,"value":144},{"type":47,"value":146},{"type":42,"tag":79,"props":1294,"children":1296},{"className":1295},[],[1297],{"type":47,"value":152},{"type":47,"value":154},{"type":42,"tag":79,"props":1300,"children":1302},{"className":1301},[],[1303],{"type":47,"value":160},{"type":47,"value":146},{"type":42,"tag":79,"props":1306,"children":1308},{"className":1307},[],[1309],{"type":47,"value":152},{"type":47,"value":1311},"), or pass the JSON as a file path instead of an inline string. See ",{"type":42,"tag":79,"props":1313,"children":1315},{"className":1314},[],[1316],{"type":47,"value":1317},"references\u002Fstaged-construction.md",{"type":47,"value":1319}," for the recommended pattern.",{"type":42,"tag":56,"props":1321,"children":1323},{"id":1322},"reference-index",[1324],{"type":47,"value":1325},"Reference Index",{"type":42,"tag":63,"props":1327,"children":1328},{},[1329,1349,1360],{"type":42,"tag":67,"props":1330,"children":1331},{},[1332,1334,1340,1342,1347],{"type":47,"value":1333},"Open ",{"type":42,"tag":79,"props":1335,"children":1337},{"className":1336},[],[1338],{"type":47,"value":1339},"references\u002Fjson-format.md",{"type":47,"value":1341}," when you need the unified JSON blueprint shape — concept\u002Fproperties\u002Fchildren\u002Freferences layout, optional-section rules, and reference-resolution semantics (",{"type":42,"tag":79,"props":1343,"children":1345},{"className":1344},[],[1346],{"type":47,"value":635},{"type":47,"value":1348}," vs name auto-resolution).",{"type":42,"tag":67,"props":1350,"children":1351},{},[1352,1353,1358],{"type":47,"value":1333},{"type":42,"tag":79,"props":1354,"children":1356},{"className":1355},[],[1357],{"type":47,"value":1317},{"type":47,"value":1359}," when the subtree is large (>~4 KB) or its child refs are needed for later edits — the skeleton → validate → incremental-fill → targeted-update → cleanup pattern.",{"type":42,"tag":67,"props":1361,"children":1362},{},[1363,1364,1370,1372,1378],{"type":47,"value":1333},{"type":42,"tag":79,"props":1365,"children":1367},{"className":1366},[],[1368],{"type":47,"value":1369},"references\u002Ftroubleshooting.md",{"type":47,"value":1371}," when an insert call fails with ",{"type":42,"tag":79,"props":1373,"children":1375},{"className":1374},[],[1376],{"type":47,"value":1377},"JsonElement.getAsString()",{"type":47,"value":1379}," errors or when the JSON shape diverges from the user's textual notation.",{"items":1381,"total":1455},[1382,1394,1403,1412,1423,1433,1446],{"slug":1383,"name":1383,"fn":1384,"description":1385,"org":1386,"tags":1387,"stars":22,"repoUrl":23,"updatedAt":1393},"mps-aspect-accessories","configure JetBrains MPS module dependencies","Wire MPS module and model dependencies, used languages, used devkits, extended languages, runtime solutions, accessory models, and language\u002Fdependency versions. Use when adding\u002Fremoving module dependencies, importing languages or devkits into a model, declaring runtime solutions, or shipping accessory content visible to consumers without explicit import.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1388,1389,1392],{"name":13,"slug":14,"type":15},{"name":1390,"slug":1391,"type":15},"Configuration","configuration",{"name":20,"slug":21,"type":15},"2026-07-17T06:06:57.311661",{"slug":1395,"name":1395,"fn":1396,"description":1397,"org":1398,"tags":1399,"stars":22,"repoUrl":23,"updatedAt":1402},"mps-aspect-actions","define and edit MPS node factories","Use when defining or editing MPS node factories (the \"actions\" aspect) — `NodeFactories` roots, per-concept `NodeFactory` setup functions that initialize a freshly created node and optionally copy data from a replaced `sampleNode`, plus the actions aspect's `CopyPasteHandlers` and `PasteWrappers` roots. Reach for this skill when a substitution, side transform, completion replacement, or `add new initialized(...)` should preserve fields from the node it is replacing, or when defaults set in a constructor are not enough.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1400,1401],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:04:48.066901",{"slug":1404,"name":1404,"fn":1405,"description":1406,"org":1407,"tags":1408,"stars":22,"repoUrl":23,"updatedAt":1411},"mps-aspect-behavior","define and edit MPS concept behavior","Use when defining or editing MPS `ConceptBehavior` — per-concept methods (non-virtual \u002F virtual \u002F abstract \u002F static \u002F virtual static), constructors, virtual dispatch (MRO), super and interface-default calls (`super\u003CInterface>.method`), overriding methods from `lang.core.behavior` interfaces such as `ScopeProvider.getScope` \u002F `INamedConcept.getName` \u002F `BaseConcept.getPresentation`, calling sibling methods (`LocalBehaviorMethodCall`) and behavior methods from other aspects via `node.method(...)`. Reach for this skill whenever the task involves authoring or modifying `\u003Clang>\u002FlanguageModels\u002Fbehavior.mps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1409,1410],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:45:21.757084",{"slug":1413,"name":1413,"fn":1414,"description":1415,"org":1416,"tags":1417,"stars":22,"repoUrl":23,"updatedAt":1422},"mps-aspect-constraints","define JetBrains MPS language constraints","Use when defining or editing MPS language constraints — property validators \u002F setters \u002F getters, referent search scopes (imperative or inherited via `ScopeProvider.getScope`), `referentSetHandler` side effects, default-scope blocks, `canBeChild` \u002F `canBeParent` \u002F `canBeAncestor` \u002F `canBeRoot` placement rules, `defaultConcreteConcept` for abstract concepts, `set \u003Cread-only>` and `{name}` aliasing, and scope helpers (`SimpleRoleScope`, `ListScope`, `CompositeScope`, `HidingByNameScope`). Reach for this skill whenever the task involves authoring or modifying `\u003Clang>\u002FlanguageModels\u002Fconstraints.mps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1418,1419],{"name":13,"slug":14,"type":15},{"name":1420,"slug":1421,"type":15},"Code Analysis","code-analysis","2026-07-23T05:41:33.639365",{"slug":1424,"name":1424,"fn":1425,"description":1426,"org":1427,"tags":1428,"stars":22,"repoUrl":23,"updatedAt":1432},"mps-aspect-dataflow","define and debug MPS dataflow builders","Use when defining or debugging MPS dataflow builders for a concept — control\u002Fdata flow declarations that drive reachability analysis and variable-use checking. Covers DataFlowBuilderDeclaration, BuilderBlock, emit instructions (code for, jump, ifjump, label, read, write, ret, mayBeUnreachable), positions (AfterPosition, BeforePosition, LabelPosition), the jetbrains.mps.lang.dataFlow language, the NodeParameter implicit, BL+smodel usage inside builder bodies, and IBuilderMode for advanced analyses such as nullable\u002Fnon-null tracking.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1429],{"name":1430,"slug":1431,"type":15},"Data Analysis","data-analysis","2026-07-13T06:45:19.114674",{"slug":1434,"name":1434,"fn":1435,"description":1436,"org":1437,"tags":1438,"stars":22,"repoUrl":23,"updatedAt":1445},"mps-aspect-editor","define MPS editor layouts","Use when creating or changing MPS editor definitions — the overall workflow from scaffolding a `ConceptEditorDeclaration` through componentizing reusable `EditorComponentDeclaration`s, refining cell models and cell layouts, applying style sheets and indent-layout style items, wiring smart references, leveraging inheritance via super-concepts and interfaces, inspecting (`print_node_json`, `show_node_representation`) and validating (`check_root_node_problems`). Covers `jetbrains.mps.lang.editor` cell models (`CellModel_RefNode`\u002F`CellModel_RefNodeList`\u002F`CellModel_RefCell`\u002F`CellModel_Property`\u002F`CellModel_Constant`), layout choices, and JSON blueprints for common editor shapes. For the non-layout side (action maps, keymaps, transformation\u002Fsubstitute menus) use `mps-aspect-editor-menus-and-keymaps`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1439,1442],{"name":1440,"slug":1441,"type":15},"Design","design",{"name":1443,"slug":1444,"type":15},"UI Components","ui-components","2026-07-23T05:41:56.638151",{"slug":1447,"name":1447,"fn":1448,"description":1449,"org":1450,"tags":1451,"stars":22,"repoUrl":23,"updatedAt":1454},"mps-aspect-editor-menus-and-keymaps","author MPS editor menus and keymaps","Use when authoring the **non-layout** parts of the MPS editor aspect — what happens when the user types, presses a key, triggers completion, pastes, or invokes a context action. Covers action maps (`CellActionMapDeclaration`), cell keymaps (`CellKeyMapDeclaration`), transformation menus (`TransformationMenu_Default` \u002F `_Named` \u002F `_Contribution`), substitute menus (`SubstituteMenu_Default` \u002F `SubstituteMenu` \u002F contributions), side transforms (LEFT\u002FRIGHT), legacy cell menus, paste wrappers and copy-paste handlers (in the actions language), completion styling, reference presentation, two-step deletion, and the editor selection API. Trigger terms: `actionMap`, `keyMap`, `delete_action_id`, `transformationMenu`, `substituteMenu`, `Ctrl+Space`, `Ctrl+Alt+B`, side transform, paste wrapper, completion styling, `PasteWrappers`, `CopyPasteHandlers`. For the **layout** side (cells, layouts, style sheets) use `mps-aspect-editor` instead.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1452,1453],{"name":20,"slug":21,"type":15},{"name":1443,"slug":1444,"type":15},"2026-07-23T05:41:49.666535",31,{"items":1457,"total":1541},[1458,1464,1469,1474,1479,1483,1488,1493,1502,1512,1521,1534],{"slug":1383,"name":1383,"fn":1384,"description":1385,"org":1459,"tags":1460,"stars":22,"repoUrl":23,"updatedAt":1393},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1461,1462,1463],{"name":13,"slug":14,"type":15},{"name":1390,"slug":1391,"type":15},{"name":20,"slug":21,"type":15},{"slug":1395,"name":1395,"fn":1396,"description":1397,"org":1465,"tags":1466,"stars":22,"repoUrl":23,"updatedAt":1402},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1467,1468],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":1404,"name":1404,"fn":1405,"description":1406,"org":1470,"tags":1471,"stars":22,"repoUrl":23,"updatedAt":1411},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1472,1473],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},{"slug":1413,"name":1413,"fn":1414,"description":1415,"org":1475,"tags":1476,"stars":22,"repoUrl":23,"updatedAt":1422},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1477,1478],{"name":13,"slug":14,"type":15},{"name":1420,"slug":1421,"type":15},{"slug":1424,"name":1424,"fn":1425,"description":1426,"org":1480,"tags":1481,"stars":22,"repoUrl":23,"updatedAt":1432},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1482],{"name":1430,"slug":1431,"type":15},{"slug":1434,"name":1434,"fn":1435,"description":1436,"org":1484,"tags":1485,"stars":22,"repoUrl":23,"updatedAt":1445},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1486,1487],{"name":1440,"slug":1441,"type":15},{"name":1443,"slug":1444,"type":15},{"slug":1447,"name":1447,"fn":1448,"description":1449,"org":1489,"tags":1490,"stars":22,"repoUrl":23,"updatedAt":1454},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1491,1492],{"name":20,"slug":21,"type":15},{"name":1443,"slug":1444,"type":15},{"slug":1494,"name":1494,"fn":1495,"description":1496,"org":1497,"tags":1498,"stars":22,"repoUrl":23,"updatedAt":1501},"mps-aspect-generation-plan","modify MPS generation plans","Use when defining or modifying an MPS generation plan — explicit ordering of generators, checkpoints for cross-model reference resolution, forks for parallel branches, IncludePlan composition, conditional PlanContribution activation, ParameterEquals\u002FConceptListSelector fork selectors, and InitModelAttributes for targetFacet routing. Apply when working with @genplan models, the jetbrains.mps.lang.generator.plan language, attaching plans via DevKits or the Custom generation facet, or debugging cross-model mapping label resolution.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1499,1500],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:44:59.507855",{"slug":1503,"name":1503,"fn":1504,"description":1505,"org":1506,"tags":1507,"stars":22,"repoUrl":23,"updatedAt":1511},"mps-aspect-generator","define JetBrains MPS generator rules","Use when defining or modifying MPS generators — author a generator module, add or edit root\u002Freduction\u002Fweaving\u002Fpattern mapping rules, attach template macros ($COPY_SRC, $LOOP, $IF, $PROPERTY, $REF, $SWITCH, $MAP_SRC, $WEAVE, $INSERT, $LABEL, $TRACE, $VAR), wire mapping labels, build template switches, write pre\u002Fpost mapping scripts, navigate `genContext`, or debug \"rule didn't fire\", missing references, empty output, infinite reduction loops, and generated-Java compile failures.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1508,1509,1510],{"name":13,"slug":14,"type":15},{"name":1420,"slug":1421,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:06:58.042999",{"slug":1513,"name":1513,"fn":1514,"description":1515,"org":1516,"tags":1517,"stars":22,"repoUrl":23,"updatedAt":1520},"mps-aspect-intentions","define and edit MPS intentions","Use when defining or editing MPS intentions (the Alt+Enter context-action aspect) — adding `IntentionDeclaration` roots, parameterized or surround-with variants, description\u002FisApplicable\u002Fexecute blocks, child-filter functions, factory-initialized AST splicing, or debugging why an intention is not offered. Lives in the language's `intentions` model and uses `jetbrains.mps.lang.intentions`.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1518,1519],{"name":13,"slug":14,"type":15},{"name":20,"slug":21,"type":15},"2026-07-23T05:41:48.692899",{"slug":1522,"name":1522,"fn":1523,"description":1524,"org":1525,"tags":1526,"stars":22,"repoUrl":23,"updatedAt":1533},"mps-aspect-migrations","author and debug MPS migration scripts","Use when authoring or debugging MPS migration scripts that upgrade user models after a language definition changes — covers jetbrains.mps.lang.migration (MigrationScript class-based, PureMigrationScript declarative, MoveConcept\u002FMoveContainmentLink\u002FMoveReferenceLink\u002FMoveProperty, ordering via OrderDependency, data exchange via putData\u002FgetData, RefactoringLog, ConceptMigrationReference) and jetbrains.mps.lang.script Enhancement Scripts (MigrationScript with MigrationScriptPart_Instance, ExtractInterfaceMigration, FactoryMigrationScriptPart, CommentMigrationScriptPart) — when a model needs version-gated upgrade, concept rename or removal, link or property rename, instance-level transformation, or composition of migration steps.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1527,1530],{"name":1528,"slug":1529,"type":15},"Debugging","debugging",{"name":1531,"slug":1532,"type":15},"Migration","migration","2026-07-13T06:45:20.372122",{"slug":1067,"name":1067,"fn":1535,"description":1536,"org":1537,"tags":1538,"stars":22,"repoUrl":23,"updatedAt":1540},"define concepts in MPS structure aspect","Define concepts, interface concepts, enumerations, and constrained data types in an MPS language's `structure` aspect. Covers smart-reference detection, alias rules, cardinality, INamedConcept usage, bulk creation, and the full `mps_mcp_alter_structure` \u002F `mps_mcp_query_structure` reference. Use when authoring or modifying a language's structure model.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1539],{"name":17,"slug":18,"type":15},"2026-07-23T05:41:30.705975",188]