[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-jetbrains-mps-mcp-workflow":3,"mdc-3wvev0-key":35,"related-org-jetbrains-mps-mcp-workflow":2085,"related-repo-jetbrains-mps-mcp-workflow":2202},{"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-mcp-workflow","manage JetBrains MPS DSL projects","Complete JetBrains MPS workflow guide for DSL projects — models, languages, generators, node JSON blueprints, validation, MPS MCP tool usage, and the index of companion skills. Use whenever working in an MPS project, when AGENTS.md says to load the MPS workflow skill, or when you need to pick the right MPS aspect-specific skill.",{"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},"Documentation","documentation","tag",{"name":17,"slug":18,"type":15},"MCP","mcp",{"name":20,"slug":21,"type":15},"Engineering","engineering",1650,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS","2026-07-20T05:56:43.369683",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-mcp-workflow","---\nname: mps-mcp-workflow\ndescription: Complete JetBrains MPS workflow guide for DSL projects — models, languages, generators, node JSON blueprints, validation, MPS MCP tool usage, and the index of companion skills. Use whenever working in an MPS project, when AGENTS.md says to load the MPS workflow skill, or when you need to pick the right MPS aspect-specific skill.\ntype: reference\n---\n\n# Projectional Agent Toolkit – JetBrains MPS for Agents\n\nEntry point for working with JetBrains MPS (Meta Programming System) models, languages, generators, and the MPS MCP tools.\n\nRead this together with `AGENTS.md` whenever the task involves MPS artifacts or MPS MCP tooling.\n\n## Critical Directives\n\n> **⚠️ STOP — If you are reading raw `.mps` or `.mpl` XML files, you are way off track.**\n> MPS model files are opaque serialized XML: you cannot safely understand or edit them as plain text, and doing so will corrupt the model.\n> Use `mps_mcp_*` tools instead. If they are not available, ask the user to start MPS and enable the MPS MCP server before continuing.\n\n- **Always prefer MPS MCP tools over hand-editing `.mps` \u002F `.mpl` XML.** Hand-edits silently corrupt model files.\n- **Preserve node IDs.** Prefer `mps_mcp_update_root_node_from_json` or surgical edits (`mps_mcp_update_node`, …) over delete-and-reinsert. Deleting destroys persistent IDs and breaks incoming references.\n- **Copy-then-modify beats reconstruct-from-JSON.** To create a node that closely resembles an existing one, duplicate it with `mps_mcp_alter_nodes` `COPY_NODE` and adjust the copy with `mps_mcp_update_node`, instead of printing the original and re-authoring it as a JSON blueprint. The copy is guaranteed structurally valid and needs no blueprint authoring at all.\n- **Reload after compiled-aspect changes.** After modifying **typesystem**, **constraints**, **behavior**, **editor**, or any other compiled aspect, call `mps_mcp_reload_all` (or rebuild the language module via `mps_mcp_alter_nodes MAKE`) before validating with `mps_mcp_check_root_node_problems` on a consumer model. Without a reload, cached compiled rules continue to fire — checking will report stale errors or miss new ones.\n- **The Structure-to-Aspect\u002FScaffold Prerequisite Chain (Ordering & Recovery).** When editing a language's **structure aspect** (e.g., creating concepts\u002Fenums or modifying properties, children, or references via `mps_mcp_alter_structure`), you MUST adhere to the following strict sequence of cross-tool steps before invoking dependent tools (such as `mps_mcp_get_concept_details` or `mps_mcp_scaffold_editor`):\n    1. **Structure Edit**: Modify the structure aspect (using `mps_mcp_alter_structure`).\n    2. **Clean Make\u002FRebuild**: Run `mps_mcp_alter_nodes` with `MAKE` and `rebuild=true` targeting the **language module** (a model-scoped make can leave a never-before-deployed language's runtime hollow). Note: a plain `mps_mcp_reload_all` alone is **not** sufficient because the generated structure aspect descriptor classes on disk must be regenerated before the ClassLoader reloads them.\n    3. **Verify Descriptors**: Retrieve the compiled concept details using `mps_mcp_get_concept_details` and verify that the `descriptorStatus` is not `\"hollow\"` and no warnings exist.\n    4. **Scaffold \u002F Aspect Editing**: Once the descriptors are verified as compiled and active, proceed to scaffold the editor (`mps_mcp_scaffold_editor`) or define other aspects (behavior, constraints, typesystem, generator, etc.).\n    *Failing to follow this ordering results in stale or hollow descriptors where dependent tools silently see empty properties, children, or references.*\n    **Shortcut:** `mps_mcp_alter_structure CREATE_CONCEPTS` with `make: true` already does steps 2–3 — it clean-rebuilds, verifies every created descriptor against the runtime, and auto-recovers a never-deployed language (one module-scoped rebuild, `recoveryStage: \"module-rebuild\"`). Trust its `makeStatus`; run the manual chain only for structure edits made through tools that do not make (`UPDATE_*`\u002F`RENAME_*` operations, `mps_mcp_update_node`).\n- **Surgical edits over full-root rewrites.** When a single child changes, prefer `mps_mcp_update_node` over re-running `mps_mcp_update_root_node_from_json` on the whole root.\n- **Validate frequently.** A successful insertion (`\"ok\": true`) does not mean the AST is semantically valid — always follow with `mps_mcp_check_root_node_problems`.\n\n> **Tool name note**: MPS MCP tools are named with a `mps_mcp_` prefix (e.g. `mps_mcp_query_nodes`, `mps_mcp_alter_nodes`, `mps_mcp_get_concept_details`). Your MCP client wraps these with a server-specific prefix (e.g. `mcp__mps-mcp-server__\u003Cenv>___`), which varies by environment. Match tools by the stable `mps_mcp_*` suffix.\n\n> **Which project the tools act on (subdirectory & multi-project checkouts).** The `mps_mcp_*` tools operate on the MPS project currently open in the running MPS instance. That project often lives in a **subdirectory** of your repository (e.g. `\u003Crepo>\u002Ftools\u002FBigProject`, as in mbeddr or MPS-extensions), and one checkout may even hold **several** MPS projects. The host resolves the project from your client's workspace roots, then falls back to the single open project. If a tool call is rejected with \"no project opened\" or \"multiple projects opened\", call `mps_mcp_list_open_projects`, then supply the intended project's `mpsProjectBaseDirectory` — the folder MPS actually opened, i.e. a path *at or inside* it, **not** the repository root — via the host's project-path argument. This is the opposite of `mps_mcp_initialize_project_for_agents`, whose `targetDirectory` is the *repository \u002F workspace root* (where `.agents\u002F`, `.claude\u002F`, `AGENTS.md`, and `CLAUDE.md` belong), which may be an *ancestor* of the MPS project directory.\n>\n> **Multi-project repository rules.** All open MPS projects share the same module repository. Write targets — models, modules, root nodes, and nodes being mutated — must belong to the project selected by `projectPath`; tools refuse writes to another open project's elements. Read\u002Freference\u002Fdependency targets may come from another open MPS project when they are explicitly named or imported: model\u002Fmodule dependencies, model used languages\u002Fdevkits, node concepts, and reference targets can point across projects, and the foreign elements are treated like read-only library\u002Fstub elements. Returned JSON for an element from another open project includes `containingProject: { name, mpsProjectBaseDirectory }` and `editableFromCurrentProject: false`; nested references use prefixes such as `conceptContainingProject`, `targetContainingProject`, or `typeContainingProject`. These markers appear *only* for elements owned by another open project — their absence does not imply an element is editable (a read-only library\u002Fstub in the current project carries `readOnly: true` but no `containingProject`), so decide editability from `readOnly` together with these markers.\n>\n> **When in doubt, ask which project.** When several MPS projects are open under one repository \u002F VCS root, the `mps_mcp_*` tools accept *any* valid project path and act relative to that project. Same-name resolution prefers the selected project's own elements before falling back to the shared repository, but an explicit reference may still resolve to another open project. If the intended project is not obvious from the user's request or the current editor focus (`mps_mcp_get_current_editor_root_node`), do **not** guess — show the `mps_mcp_list_open_projects` entries and ask the user which project the query or change should run against.\n\n## Companion Skills\n\nAll MPS skills live in a per-harness directory loaded by the agent host (e.g. `.agents\u002Fskills\u002F\u003Cskill-name>\u002FSKILL.md` for AGENTS.md-aware hosts, `.claude\u002Fskills\u002F\u003Cskill-name>\u002FSKILL.md` for Claude Code). Load whichever ones apply to your current task.\n\n> **Installing \u002F refreshing the catalog.** These `mps-*` skills and the project's `AGENTS.md`\u002F`CLAUDE.md` are installed and refreshed by the `mps_mcp_initialize_project_for_agents` MCP tool. It installs into a `targetDirectory` — normally your **repository \u002F workspace root** (the folder containing `.git`), which may be an *ancestor* of the MPS project directory when the project sits in a subdirectory; leave `targetDirectory` empty to let the tool derive that root from the open project's enclosing VCS folder, and do **not** pass it `projectPath`. If no `mps-*` skills exist yet, the project has not been initialized for agents — tell the user and offer to run it. If the catalog looks stale or incomplete, offer to refresh it (with approval): delete every `mps-*` skill folder from `.agents\u002Fskills\u002F` and `.claude\u002Fskills\u002F` — keeping any project-local `*-dsl` skills — re-run the tool, then carefully merge its returned `agentsFileText` into `AGENTS.md`\u002F`CLAUDE.md`, preserving project-specific sections. See that tool's description for the exact refresh contract.\n\n| Skill | What it covers |\n|-------|---------------|\n| `mps-language-aspects-overview`     | Entry point for defining an MPS language — lists the aspects, what each owns, and the typical authoring order. Start here. |\n| `mps-language-modularity`           | Design tier for multi-language work — choose between referencing, extension, reuse, and embedding *before* authoring aspects, then route into the aspect skills. Use when one language must see, extend, embed, or adapt another. |\n| `mps-aspect-structure-concepts`            | Define concepts, interface concepts, enumerations, and constrained data types. Includes the full `mps_mcp_alter_structure` \u002F `mps_mcp_query_structure` reference. |\n| `mps-baselanguage`                  | Author and edit `jetbrains.mps.baseLanguage` (Java) nodes — parser vs. JSON AST, concept mapping, reference harvesting, validation. Load when writing any Java\u002FBaseLanguage code in MPS. |\n| `mps-model-manipulation`                    | Write and edit MPS BaseLanguage code that uses smodel, closures, and collections — manipulating nodes, lists, and queries. Use when editing checking rules, behavior methods, typesystem rules, or any model code that manipulates nodes. |\n| `mps-aspect-accessories`            | Module\u002Fmodel dependencies, used languages, runtime solutions, accessory models. |\n| `mps-aspect-actions`                | Node factories (the \"actions\" aspect) — concept-specific setup functions for newly created nodes. |\n| `mps-aspect-behavior`               | ConceptBehavior — per-concept methods, constructors, virtual dispatch, calling behavior from other aspects. |\n| `mps-aspect-constraints`            | Property validators\u002Fsetters, referent scopes, `canBe*` rules (canBeChild\u002FParent\u002FAncestor\u002FRoot). |\n| `mps-aspect-dataflow`               | Dataflow builders — control and data flow declarations for concept nodes, reachability analysis, variable-use checking. |\n| `mps-aspect-editor-menus-and-keymaps` | Non-layout parts of the MPS editor aspect — action maps, cell keymaps, transformation\u002Fsubstitute menus, side transforms, paste handlers, completion styling. |\n| `mps-aspect-generator`              | Generator templates — root mapping rules, reduction rules, macros, mapping labels. |\n| `mps-aspect-generation-plan`        | Generation plans — explicit ordering of generation steps, checkpoints, forks, plan contributions. |\n| `mps-aspect-intentions`             | Intentions — Alt+Enter context actions, parameterized\u002Fsurround\u002Fquick-fix variants. |\n| `mps-aspect-migrations`             | Migration scripts — upgrading user models when language definitions change. |\n| `mps-aspect-textgen`                | TextGen — concept-to-plain-text serialization rules. |\n| `mps-aspect-typesystem`             | Typesystem — inference rules, subtyping, replacement, comparison, non-typesystem checking. |\n| `mps-aspect-editor`                 | Overall workflow for creating and changing MPS editor definitions — scaffolding, componentizing, cell models, layouts, styles, validation. |\n| `mps-language-analysis`             | Analyze MPS language definitions — discover concepts, metadata, aspects, sample nodes. |\n| `mps-language-inheritance`          | Investigate inheritance between MPS languages and concepts — extends, super, sub, assignable. |\n| `mps-node-editing`                  | Modify MPS nodes using JSON blueprints — the canonical workflow for any node mutation. |\n| `mps-dsl-memory`                    | Explore a live MPS DSL project and create or refresh generated project-local DSL skills under `.agents\u002Fskills\u002F\u003Cdsl-name>-dsl\u002F`. |\n| `mps-lang-core-xml`                 | `jetbrains.mps.core.xml` language for authoring XML documents and XML-generating generator templates. |\n| `mps-quotations`                    | MPS quotations and anti-quotations — node literals creating SNode trees inline in behavior\u002Fgenerator\u002Fmodel code. |\n| `mps-build-language`                | MPS Build Language — declarative DSL generating Ant `build.xml` files for packaging plugins, Java modules, standalone IDEs. |\n| `mps-ide-plugin`                    | MPS IDE plugins — actions, action groups, tool windows, keymaps, preference components. |\n| `mps-bugfix`                        | MPS bugfixing workflow. |\n\n## Key Concepts\n\nMPS is a projectional editor and a language workbench. Unlike text-based IDEs, MPS works with an Abstract Syntax Tree (AST) directly. JSON is used to represent MPS nodes and their properties in a structured format for the MPS tools.\n\n- **Modules**: The top-level containers in an MPS project.\n    - **Solution**: contains user code (models).\n    - **Language**: defines a new language - structure (concepts and interface concepts), editor, etc.\n    - **Generator**: defines how to transform one language to another (usually to Java\u002FBaseLanguage). May belong to a language or be independent.\n    - **DevKit**: a bundle of languages and other devkits. DevKits can also export solutions and languages. Importing a DevKit into a module or model automatically makes all its exported languages and solutions available. This is the preferred way to manage common sets of languages and dependencies.\n- **Models**: contained within modules. They hold a collection of **Root Nodes**.\n- **Nodes**: the basic building blocks of the AST. Nodes are organized hierarchically.\n    - **Root Nodes**: the top-level nodes in a model.\n- **Concepts**: define the \"type\" of a node (like a class in OOP). They define properties, children, and references. Concepts are defined in the **structure** aspect of a language. Like in OOP, a concept can extend another concept and implement multiple interface concepts, which leads to subconcept-superconcept relationships and affects assignability of nodes into child or reference roles.\n- **Aspects**: different parts of a language definition (Structure, Editor, Typesystem, Constraints, etc.). Technically, each aspect is a dedicated model inside a language's module.\n- Some MPS modules and models can be read-only.\n- MPS modules and models define dependencies between each other. DevKits can re-export dependencies on solutions and other devkits. If a module depends on a DevKit, it implicitly depends on all solutions exported by that DevKit.\n- MPS models specify 'used languages'. If model A uses language L, nodes in model A can be instances of concepts from language L. Using a DevKit in a model automatically includes all languages exported by that DevKit (and any devkits it extends).\n\n## Common Workflow — Initialize a Session\n\n1. **Check generated DSL skills** under `.agents\u002Fskills\u002F*-dsl\u002F` before starting unfamiliar DSL work. Use the relevant project-local DSL skill when it exists; if it is missing or stale, load `mps-dsl-memory` to create or refresh it.\n2. **Anchor on the user's focus** — call `mps_mcp_get_current_editor_root_node` so you know which root the user is looking at.\n3. **Identify the task family**: defining a language → load `mps-language-aspects-overview`. Editing user code → load `mps-node-editing` and (often) `mps-baselanguage`. Investigating an unfamiliar language → load `mps-language-analysis`.\n4. **Follow the matching aspect skill** for the specific aspect you're touching.\n5. **Validate frequently** with `mps_mcp_check_root_node_problems`. Rebuild\u002Freload after compiled-aspect changes.\n\n## Essential Skills (Detail)\n\nOpen `references\u002Ffinding-things.md` for the protocol on finding models, modules, and languages (including shortened-name resolution like `j.m.l.core` → `jetbrains.mps.lang.core`).\n\nOpen `references\u002Fnode-editing-rules.md` for the full rulebook on adding\u002Fupdating nodes (concept selection, role types, cardinality, assignability, persistent IDs, surgical edits, reload after compiled-aspect changes).\n\nOpen `references\u002Freference-formats.md` for the reference-format protocol: node refs (`r:`\u002F`i:`), concept refs (`c:`), and the critical \"never use a concept ref where a node ref is expected\" rule.\n\nOpen `references\u002Fbulk-creation.md` for the print-shallow-then-add-children staged construction workflow used when subtrees exceed the JSON size limit.\n\nOpen `references\u002Fanalysis-tools.md` for the inventory of analysis operations (`mps_mcp_print_node`, `mps_mcp_check_root_node_problems` with its `quickFixes`\u002F`autoApplyQuickFixes`, `mps_mcp_list_node_intentions` \u002F `mps_mcp_apply_intention`, `mps_mcp_alter_nodes FIX_REFERENCES`, etc.).\n\nOpen `references\u002Feditor-workflow.md` for the MPS Concept Editor workflow (scaffold → componentize → refine → validate) and the editor procedural guidelines.\n\nOpen `references\u002Fmcp-tools-index.md` for the complete inventory of MPS MCP tools grouped by Project\u002FStructure, Modules and Models, Root Nodes and Nodes, Console, and Language Definition.\n\n## Boundaries\n\n- **Do not** edit serialized `.mps` model files as plain text unless the user explicitly asks for it.\n- **Do not** edit `.mpl` module descriptors manually if an MCP wiring tool (`mps_mcp_module_dependency`, `mps_mcp_update_module`, …) covers the change.\n- **Do not** delete-and-reinsert a node to \"change\" it when surgical tools exist.\n",{"data":36,"body":38},{"name":4,"description":6,"type":37},"reference",{"type":39,"children":40},"root",[41,50,56,70,77,116,543,599,861,867,888,1034,1579,1585,1590,1726,1732,1840,1846,1874,1886,1921,1933,1995,2007,2019,2025],{"type":42,"tag":43,"props":44,"children":46},"element","h1",{"id":45},"projectional-agent-toolkit-jetbrains-mps-for-agents",[47],{"type":48,"value":49},"text","Projectional Agent Toolkit – JetBrains MPS for Agents",{"type":42,"tag":51,"props":52,"children":53},"p",{},[54],{"type":48,"value":55},"Entry point for working with JetBrains MPS (Meta Programming System) models, languages, generators, and the MPS MCP tools.",{"type":42,"tag":51,"props":57,"children":58},{},[59,61,68],{"type":48,"value":60},"Read this together with ",{"type":42,"tag":62,"props":63,"children":65},"code",{"className":64},[],[66],{"type":48,"value":67},"AGENTS.md",{"type":48,"value":69}," whenever the task involves MPS artifacts or MPS MCP tooling.",{"type":42,"tag":71,"props":72,"children":74},"h2",{"id":73},"critical-directives",[75],{"type":48,"value":76},"Critical Directives",{"type":42,"tag":78,"props":79,"children":80},"blockquote",{},[81],{"type":42,"tag":51,"props":82,"children":83},{},[84,106,108,114],{"type":42,"tag":85,"props":86,"children":87},"strong",{},[88,90,96,98,104],{"type":48,"value":89},"⚠️ STOP — If you are reading raw ",{"type":42,"tag":62,"props":91,"children":93},{"className":92},[],[94],{"type":48,"value":95},".mps",{"type":48,"value":97}," or ",{"type":42,"tag":62,"props":99,"children":101},{"className":100},[],[102],{"type":48,"value":103},".mpl",{"type":48,"value":105}," XML files, you are way off track.",{"type":48,"value":107},"\nMPS model files are opaque serialized XML: you cannot safely understand or edit them as plain text, and doing so will corrupt the model.\nUse ",{"type":42,"tag":62,"props":109,"children":111},{"className":110},[],[112],{"type":48,"value":113},"mps_mcp_*",{"type":48,"value":115}," tools instead. If they are not available, ask the user to start MPS and enable the MPS MCP server before continuing.",{"type":42,"tag":117,"props":118,"children":119},"ul",{},[120,145,171,204,264,494,518],{"type":42,"tag":121,"props":122,"children":123},"li",{},[124,143],{"type":42,"tag":85,"props":125,"children":126},{},[127,129,134,136,141],{"type":48,"value":128},"Always prefer MPS MCP tools over hand-editing ",{"type":42,"tag":62,"props":130,"children":132},{"className":131},[],[133],{"type":48,"value":95},{"type":48,"value":135}," \u002F ",{"type":42,"tag":62,"props":137,"children":139},{"className":138},[],[140],{"type":48,"value":103},{"type":48,"value":142}," XML.",{"type":48,"value":144}," Hand-edits silently corrupt model files.",{"type":42,"tag":121,"props":146,"children":147},{},[148,153,155,161,163,169],{"type":42,"tag":85,"props":149,"children":150},{},[151],{"type":48,"value":152},"Preserve node IDs.",{"type":48,"value":154}," Prefer ",{"type":42,"tag":62,"props":156,"children":158},{"className":157},[],[159],{"type":48,"value":160},"mps_mcp_update_root_node_from_json",{"type":48,"value":162}," or surgical edits (",{"type":42,"tag":62,"props":164,"children":166},{"className":165},[],[167],{"type":48,"value":168},"mps_mcp_update_node",{"type":48,"value":170},", …) over delete-and-reinsert. Deleting destroys persistent IDs and breaks incoming references.",{"type":42,"tag":121,"props":172,"children":173},{},[174,179,181,187,189,195,197,202],{"type":42,"tag":85,"props":175,"children":176},{},[177],{"type":48,"value":178},"Copy-then-modify beats reconstruct-from-JSON.",{"type":48,"value":180}," To create a node that closely resembles an existing one, duplicate it with ",{"type":42,"tag":62,"props":182,"children":184},{"className":183},[],[185],{"type":48,"value":186},"mps_mcp_alter_nodes",{"type":48,"value":188}," ",{"type":42,"tag":62,"props":190,"children":192},{"className":191},[],[193],{"type":48,"value":194},"COPY_NODE",{"type":48,"value":196}," and adjust the copy with ",{"type":42,"tag":62,"props":198,"children":200},{"className":199},[],[201],{"type":48,"value":168},{"type":48,"value":203},", instead of printing the original and re-authoring it as a JSON blueprint. The copy is guaranteed structurally valid and needs no blueprint authoring at all.",{"type":42,"tag":121,"props":205,"children":206},{},[207,212,214,219,221,226,227,232,233,238,240,246,248,254,256,262],{"type":42,"tag":85,"props":208,"children":209},{},[210],{"type":48,"value":211},"Reload after compiled-aspect changes.",{"type":48,"value":213}," After modifying ",{"type":42,"tag":85,"props":215,"children":216},{},[217],{"type":48,"value":218},"typesystem",{"type":48,"value":220},", ",{"type":42,"tag":85,"props":222,"children":223},{},[224],{"type":48,"value":225},"constraints",{"type":48,"value":220},{"type":42,"tag":85,"props":228,"children":229},{},[230],{"type":48,"value":231},"behavior",{"type":48,"value":220},{"type":42,"tag":85,"props":234,"children":235},{},[236],{"type":48,"value":237},"editor",{"type":48,"value":239},", or any other compiled aspect, call ",{"type":42,"tag":62,"props":241,"children":243},{"className":242},[],[244],{"type":48,"value":245},"mps_mcp_reload_all",{"type":48,"value":247}," (or rebuild the language module via ",{"type":42,"tag":62,"props":249,"children":251},{"className":250},[],[252],{"type":48,"value":253},"mps_mcp_alter_nodes MAKE",{"type":48,"value":255},") before validating with ",{"type":42,"tag":62,"props":257,"children":259},{"className":258},[],[260],{"type":48,"value":261},"mps_mcp_check_root_node_problems",{"type":48,"value":263}," on a consumer model. Without a reload, cached compiled rules continue to fire — checking will report stale errors or miss new ones.",{"type":42,"tag":121,"props":265,"children":266},{},[267,272,274,279,281,287,289,295,296,302,304],{"type":42,"tag":85,"props":268,"children":269},{},[270],{"type":48,"value":271},"The Structure-to-Aspect\u002FScaffold Prerequisite Chain (Ordering & Recovery).",{"type":48,"value":273}," When editing a language's ",{"type":42,"tag":85,"props":275,"children":276},{},[277],{"type":48,"value":278},"structure aspect",{"type":48,"value":280}," (e.g., creating concepts\u002Fenums or modifying properties, children, or references via ",{"type":42,"tag":62,"props":282,"children":284},{"className":283},[],[285],{"type":48,"value":286},"mps_mcp_alter_structure",{"type":48,"value":288},"), you MUST adhere to the following strict sequence of cross-tool steps before invoking dependent tools (such as ",{"type":42,"tag":62,"props":290,"children":292},{"className":291},[],[293],{"type":48,"value":294},"mps_mcp_get_concept_details",{"type":48,"value":97},{"type":42,"tag":62,"props":297,"children":299},{"className":298},[],[300],{"type":48,"value":301},"mps_mcp_scaffold_editor",{"type":48,"value":303},"):\n",{"type":42,"tag":305,"props":306,"children":307},"ol",{},[308,325,379,412],{"type":42,"tag":121,"props":309,"children":310},{},[311,316,318,323],{"type":42,"tag":85,"props":312,"children":313},{},[314],{"type":48,"value":315},"Structure Edit",{"type":48,"value":317},": Modify the structure aspect (using ",{"type":42,"tag":62,"props":319,"children":321},{"className":320},[],[322],{"type":48,"value":286},{"type":48,"value":324},").",{"type":42,"tag":121,"props":326,"children":327},{},[328,333,335,340,342,348,350,356,358,363,365,370,372,377],{"type":42,"tag":85,"props":329,"children":330},{},[331],{"type":48,"value":332},"Clean Make\u002FRebuild",{"type":48,"value":334},": Run ",{"type":42,"tag":62,"props":336,"children":338},{"className":337},[],[339],{"type":48,"value":186},{"type":48,"value":341}," with ",{"type":42,"tag":62,"props":343,"children":345},{"className":344},[],[346],{"type":48,"value":347},"MAKE",{"type":48,"value":349}," and ",{"type":42,"tag":62,"props":351,"children":353},{"className":352},[],[354],{"type":48,"value":355},"rebuild=true",{"type":48,"value":357}," targeting the ",{"type":42,"tag":85,"props":359,"children":360},{},[361],{"type":48,"value":362},"language module",{"type":48,"value":364}," (a model-scoped make can leave a never-before-deployed language's runtime hollow). Note: a plain ",{"type":42,"tag":62,"props":366,"children":368},{"className":367},[],[369],{"type":48,"value":245},{"type":48,"value":371}," alone is ",{"type":42,"tag":85,"props":373,"children":374},{},[375],{"type":48,"value":376},"not",{"type":48,"value":378}," sufficient because the generated structure aspect descriptor classes on disk must be regenerated before the ClassLoader reloads them.",{"type":42,"tag":121,"props":380,"children":381},{},[382,387,389,394,396,402,404,410],{"type":42,"tag":85,"props":383,"children":384},{},[385],{"type":48,"value":386},"Verify Descriptors",{"type":48,"value":388},": Retrieve the compiled concept details using ",{"type":42,"tag":62,"props":390,"children":392},{"className":391},[],[393],{"type":48,"value":294},{"type":48,"value":395}," and verify that the ",{"type":42,"tag":62,"props":397,"children":399},{"className":398},[],[400],{"type":48,"value":401},"descriptorStatus",{"type":48,"value":403}," is not ",{"type":42,"tag":62,"props":405,"children":407},{"className":406},[],[408],{"type":48,"value":409},"\"hollow\"",{"type":48,"value":411}," and no warnings exist.",{"type":42,"tag":121,"props":413,"children":414},{},[415,420,422,427,429,435,440,441,447,448,454,456,462,464,470,472,478,480,486,488,493],{"type":42,"tag":85,"props":416,"children":417},{},[418],{"type":48,"value":419},"Scaffold \u002F Aspect Editing",{"type":48,"value":421},": Once the descriptors are verified as compiled and active, proceed to scaffold the editor (",{"type":42,"tag":62,"props":423,"children":425},{"className":424},[],[426],{"type":48,"value":301},{"type":48,"value":428},") or define other aspects (behavior, constraints, typesystem, generator, etc.).\n",{"type":42,"tag":430,"props":431,"children":432},"em",{},[433],{"type":48,"value":434},"Failing to follow this ordering results in stale or hollow descriptors where dependent tools silently see empty properties, children, or references.",{"type":42,"tag":85,"props":436,"children":437},{},[438],{"type":48,"value":439},"Shortcut:",{"type":48,"value":188},{"type":42,"tag":62,"props":442,"children":444},{"className":443},[],[445],{"type":48,"value":446},"mps_mcp_alter_structure CREATE_CONCEPTS",{"type":48,"value":341},{"type":42,"tag":62,"props":449,"children":451},{"className":450},[],[452],{"type":48,"value":453},"make: true",{"type":48,"value":455}," already does steps 2–3 — it clean-rebuilds, verifies every created descriptor against the runtime, and auto-recovers a never-deployed language (one module-scoped rebuild, ",{"type":42,"tag":62,"props":457,"children":459},{"className":458},[],[460],{"type":48,"value":461},"recoveryStage: \"module-rebuild\"",{"type":48,"value":463},"). Trust its ",{"type":42,"tag":62,"props":465,"children":467},{"className":466},[],[468],{"type":48,"value":469},"makeStatus",{"type":48,"value":471},"; run the manual chain only for structure edits made through tools that do not make (",{"type":42,"tag":62,"props":473,"children":475},{"className":474},[],[476],{"type":48,"value":477},"UPDATE_*",{"type":48,"value":479},"\u002F",{"type":42,"tag":62,"props":481,"children":483},{"className":482},[],[484],{"type":48,"value":485},"RENAME_*",{"type":48,"value":487}," operations, ",{"type":42,"tag":62,"props":489,"children":491},{"className":490},[],[492],{"type":48,"value":168},{"type":48,"value":324},{"type":42,"tag":121,"props":495,"children":496},{},[497,502,504,509,511,516],{"type":42,"tag":85,"props":498,"children":499},{},[500],{"type":48,"value":501},"Surgical edits over full-root rewrites.",{"type":48,"value":503}," When a single child changes, prefer ",{"type":42,"tag":62,"props":505,"children":507},{"className":506},[],[508],{"type":48,"value":168},{"type":48,"value":510}," over re-running ",{"type":42,"tag":62,"props":512,"children":514},{"className":513},[],[515],{"type":48,"value":160},{"type":48,"value":517}," on the whole root.",{"type":42,"tag":121,"props":519,"children":520},{},[521,526,528,534,536,541],{"type":42,"tag":85,"props":522,"children":523},{},[524],{"type":48,"value":525},"Validate frequently.",{"type":48,"value":527}," A successful insertion (",{"type":42,"tag":62,"props":529,"children":531},{"className":530},[],[532],{"type":48,"value":533},"\"ok\": true",{"type":48,"value":535},") does not mean the AST is semantically valid — always follow with ",{"type":42,"tag":62,"props":537,"children":539},{"className":538},[],[540],{"type":48,"value":261},{"type":48,"value":542},".",{"type":42,"tag":78,"props":544,"children":545},{},[546],{"type":42,"tag":51,"props":547,"children":548},{},[549,554,556,562,564,570,571,576,577,582,584,590,592,597],{"type":42,"tag":85,"props":550,"children":551},{},[552],{"type":48,"value":553},"Tool name note",{"type":48,"value":555},": MPS MCP tools are named with a ",{"type":42,"tag":62,"props":557,"children":559},{"className":558},[],[560],{"type":48,"value":561},"mps_mcp_",{"type":48,"value":563}," prefix (e.g. ",{"type":42,"tag":62,"props":565,"children":567},{"className":566},[],[568],{"type":48,"value":569},"mps_mcp_query_nodes",{"type":48,"value":220},{"type":42,"tag":62,"props":572,"children":574},{"className":573},[],[575],{"type":48,"value":186},{"type":48,"value":220},{"type":42,"tag":62,"props":578,"children":580},{"className":579},[],[581],{"type":48,"value":294},{"type":48,"value":583},"). Your MCP client wraps these with a server-specific prefix (e.g. ",{"type":42,"tag":62,"props":585,"children":587},{"className":586},[],[588],{"type":48,"value":589},"mcp__mps-mcp-server__\u003Cenv>___",{"type":48,"value":591},"), which varies by environment. Match tools by the stable ",{"type":42,"tag":62,"props":593,"children":595},{"className":594},[],[596],{"type":48,"value":113},{"type":48,"value":598}," suffix.",{"type":42,"tag":78,"props":600,"children":601},{},[602,729,816],{"type":42,"tag":51,"props":603,"children":604},{},[605,610,612,617,619,624,626,632,634,639,641,647,649,655,657,662,664,668,670,676,678,684,686,691,693,699,700,706,707,712,714,720,722,727],{"type":42,"tag":85,"props":606,"children":607},{},[608],{"type":48,"value":609},"Which project the tools act on (subdirectory & multi-project checkouts).",{"type":48,"value":611}," The ",{"type":42,"tag":62,"props":613,"children":615},{"className":614},[],[616],{"type":48,"value":113},{"type":48,"value":618}," tools operate on the MPS project currently open in the running MPS instance. That project often lives in a ",{"type":42,"tag":85,"props":620,"children":621},{},[622],{"type":48,"value":623},"subdirectory",{"type":48,"value":625}," of your repository (e.g. ",{"type":42,"tag":62,"props":627,"children":629},{"className":628},[],[630],{"type":48,"value":631},"\u003Crepo>\u002Ftools\u002FBigProject",{"type":48,"value":633},", as in mbeddr or MPS-extensions), and one checkout may even hold ",{"type":42,"tag":85,"props":635,"children":636},{},[637],{"type":48,"value":638},"several",{"type":48,"value":640}," MPS projects. The host resolves the project from your client's workspace roots, then falls back to the single open project. If a tool call is rejected with \"no project opened\" or \"multiple projects opened\", call ",{"type":42,"tag":62,"props":642,"children":644},{"className":643},[],[645],{"type":48,"value":646},"mps_mcp_list_open_projects",{"type":48,"value":648},", then supply the intended project's ",{"type":42,"tag":62,"props":650,"children":652},{"className":651},[],[653],{"type":48,"value":654},"mpsProjectBaseDirectory",{"type":48,"value":656}," — the folder MPS actually opened, i.e. a path ",{"type":42,"tag":430,"props":658,"children":659},{},[660],{"type":48,"value":661},"at or inside",{"type":48,"value":663}," it, ",{"type":42,"tag":85,"props":665,"children":666},{},[667],{"type":48,"value":376},{"type":48,"value":669}," the repository root — via the host's project-path argument. This is the opposite of ",{"type":42,"tag":62,"props":671,"children":673},{"className":672},[],[674],{"type":48,"value":675},"mps_mcp_initialize_project_for_agents",{"type":48,"value":677},", whose ",{"type":42,"tag":62,"props":679,"children":681},{"className":680},[],[682],{"type":48,"value":683},"targetDirectory",{"type":48,"value":685}," is the ",{"type":42,"tag":430,"props":687,"children":688},{},[689],{"type":48,"value":690},"repository \u002F workspace root",{"type":48,"value":692}," (where ",{"type":42,"tag":62,"props":694,"children":696},{"className":695},[],[697],{"type":48,"value":698},".agents\u002F",{"type":48,"value":220},{"type":42,"tag":62,"props":701,"children":703},{"className":702},[],[704],{"type":48,"value":705},".claude\u002F",{"type":48,"value":220},{"type":42,"tag":62,"props":708,"children":710},{"className":709},[],[711],{"type":48,"value":67},{"type":48,"value":713},", and ",{"type":42,"tag":62,"props":715,"children":717},{"className":716},[],[718],{"type":48,"value":719},"CLAUDE.md",{"type":48,"value":721}," belong), which may be an ",{"type":42,"tag":430,"props":723,"children":724},{},[725],{"type":48,"value":726},"ancestor",{"type":48,"value":728}," of the MPS project directory.",{"type":42,"tag":51,"props":730,"children":731},{},[732,737,739,745,747,753,754,760,762,768,769,775,777,783,785,790,792,798,800,806,808,814],{"type":42,"tag":85,"props":733,"children":734},{},[735],{"type":48,"value":736},"Multi-project repository rules.",{"type":48,"value":738}," All open MPS projects share the same module repository. Write targets — models, modules, root nodes, and nodes being mutated — must belong to the project selected by ",{"type":42,"tag":62,"props":740,"children":742},{"className":741},[],[743],{"type":48,"value":744},"projectPath",{"type":48,"value":746},"; tools refuse writes to another open project's elements. Read\u002Freference\u002Fdependency targets may come from another open MPS project when they are explicitly named or imported: model\u002Fmodule dependencies, model used languages\u002Fdevkits, node concepts, and reference targets can point across projects, and the foreign elements are treated like read-only library\u002Fstub elements. Returned JSON for an element from another open project includes ",{"type":42,"tag":62,"props":748,"children":750},{"className":749},[],[751],{"type":48,"value":752},"containingProject: { name, mpsProjectBaseDirectory }",{"type":48,"value":349},{"type":42,"tag":62,"props":755,"children":757},{"className":756},[],[758],{"type":48,"value":759},"editableFromCurrentProject: false",{"type":48,"value":761},"; nested references use prefixes such as ",{"type":42,"tag":62,"props":763,"children":765},{"className":764},[],[766],{"type":48,"value":767},"conceptContainingProject",{"type":48,"value":220},{"type":42,"tag":62,"props":770,"children":772},{"className":771},[],[773],{"type":48,"value":774},"targetContainingProject",{"type":48,"value":776},", or ",{"type":42,"tag":62,"props":778,"children":780},{"className":779},[],[781],{"type":48,"value":782},"typeContainingProject",{"type":48,"value":784},". These markers appear ",{"type":42,"tag":430,"props":786,"children":787},{},[788],{"type":48,"value":789},"only",{"type":48,"value":791}," for elements owned by another open project — their absence does not imply an element is editable (a read-only library\u002Fstub in the current project carries ",{"type":42,"tag":62,"props":793,"children":795},{"className":794},[],[796],{"type":48,"value":797},"readOnly: true",{"type":48,"value":799}," but no ",{"type":42,"tag":62,"props":801,"children":803},{"className":802},[],[804],{"type":48,"value":805},"containingProject",{"type":48,"value":807},"), so decide editability from ",{"type":42,"tag":62,"props":809,"children":811},{"className":810},[],[812],{"type":48,"value":813},"readOnly",{"type":48,"value":815}," together with these markers.",{"type":42,"tag":51,"props":817,"children":818},{},[819,824,826,831,833,838,840,846,848,852,854,859],{"type":42,"tag":85,"props":820,"children":821},{},[822],{"type":48,"value":823},"When in doubt, ask which project.",{"type":48,"value":825}," When several MPS projects are open under one repository \u002F VCS root, the ",{"type":42,"tag":62,"props":827,"children":829},{"className":828},[],[830],{"type":48,"value":113},{"type":48,"value":832}," tools accept ",{"type":42,"tag":430,"props":834,"children":835},{},[836],{"type":48,"value":837},"any",{"type":48,"value":839}," valid project path and act relative to that project. Same-name resolution prefers the selected project's own elements before falling back to the shared repository, but an explicit reference may still resolve to another open project. If the intended project is not obvious from the user's request or the current editor focus (",{"type":42,"tag":62,"props":841,"children":843},{"className":842},[],[844],{"type":48,"value":845},"mps_mcp_get_current_editor_root_node",{"type":48,"value":847},"), do ",{"type":42,"tag":85,"props":849,"children":850},{},[851],{"type":48,"value":376},{"type":48,"value":853}," guess — show the ",{"type":42,"tag":62,"props":855,"children":857},{"className":856},[],[858],{"type":48,"value":646},{"type":48,"value":860}," entries and ask the user which project the query or change should run against.",{"type":42,"tag":71,"props":862,"children":864},{"id":863},"companion-skills",[865],{"type":48,"value":866},"Companion Skills",{"type":42,"tag":51,"props":868,"children":869},{},[870,872,878,880,886],{"type":48,"value":871},"All MPS skills live in a per-harness directory loaded by the agent host (e.g. ",{"type":42,"tag":62,"props":873,"children":875},{"className":874},[],[876],{"type":48,"value":877},".agents\u002Fskills\u002F\u003Cskill-name>\u002FSKILL.md",{"type":48,"value":879}," for AGENTS.md-aware hosts, ",{"type":42,"tag":62,"props":881,"children":883},{"className":882},[],[884],{"type":48,"value":885},".claude\u002Fskills\u002F\u003Cskill-name>\u002FSKILL.md",{"type":48,"value":887}," for Claude Code). Load whichever ones apply to your current task.",{"type":42,"tag":78,"props":889,"children":890},{},[891],{"type":42,"tag":51,"props":892,"children":893},{},[894,899,901,907,909,914,915,920,922,927,929,934,936,940,942,948,950,954,956,961,963,967,969,974,976,981,983,988,990,996,997,1003,1005,1011,1013,1019,1021,1026,1027,1032],{"type":42,"tag":85,"props":895,"children":896},{},[897],{"type":48,"value":898},"Installing \u002F refreshing the catalog.",{"type":48,"value":900}," These ",{"type":42,"tag":62,"props":902,"children":904},{"className":903},[],[905],{"type":48,"value":906},"mps-*",{"type":48,"value":908}," skills and the project's ",{"type":42,"tag":62,"props":910,"children":912},{"className":911},[],[913],{"type":48,"value":67},{"type":48,"value":479},{"type":42,"tag":62,"props":916,"children":918},{"className":917},[],[919],{"type":48,"value":719},{"type":48,"value":921}," are installed and refreshed by the ",{"type":42,"tag":62,"props":923,"children":925},{"className":924},[],[926],{"type":48,"value":675},{"type":48,"value":928}," MCP tool. It installs into a ",{"type":42,"tag":62,"props":930,"children":932},{"className":931},[],[933],{"type":48,"value":683},{"type":48,"value":935}," — normally your ",{"type":42,"tag":85,"props":937,"children":938},{},[939],{"type":48,"value":690},{"type":48,"value":941}," (the folder containing ",{"type":42,"tag":62,"props":943,"children":945},{"className":944},[],[946],{"type":48,"value":947},".git",{"type":48,"value":949},"), which may be an ",{"type":42,"tag":430,"props":951,"children":952},{},[953],{"type":48,"value":726},{"type":48,"value":955}," of the MPS project directory when the project sits in a subdirectory; leave ",{"type":42,"tag":62,"props":957,"children":959},{"className":958},[],[960],{"type":48,"value":683},{"type":48,"value":962}," empty to let the tool derive that root from the open project's enclosing VCS folder, and do ",{"type":42,"tag":85,"props":964,"children":965},{},[966],{"type":48,"value":376},{"type":48,"value":968}," pass it ",{"type":42,"tag":62,"props":970,"children":972},{"className":971},[],[973],{"type":48,"value":744},{"type":48,"value":975},". If no ",{"type":42,"tag":62,"props":977,"children":979},{"className":978},[],[980],{"type":48,"value":906},{"type":48,"value":982}," skills exist yet, the project has not been initialized for agents — tell the user and offer to run it. If the catalog looks stale or incomplete, offer to refresh it (with approval): delete every ",{"type":42,"tag":62,"props":984,"children":986},{"className":985},[],[987],{"type":48,"value":906},{"type":48,"value":989}," skill folder from ",{"type":42,"tag":62,"props":991,"children":993},{"className":992},[],[994],{"type":48,"value":995},".agents\u002Fskills\u002F",{"type":48,"value":349},{"type":42,"tag":62,"props":998,"children":1000},{"className":999},[],[1001],{"type":48,"value":1002},".claude\u002Fskills\u002F",{"type":48,"value":1004}," — keeping any project-local ",{"type":42,"tag":62,"props":1006,"children":1008},{"className":1007},[],[1009],{"type":48,"value":1010},"*-dsl",{"type":48,"value":1012}," skills — re-run the tool, then carefully merge its returned ",{"type":42,"tag":62,"props":1014,"children":1016},{"className":1015},[],[1017],{"type":48,"value":1018},"agentsFileText",{"type":48,"value":1020}," into ",{"type":42,"tag":62,"props":1022,"children":1024},{"className":1023},[],[1025],{"type":48,"value":67},{"type":48,"value":479},{"type":42,"tag":62,"props":1028,"children":1030},{"className":1029},[],[1031],{"type":48,"value":719},{"type":48,"value":1033},", preserving project-specific sections. See that tool's description for the exact refresh contract.",{"type":42,"tag":1035,"props":1036,"children":1037},"table",{},[1038,1057],{"type":42,"tag":1039,"props":1040,"children":1041},"thead",{},[1042],{"type":42,"tag":1043,"props":1044,"children":1045},"tr",{},[1046,1052],{"type":42,"tag":1047,"props":1048,"children":1049},"th",{},[1050],{"type":48,"value":1051},"Skill",{"type":42,"tag":1047,"props":1053,"children":1054},{},[1055],{"type":48,"value":1056},"What it covers",{"type":42,"tag":1058,"props":1059,"children":1060},"tbody",{},[1061,1079,1103,1134,1159,1176,1193,1210,1227,1252,1269,1286,1303,1320,1337,1354,1371,1388,1405,1422,1439,1456,1480,1503,1520,1545,1562],{"type":42,"tag":1043,"props":1062,"children":1063},{},[1064,1074],{"type":42,"tag":1065,"props":1066,"children":1067},"td",{},[1068],{"type":42,"tag":62,"props":1069,"children":1071},{"className":1070},[],[1072],{"type":48,"value":1073},"mps-language-aspects-overview",{"type":42,"tag":1065,"props":1075,"children":1076},{},[1077],{"type":48,"value":1078},"Entry point for defining an MPS language — lists the aspects, what each owns, and the typical authoring order. Start here.",{"type":42,"tag":1043,"props":1080,"children":1081},{},[1082,1091],{"type":42,"tag":1065,"props":1083,"children":1084},{},[1085],{"type":42,"tag":62,"props":1086,"children":1088},{"className":1087},[],[1089],{"type":48,"value":1090},"mps-language-modularity",{"type":42,"tag":1065,"props":1092,"children":1093},{},[1094,1096,1101],{"type":48,"value":1095},"Design tier for multi-language work — choose between referencing, extension, reuse, and embedding ",{"type":42,"tag":430,"props":1097,"children":1098},{},[1099],{"type":48,"value":1100},"before",{"type":48,"value":1102}," authoring aspects, then route into the aspect skills. Use when one language must see, extend, embed, or adapt another.",{"type":42,"tag":1043,"props":1104,"children":1105},{},[1106,1115],{"type":42,"tag":1065,"props":1107,"children":1108},{},[1109],{"type":42,"tag":62,"props":1110,"children":1112},{"className":1111},[],[1113],{"type":48,"value":1114},"mps-aspect-structure-concepts",{"type":42,"tag":1065,"props":1116,"children":1117},{},[1118,1120,1125,1126,1132],{"type":48,"value":1119},"Define concepts, interface concepts, enumerations, and constrained data types. Includes the full ",{"type":42,"tag":62,"props":1121,"children":1123},{"className":1122},[],[1124],{"type":48,"value":286},{"type":48,"value":135},{"type":42,"tag":62,"props":1127,"children":1129},{"className":1128},[],[1130],{"type":48,"value":1131},"mps_mcp_query_structure",{"type":48,"value":1133}," reference.",{"type":42,"tag":1043,"props":1135,"children":1136},{},[1137,1146],{"type":42,"tag":1065,"props":1138,"children":1139},{},[1140],{"type":42,"tag":62,"props":1141,"children":1143},{"className":1142},[],[1144],{"type":48,"value":1145},"mps-baselanguage",{"type":42,"tag":1065,"props":1147,"children":1148},{},[1149,1151,1157],{"type":48,"value":1150},"Author and edit ",{"type":42,"tag":62,"props":1152,"children":1154},{"className":1153},[],[1155],{"type":48,"value":1156},"jetbrains.mps.baseLanguage",{"type":48,"value":1158}," (Java) nodes — parser vs. JSON AST, concept mapping, reference harvesting, validation. Load when writing any Java\u002FBaseLanguage code in MPS.",{"type":42,"tag":1043,"props":1160,"children":1161},{},[1162,1171],{"type":42,"tag":1065,"props":1163,"children":1164},{},[1165],{"type":42,"tag":62,"props":1166,"children":1168},{"className":1167},[],[1169],{"type":48,"value":1170},"mps-model-manipulation",{"type":42,"tag":1065,"props":1172,"children":1173},{},[1174],{"type":48,"value":1175},"Write and edit MPS BaseLanguage code that uses smodel, closures, and collections — manipulating nodes, lists, and queries. Use when editing checking rules, behavior methods, typesystem rules, or any model code that manipulates nodes.",{"type":42,"tag":1043,"props":1177,"children":1178},{},[1179,1188],{"type":42,"tag":1065,"props":1180,"children":1181},{},[1182],{"type":42,"tag":62,"props":1183,"children":1185},{"className":1184},[],[1186],{"type":48,"value":1187},"mps-aspect-accessories",{"type":42,"tag":1065,"props":1189,"children":1190},{},[1191],{"type":48,"value":1192},"Module\u002Fmodel dependencies, used languages, runtime solutions, accessory models.",{"type":42,"tag":1043,"props":1194,"children":1195},{},[1196,1205],{"type":42,"tag":1065,"props":1197,"children":1198},{},[1199],{"type":42,"tag":62,"props":1200,"children":1202},{"className":1201},[],[1203],{"type":48,"value":1204},"mps-aspect-actions",{"type":42,"tag":1065,"props":1206,"children":1207},{},[1208],{"type":48,"value":1209},"Node factories (the \"actions\" aspect) — concept-specific setup functions for newly created nodes.",{"type":42,"tag":1043,"props":1211,"children":1212},{},[1213,1222],{"type":42,"tag":1065,"props":1214,"children":1215},{},[1216],{"type":42,"tag":62,"props":1217,"children":1219},{"className":1218},[],[1220],{"type":48,"value":1221},"mps-aspect-behavior",{"type":42,"tag":1065,"props":1223,"children":1224},{},[1225],{"type":48,"value":1226},"ConceptBehavior — per-concept methods, constructors, virtual dispatch, calling behavior from other aspects.",{"type":42,"tag":1043,"props":1228,"children":1229},{},[1230,1239],{"type":42,"tag":1065,"props":1231,"children":1232},{},[1233],{"type":42,"tag":62,"props":1234,"children":1236},{"className":1235},[],[1237],{"type":48,"value":1238},"mps-aspect-constraints",{"type":42,"tag":1065,"props":1240,"children":1241},{},[1242,1244,1250],{"type":48,"value":1243},"Property validators\u002Fsetters, referent scopes, ",{"type":42,"tag":62,"props":1245,"children":1247},{"className":1246},[],[1248],{"type":48,"value":1249},"canBe*",{"type":48,"value":1251}," rules (canBeChild\u002FParent\u002FAncestor\u002FRoot).",{"type":42,"tag":1043,"props":1253,"children":1254},{},[1255,1264],{"type":42,"tag":1065,"props":1256,"children":1257},{},[1258],{"type":42,"tag":62,"props":1259,"children":1261},{"className":1260},[],[1262],{"type":48,"value":1263},"mps-aspect-dataflow",{"type":42,"tag":1065,"props":1265,"children":1266},{},[1267],{"type":48,"value":1268},"Dataflow builders — control and data flow declarations for concept nodes, reachability analysis, variable-use checking.",{"type":42,"tag":1043,"props":1270,"children":1271},{},[1272,1281],{"type":42,"tag":1065,"props":1273,"children":1274},{},[1275],{"type":42,"tag":62,"props":1276,"children":1278},{"className":1277},[],[1279],{"type":48,"value":1280},"mps-aspect-editor-menus-and-keymaps",{"type":42,"tag":1065,"props":1282,"children":1283},{},[1284],{"type":48,"value":1285},"Non-layout parts of the MPS editor aspect — action maps, cell keymaps, transformation\u002Fsubstitute menus, side transforms, paste handlers, completion styling.",{"type":42,"tag":1043,"props":1287,"children":1288},{},[1289,1298],{"type":42,"tag":1065,"props":1290,"children":1291},{},[1292],{"type":42,"tag":62,"props":1293,"children":1295},{"className":1294},[],[1296],{"type":48,"value":1297},"mps-aspect-generator",{"type":42,"tag":1065,"props":1299,"children":1300},{},[1301],{"type":48,"value":1302},"Generator templates — root mapping rules, reduction rules, macros, mapping labels.",{"type":42,"tag":1043,"props":1304,"children":1305},{},[1306,1315],{"type":42,"tag":1065,"props":1307,"children":1308},{},[1309],{"type":42,"tag":62,"props":1310,"children":1312},{"className":1311},[],[1313],{"type":48,"value":1314},"mps-aspect-generation-plan",{"type":42,"tag":1065,"props":1316,"children":1317},{},[1318],{"type":48,"value":1319},"Generation plans — explicit ordering of generation steps, checkpoints, forks, plan contributions.",{"type":42,"tag":1043,"props":1321,"children":1322},{},[1323,1332],{"type":42,"tag":1065,"props":1324,"children":1325},{},[1326],{"type":42,"tag":62,"props":1327,"children":1329},{"className":1328},[],[1330],{"type":48,"value":1331},"mps-aspect-intentions",{"type":42,"tag":1065,"props":1333,"children":1334},{},[1335],{"type":48,"value":1336},"Intentions — Alt+Enter context actions, parameterized\u002Fsurround\u002Fquick-fix variants.",{"type":42,"tag":1043,"props":1338,"children":1339},{},[1340,1349],{"type":42,"tag":1065,"props":1341,"children":1342},{},[1343],{"type":42,"tag":62,"props":1344,"children":1346},{"className":1345},[],[1347],{"type":48,"value":1348},"mps-aspect-migrations",{"type":42,"tag":1065,"props":1350,"children":1351},{},[1352],{"type":48,"value":1353},"Migration scripts — upgrading user models when language definitions change.",{"type":42,"tag":1043,"props":1355,"children":1356},{},[1357,1366],{"type":42,"tag":1065,"props":1358,"children":1359},{},[1360],{"type":42,"tag":62,"props":1361,"children":1363},{"className":1362},[],[1364],{"type":48,"value":1365},"mps-aspect-textgen",{"type":42,"tag":1065,"props":1367,"children":1368},{},[1369],{"type":48,"value":1370},"TextGen — concept-to-plain-text serialization rules.",{"type":42,"tag":1043,"props":1372,"children":1373},{},[1374,1383],{"type":42,"tag":1065,"props":1375,"children":1376},{},[1377],{"type":42,"tag":62,"props":1378,"children":1380},{"className":1379},[],[1381],{"type":48,"value":1382},"mps-aspect-typesystem",{"type":42,"tag":1065,"props":1384,"children":1385},{},[1386],{"type":48,"value":1387},"Typesystem — inference rules, subtyping, replacement, comparison, non-typesystem checking.",{"type":42,"tag":1043,"props":1389,"children":1390},{},[1391,1400],{"type":42,"tag":1065,"props":1392,"children":1393},{},[1394],{"type":42,"tag":62,"props":1395,"children":1397},{"className":1396},[],[1398],{"type":48,"value":1399},"mps-aspect-editor",{"type":42,"tag":1065,"props":1401,"children":1402},{},[1403],{"type":48,"value":1404},"Overall workflow for creating and changing MPS editor definitions — scaffolding, componentizing, cell models, layouts, styles, validation.",{"type":42,"tag":1043,"props":1406,"children":1407},{},[1408,1417],{"type":42,"tag":1065,"props":1409,"children":1410},{},[1411],{"type":42,"tag":62,"props":1412,"children":1414},{"className":1413},[],[1415],{"type":48,"value":1416},"mps-language-analysis",{"type":42,"tag":1065,"props":1418,"children":1419},{},[1420],{"type":48,"value":1421},"Analyze MPS language definitions — discover concepts, metadata, aspects, sample nodes.",{"type":42,"tag":1043,"props":1423,"children":1424},{},[1425,1434],{"type":42,"tag":1065,"props":1426,"children":1427},{},[1428],{"type":42,"tag":62,"props":1429,"children":1431},{"className":1430},[],[1432],{"type":48,"value":1433},"mps-language-inheritance",{"type":42,"tag":1065,"props":1435,"children":1436},{},[1437],{"type":48,"value":1438},"Investigate inheritance between MPS languages and concepts — extends, super, sub, assignable.",{"type":42,"tag":1043,"props":1440,"children":1441},{},[1442,1451],{"type":42,"tag":1065,"props":1443,"children":1444},{},[1445],{"type":42,"tag":62,"props":1446,"children":1448},{"className":1447},[],[1449],{"type":48,"value":1450},"mps-node-editing",{"type":42,"tag":1065,"props":1452,"children":1453},{},[1454],{"type":48,"value":1455},"Modify MPS nodes using JSON blueprints — the canonical workflow for any node mutation.",{"type":42,"tag":1043,"props":1457,"children":1458},{},[1459,1468],{"type":42,"tag":1065,"props":1460,"children":1461},{},[1462],{"type":42,"tag":62,"props":1463,"children":1465},{"className":1464},[],[1466],{"type":48,"value":1467},"mps-dsl-memory",{"type":42,"tag":1065,"props":1469,"children":1470},{},[1471,1473,1479],{"type":48,"value":1472},"Explore a live MPS DSL project and create or refresh generated project-local DSL skills under ",{"type":42,"tag":62,"props":1474,"children":1476},{"className":1475},[],[1477],{"type":48,"value":1478},".agents\u002Fskills\u002F\u003Cdsl-name>-dsl\u002F",{"type":48,"value":542},{"type":42,"tag":1043,"props":1481,"children":1482},{},[1483,1492],{"type":42,"tag":1065,"props":1484,"children":1485},{},[1486],{"type":42,"tag":62,"props":1487,"children":1489},{"className":1488},[],[1490],{"type":48,"value":1491},"mps-lang-core-xml",{"type":42,"tag":1065,"props":1493,"children":1494},{},[1495,1501],{"type":42,"tag":62,"props":1496,"children":1498},{"className":1497},[],[1499],{"type":48,"value":1500},"jetbrains.mps.core.xml",{"type":48,"value":1502}," language for authoring XML documents and XML-generating generator templates.",{"type":42,"tag":1043,"props":1504,"children":1505},{},[1506,1515],{"type":42,"tag":1065,"props":1507,"children":1508},{},[1509],{"type":42,"tag":62,"props":1510,"children":1512},{"className":1511},[],[1513],{"type":48,"value":1514},"mps-quotations",{"type":42,"tag":1065,"props":1516,"children":1517},{},[1518],{"type":48,"value":1519},"MPS quotations and anti-quotations — node literals creating SNode trees inline in behavior\u002Fgenerator\u002Fmodel code.",{"type":42,"tag":1043,"props":1521,"children":1522},{},[1523,1532],{"type":42,"tag":1065,"props":1524,"children":1525},{},[1526],{"type":42,"tag":62,"props":1527,"children":1529},{"className":1528},[],[1530],{"type":48,"value":1531},"mps-build-language",{"type":42,"tag":1065,"props":1533,"children":1534},{},[1535,1537,1543],{"type":48,"value":1536},"MPS Build Language — declarative DSL generating Ant ",{"type":42,"tag":62,"props":1538,"children":1540},{"className":1539},[],[1541],{"type":48,"value":1542},"build.xml",{"type":48,"value":1544}," files for packaging plugins, Java modules, standalone IDEs.",{"type":42,"tag":1043,"props":1546,"children":1547},{},[1548,1557],{"type":42,"tag":1065,"props":1549,"children":1550},{},[1551],{"type":42,"tag":62,"props":1552,"children":1554},{"className":1553},[],[1555],{"type":48,"value":1556},"mps-ide-plugin",{"type":42,"tag":1065,"props":1558,"children":1559},{},[1560],{"type":48,"value":1561},"MPS IDE plugins — actions, action groups, tool windows, keymaps, preference components.",{"type":42,"tag":1043,"props":1563,"children":1564},{},[1565,1574],{"type":42,"tag":1065,"props":1566,"children":1567},{},[1568],{"type":42,"tag":62,"props":1569,"children":1571},{"className":1570},[],[1572],{"type":48,"value":1573},"mps-bugfix",{"type":42,"tag":1065,"props":1575,"children":1576},{},[1577],{"type":48,"value":1578},"MPS bugfixing workflow.",{"type":42,"tag":71,"props":1580,"children":1582},{"id":1581},"key-concepts",[1583],{"type":48,"value":1584},"Key Concepts",{"type":42,"tag":51,"props":1586,"children":1587},{},[1588],{"type":48,"value":1589},"MPS is a projectional editor and a language workbench. Unlike text-based IDEs, MPS works with an Abstract Syntax Tree (AST) directly. JSON is used to represent MPS nodes and their properties in a structured format for the MPS tools.",{"type":42,"tag":117,"props":1591,"children":1592},{},[1593,1646,1662,1684,1701,1711,1716,1721],{"type":42,"tag":121,"props":1594,"children":1595},{},[1596,1601,1603],{"type":42,"tag":85,"props":1597,"children":1598},{},[1599],{"type":48,"value":1600},"Modules",{"type":48,"value":1602},": The top-level containers in an MPS project.\n",{"type":42,"tag":117,"props":1604,"children":1605},{},[1606,1616,1626,1636],{"type":42,"tag":121,"props":1607,"children":1608},{},[1609,1614],{"type":42,"tag":85,"props":1610,"children":1611},{},[1612],{"type":48,"value":1613},"Solution",{"type":48,"value":1615},": contains user code (models).",{"type":42,"tag":121,"props":1617,"children":1618},{},[1619,1624],{"type":42,"tag":85,"props":1620,"children":1621},{},[1622],{"type":48,"value":1623},"Language",{"type":48,"value":1625},": defines a new language - structure (concepts and interface concepts), editor, etc.",{"type":42,"tag":121,"props":1627,"children":1628},{},[1629,1634],{"type":42,"tag":85,"props":1630,"children":1631},{},[1632],{"type":48,"value":1633},"Generator",{"type":48,"value":1635},": defines how to transform one language to another (usually to Java\u002FBaseLanguage). May belong to a language or be independent.",{"type":42,"tag":121,"props":1637,"children":1638},{},[1639,1644],{"type":42,"tag":85,"props":1640,"children":1641},{},[1642],{"type":48,"value":1643},"DevKit",{"type":48,"value":1645},": a bundle of languages and other devkits. DevKits can also export solutions and languages. Importing a DevKit into a module or model automatically makes all its exported languages and solutions available. This is the preferred way to manage common sets of languages and dependencies.",{"type":42,"tag":121,"props":1647,"children":1648},{},[1649,1654,1656,1661],{"type":42,"tag":85,"props":1650,"children":1651},{},[1652],{"type":48,"value":1653},"Models",{"type":48,"value":1655},": contained within modules. They hold a collection of ",{"type":42,"tag":85,"props":1657,"children":1658},{},[1659],{"type":48,"value":1660},"Root Nodes",{"type":48,"value":542},{"type":42,"tag":121,"props":1663,"children":1664},{},[1665,1670,1672],{"type":42,"tag":85,"props":1666,"children":1667},{},[1668],{"type":48,"value":1669},"Nodes",{"type":48,"value":1671},": the basic building blocks of the AST. Nodes are organized hierarchically.\n",{"type":42,"tag":117,"props":1673,"children":1674},{},[1675],{"type":42,"tag":121,"props":1676,"children":1677},{},[1678,1682],{"type":42,"tag":85,"props":1679,"children":1680},{},[1681],{"type":48,"value":1660},{"type":48,"value":1683},": the top-level nodes in a model.",{"type":42,"tag":121,"props":1685,"children":1686},{},[1687,1692,1694,1699],{"type":42,"tag":85,"props":1688,"children":1689},{},[1690],{"type":48,"value":1691},"Concepts",{"type":48,"value":1693},": define the \"type\" of a node (like a class in OOP). They define properties, children, and references. Concepts are defined in the ",{"type":42,"tag":85,"props":1695,"children":1696},{},[1697],{"type":48,"value":1698},"structure",{"type":48,"value":1700}," aspect of a language. Like in OOP, a concept can extend another concept and implement multiple interface concepts, which leads to subconcept-superconcept relationships and affects assignability of nodes into child or reference roles.",{"type":42,"tag":121,"props":1702,"children":1703},{},[1704,1709],{"type":42,"tag":85,"props":1705,"children":1706},{},[1707],{"type":48,"value":1708},"Aspects",{"type":48,"value":1710},": different parts of a language definition (Structure, Editor, Typesystem, Constraints, etc.). Technically, each aspect is a dedicated model inside a language's module.",{"type":42,"tag":121,"props":1712,"children":1713},{},[1714],{"type":48,"value":1715},"Some MPS modules and models can be read-only.",{"type":42,"tag":121,"props":1717,"children":1718},{},[1719],{"type":48,"value":1720},"MPS modules and models define dependencies between each other. DevKits can re-export dependencies on solutions and other devkits. If a module depends on a DevKit, it implicitly depends on all solutions exported by that DevKit.",{"type":42,"tag":121,"props":1722,"children":1723},{},[1724],{"type":48,"value":1725},"MPS models specify 'used languages'. If model A uses language L, nodes in model A can be instances of concepts from language L. Using a DevKit in a model automatically includes all languages exported by that DevKit (and any devkits it extends).",{"type":42,"tag":71,"props":1727,"children":1729},{"id":1728},"common-workflow-initialize-a-session",[1730],{"type":48,"value":1731},"Common Workflow — Initialize a Session",{"type":42,"tag":305,"props":1733,"children":1734},{},[1735,1760,1777,1814,1824],{"type":42,"tag":121,"props":1736,"children":1737},{},[1738,1743,1745,1751,1753,1758],{"type":42,"tag":85,"props":1739,"children":1740},{},[1741],{"type":48,"value":1742},"Check generated DSL skills",{"type":48,"value":1744}," under ",{"type":42,"tag":62,"props":1746,"children":1748},{"className":1747},[],[1749],{"type":48,"value":1750},".agents\u002Fskills\u002F*-dsl\u002F",{"type":48,"value":1752}," before starting unfamiliar DSL work. Use the relevant project-local DSL skill when it exists; if it is missing or stale, load ",{"type":42,"tag":62,"props":1754,"children":1756},{"className":1755},[],[1757],{"type":48,"value":1467},{"type":48,"value":1759}," to create or refresh it.",{"type":42,"tag":121,"props":1761,"children":1762},{},[1763,1768,1770,1775],{"type":42,"tag":85,"props":1764,"children":1765},{},[1766],{"type":48,"value":1767},"Anchor on the user's focus",{"type":48,"value":1769}," — call ",{"type":42,"tag":62,"props":1771,"children":1773},{"className":1772},[],[1774],{"type":48,"value":845},{"type":48,"value":1776}," so you know which root the user is looking at.",{"type":42,"tag":121,"props":1778,"children":1779},{},[1780,1785,1787,1792,1794,1799,1801,1806,1808,1813],{"type":42,"tag":85,"props":1781,"children":1782},{},[1783],{"type":48,"value":1784},"Identify the task family",{"type":48,"value":1786},": defining a language → load ",{"type":42,"tag":62,"props":1788,"children":1790},{"className":1789},[],[1791],{"type":48,"value":1073},{"type":48,"value":1793},". Editing user code → load ",{"type":42,"tag":62,"props":1795,"children":1797},{"className":1796},[],[1798],{"type":48,"value":1450},{"type":48,"value":1800}," and (often) ",{"type":42,"tag":62,"props":1802,"children":1804},{"className":1803},[],[1805],{"type":48,"value":1145},{"type":48,"value":1807},". Investigating an unfamiliar language → load ",{"type":42,"tag":62,"props":1809,"children":1811},{"className":1810},[],[1812],{"type":48,"value":1416},{"type":48,"value":542},{"type":42,"tag":121,"props":1815,"children":1816},{},[1817,1822],{"type":42,"tag":85,"props":1818,"children":1819},{},[1820],{"type":48,"value":1821},"Follow the matching aspect skill",{"type":48,"value":1823}," for the specific aspect you're touching.",{"type":42,"tag":121,"props":1825,"children":1826},{},[1827,1832,1833,1838],{"type":42,"tag":85,"props":1828,"children":1829},{},[1830],{"type":48,"value":1831},"Validate frequently",{"type":48,"value":341},{"type":42,"tag":62,"props":1834,"children":1836},{"className":1835},[],[1837],{"type":48,"value":261},{"type":48,"value":1839},". Rebuild\u002Freload after compiled-aspect changes.",{"type":42,"tag":71,"props":1841,"children":1843},{"id":1842},"essential-skills-detail",[1844],{"type":48,"value":1845},"Essential Skills (Detail)",{"type":42,"tag":51,"props":1847,"children":1848},{},[1849,1851,1857,1859,1865,1867,1873],{"type":48,"value":1850},"Open ",{"type":42,"tag":62,"props":1852,"children":1854},{"className":1853},[],[1855],{"type":48,"value":1856},"references\u002Ffinding-things.md",{"type":48,"value":1858}," for the protocol on finding models, modules, and languages (including shortened-name resolution like ",{"type":42,"tag":62,"props":1860,"children":1862},{"className":1861},[],[1863],{"type":48,"value":1864},"j.m.l.core",{"type":48,"value":1866}," → ",{"type":42,"tag":62,"props":1868,"children":1870},{"className":1869},[],[1871],{"type":48,"value":1872},"jetbrains.mps.lang.core",{"type":48,"value":324},{"type":42,"tag":51,"props":1875,"children":1876},{},[1877,1878,1884],{"type":48,"value":1850},{"type":42,"tag":62,"props":1879,"children":1881},{"className":1880},[],[1882],{"type":48,"value":1883},"references\u002Fnode-editing-rules.md",{"type":48,"value":1885}," for the full rulebook on adding\u002Fupdating nodes (concept selection, role types, cardinality, assignability, persistent IDs, surgical edits, reload after compiled-aspect changes).",{"type":42,"tag":51,"props":1887,"children":1888},{},[1889,1890,1896,1898,1904,1905,1911,1913,1919],{"type":48,"value":1850},{"type":42,"tag":62,"props":1891,"children":1893},{"className":1892},[],[1894],{"type":48,"value":1895},"references\u002Freference-formats.md",{"type":48,"value":1897}," for the reference-format protocol: node refs (",{"type":42,"tag":62,"props":1899,"children":1901},{"className":1900},[],[1902],{"type":48,"value":1903},"r:",{"type":48,"value":479},{"type":42,"tag":62,"props":1906,"children":1908},{"className":1907},[],[1909],{"type":48,"value":1910},"i:",{"type":48,"value":1912},"), concept refs (",{"type":42,"tag":62,"props":1914,"children":1916},{"className":1915},[],[1917],{"type":48,"value":1918},"c:",{"type":48,"value":1920},"), and the critical \"never use a concept ref where a node ref is expected\" rule.",{"type":42,"tag":51,"props":1922,"children":1923},{},[1924,1925,1931],{"type":48,"value":1850},{"type":42,"tag":62,"props":1926,"children":1928},{"className":1927},[],[1929],{"type":48,"value":1930},"references\u002Fbulk-creation.md",{"type":48,"value":1932}," for the print-shallow-then-add-children staged construction workflow used when subtrees exceed the JSON size limit.",{"type":42,"tag":51,"props":1934,"children":1935},{},[1936,1937,1943,1945,1951,1952,1957,1959,1965,1966,1972,1973,1979,1980,1986,1987,1993],{"type":48,"value":1850},{"type":42,"tag":62,"props":1938,"children":1940},{"className":1939},[],[1941],{"type":48,"value":1942},"references\u002Fanalysis-tools.md",{"type":48,"value":1944}," for the inventory of analysis operations (",{"type":42,"tag":62,"props":1946,"children":1948},{"className":1947},[],[1949],{"type":48,"value":1950},"mps_mcp_print_node",{"type":48,"value":220},{"type":42,"tag":62,"props":1953,"children":1955},{"className":1954},[],[1956],{"type":48,"value":261},{"type":48,"value":1958}," with its ",{"type":42,"tag":62,"props":1960,"children":1962},{"className":1961},[],[1963],{"type":48,"value":1964},"quickFixes",{"type":48,"value":479},{"type":42,"tag":62,"props":1967,"children":1969},{"className":1968},[],[1970],{"type":48,"value":1971},"autoApplyQuickFixes",{"type":48,"value":220},{"type":42,"tag":62,"props":1974,"children":1976},{"className":1975},[],[1977],{"type":48,"value":1978},"mps_mcp_list_node_intentions",{"type":48,"value":135},{"type":42,"tag":62,"props":1981,"children":1983},{"className":1982},[],[1984],{"type":48,"value":1985},"mps_mcp_apply_intention",{"type":48,"value":220},{"type":42,"tag":62,"props":1988,"children":1990},{"className":1989},[],[1991],{"type":48,"value":1992},"mps_mcp_alter_nodes FIX_REFERENCES",{"type":48,"value":1994},", etc.).",{"type":42,"tag":51,"props":1996,"children":1997},{},[1998,1999,2005],{"type":48,"value":1850},{"type":42,"tag":62,"props":2000,"children":2002},{"className":2001},[],[2003],{"type":48,"value":2004},"references\u002Feditor-workflow.md",{"type":48,"value":2006}," for the MPS Concept Editor workflow (scaffold → componentize → refine → validate) and the editor procedural guidelines.",{"type":42,"tag":51,"props":2008,"children":2009},{},[2010,2011,2017],{"type":48,"value":1850},{"type":42,"tag":62,"props":2012,"children":2014},{"className":2013},[],[2015],{"type":48,"value":2016},"references\u002Fmcp-tools-index.md",{"type":48,"value":2018}," for the complete inventory of MPS MCP tools grouped by Project\u002FStructure, Modules and Models, Root Nodes and Nodes, Console, and Language Definition.",{"type":42,"tag":71,"props":2020,"children":2022},{"id":2021},"boundaries",[2023],{"type":48,"value":2024},"Boundaries",{"type":42,"tag":117,"props":2026,"children":2027},{},[2028,2045,2076],{"type":42,"tag":121,"props":2029,"children":2030},{},[2031,2036,2038,2043],{"type":42,"tag":85,"props":2032,"children":2033},{},[2034],{"type":48,"value":2035},"Do not",{"type":48,"value":2037}," edit serialized ",{"type":42,"tag":62,"props":2039,"children":2041},{"className":2040},[],[2042],{"type":48,"value":95},{"type":48,"value":2044}," model files as plain text unless the user explicitly asks for it.",{"type":42,"tag":121,"props":2046,"children":2047},{},[2048,2052,2054,2059,2061,2067,2068,2074],{"type":42,"tag":85,"props":2049,"children":2050},{},[2051],{"type":48,"value":2035},{"type":48,"value":2053}," edit ",{"type":42,"tag":62,"props":2055,"children":2057},{"className":2056},[],[2058],{"type":48,"value":103},{"type":48,"value":2060}," module descriptors manually if an MCP wiring tool (",{"type":42,"tag":62,"props":2062,"children":2064},{"className":2063},[],[2065],{"type":48,"value":2066},"mps_mcp_module_dependency",{"type":48,"value":220},{"type":42,"tag":62,"props":2069,"children":2071},{"className":2070},[],[2072],{"type":48,"value":2073},"mps_mcp_update_module",{"type":48,"value":2075},", …) covers the change.",{"type":42,"tag":121,"props":2077,"children":2078},{},[2079,2083],{"type":42,"tag":85,"props":2080,"children":2081},{},[2082],{"type":48,"value":2035},{"type":48,"value":2084}," delete-and-reinsert a node to \"change\" it when surgical tools exist.",{"items":2086,"total":2201},[2087,2100,2108,2116,2126,2135,2147,2155,2163,2172,2180,2192],{"slug":1187,"name":1187,"fn":2088,"description":2089,"org":2090,"tags":2091,"stars":22,"repoUrl":23,"updatedAt":2099},"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},[2092,2095,2098],{"name":2093,"slug":2094,"type":15},"Architecture","architecture",{"name":2096,"slug":2097,"type":15},"Configuration","configuration",{"name":20,"slug":21,"type":15},"2026-07-17T06:06:57.311661",{"slug":1204,"name":1204,"fn":2101,"description":2102,"org":2103,"tags":2104,"stars":22,"repoUrl":23,"updatedAt":2107},"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},[2105,2106],{"name":2093,"slug":2094,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:04:48.066901",{"slug":1221,"name":1221,"fn":2109,"description":2110,"org":2111,"tags":2112,"stars":22,"repoUrl":23,"updatedAt":2115},"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},[2113,2114],{"name":2093,"slug":2094,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:45:21.757084",{"slug":1238,"name":1238,"fn":2117,"description":2118,"org":2119,"tags":2120,"stars":22,"repoUrl":23,"updatedAt":2125},"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},[2121,2122],{"name":2093,"slug":2094,"type":15},{"name":2123,"slug":2124,"type":15},"Code Analysis","code-analysis","2026-07-23T05:41:33.639365",{"slug":1263,"name":1263,"fn":2127,"description":2128,"org":2129,"tags":2130,"stars":22,"repoUrl":23,"updatedAt":2134},"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},[2131],{"name":2132,"slug":2133,"type":15},"Data Analysis","data-analysis","2026-07-13T06:45:19.114674",{"slug":1399,"name":1399,"fn":2136,"description":2137,"org":2138,"tags":2139,"stars":22,"repoUrl":23,"updatedAt":2146},"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},[2140,2143],{"name":2141,"slug":2142,"type":15},"Design","design",{"name":2144,"slug":2145,"type":15},"UI Components","ui-components","2026-07-23T05:41:56.638151",{"slug":1280,"name":1280,"fn":2148,"description":2149,"org":2150,"tags":2151,"stars":22,"repoUrl":23,"updatedAt":2154},"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},[2152,2153],{"name":20,"slug":21,"type":15},{"name":2144,"slug":2145,"type":15},"2026-07-23T05:41:49.666535",{"slug":1314,"name":1314,"fn":2156,"description":2157,"org":2158,"tags":2159,"stars":22,"repoUrl":23,"updatedAt":2162},"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},[2160,2161],{"name":2093,"slug":2094,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:44:59.507855",{"slug":1297,"name":1297,"fn":2164,"description":2165,"org":2166,"tags":2167,"stars":22,"repoUrl":23,"updatedAt":2171},"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},[2168,2169,2170],{"name":2093,"slug":2094,"type":15},{"name":2123,"slug":2124,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:06:58.042999",{"slug":1331,"name":1331,"fn":2173,"description":2174,"org":2175,"tags":2176,"stars":22,"repoUrl":23,"updatedAt":2179},"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},[2177,2178],{"name":2093,"slug":2094,"type":15},{"name":20,"slug":21,"type":15},"2026-07-23T05:41:48.692899",{"slug":1348,"name":1348,"fn":2181,"description":2182,"org":2183,"tags":2184,"stars":22,"repoUrl":23,"updatedAt":2191},"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},[2185,2188],{"name":2186,"slug":2187,"type":15},"Debugging","debugging",{"name":2189,"slug":2190,"type":15},"Migration","migration","2026-07-13T06:45:20.372122",{"slug":1114,"name":1114,"fn":2193,"description":2194,"org":2195,"tags":2196,"stars":22,"repoUrl":23,"updatedAt":2200},"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},[2197],{"name":2198,"slug":2199,"type":15},"Data Modeling","data-modeling","2026-07-23T05:41:30.705975",188,{"items":2203,"total":2239},[2204,2210,2215,2220,2225,2229,2234],{"slug":1187,"name":1187,"fn":2088,"description":2089,"org":2205,"tags":2206,"stars":22,"repoUrl":23,"updatedAt":2099},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2207,2208,2209],{"name":2093,"slug":2094,"type":15},{"name":2096,"slug":2097,"type":15},{"name":20,"slug":21,"type":15},{"slug":1204,"name":1204,"fn":2101,"description":2102,"org":2211,"tags":2212,"stars":22,"repoUrl":23,"updatedAt":2107},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2213,2214],{"name":2093,"slug":2094,"type":15},{"name":20,"slug":21,"type":15},{"slug":1221,"name":1221,"fn":2109,"description":2110,"org":2216,"tags":2217,"stars":22,"repoUrl":23,"updatedAt":2115},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2218,2219],{"name":2093,"slug":2094,"type":15},{"name":20,"slug":21,"type":15},{"slug":1238,"name":1238,"fn":2117,"description":2118,"org":2221,"tags":2222,"stars":22,"repoUrl":23,"updatedAt":2125},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2223,2224],{"name":2093,"slug":2094,"type":15},{"name":2123,"slug":2124,"type":15},{"slug":1263,"name":1263,"fn":2127,"description":2128,"org":2226,"tags":2227,"stars":22,"repoUrl":23,"updatedAt":2134},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2228],{"name":2132,"slug":2133,"type":15},{"slug":1399,"name":1399,"fn":2136,"description":2137,"org":2230,"tags":2231,"stars":22,"repoUrl":23,"updatedAt":2146},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2232,2233],{"name":2141,"slug":2142,"type":15},{"name":2144,"slug":2145,"type":15},{"slug":1280,"name":1280,"fn":2148,"description":2149,"org":2235,"tags":2236,"stars":22,"repoUrl":23,"updatedAt":2154},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[2237,2238],{"name":20,"slug":21,"type":15},{"name":2144,"slug":2145,"type":15},31]