[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-jetbrains-mps-distribution-build":3,"mdc-ouexw6-key":35,"related-repo-jetbrains-mps-distribution-build":1254,"related-org-jetbrains-mps-distribution-build":1332},{"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-distribution-build","bundle plugins into MPS distributions","Use when bundling a new plain Java\u002FKotlin plugin into MPS distribution archives, debugging packaging\u002Flayout issues in `build\u002Fmps*.xml`, tracing where per-plugin artefacts end up, or editing `plugins\u002Fmps-build\u002Fsolutions\u002FmpsBuild\u002Fmodels\u002Fbuild.mps` (the source of truth that generates every `build\u002Fmps*.xml`). The skill covers the generated Ant pipeline, plugin-to-distribution wiring, and the per-plugin \u002F aggregator \u002F distribution layers.",{"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},"Packaging","packaging","tag",{"name":17,"slug":18,"type":15},"Deployment","deployment",{"name":20,"slug":21,"type":15},"Engineering","engineering",1650,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS","2026-07-13T06:45:17.817461",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-distribution-build","---\nname: mps-distribution-build\ndescription: Use when bundling a new plain Java\u002FKotlin plugin into MPS distribution archives, debugging packaging\u002Flayout issues in `build\u002Fmps*.xml`, tracing where per-plugin artefacts end up, or editing `plugins\u002Fmps-build\u002Fsolutions\u002FmpsBuild\u002Fmodels\u002Fbuild.mps` (the source of truth that generates every `build\u002Fmps*.xml`). The skill covers the generated Ant pipeline, plugin-to-distribution wiring, and the per-plugin \u002F aggregator \u002F distribution layers.\ntype: reference\n---\n\n# MPS Distribution Build — Ant Pipeline & Plugin Bundling\n\nThis skill explains how the generated Ant scripts under `build\u002Fmps*.xml` assemble MPS distribution archives, and how to add a new plain Java\u002FKotlin plugin module (e.g. `plugins\u002Fmcp-tools`) so it ends up in the produced archives. Authoring the model that *generates* these Ant scripts is covered separately by `mps-build-language` — this skill focuses on the **output side** and the plugin-bundling touchpoints.\n\n## Critical Directives\n\n- **The Ant files are generated.** All `build\u002Fmps*.xml` files carry `\u003C!-- Generated by MPS -->`. Do not hand-edit them as a permanent solution — author the change in `plugins\u002Fmps-build\u002Fsolutions\u002FmpsBuild\u002Fmodels\u002Fbuild.mps` and regenerate.\n- A new per-plugin `BuildProject` is invisible to the distribution until it is **also** wired into the `mps` aggregator BuildProject and `mpsDistribution`. A plugin can build into `build\u002Fartifacts\u002F\u003CprojectName>\u002F` but never enter the final zip if `mps.xml` is not updated.\n- IDEA platform jars under `\u003CMPS>\u002Flib\u002F` and `\u003CMPS>\u002Fplugins\u002F\u003Cidea-plugin>\u002Flib\u002F` are fetched by `build.xml platform` (Ivy via `getDependencies.xml`). They do **not** exist on a clean checkout, and no `BuildProject` declares the fetch. Every per-plugin script implicitly requires `ant -f build\u002Fbuild.xml platform` to have already run.\n- There is **no `${idea.plugins.dir}` macro** — do not invent one. Reference fetched IDEA-plugin jars via `${basedir}\u002Fplugins\u002F\u003Cidea-plugin>\u002Flib\u002F` (matches the IDEA project libraries under `.idea\u002Flibraries\u002F*.xml`).\n- The `test\u002F` source root is not part of the production jar. Test compilation belongs in a sibling test-only `BuildProject` (cf. `mpsTesting.xml`), not layered onto the production jar.\n- Validate cheap first: regenerate, then run `ant -f build\u002F\u003CprojectName>.xml assemble` in isolation **before** running the full `build\u002Frun_build.sh`.\n\n## Common-Path Workflow — Bundle a New Plain Java\u002FKotlin Plugin\n\nRunning example: bundling `plugins\u002Fmcp-tools` (a `JAVA_MODULE` with Kotlin sources, depending on `com.intellij.mcpServer`).\n\n1. **Diagnose where the plugin currently is.** `grep -r \u003Cplugin-name> build\u002F` (empty → no generated Ant script). Look under `build\u002Fartifacts\u002F\u003CprojectName>\u002F`, `build\u002Fartifacts\u002Fmps\u002Fplugins\u002F\u003Cx>\u002F`, and the final `${build.number}*.zip` to find which layer is missing it. See `references\u002Fdiagnostics.md`.\n2. **Pick a shape.** Model it like `mpsHttpSupportPlugin` (Option A, preferred — full Ant compile pipeline) or like `mcpserver` \u002F `terminal` (Option B — pre-built, copied from `\u003CMPS>\u002Fplugins\u002F\u003Cx>\u002F` by `mpsStandalone`). See `references\u002Fplugin-bundling-options.md`.\n3. **Author in `build.mps`.** Add a `BuildProject \u003CprojectName>` with the right `BuildLayout` (Java\u002FKotlin source roots, `META-INF\u002Fplugin.xml`, jar packaging, dependencies via `BuildSource_JavaDependencyModule` \u002F `…ExternalJar`). Carry the `BuildJavaPlugin` marker so the generator emits a plain compile pipeline. Depend on `mpsBootstrapCore` (and likely `mpsCore` \u002F `mpsWorkbench`). See `references\u002Fbuild-mps-authoring.md`.\n4. **Wire it into the aggregator.** Edit the `mps` aggregator BuildProject so it imports `${artifacts.\u003CprojectName>}`, copies `${artifacts.\u003CprojectName>}\u002F\u003Cplugin-folder>` into `${build.layout}\u002Fplugins\u002F\u003Cplugin-folder>`, and invokes the new Ant file in its `buildDependents`. Add the same `\u003Cant antfile=\"build\u002F\u003CprojectName>.xml\" …\u002F>` line to `mpsDistribution.xml`'s `buildDependents`.\n5. **Regenerate** `build.mps`. A new `build\u002F\u003CprojectName>.xml` will appear; `build\u002Fmps.xml` and `build\u002FmpsDistribution.xml` will be updated by the same regeneration.\n6. **Smoke step (no full build).** Run `ant -f build\u002F\u003CprojectName>.xml assemble` in isolation. Pre-run `ant -f build\u002Fbuild.xml platform` once so the IDEA jars exist on disk.\n7. **Full build** via `build\u002Frun_build.sh`. Verify the three artefact locations in `references\u002Fvalidation.md`.\n8. If the plugin has a `test\u002F` source root, add a sibling test-only `BuildProject` (`\u003CprojectName>Tests`) — see `references\u002Ftest-suite-wiring.md`.\n\n## Pipeline at a Glance\n\n```\nbuild.xml                              build.txt              dependencies.properties\n   │                                       │                          │\n   ├─ platform              ───────────► Ivy fetches IDEA + libs into \u003CMPS>\u002Flib, \u003CMPS>\u002Fplugins\u002F*\n   │   (getDependencies.xml)\n   │\n   ├─ getResourcesAndBuildAll\n   │     └─ mpsDistribution.xml buildDependents\n   │            ├─ mpsTrueBootstrap.xml  ──┐\n   │            ├─ mpsBootstrapCore.xml    │  per-plugin Ant scripts\n   │            ├─ mpsCore.xml             │  (compile + jar + layout into\n   │            ├─ mpsWorkbench.xml        │   build\u002Fartifacts\u002F\u003CprojectName>\u002F)\n   │            ├─ mpsBuild.xml            │\n   │            ├─ mpsTesting.xml          │\n   │            ├─ mpsPlugins.xml          │\n   │            ├─ mpsJava.xml             │\n   │            ├─ mpsHttpSupportPlugin.xml│\n   │            ├─ mpsKotlinPlugin.xml     │\n   │            ├─ mpsContextActionsTool.xml│\n   │            ├─ … (30+ files)          ─┘\n   │            └─ mps.xml                 (aggregates into build\u002Fartifacts\u002Fmps\u002F)\n   │\n   └─ assemble\n         └─ mpsDistribution.xml assemble   (zips\u002Ftars into build\u002Fartifacts\u002FmpsDistribution\u002F)\n```\n\n## Related Skills\n\n- `mps-build-language` — when you are authoring or editing the build language model itself, not just consuming its output.\n- `mps-tests` — when the plugin you are bundling has a JUnit \u002F MPS test suite that must run in CI.\n- `mps-ide-plugin` — when the new module is an MPS IDE plugin (`plugin.xml`, actions, tool windows). Bundling and IDE-plugin authoring are independent steps.\n- `mps-aspect-generator` — when the failure is in MPS generation rather than packaging.\n\n## Reference Index\n\n- Open `references\u002Farchitecture.md` for the long form of \"how Ant files compose\" — entry point `build\u002Fbuild.xml` targets, the three layers of generated scripts (`mpsTrueBootstrap.xml`\u002F`mpsBootstrapCore.xml`\u002Fper-plugin files; `mps.xml` aggregator; `mpsStandalone.xml`), and the final distribution layer `mpsDistribution.xml` with its per-platform archives. Open when you need to know where a particular file lives in the pipeline or what its `buildDependents` does.\n- Open `references\u002Fbuild-mps-source-of-truth.md` when editing `plugins\u002Fmps-build\u002Fsolutions\u002FmpsBuild\u002Fmodels\u002Fbuild.mps` — explains the `BuildProject` structure, the meaning of opaque concept indices (`1l3spW`, `398b33`, `TrG5h`, `turDy`, `2DA0ip`, `1l3spV`, `10PD9b`), and how regeneration writes the `build\u002F*.xml` files.\n- Open `references\u002Fplugin-bundling-options.md` to choose between Option A (full Ant compile pipeline like `mpsHttpSupportPlugin`) and Option B (pre-built drop into `mpsStandalone`). Includes the rationale for picking Option A for new MPS-authored plugins.\n- Open `references\u002Fbuild-mps-authoring.md` when adding the new `BuildProject` to `build.mps` — `BuildLayout` shape, `BuildSource_JavaModule` \u002F `BuildSource_JavaContentRoot`, the `BuildJavaPlugin` marker, dependency chain through `mpsBootstrapCore`, and the convention for referencing fetched IDEA-plugin jars via `${basedir}\u002Fplugins\u002F\u003Cidea-plugin>\u002Flib\u002F`.\n- Open `references\u002Fdiagnostics.md` when a plugin is missing from the distribution and you need to figure out which layer dropped it — three-step diagnosis using `grep`, `build\u002Fartifacts\u002F\u003CprojectName>\u002F`, and `build\u002Fartifacts\u002Fmps\u002Fplugins\u002F\u003Cx>\u002F`.\n- Open `references\u002Fvalidation.md` for the two-stage validation procedure (cheap `ant -f build\u002F\u003CprojectName>.xml assemble` smoke step, then full `build\u002Frun_build.sh`) and the three artefact locations to verify after a full build.\n- Open `references\u002Ftouchpoint-checklist.md` for the table of files modified by adding a new Option A plugin — what is hand-edited (`build.mps`), what is regenerated (`build\u002F\u003CprojectName>.xml`, `build\u002Fmps.xml`, `build\u002FmpsDistribution.xml`), and what stays unchanged (`plugins\u002F\u003Cplugin>\u002FMETA-INF\u002Fplugin.xml`, `.iml`).\n- Open `references\u002Ftest-suite-wiring.md` when the new plugin has a `test\u002F` source root that must run in CI — sibling test-only `BuildProject`, JUnit launcher, and `…Tests.xml` aggregator wiring.\n- Open `references\u002Fkey-files.md` for the quick reference of every build file mentioned anywhere in this skill, with one-line descriptions.\n",{"data":36,"body":38},{"name":4,"description":6,"type":37},"reference",{"type":39,"children":40},"root",[41,50,97,104,345,351,378,772,778,790,796,850,856],{"type":42,"tag":43,"props":44,"children":46},"element","h1",{"id":45},"mps-distribution-build-ant-pipeline-plugin-bundling",[47],{"type":48,"value":49},"text","MPS Distribution Build — Ant Pipeline & Plugin Bundling",{"type":42,"tag":51,"props":52,"children":53},"p",{},[54,56,63,65,71,73,79,81,87,89,95],{"type":48,"value":55},"This skill explains how the generated Ant scripts under ",{"type":42,"tag":57,"props":58,"children":60},"code",{"className":59},[],[61],{"type":48,"value":62},"build\u002Fmps*.xml",{"type":48,"value":64}," assemble MPS distribution archives, and how to add a new plain Java\u002FKotlin plugin module (e.g. ",{"type":42,"tag":57,"props":66,"children":68},{"className":67},[],[69],{"type":48,"value":70},"plugins\u002Fmcp-tools",{"type":48,"value":72},") so it ends up in the produced archives. Authoring the model that ",{"type":42,"tag":74,"props":75,"children":76},"em",{},[77],{"type":48,"value":78},"generates",{"type":48,"value":80}," these Ant scripts is covered separately by ",{"type":42,"tag":57,"props":82,"children":84},{"className":83},[],[85],{"type":48,"value":86},"mps-build-language",{"type":48,"value":88}," — this skill focuses on the ",{"type":42,"tag":90,"props":91,"children":92},"strong",{},[93],{"type":48,"value":94},"output side",{"type":48,"value":96}," and the plugin-bundling touchpoints.",{"type":42,"tag":98,"props":99,"children":101},"h2",{"id":100},"critical-directives",[102],{"type":48,"value":103},"Critical Directives",{"type":42,"tag":105,"props":106,"children":107},"ul",{},[108,142,194,253,289,317],{"type":42,"tag":109,"props":110,"children":111},"li",{},[112,117,119,124,126,132,134,140],{"type":42,"tag":90,"props":113,"children":114},{},[115],{"type":48,"value":116},"The Ant files are generated.",{"type":48,"value":118}," All ",{"type":42,"tag":57,"props":120,"children":122},{"className":121},[],[123],{"type":48,"value":62},{"type":48,"value":125}," files carry ",{"type":42,"tag":57,"props":127,"children":129},{"className":128},[],[130],{"type":48,"value":131},"\u003C!-- Generated by MPS -->",{"type":48,"value":133},". Do not hand-edit them as a permanent solution — author the change in ",{"type":42,"tag":57,"props":135,"children":137},{"className":136},[],[138],{"type":48,"value":139},"plugins\u002Fmps-build\u002Fsolutions\u002FmpsBuild\u002Fmodels\u002Fbuild.mps",{"type":48,"value":141}," and regenerate.",{"type":42,"tag":109,"props":143,"children":144},{},[145,147,153,155,160,162,168,170,176,178,184,186,192],{"type":48,"value":146},"A new per-plugin ",{"type":42,"tag":57,"props":148,"children":150},{"className":149},[],[151],{"type":48,"value":152},"BuildProject",{"type":48,"value":154}," is invisible to the distribution until it is ",{"type":42,"tag":90,"props":156,"children":157},{},[158],{"type":48,"value":159},"also",{"type":48,"value":161}," wired into the ",{"type":42,"tag":57,"props":163,"children":165},{"className":164},[],[166],{"type":48,"value":167},"mps",{"type":48,"value":169}," aggregator BuildProject and ",{"type":42,"tag":57,"props":171,"children":173},{"className":172},[],[174],{"type":48,"value":175},"mpsDistribution",{"type":48,"value":177},". A plugin can build into ",{"type":42,"tag":57,"props":179,"children":181},{"className":180},[],[182],{"type":48,"value":183},"build\u002Fartifacts\u002F\u003CprojectName>\u002F",{"type":48,"value":185}," but never enter the final zip if ",{"type":42,"tag":57,"props":187,"children":189},{"className":188},[],[190],{"type":48,"value":191},"mps.xml",{"type":48,"value":193}," is not updated.",{"type":42,"tag":109,"props":195,"children":196},{},[197,199,205,207,213,215,221,223,229,231,236,238,243,245,251],{"type":48,"value":198},"IDEA platform jars under ",{"type":42,"tag":57,"props":200,"children":202},{"className":201},[],[203],{"type":48,"value":204},"\u003CMPS>\u002Flib\u002F",{"type":48,"value":206}," and ",{"type":42,"tag":57,"props":208,"children":210},{"className":209},[],[211],{"type":48,"value":212},"\u003CMPS>\u002Fplugins\u002F\u003Cidea-plugin>\u002Flib\u002F",{"type":48,"value":214}," are fetched by ",{"type":42,"tag":57,"props":216,"children":218},{"className":217},[],[219],{"type":48,"value":220},"build.xml platform",{"type":48,"value":222}," (Ivy via ",{"type":42,"tag":57,"props":224,"children":226},{"className":225},[],[227],{"type":48,"value":228},"getDependencies.xml",{"type":48,"value":230},"). They do ",{"type":42,"tag":90,"props":232,"children":233},{},[234],{"type":48,"value":235},"not",{"type":48,"value":237}," exist on a clean checkout, and no ",{"type":42,"tag":57,"props":239,"children":241},{"className":240},[],[242],{"type":48,"value":152},{"type":48,"value":244}," declares the fetch. Every per-plugin script implicitly requires ",{"type":42,"tag":57,"props":246,"children":248},{"className":247},[],[249],{"type":48,"value":250},"ant -f build\u002Fbuild.xml platform",{"type":48,"value":252}," to have already run.",{"type":42,"tag":109,"props":254,"children":255},{},[256,258,271,273,279,281,287],{"type":48,"value":257},"There is ",{"type":42,"tag":90,"props":259,"children":260},{},[261,263,269],{"type":48,"value":262},"no ",{"type":42,"tag":57,"props":264,"children":266},{"className":265},[],[267],{"type":48,"value":268},"${idea.plugins.dir}",{"type":48,"value":270}," macro",{"type":48,"value":272}," — do not invent one. Reference fetched IDEA-plugin jars via ",{"type":42,"tag":57,"props":274,"children":276},{"className":275},[],[277],{"type":48,"value":278},"${basedir}\u002Fplugins\u002F\u003Cidea-plugin>\u002Flib\u002F",{"type":48,"value":280}," (matches the IDEA project libraries under ",{"type":42,"tag":57,"props":282,"children":284},{"className":283},[],[285],{"type":48,"value":286},".idea\u002Flibraries\u002F*.xml",{"type":48,"value":288},").",{"type":42,"tag":109,"props":290,"children":291},{},[292,294,300,302,307,309,315],{"type":48,"value":293},"The ",{"type":42,"tag":57,"props":295,"children":297},{"className":296},[],[298],{"type":48,"value":299},"test\u002F",{"type":48,"value":301}," source root is not part of the production jar. Test compilation belongs in a sibling test-only ",{"type":42,"tag":57,"props":303,"children":305},{"className":304},[],[306],{"type":48,"value":152},{"type":48,"value":308}," (cf. ",{"type":42,"tag":57,"props":310,"children":312},{"className":311},[],[313],{"type":48,"value":314},"mpsTesting.xml",{"type":48,"value":316},"), not layered onto the production jar.",{"type":42,"tag":109,"props":318,"children":319},{},[320,322,328,330,335,337,343],{"type":48,"value":321},"Validate cheap first: regenerate, then run ",{"type":42,"tag":57,"props":323,"children":325},{"className":324},[],[326],{"type":48,"value":327},"ant -f build\u002F\u003CprojectName>.xml assemble",{"type":48,"value":329}," in isolation ",{"type":42,"tag":90,"props":331,"children":332},{},[333],{"type":48,"value":334},"before",{"type":48,"value":336}," running the full ",{"type":42,"tag":57,"props":338,"children":340},{"className":339},[],[341],{"type":48,"value":342},"build\u002Frun_build.sh",{"type":48,"value":344},".",{"type":42,"tag":98,"props":346,"children":348},{"id":347},"common-path-workflow-bundle-a-new-plain-javakotlin-plugin",[349],{"type":48,"value":350},"Common-Path Workflow — Bundle a New Plain Java\u002FKotlin Plugin",{"type":42,"tag":51,"props":352,"children":353},{},[354,356,361,363,369,371,377],{"type":48,"value":355},"Running example: bundling ",{"type":42,"tag":57,"props":357,"children":359},{"className":358},[],[360],{"type":48,"value":70},{"type":48,"value":362}," (a ",{"type":42,"tag":57,"props":364,"children":366},{"className":365},[],[367],{"type":48,"value":368},"JAVA_MODULE",{"type":48,"value":370}," with Kotlin sources, depending on ",{"type":42,"tag":57,"props":372,"children":374},{"className":373},[],[375],{"type":48,"value":376},"com.intellij.mcpServer",{"type":48,"value":288},{"type":42,"tag":379,"props":380,"children":381},"ol",{},[382,430,487,580,651,690,714,738],{"type":42,"tag":109,"props":383,"children":384},{},[385,390,392,398,400,405,407,413,415,421,423,429],{"type":42,"tag":90,"props":386,"children":387},{},[388],{"type":48,"value":389},"Diagnose where the plugin currently is.",{"type":48,"value":391}," ",{"type":42,"tag":57,"props":393,"children":395},{"className":394},[],[396],{"type":48,"value":397},"grep -r \u003Cplugin-name> build\u002F",{"type":48,"value":399}," (empty → no generated Ant script). Look under ",{"type":42,"tag":57,"props":401,"children":403},{"className":402},[],[404],{"type":48,"value":183},{"type":48,"value":406},", ",{"type":42,"tag":57,"props":408,"children":410},{"className":409},[],[411],{"type":48,"value":412},"build\u002Fartifacts\u002Fmps\u002Fplugins\u002F\u003Cx>\u002F",{"type":48,"value":414},", and the final ",{"type":42,"tag":57,"props":416,"children":418},{"className":417},[],[419],{"type":48,"value":420},"${build.number}*.zip",{"type":48,"value":422}," to find which layer is missing it. See ",{"type":42,"tag":57,"props":424,"children":426},{"className":425},[],[427],{"type":48,"value":428},"references\u002Fdiagnostics.md",{"type":48,"value":344},{"type":42,"tag":109,"props":431,"children":432},{},[433,438,440,446,448,454,456,462,464,470,472,478,480,486],{"type":42,"tag":90,"props":434,"children":435},{},[436],{"type":48,"value":437},"Pick a shape.",{"type":48,"value":439}," Model it like ",{"type":42,"tag":57,"props":441,"children":443},{"className":442},[],[444],{"type":48,"value":445},"mpsHttpSupportPlugin",{"type":48,"value":447}," (Option A, preferred — full Ant compile pipeline) or like ",{"type":42,"tag":57,"props":449,"children":451},{"className":450},[],[452],{"type":48,"value":453},"mcpserver",{"type":48,"value":455}," \u002F ",{"type":42,"tag":57,"props":457,"children":459},{"className":458},[],[460],{"type":48,"value":461},"terminal",{"type":48,"value":463}," (Option B — pre-built, copied from ",{"type":42,"tag":57,"props":465,"children":467},{"className":466},[],[468],{"type":48,"value":469},"\u003CMPS>\u002Fplugins\u002F\u003Cx>\u002F",{"type":48,"value":471}," by ",{"type":42,"tag":57,"props":473,"children":475},{"className":474},[],[476],{"type":48,"value":477},"mpsStandalone",{"type":48,"value":479},"). See ",{"type":42,"tag":57,"props":481,"children":483},{"className":482},[],[484],{"type":48,"value":485},"references\u002Fplugin-bundling-options.md",{"type":48,"value":344},{"type":42,"tag":109,"props":488,"children":489},{},[490,502,504,510,512,518,520,526,528,534,535,541,543,549,551,557,559,565,566,572,573,579],{"type":42,"tag":90,"props":491,"children":492},{},[493,495,501],{"type":48,"value":494},"Author in ",{"type":42,"tag":57,"props":496,"children":498},{"className":497},[],[499],{"type":48,"value":500},"build.mps",{"type":48,"value":344},{"type":48,"value":503}," Add a ",{"type":42,"tag":57,"props":505,"children":507},{"className":506},[],[508],{"type":48,"value":509},"BuildProject \u003CprojectName>",{"type":48,"value":511}," with the right ",{"type":42,"tag":57,"props":513,"children":515},{"className":514},[],[516],{"type":48,"value":517},"BuildLayout",{"type":48,"value":519}," (Java\u002FKotlin source roots, ",{"type":42,"tag":57,"props":521,"children":523},{"className":522},[],[524],{"type":48,"value":525},"META-INF\u002Fplugin.xml",{"type":48,"value":527},", jar packaging, dependencies via ",{"type":42,"tag":57,"props":529,"children":531},{"className":530},[],[532],{"type":48,"value":533},"BuildSource_JavaDependencyModule",{"type":48,"value":455},{"type":42,"tag":57,"props":536,"children":538},{"className":537},[],[539],{"type":48,"value":540},"…ExternalJar",{"type":48,"value":542},"). Carry the ",{"type":42,"tag":57,"props":544,"children":546},{"className":545},[],[547],{"type":48,"value":548},"BuildJavaPlugin",{"type":48,"value":550}," marker so the generator emits a plain compile pipeline. Depend on ",{"type":42,"tag":57,"props":552,"children":554},{"className":553},[],[555],{"type":48,"value":556},"mpsBootstrapCore",{"type":48,"value":558}," (and likely ",{"type":42,"tag":57,"props":560,"children":562},{"className":561},[],[563],{"type":48,"value":564},"mpsCore",{"type":48,"value":455},{"type":42,"tag":57,"props":567,"children":569},{"className":568},[],[570],{"type":48,"value":571},"mpsWorkbench",{"type":48,"value":479},{"type":42,"tag":57,"props":574,"children":576},{"className":575},[],[577],{"type":48,"value":578},"references\u002Fbuild-mps-authoring.md",{"type":48,"value":344},{"type":42,"tag":109,"props":581,"children":582},{},[583,588,590,595,597,603,605,611,613,619,621,627,629,635,637,643,645,650],{"type":42,"tag":90,"props":584,"children":585},{},[586],{"type":48,"value":587},"Wire it into the aggregator.",{"type":48,"value":589}," Edit the ",{"type":42,"tag":57,"props":591,"children":593},{"className":592},[],[594],{"type":48,"value":167},{"type":48,"value":596}," aggregator BuildProject so it imports ",{"type":42,"tag":57,"props":598,"children":600},{"className":599},[],[601],{"type":48,"value":602},"${artifacts.\u003CprojectName>}",{"type":48,"value":604},", copies ",{"type":42,"tag":57,"props":606,"children":608},{"className":607},[],[609],{"type":48,"value":610},"${artifacts.\u003CprojectName>}\u002F\u003Cplugin-folder>",{"type":48,"value":612}," into ",{"type":42,"tag":57,"props":614,"children":616},{"className":615},[],[617],{"type":48,"value":618},"${build.layout}\u002Fplugins\u002F\u003Cplugin-folder>",{"type":48,"value":620},", and invokes the new Ant file in its ",{"type":42,"tag":57,"props":622,"children":624},{"className":623},[],[625],{"type":48,"value":626},"buildDependents",{"type":48,"value":628},". Add the same ",{"type":42,"tag":57,"props":630,"children":632},{"className":631},[],[633],{"type":48,"value":634},"\u003Cant antfile=\"build\u002F\u003CprojectName>.xml\" …\u002F>",{"type":48,"value":636}," line to ",{"type":42,"tag":57,"props":638,"children":640},{"className":639},[],[641],{"type":48,"value":642},"mpsDistribution.xml",{"type":48,"value":644},"'s ",{"type":42,"tag":57,"props":646,"children":648},{"className":647},[],[649],{"type":48,"value":626},{"type":48,"value":344},{"type":42,"tag":109,"props":652,"children":653},{},[654,659,660,665,667,673,675,681,682,688],{"type":42,"tag":90,"props":655,"children":656},{},[657],{"type":48,"value":658},"Regenerate",{"type":48,"value":391},{"type":42,"tag":57,"props":661,"children":663},{"className":662},[],[664],{"type":48,"value":500},{"type":48,"value":666},". A new ",{"type":42,"tag":57,"props":668,"children":670},{"className":669},[],[671],{"type":48,"value":672},"build\u002F\u003CprojectName>.xml",{"type":48,"value":674}," will appear; ",{"type":42,"tag":57,"props":676,"children":678},{"className":677},[],[679],{"type":48,"value":680},"build\u002Fmps.xml",{"type":48,"value":206},{"type":42,"tag":57,"props":683,"children":685},{"className":684},[],[686],{"type":48,"value":687},"build\u002FmpsDistribution.xml",{"type":48,"value":689}," will be updated by the same regeneration.",{"type":42,"tag":109,"props":691,"children":692},{},[693,698,700,705,707,712],{"type":42,"tag":90,"props":694,"children":695},{},[696],{"type":48,"value":697},"Smoke step (no full build).",{"type":48,"value":699}," Run ",{"type":42,"tag":57,"props":701,"children":703},{"className":702},[],[704],{"type":48,"value":327},{"type":48,"value":706}," in isolation. Pre-run ",{"type":42,"tag":57,"props":708,"children":710},{"className":709},[],[711],{"type":48,"value":250},{"type":48,"value":713}," once so the IDEA jars exist on disk.",{"type":42,"tag":109,"props":715,"children":716},{},[717,722,724,729,731,737],{"type":42,"tag":90,"props":718,"children":719},{},[720],{"type":48,"value":721},"Full build",{"type":48,"value":723}," via ",{"type":42,"tag":57,"props":725,"children":727},{"className":726},[],[728],{"type":48,"value":342},{"type":48,"value":730},". Verify the three artefact locations in ",{"type":42,"tag":57,"props":732,"children":734},{"className":733},[],[735],{"type":48,"value":736},"references\u002Fvalidation.md",{"type":48,"value":344},{"type":42,"tag":109,"props":739,"children":740},{},[741,743,748,750,755,757,763,765,771],{"type":48,"value":742},"If the plugin has a ",{"type":42,"tag":57,"props":744,"children":746},{"className":745},[],[747],{"type":48,"value":299},{"type":48,"value":749}," source root, add a sibling test-only ",{"type":42,"tag":57,"props":751,"children":753},{"className":752},[],[754],{"type":48,"value":152},{"type":48,"value":756}," (",{"type":42,"tag":57,"props":758,"children":760},{"className":759},[],[761],{"type":48,"value":762},"\u003CprojectName>Tests",{"type":48,"value":764},") — see ",{"type":42,"tag":57,"props":766,"children":768},{"className":767},[],[769],{"type":48,"value":770},"references\u002Ftest-suite-wiring.md",{"type":48,"value":344},{"type":42,"tag":98,"props":773,"children":775},{"id":774},"pipeline-at-a-glance",[776],{"type":48,"value":777},"Pipeline at a Glance",{"type":42,"tag":779,"props":780,"children":784},"pre",{"className":781,"code":783,"language":48},[782],"language-text","build.xml                              build.txt              dependencies.properties\n   │                                       │                          │\n   ├─ platform              ───────────► Ivy fetches IDEA + libs into \u003CMPS>\u002Flib, \u003CMPS>\u002Fplugins\u002F*\n   │   (getDependencies.xml)\n   │\n   ├─ getResourcesAndBuildAll\n   │     └─ mpsDistribution.xml buildDependents\n   │            ├─ mpsTrueBootstrap.xml  ──┐\n   │            ├─ mpsBootstrapCore.xml    │  per-plugin Ant scripts\n   │            ├─ mpsCore.xml             │  (compile + jar + layout into\n   │            ├─ mpsWorkbench.xml        │   build\u002Fartifacts\u002F\u003CprojectName>\u002F)\n   │            ├─ mpsBuild.xml            │\n   │            ├─ mpsTesting.xml          │\n   │            ├─ mpsPlugins.xml          │\n   │            ├─ mpsJava.xml             │\n   │            ├─ mpsHttpSupportPlugin.xml│\n   │            ├─ mpsKotlinPlugin.xml     │\n   │            ├─ mpsContextActionsTool.xml│\n   │            ├─ … (30+ files)          ─┘\n   │            └─ mps.xml                 (aggregates into build\u002Fartifacts\u002Fmps\u002F)\n   │\n   └─ assemble\n         └─ mpsDistribution.xml assemble   (zips\u002Ftars into build\u002Fartifacts\u002FmpsDistribution\u002F)\n",[785],{"type":42,"tag":57,"props":786,"children":788},{"__ignoreMap":787},"",[789],{"type":48,"value":783},{"type":42,"tag":98,"props":791,"children":793},{"id":792},"related-skills",[794],{"type":48,"value":795},"Related Skills",{"type":42,"tag":105,"props":797,"children":798},{},[799,809,820,839],{"type":42,"tag":109,"props":800,"children":801},{},[802,807],{"type":42,"tag":57,"props":803,"children":805},{"className":804},[],[806],{"type":48,"value":86},{"type":48,"value":808}," — when you are authoring or editing the build language model itself, not just consuming its output.",{"type":42,"tag":109,"props":810,"children":811},{},[812,818],{"type":42,"tag":57,"props":813,"children":815},{"className":814},[],[816],{"type":48,"value":817},"mps-tests",{"type":48,"value":819}," — when the plugin you are bundling has a JUnit \u002F MPS test suite that must run in CI.",{"type":42,"tag":109,"props":821,"children":822},{},[823,829,831,837],{"type":42,"tag":57,"props":824,"children":826},{"className":825},[],[827],{"type":48,"value":828},"mps-ide-plugin",{"type":48,"value":830}," — when the new module is an MPS IDE plugin (",{"type":42,"tag":57,"props":832,"children":834},{"className":833},[],[835],{"type":48,"value":836},"plugin.xml",{"type":48,"value":838},", actions, tool windows). Bundling and IDE-plugin authoring are independent steps.",{"type":42,"tag":109,"props":840,"children":841},{},[842,848],{"type":42,"tag":57,"props":843,"children":845},{"className":844},[],[846],{"type":48,"value":847},"mps-aspect-generator",{"type":48,"value":849}," — when the failure is in MPS generation rather than packaging.",{"type":42,"tag":98,"props":851,"children":853},{"id":852},"reference-index",[854],{"type":48,"value":855},"Reference Index",{"type":42,"tag":105,"props":857,"children":858},{},[859,925,1009,1034,1101,1132,1157,1209,1242],{"type":42,"tag":109,"props":860,"children":861},{},[862,864,870,872,878,880,886,888,894,896,901,903,909,911,916,918,923],{"type":48,"value":863},"Open ",{"type":42,"tag":57,"props":865,"children":867},{"className":866},[],[868],{"type":48,"value":869},"references\u002Farchitecture.md",{"type":48,"value":871}," for the long form of \"how Ant files compose\" — entry point ",{"type":42,"tag":57,"props":873,"children":875},{"className":874},[],[876],{"type":48,"value":877},"build\u002Fbuild.xml",{"type":48,"value":879}," targets, the three layers of generated scripts (",{"type":42,"tag":57,"props":881,"children":883},{"className":882},[],[884],{"type":48,"value":885},"mpsTrueBootstrap.xml",{"type":48,"value":887},"\u002F",{"type":42,"tag":57,"props":889,"children":891},{"className":890},[],[892],{"type":48,"value":893},"mpsBootstrapCore.xml",{"type":48,"value":895},"\u002Fper-plugin files; ",{"type":42,"tag":57,"props":897,"children":899},{"className":898},[],[900],{"type":48,"value":191},{"type":48,"value":902}," aggregator; ",{"type":42,"tag":57,"props":904,"children":906},{"className":905},[],[907],{"type":48,"value":908},"mpsStandalone.xml",{"type":48,"value":910},"), and the final distribution layer ",{"type":42,"tag":57,"props":912,"children":914},{"className":913},[],[915],{"type":48,"value":642},{"type":48,"value":917}," with its per-platform archives. Open when you need to know where a particular file lives in the pipeline or what its ",{"type":42,"tag":57,"props":919,"children":921},{"className":920},[],[922],{"type":48,"value":626},{"type":48,"value":924}," does.",{"type":42,"tag":109,"props":926,"children":927},{},[928,929,935,937,942,944,949,951,957,958,964,965,971,972,978,979,985,986,992,993,999,1001,1007],{"type":48,"value":863},{"type":42,"tag":57,"props":930,"children":932},{"className":931},[],[933],{"type":48,"value":934},"references\u002Fbuild-mps-source-of-truth.md",{"type":48,"value":936}," when editing ",{"type":42,"tag":57,"props":938,"children":940},{"className":939},[],[941],{"type":48,"value":139},{"type":48,"value":943}," — explains the ",{"type":42,"tag":57,"props":945,"children":947},{"className":946},[],[948],{"type":48,"value":152},{"type":48,"value":950}," structure, the meaning of opaque concept indices (",{"type":42,"tag":57,"props":952,"children":954},{"className":953},[],[955],{"type":48,"value":956},"1l3spW",{"type":48,"value":406},{"type":42,"tag":57,"props":959,"children":961},{"className":960},[],[962],{"type":48,"value":963},"398b33",{"type":48,"value":406},{"type":42,"tag":57,"props":966,"children":968},{"className":967},[],[969],{"type":48,"value":970},"TrG5h",{"type":48,"value":406},{"type":42,"tag":57,"props":973,"children":975},{"className":974},[],[976],{"type":48,"value":977},"turDy",{"type":48,"value":406},{"type":42,"tag":57,"props":980,"children":982},{"className":981},[],[983],{"type":48,"value":984},"2DA0ip",{"type":48,"value":406},{"type":42,"tag":57,"props":987,"children":989},{"className":988},[],[990],{"type":48,"value":991},"1l3spV",{"type":48,"value":406},{"type":42,"tag":57,"props":994,"children":996},{"className":995},[],[997],{"type":48,"value":998},"10PD9b",{"type":48,"value":1000},"), and how regeneration writes the ",{"type":42,"tag":57,"props":1002,"children":1004},{"className":1003},[],[1005],{"type":48,"value":1006},"build\u002F*.xml",{"type":48,"value":1008}," files.",{"type":42,"tag":109,"props":1010,"children":1011},{},[1012,1013,1018,1020,1025,1027,1032],{"type":48,"value":863},{"type":42,"tag":57,"props":1014,"children":1016},{"className":1015},[],[1017],{"type":48,"value":485},{"type":48,"value":1019}," to choose between Option A (full Ant compile pipeline like ",{"type":42,"tag":57,"props":1021,"children":1023},{"className":1022},[],[1024],{"type":48,"value":445},{"type":48,"value":1026},") and Option B (pre-built drop into ",{"type":42,"tag":57,"props":1028,"children":1030},{"className":1029},[],[1031],{"type":48,"value":477},{"type":48,"value":1033},"). Includes the rationale for picking Option A for new MPS-authored plugins.",{"type":42,"tag":109,"props":1035,"children":1036},{},[1037,1038,1043,1045,1050,1052,1057,1059,1064,1066,1072,1073,1079,1081,1086,1088,1093,1095,1100],{"type":48,"value":863},{"type":42,"tag":57,"props":1039,"children":1041},{"className":1040},[],[1042],{"type":48,"value":578},{"type":48,"value":1044}," when adding the new ",{"type":42,"tag":57,"props":1046,"children":1048},{"className":1047},[],[1049],{"type":48,"value":152},{"type":48,"value":1051}," to ",{"type":42,"tag":57,"props":1053,"children":1055},{"className":1054},[],[1056],{"type":48,"value":500},{"type":48,"value":1058}," — ",{"type":42,"tag":57,"props":1060,"children":1062},{"className":1061},[],[1063],{"type":48,"value":517},{"type":48,"value":1065}," shape, ",{"type":42,"tag":57,"props":1067,"children":1069},{"className":1068},[],[1070],{"type":48,"value":1071},"BuildSource_JavaModule",{"type":48,"value":455},{"type":42,"tag":57,"props":1074,"children":1076},{"className":1075},[],[1077],{"type":48,"value":1078},"BuildSource_JavaContentRoot",{"type":48,"value":1080},", the ",{"type":42,"tag":57,"props":1082,"children":1084},{"className":1083},[],[1085],{"type":48,"value":548},{"type":48,"value":1087}," marker, dependency chain through ",{"type":42,"tag":57,"props":1089,"children":1091},{"className":1090},[],[1092],{"type":48,"value":556},{"type":48,"value":1094},", and the convention for referencing fetched IDEA-plugin jars via ",{"type":42,"tag":57,"props":1096,"children":1098},{"className":1097},[],[1099],{"type":48,"value":278},{"type":48,"value":344},{"type":42,"tag":109,"props":1102,"children":1103},{},[1104,1105,1110,1112,1118,1119,1124,1126,1131],{"type":48,"value":863},{"type":42,"tag":57,"props":1106,"children":1108},{"className":1107},[],[1109],{"type":48,"value":428},{"type":48,"value":1111}," when a plugin is missing from the distribution and you need to figure out which layer dropped it — three-step diagnosis using ",{"type":42,"tag":57,"props":1113,"children":1115},{"className":1114},[],[1116],{"type":48,"value":1117},"grep",{"type":48,"value":406},{"type":42,"tag":57,"props":1120,"children":1122},{"className":1121},[],[1123],{"type":48,"value":183},{"type":48,"value":1125},", and ",{"type":42,"tag":57,"props":1127,"children":1129},{"className":1128},[],[1130],{"type":48,"value":412},{"type":48,"value":344},{"type":42,"tag":109,"props":1133,"children":1134},{},[1135,1136,1141,1143,1148,1150,1155],{"type":48,"value":863},{"type":42,"tag":57,"props":1137,"children":1139},{"className":1138},[],[1140],{"type":48,"value":736},{"type":48,"value":1142}," for the two-stage validation procedure (cheap ",{"type":42,"tag":57,"props":1144,"children":1146},{"className":1145},[],[1147],{"type":48,"value":327},{"type":48,"value":1149}," smoke step, then full ",{"type":42,"tag":57,"props":1151,"children":1153},{"className":1152},[],[1154],{"type":48,"value":342},{"type":48,"value":1156},") and the three artefact locations to verify after a full build.",{"type":42,"tag":109,"props":1158,"children":1159},{},[1160,1161,1167,1169,1174,1176,1181,1182,1187,1188,1193,1195,1201,1202,1208],{"type":48,"value":863},{"type":42,"tag":57,"props":1162,"children":1164},{"className":1163},[],[1165],{"type":48,"value":1166},"references\u002Ftouchpoint-checklist.md",{"type":48,"value":1168}," for the table of files modified by adding a new Option A plugin — what is hand-edited (",{"type":42,"tag":57,"props":1170,"children":1172},{"className":1171},[],[1173],{"type":48,"value":500},{"type":48,"value":1175},"), what is regenerated (",{"type":42,"tag":57,"props":1177,"children":1179},{"className":1178},[],[1180],{"type":48,"value":672},{"type":48,"value":406},{"type":42,"tag":57,"props":1183,"children":1185},{"className":1184},[],[1186],{"type":48,"value":680},{"type":48,"value":406},{"type":42,"tag":57,"props":1189,"children":1191},{"className":1190},[],[1192],{"type":48,"value":687},{"type":48,"value":1194},"), and what stays unchanged (",{"type":42,"tag":57,"props":1196,"children":1198},{"className":1197},[],[1199],{"type":48,"value":1200},"plugins\u002F\u003Cplugin>\u002FMETA-INF\u002Fplugin.xml",{"type":48,"value":406},{"type":42,"tag":57,"props":1203,"children":1205},{"className":1204},[],[1206],{"type":48,"value":1207},".iml",{"type":48,"value":288},{"type":42,"tag":109,"props":1210,"children":1211},{},[1212,1213,1218,1220,1225,1227,1232,1234,1240],{"type":48,"value":863},{"type":42,"tag":57,"props":1214,"children":1216},{"className":1215},[],[1217],{"type":48,"value":770},{"type":48,"value":1219}," when the new plugin has a ",{"type":42,"tag":57,"props":1221,"children":1223},{"className":1222},[],[1224],{"type":48,"value":299},{"type":48,"value":1226}," source root that must run in CI — sibling test-only ",{"type":42,"tag":57,"props":1228,"children":1230},{"className":1229},[],[1231],{"type":48,"value":152},{"type":48,"value":1233},", JUnit launcher, and ",{"type":42,"tag":57,"props":1235,"children":1237},{"className":1236},[],[1238],{"type":48,"value":1239},"…Tests.xml",{"type":48,"value":1241}," aggregator wiring.",{"type":42,"tag":109,"props":1243,"children":1244},{},[1245,1246,1252],{"type":48,"value":863},{"type":42,"tag":57,"props":1247,"children":1249},{"className":1248},[],[1250],{"type":48,"value":1251},"references\u002Fkey-files.md",{"type":48,"value":1253}," for the quick reference of every build file mentioned anywhere in this skill, with one-line descriptions.",{"items":1255,"total":1331},[1256,1270,1279,1288,1299,1309,1322],{"slug":1257,"name":1257,"fn":1258,"description":1259,"org":1260,"tags":1261,"stars":22,"repoUrl":23,"updatedAt":1269},"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},[1262,1265,1268],{"name":1263,"slug":1264,"type":15},"Architecture","architecture",{"name":1266,"slug":1267,"type":15},"Configuration","configuration",{"name":20,"slug":21,"type":15},"2026-07-17T06:06:57.311661",{"slug":1271,"name":1271,"fn":1272,"description":1273,"org":1274,"tags":1275,"stars":22,"repoUrl":23,"updatedAt":1278},"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},[1276,1277],{"name":1263,"slug":1264,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:04:48.066901",{"slug":1280,"name":1280,"fn":1281,"description":1282,"org":1283,"tags":1284,"stars":22,"repoUrl":23,"updatedAt":1287},"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},[1285,1286],{"name":1263,"slug":1264,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:45:21.757084",{"slug":1289,"name":1289,"fn":1290,"description":1291,"org":1292,"tags":1293,"stars":22,"repoUrl":23,"updatedAt":1298},"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},[1294,1295],{"name":1263,"slug":1264,"type":15},{"name":1296,"slug":1297,"type":15},"Code Analysis","code-analysis","2026-07-23T05:41:33.639365",{"slug":1300,"name":1300,"fn":1301,"description":1302,"org":1303,"tags":1304,"stars":22,"repoUrl":23,"updatedAt":1308},"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},[1305],{"name":1306,"slug":1307,"type":15},"Data Analysis","data-analysis","2026-07-13T06:45:19.114674",{"slug":1310,"name":1310,"fn":1311,"description":1312,"org":1313,"tags":1314,"stars":22,"repoUrl":23,"updatedAt":1321},"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},[1315,1318],{"name":1316,"slug":1317,"type":15},"Design","design",{"name":1319,"slug":1320,"type":15},"UI Components","ui-components","2026-07-23T05:41:56.638151",{"slug":1323,"name":1323,"fn":1324,"description":1325,"org":1326,"tags":1327,"stars":22,"repoUrl":23,"updatedAt":1330},"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},[1328,1329],{"name":20,"slug":21,"type":15},{"name":1319,"slug":1320,"type":15},"2026-07-23T05:41:49.666535",31,{"items":1333,"total":1419},[1334,1340,1345,1350,1355,1359,1364,1369,1378,1387,1396,1409],{"slug":1257,"name":1257,"fn":1258,"description":1259,"org":1335,"tags":1336,"stars":22,"repoUrl":23,"updatedAt":1269},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1337,1338,1339],{"name":1263,"slug":1264,"type":15},{"name":1266,"slug":1267,"type":15},{"name":20,"slug":21,"type":15},{"slug":1271,"name":1271,"fn":1272,"description":1273,"org":1341,"tags":1342,"stars":22,"repoUrl":23,"updatedAt":1278},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1343,1344],{"name":1263,"slug":1264,"type":15},{"name":20,"slug":21,"type":15},{"slug":1280,"name":1280,"fn":1281,"description":1282,"org":1346,"tags":1347,"stars":22,"repoUrl":23,"updatedAt":1287},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1348,1349],{"name":1263,"slug":1264,"type":15},{"name":20,"slug":21,"type":15},{"slug":1289,"name":1289,"fn":1290,"description":1291,"org":1351,"tags":1352,"stars":22,"repoUrl":23,"updatedAt":1298},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1353,1354],{"name":1263,"slug":1264,"type":15},{"name":1296,"slug":1297,"type":15},{"slug":1300,"name":1300,"fn":1301,"description":1302,"org":1356,"tags":1357,"stars":22,"repoUrl":23,"updatedAt":1308},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1358],{"name":1306,"slug":1307,"type":15},{"slug":1310,"name":1310,"fn":1311,"description":1312,"org":1360,"tags":1361,"stars":22,"repoUrl":23,"updatedAt":1321},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1362,1363],{"name":1316,"slug":1317,"type":15},{"name":1319,"slug":1320,"type":15},{"slug":1323,"name":1323,"fn":1324,"description":1325,"org":1365,"tags":1366,"stars":22,"repoUrl":23,"updatedAt":1330},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1367,1368],{"name":20,"slug":21,"type":15},{"name":1319,"slug":1320,"type":15},{"slug":1370,"name":1370,"fn":1371,"description":1372,"org":1373,"tags":1374,"stars":22,"repoUrl":23,"updatedAt":1377},"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},[1375,1376],{"name":1263,"slug":1264,"type":15},{"name":20,"slug":21,"type":15},"2026-07-13T06:44:59.507855",{"slug":847,"name":847,"fn":1379,"description":1380,"org":1381,"tags":1382,"stars":22,"repoUrl":23,"updatedAt":1386},"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},[1383,1384,1385],{"name":1263,"slug":1264,"type":15},{"name":1296,"slug":1297,"type":15},{"name":20,"slug":21,"type":15},"2026-07-17T06:06:58.042999",{"slug":1388,"name":1388,"fn":1389,"description":1390,"org":1391,"tags":1392,"stars":22,"repoUrl":23,"updatedAt":1395},"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},[1393,1394],{"name":1263,"slug":1264,"type":15},{"name":20,"slug":21,"type":15},"2026-07-23T05:41:48.692899",{"slug":1397,"name":1397,"fn":1398,"description":1399,"org":1400,"tags":1401,"stars":22,"repoUrl":23,"updatedAt":1408},"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},[1402,1405],{"name":1403,"slug":1404,"type":15},"Debugging","debugging",{"name":1406,"slug":1407,"type":15},"Migration","migration","2026-07-13T06:45:20.372122",{"slug":1410,"name":1410,"fn":1411,"description":1412,"org":1413,"tags":1414,"stars":22,"repoUrl":23,"updatedAt":1418},"mps-aspect-structure-concepts","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},[1415],{"name":1416,"slug":1417,"type":15},"Data Modeling","data-modeling","2026-07-23T05:41:30.705975",188]