[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-jetbrains-mps-aspect-structure-concepts":3,"mdc--z39swh-key":29,"related-org-jetbrains-mps-aspect-structure-concepts":1082,"related-repo-jetbrains-mps-aspect-structure-concepts":1203},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":16,"repoUrl":17,"updatedAt":18,"license":19,"forks":20,"topics":21,"repo":24,"sourceUrl":27,"mdContent":28},"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},"jetbrains","JetBrains","https:\u002F\u002Fpexgzepcugksgbtrxkhf.supabase.co\u002Fstorage\u002Fv1\u002Fobject\u002Fpublic\u002Forg-logos\u002Fjetbrains.png",[12],{"name":13,"slug":14,"type":15},"Data Modeling","data-modeling","tag",1650,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS","2026-07-23T05:41:30.705975",null,311,[22,23],"domain-specific-language","dsl",{"repoUrl":17,"stars":16,"forks":20,"topics":25,"description":26},[22,23],"JetBrains Meta programming System","https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS\u002Ftree\u002FHEAD\u002Fplugins\u002Fmcp-tools\u002Fresources\u002Fjetbrains\u002Fmps\u002Fagents\u002Fmcp\u002Fskills\u002Fmps-aspect-structure-concepts","---\nname: mps-aspect-structure-concepts\ndescription: 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.\ntype: reference\n---\n\n# MPS Structure Aspect — Concepts\n\nConcepts (`ConceptDeclaration`), interface concepts (`InterfaceConceptDeclaration`), enumerations (`EnumerationDeclaration`), and constrained data types (`ConstrainedDataTypeDeclaration`) are root nodes in a language's `structure` model. They use the language `jetbrains.mps.lang.structure`.\n\n## Critical Directives\n\n- **Implement `INamedConcept` instead of declaring `name` directly.** A `name` property declared directly on a concept is an antipattern in MPS — implement `jetbrains.mps.lang.core.structure.INamedConcept` instead.\n- **Smart reference check (CRITICAL)**: before setting a `conceptAlias`, determine whether the concept is an \"Implicit Smart Reference\". If it has exactly one mandatory reference and no properties or children of its own, **do NOT set a `conceptAlias`** — the concept should be transparent in the editor and completion menu so the user types the target's name directly. Examples: variable references, method calls, routine calls.\n- **Leave alias empty on transparent collections too** (e.g. `StatementList`).\n- **Set alias on concepts that can be root** — that's how the user reaches them through the new-root menu.\n- **Always rebuild the language** with `mps_mcp_alter_nodes MAKE` and `rebuild=\"true\"` after structural changes, so the new concepts are discoverable by runtime tools.\n\n## Prerequisites\n\n* Requires the target language and its `structure` model.\n* Uses the `jetbrains.mps.lang.structure` language.\n* Concepts, interface concepts, and enums are root nodes in the `structure` model.\n\n## Workflow\n\n1. **Locate language**: use `mps_mcp_get_project_structure` to find the language and its `structure` model.\n2. **Module creation**: if needed, create the module via `mps_mcp_create_module` using an absolute path.\n3. **Define elements**:\n    * **ConceptDeclaration**: core entities.\n    * **InterfaceConceptDeclaration**: orthogonal functionality.\n    * **EnumerationDeclaration**: fixed values.\n    * **ConstrainedDataTypeDeclaration**: regex-restricted properties.\n    * **Attributes (annotations)**: concepts extending `NodeAttribute` \u002F `PropertyAttribute` \u002F `ChildAttribute` \u002F `LinkAttribute` that graft extra children\u002Fdata onto *other* concepts without editing them — see Attributes section below.\n4. **Inheritance & interfaces**:\n    * Use inheritance and abstract concepts for shared logic.\n    * Implement `jetbrains.mps.lang.core.structure.INamedConcept` if the concept needs a `name` property.\n5. **Smart reference assessment**: see directives above.\n6. **Set alias on concepts that can be root**: helps the user instantiate the concept through a menu.\n7. **Leave alias empty on smart references and transparent collections**: e.g. `StatementList`.\n8. **Property definition**:\n    * For enum properties: create the `EnumerationDeclaration` first, then set the property `dataType` to reference it.\n9. **Proper cardinality**: make sure intended child collections have the cardinality of `0..n` or `1..n`.\n10. **Bulk operations**: use `mps_mcp_alter_structure` for creating multiple concepts or enums efficiently.\n    * Local references within the same JSON blueprint can use names for resolution.\n11. **Reload runtime**: always rebuild the language (via `mps_mcp_alter_nodes` with `MAKE` and `rebuild=\"true\"`) after structural changes to make concepts discoverable.\n\n## Attributes (Annotations)\n\nAttributes let one language attach extra children, references, or property data to nodes of a concept it does **not** own — without editing or subclassing that concept. The host carries a universal `smodelAttribute` child slot (`0..n`, every `BaseConcept` has it); the attribute's own declaration says where it may attach. Used heavily for cross-cutting concerns: generator macros (`NodeMacro`\u002F`PropertyMacro`\u002F`ReferenceMacro`), documentation\u002Fdescription comments, requirement traces, error suppression.\n\n- Declare an attribute = a `ConceptDeclaration` that **extends** one of `NodeAttribute` (whole node), `PropertyAttribute` (one property), `ChildAttribute` (one child link), or `LinkAttribute` (one reference link), **plus** an `AttributeInfo` (alias `@attribute info`) in its `smodelAttribute` role specifying the extension point: `role` (the attach key), `attributed` (which concept(s) may receive it — `BaseConcept` = any), and `multiple` (one vs. many per node).\n- `CREATE_CONCEPTS` cannot express the `AttributeInfo` — create the concept extending the base attribute, then add the `AttributeInfo` with `mps_mcp_update_node`. Full walkthrough, concept reference, and the canonical `RequirementTrace` blueprint live in `references\u002Fattributes-and-annotations.md`.\n\n## Related Skills\n\n- **`mps-aspect-editor-menus-and-keymaps`** — once concepts exist, define their editors (often the next step).\n- **`mps-aspect-constraints`** — property validators, scopes, and `canBe*` rules layered on top of structure.\n- **`mps-aspect-behavior`** — virtual methods per concept.\n- **`mps-aspect-actions`** — node factories for newly created concepts.\n- **`mps-language-inheritance`** — for `extendedLanguages` and concept super\u002Finterface relationships.\n\n## Reference Index\n\n- Open `references\u002Fstructure-operation-api.md` for exact `mps_mcp_alter_structure` and `mps_mcp_query_structure` operation names, JSON parameter formats, structure blueprint schemas, `make` flag handling, and `makeStatus` semantics (success \u002F runtime_stale \u002F failed \u002F skipped).\n- Open `references\u002Fattributes-and-annotations.md` for attributes\u002Fannotations: the four attribute kinds (`NodeAttribute` \u002F `PropertyAttribute` \u002F `ChildAttribute` \u002F `LinkAttribute`), how to choose between them (feature-pinned kinds need a visible feature cell — whole-role markers should be a `NodeAttribute` + `LinkDeclaration` reference, converted at runtime via `MetaAdapterByDeclaration`), the `AttributeInfo` extension-point spec (`role`, `attributed`, `multiple`), the two-step MCP creation flow, the `smodelAttribute` slot, and worked examples (`RequirementTrace`, generator macros, doc\u002Fcomment annotations).\n",{"data":30,"body":32},{"name":4,"description":6,"type":31},"reference",{"type":33,"children":34},"root",[35,44,99,106,237,243,281,287,613,619,677,835,841,930,936],{"type":36,"tag":37,"props":38,"children":40},"element","h1",{"id":39},"mps-structure-aspect-concepts",[41],{"type":42,"value":43},"text","MPS Structure Aspect — Concepts",{"type":36,"tag":45,"props":46,"children":47},"p",{},[48,50,57,59,65,67,73,75,81,83,89,91,97],{"type":42,"value":49},"Concepts (",{"type":36,"tag":51,"props":52,"children":54},"code",{"className":53},[],[55],{"type":42,"value":56},"ConceptDeclaration",{"type":42,"value":58},"), interface concepts (",{"type":36,"tag":51,"props":60,"children":62},{"className":61},[],[63],{"type":42,"value":64},"InterfaceConceptDeclaration",{"type":42,"value":66},"), enumerations (",{"type":36,"tag":51,"props":68,"children":70},{"className":69},[],[71],{"type":42,"value":72},"EnumerationDeclaration",{"type":42,"value":74},"), and constrained data types (",{"type":36,"tag":51,"props":76,"children":78},{"className":77},[],[79],{"type":42,"value":80},"ConstrainedDataTypeDeclaration",{"type":42,"value":82},") are root nodes in a language's ",{"type":36,"tag":51,"props":84,"children":86},{"className":85},[],[87],{"type":42,"value":88},"structure",{"type":42,"value":90}," model. They use the language ",{"type":36,"tag":51,"props":92,"children":94},{"className":93},[],[95],{"type":42,"value":96},"jetbrains.mps.lang.structure",{"type":42,"value":98},".",{"type":36,"tag":100,"props":101,"children":103},"h2",{"id":102},"critical-directives",[104],{"type":42,"value":105},"Critical Directives",{"type":36,"tag":107,"props":108,"children":109},"ul",{},[110,153,183,201,211],{"type":36,"tag":111,"props":112,"children":113},"li",{},[114,136,138,143,145,151],{"type":36,"tag":115,"props":116,"children":117},"strong",{},[118,120,126,128,134],{"type":42,"value":119},"Implement ",{"type":36,"tag":51,"props":121,"children":123},{"className":122},[],[124],{"type":42,"value":125},"INamedConcept",{"type":42,"value":127}," instead of declaring ",{"type":36,"tag":51,"props":129,"children":131},{"className":130},[],[132],{"type":42,"value":133},"name",{"type":42,"value":135}," directly.",{"type":42,"value":137}," A ",{"type":36,"tag":51,"props":139,"children":141},{"className":140},[],[142],{"type":42,"value":133},{"type":42,"value":144}," property declared directly on a concept is an antipattern in MPS — implement ",{"type":36,"tag":51,"props":146,"children":148},{"className":147},[],[149],{"type":42,"value":150},"jetbrains.mps.lang.core.structure.INamedConcept",{"type":42,"value":152}," instead.",{"type":36,"tag":111,"props":154,"children":155},{},[156,161,163,169,171,181],{"type":36,"tag":115,"props":157,"children":158},{},[159],{"type":42,"value":160},"Smart reference check (CRITICAL)",{"type":42,"value":162},": before setting a ",{"type":36,"tag":51,"props":164,"children":166},{"className":165},[],[167],{"type":42,"value":168},"conceptAlias",{"type":42,"value":170},", determine whether the concept is an \"Implicit Smart Reference\". If it has exactly one mandatory reference and no properties or children of its own, ",{"type":36,"tag":115,"props":172,"children":173},{},[174,176],{"type":42,"value":175},"do NOT set a ",{"type":36,"tag":51,"props":177,"children":179},{"className":178},[],[180],{"type":42,"value":168},{"type":42,"value":182}," — the concept should be transparent in the editor and completion menu so the user types the target's name directly. Examples: variable references, method calls, routine calls.",{"type":36,"tag":111,"props":184,"children":185},{},[186,191,193,199],{"type":36,"tag":115,"props":187,"children":188},{},[189],{"type":42,"value":190},"Leave alias empty on transparent collections too",{"type":42,"value":192}," (e.g. ",{"type":36,"tag":51,"props":194,"children":196},{"className":195},[],[197],{"type":42,"value":198},"StatementList",{"type":42,"value":200},").",{"type":36,"tag":111,"props":202,"children":203},{},[204,209],{"type":36,"tag":115,"props":205,"children":206},{},[207],{"type":42,"value":208},"Set alias on concepts that can be root",{"type":42,"value":210}," — that's how the user reaches them through the new-root menu.",{"type":36,"tag":111,"props":212,"children":213},{},[214,219,221,227,229,235],{"type":36,"tag":115,"props":215,"children":216},{},[217],{"type":42,"value":218},"Always rebuild the language",{"type":42,"value":220}," with ",{"type":36,"tag":51,"props":222,"children":224},{"className":223},[],[225],{"type":42,"value":226},"mps_mcp_alter_nodes MAKE",{"type":42,"value":228}," and ",{"type":36,"tag":51,"props":230,"children":232},{"className":231},[],[233],{"type":42,"value":234},"rebuild=\"true\"",{"type":42,"value":236}," after structural changes, so the new concepts are discoverable by runtime tools.",{"type":36,"tag":100,"props":238,"children":240},{"id":239},"prerequisites",[241],{"type":42,"value":242},"Prerequisites",{"type":36,"tag":107,"props":244,"children":245},{},[246,258,270],{"type":36,"tag":111,"props":247,"children":248},{},[249,251,256],{"type":42,"value":250},"Requires the target language and its ",{"type":36,"tag":51,"props":252,"children":254},{"className":253},[],[255],{"type":42,"value":88},{"type":42,"value":257}," model.",{"type":36,"tag":111,"props":259,"children":260},{},[261,263,268],{"type":42,"value":262},"Uses the ",{"type":36,"tag":51,"props":264,"children":266},{"className":265},[],[267],{"type":42,"value":96},{"type":42,"value":269}," language.",{"type":36,"tag":111,"props":271,"children":272},{},[273,275,280],{"type":42,"value":274},"Concepts, interface concepts, and enums are root nodes in the ",{"type":36,"tag":51,"props":276,"children":278},{"className":277},[],[279],{"type":42,"value":88},{"type":42,"value":257},{"type":36,"tag":100,"props":282,"children":284},{"id":283},"workflow",[285],{"type":42,"value":286},"Workflow",{"type":36,"tag":288,"props":289,"children":290},"ol",{},[291,315,333,430,465,475,484,500,532,557,582],{"type":36,"tag":111,"props":292,"children":293},{},[294,299,301,307,309,314],{"type":36,"tag":115,"props":295,"children":296},{},[297],{"type":42,"value":298},"Locate language",{"type":42,"value":300},": use ",{"type":36,"tag":51,"props":302,"children":304},{"className":303},[],[305],{"type":42,"value":306},"mps_mcp_get_project_structure",{"type":42,"value":308}," to find the language and its ",{"type":36,"tag":51,"props":310,"children":312},{"className":311},[],[313],{"type":42,"value":88},{"type":42,"value":257},{"type":36,"tag":111,"props":316,"children":317},{},[318,323,325,331],{"type":36,"tag":115,"props":319,"children":320},{},[321],{"type":42,"value":322},"Module creation",{"type":42,"value":324},": if needed, create the module via ",{"type":36,"tag":51,"props":326,"children":328},{"className":327},[],[329],{"type":42,"value":330},"mps_mcp_create_module",{"type":42,"value":332}," using an absolute path.",{"type":36,"tag":111,"props":334,"children":335},{},[336,341,343],{"type":36,"tag":115,"props":337,"children":338},{},[339],{"type":42,"value":340},"Define elements",{"type":42,"value":342},":\n",{"type":36,"tag":107,"props":344,"children":345},{},[346,355,364,373,382],{"type":36,"tag":111,"props":347,"children":348},{},[349,353],{"type":36,"tag":115,"props":350,"children":351},{},[352],{"type":42,"value":56},{"type":42,"value":354},": core entities.",{"type":36,"tag":111,"props":356,"children":357},{},[358,362],{"type":36,"tag":115,"props":359,"children":360},{},[361],{"type":42,"value":64},{"type":42,"value":363},": orthogonal functionality.",{"type":36,"tag":111,"props":365,"children":366},{},[367,371],{"type":36,"tag":115,"props":368,"children":369},{},[370],{"type":42,"value":72},{"type":42,"value":372},": fixed values.",{"type":36,"tag":111,"props":374,"children":375},{},[376,380],{"type":36,"tag":115,"props":377,"children":378},{},[379],{"type":42,"value":80},{"type":42,"value":381},": regex-restricted properties.",{"type":36,"tag":111,"props":383,"children":384},{},[385,390,392,398,400,406,407,413,414,420,422,428],{"type":36,"tag":115,"props":386,"children":387},{},[388],{"type":42,"value":389},"Attributes (annotations)",{"type":42,"value":391},": concepts extending ",{"type":36,"tag":51,"props":393,"children":395},{"className":394},[],[396],{"type":42,"value":397},"NodeAttribute",{"type":42,"value":399}," \u002F ",{"type":36,"tag":51,"props":401,"children":403},{"className":402},[],[404],{"type":42,"value":405},"PropertyAttribute",{"type":42,"value":399},{"type":36,"tag":51,"props":408,"children":410},{"className":409},[],[411],{"type":42,"value":412},"ChildAttribute",{"type":42,"value":399},{"type":36,"tag":51,"props":415,"children":417},{"className":416},[],[418],{"type":42,"value":419},"LinkAttribute",{"type":42,"value":421}," that graft extra children\u002Fdata onto ",{"type":36,"tag":423,"props":424,"children":425},"em",{},[426],{"type":42,"value":427},"other",{"type":42,"value":429}," concepts without editing them — see Attributes section below.",{"type":36,"tag":111,"props":431,"children":432},{},[433,438,439],{"type":36,"tag":115,"props":434,"children":435},{},[436],{"type":42,"value":437},"Inheritance & interfaces",{"type":42,"value":342},{"type":36,"tag":107,"props":440,"children":441},{},[442,447],{"type":36,"tag":111,"props":443,"children":444},{},[445],{"type":42,"value":446},"Use inheritance and abstract concepts for shared logic.",{"type":36,"tag":111,"props":448,"children":449},{},[450,451,456,458,463],{"type":42,"value":119},{"type":36,"tag":51,"props":452,"children":454},{"className":453},[],[455],{"type":42,"value":150},{"type":42,"value":457}," if the concept needs a ",{"type":36,"tag":51,"props":459,"children":461},{"className":460},[],[462],{"type":42,"value":133},{"type":42,"value":464}," property.",{"type":36,"tag":111,"props":466,"children":467},{},[468,473],{"type":36,"tag":115,"props":469,"children":470},{},[471],{"type":42,"value":472},"Smart reference assessment",{"type":42,"value":474},": see directives above.",{"type":36,"tag":111,"props":476,"children":477},{},[478,482],{"type":36,"tag":115,"props":479,"children":480},{},[481],{"type":42,"value":208},{"type":42,"value":483},": helps the user instantiate the concept through a menu.",{"type":36,"tag":111,"props":485,"children":486},{},[487,492,494,499],{"type":36,"tag":115,"props":488,"children":489},{},[490],{"type":42,"value":491},"Leave alias empty on smart references and transparent collections",{"type":42,"value":493},": e.g. ",{"type":36,"tag":51,"props":495,"children":497},{"className":496},[],[498],{"type":42,"value":198},{"type":42,"value":98},{"type":36,"tag":111,"props":501,"children":502},{},[503,508,509],{"type":36,"tag":115,"props":504,"children":505},{},[506],{"type":42,"value":507},"Property definition",{"type":42,"value":342},{"type":36,"tag":107,"props":510,"children":511},{},[512],{"type":36,"tag":111,"props":513,"children":514},{},[515,517,522,524,530],{"type":42,"value":516},"For enum properties: create the ",{"type":36,"tag":51,"props":518,"children":520},{"className":519},[],[521],{"type":42,"value":72},{"type":42,"value":523}," first, then set the property ",{"type":36,"tag":51,"props":525,"children":527},{"className":526},[],[528],{"type":42,"value":529},"dataType",{"type":42,"value":531}," to reference it.",{"type":36,"tag":111,"props":533,"children":534},{},[535,540,542,548,550,556],{"type":36,"tag":115,"props":536,"children":537},{},[538],{"type":42,"value":539},"Proper cardinality",{"type":42,"value":541},": make sure intended child collections have the cardinality of ",{"type":36,"tag":51,"props":543,"children":545},{"className":544},[],[546],{"type":42,"value":547},"0..n",{"type":42,"value":549}," or ",{"type":36,"tag":51,"props":551,"children":553},{"className":552},[],[554],{"type":42,"value":555},"1..n",{"type":42,"value":98},{"type":36,"tag":111,"props":558,"children":559},{},[560,565,566,572,574],{"type":36,"tag":115,"props":561,"children":562},{},[563],{"type":42,"value":564},"Bulk operations",{"type":42,"value":300},{"type":36,"tag":51,"props":567,"children":569},{"className":568},[],[570],{"type":42,"value":571},"mps_mcp_alter_structure",{"type":42,"value":573}," for creating multiple concepts or enums efficiently.\n",{"type":36,"tag":107,"props":575,"children":576},{},[577],{"type":36,"tag":111,"props":578,"children":579},{},[580],{"type":42,"value":581},"Local references within the same JSON blueprint can use names for resolution.",{"type":36,"tag":111,"props":583,"children":584},{},[585,590,592,598,599,605,606,611],{"type":36,"tag":115,"props":586,"children":587},{},[588],{"type":42,"value":589},"Reload runtime",{"type":42,"value":591},": always rebuild the language (via ",{"type":36,"tag":51,"props":593,"children":595},{"className":594},[],[596],{"type":42,"value":597},"mps_mcp_alter_nodes",{"type":42,"value":220},{"type":36,"tag":51,"props":600,"children":602},{"className":601},[],[603],{"type":42,"value":604},"MAKE",{"type":42,"value":228},{"type":36,"tag":51,"props":607,"children":609},{"className":608},[],[610],{"type":42,"value":234},{"type":42,"value":612},") after structural changes to make concepts discoverable.",{"type":36,"tag":100,"props":614,"children":616},{"id":615},"attributes-annotations",[617],{"type":42,"value":618},"Attributes (Annotations)",{"type":36,"tag":45,"props":620,"children":621},{},[622,624,629,631,637,639,644,646,652,654,660,662,668,669,675],{"type":42,"value":623},"Attributes let one language attach extra children, references, or property data to nodes of a concept it does ",{"type":36,"tag":115,"props":625,"children":626},{},[627],{"type":42,"value":628},"not",{"type":42,"value":630}," own — without editing or subclassing that concept. The host carries a universal ",{"type":36,"tag":51,"props":632,"children":634},{"className":633},[],[635],{"type":42,"value":636},"smodelAttribute",{"type":42,"value":638}," child slot (",{"type":36,"tag":51,"props":640,"children":642},{"className":641},[],[643],{"type":42,"value":547},{"type":42,"value":645},", every ",{"type":36,"tag":51,"props":647,"children":649},{"className":648},[],[650],{"type":42,"value":651},"BaseConcept",{"type":42,"value":653}," has it); the attribute's own declaration says where it may attach. Used heavily for cross-cutting concerns: generator macros (",{"type":36,"tag":51,"props":655,"children":657},{"className":656},[],[658],{"type":42,"value":659},"NodeMacro",{"type":42,"value":661},"\u002F",{"type":36,"tag":51,"props":663,"children":665},{"className":664},[],[666],{"type":42,"value":667},"PropertyMacro",{"type":42,"value":661},{"type":36,"tag":51,"props":670,"children":672},{"className":671},[],[673],{"type":42,"value":674},"ReferenceMacro",{"type":42,"value":676},"), documentation\u002Fdescription comments, requirement traces, error suppression.",{"type":36,"tag":107,"props":678,"children":679},{},[680,788],{"type":36,"tag":111,"props":681,"children":682},{},[683,685,690,692,697,699,704,706,711,713,718,720,725,727,732,734,740,742,748,750,755,757,763,765,771,773,778,780,786],{"type":42,"value":684},"Declare an attribute = a ",{"type":36,"tag":51,"props":686,"children":688},{"className":687},[],[689],{"type":42,"value":56},{"type":42,"value":691}," that ",{"type":36,"tag":115,"props":693,"children":694},{},[695],{"type":42,"value":696},"extends",{"type":42,"value":698}," one of ",{"type":36,"tag":51,"props":700,"children":702},{"className":701},[],[703],{"type":42,"value":397},{"type":42,"value":705}," (whole node), ",{"type":36,"tag":51,"props":707,"children":709},{"className":708},[],[710],{"type":42,"value":405},{"type":42,"value":712}," (one property), ",{"type":36,"tag":51,"props":714,"children":716},{"className":715},[],[717],{"type":42,"value":412},{"type":42,"value":719}," (one child link), or ",{"type":36,"tag":51,"props":721,"children":723},{"className":722},[],[724],{"type":42,"value":419},{"type":42,"value":726}," (one reference link), ",{"type":36,"tag":115,"props":728,"children":729},{},[730],{"type":42,"value":731},"plus",{"type":42,"value":733}," an ",{"type":36,"tag":51,"props":735,"children":737},{"className":736},[],[738],{"type":42,"value":739},"AttributeInfo",{"type":42,"value":741}," (alias ",{"type":36,"tag":51,"props":743,"children":745},{"className":744},[],[746],{"type":42,"value":747},"@attribute info",{"type":42,"value":749},") in its ",{"type":36,"tag":51,"props":751,"children":753},{"className":752},[],[754],{"type":42,"value":636},{"type":42,"value":756}," role specifying the extension point: ",{"type":36,"tag":51,"props":758,"children":760},{"className":759},[],[761],{"type":42,"value":762},"role",{"type":42,"value":764}," (the attach key), ",{"type":36,"tag":51,"props":766,"children":768},{"className":767},[],[769],{"type":42,"value":770},"attributed",{"type":42,"value":772}," (which concept(s) may receive it — ",{"type":36,"tag":51,"props":774,"children":776},{"className":775},[],[777],{"type":42,"value":651},{"type":42,"value":779}," = any), and ",{"type":36,"tag":51,"props":781,"children":783},{"className":782},[],[784],{"type":42,"value":785},"multiple",{"type":42,"value":787}," (one vs. many per node).",{"type":36,"tag":111,"props":789,"children":790},{},[791,797,799,804,806,811,812,818,820,826,828,834],{"type":36,"tag":51,"props":792,"children":794},{"className":793},[],[795],{"type":42,"value":796},"CREATE_CONCEPTS",{"type":42,"value":798}," cannot express the ",{"type":36,"tag":51,"props":800,"children":802},{"className":801},[],[803],{"type":42,"value":739},{"type":42,"value":805}," — create the concept extending the base attribute, then add the ",{"type":36,"tag":51,"props":807,"children":809},{"className":808},[],[810],{"type":42,"value":739},{"type":42,"value":220},{"type":36,"tag":51,"props":813,"children":815},{"className":814},[],[816],{"type":42,"value":817},"mps_mcp_update_node",{"type":42,"value":819},". Full walkthrough, concept reference, and the canonical ",{"type":36,"tag":51,"props":821,"children":823},{"className":822},[],[824],{"type":42,"value":825},"RequirementTrace",{"type":42,"value":827}," blueprint live in ",{"type":36,"tag":51,"props":829,"children":831},{"className":830},[],[832],{"type":42,"value":833},"references\u002Fattributes-and-annotations.md",{"type":42,"value":98},{"type":36,"tag":100,"props":836,"children":838},{"id":837},"related-skills",[839],{"type":42,"value":840},"Related Skills",{"type":36,"tag":107,"props":842,"children":843},{},[844,858,880,894,908],{"type":36,"tag":111,"props":845,"children":846},{},[847,856],{"type":36,"tag":115,"props":848,"children":849},{},[850],{"type":36,"tag":51,"props":851,"children":853},{"className":852},[],[854],{"type":42,"value":855},"mps-aspect-editor-menus-and-keymaps",{"type":42,"value":857}," — once concepts exist, define their editors (often the next step).",{"type":36,"tag":111,"props":859,"children":860},{},[861,870,872,878],{"type":36,"tag":115,"props":862,"children":863},{},[864],{"type":36,"tag":51,"props":865,"children":867},{"className":866},[],[868],{"type":42,"value":869},"mps-aspect-constraints",{"type":42,"value":871}," — property validators, scopes, and ",{"type":36,"tag":51,"props":873,"children":875},{"className":874},[],[876],{"type":42,"value":877},"canBe*",{"type":42,"value":879}," rules layered on top of structure.",{"type":36,"tag":111,"props":881,"children":882},{},[883,892],{"type":36,"tag":115,"props":884,"children":885},{},[886],{"type":36,"tag":51,"props":887,"children":889},{"className":888},[],[890],{"type":42,"value":891},"mps-aspect-behavior",{"type":42,"value":893}," — virtual methods per concept.",{"type":36,"tag":111,"props":895,"children":896},{},[897,906],{"type":36,"tag":115,"props":898,"children":899},{},[900],{"type":36,"tag":51,"props":901,"children":903},{"className":902},[],[904],{"type":42,"value":905},"mps-aspect-actions",{"type":42,"value":907}," — node factories for newly created concepts.",{"type":36,"tag":111,"props":909,"children":910},{},[911,920,922,928],{"type":36,"tag":115,"props":912,"children":913},{},[914],{"type":36,"tag":51,"props":915,"children":917},{"className":916},[],[918],{"type":42,"value":919},"mps-language-inheritance",{"type":42,"value":921}," — for ",{"type":36,"tag":51,"props":923,"children":925},{"className":924},[],[926],{"type":42,"value":927},"extendedLanguages",{"type":42,"value":929}," and concept super\u002Finterface relationships.",{"type":36,"tag":100,"props":931,"children":933},{"id":932},"reference-index",[934],{"type":42,"value":935},"Reference Index",{"type":36,"tag":107,"props":937,"children":938},{},[939,982],{"type":36,"tag":111,"props":940,"children":941},{},[942,944,950,952,957,958,964,966,972,974,980],{"type":42,"value":943},"Open ",{"type":36,"tag":51,"props":945,"children":947},{"className":946},[],[948],{"type":42,"value":949},"references\u002Fstructure-operation-api.md",{"type":42,"value":951}," for exact ",{"type":36,"tag":51,"props":953,"children":955},{"className":954},[],[956],{"type":42,"value":571},{"type":42,"value":228},{"type":36,"tag":51,"props":959,"children":961},{"className":960},[],[962],{"type":42,"value":963},"mps_mcp_query_structure",{"type":42,"value":965}," operation names, JSON parameter formats, structure blueprint schemas, ",{"type":36,"tag":51,"props":967,"children":969},{"className":968},[],[970],{"type":42,"value":971},"make",{"type":42,"value":973}," flag handling, and ",{"type":36,"tag":51,"props":975,"children":977},{"className":976},[],[978],{"type":42,"value":979},"makeStatus",{"type":42,"value":981}," semantics (success \u002F runtime_stale \u002F failed \u002F skipped).",{"type":36,"tag":111,"props":983,"children":984},{},[985,986,991,993,998,999,1004,1005,1010,1011,1016,1018,1023,1025,1031,1033,1039,1041,1046,1048,1053,1055,1060,1061,1066,1068,1073,1075,1080],{"type":42,"value":943},{"type":36,"tag":51,"props":987,"children":989},{"className":988},[],[990],{"type":42,"value":833},{"type":42,"value":992}," for attributes\u002Fannotations: the four attribute kinds (",{"type":36,"tag":51,"props":994,"children":996},{"className":995},[],[997],{"type":42,"value":397},{"type":42,"value":399},{"type":36,"tag":51,"props":1000,"children":1002},{"className":1001},[],[1003],{"type":42,"value":405},{"type":42,"value":399},{"type":36,"tag":51,"props":1006,"children":1008},{"className":1007},[],[1009],{"type":42,"value":412},{"type":42,"value":399},{"type":36,"tag":51,"props":1012,"children":1014},{"className":1013},[],[1015],{"type":42,"value":419},{"type":42,"value":1017},"), how to choose between them (feature-pinned kinds need a visible feature cell — whole-role markers should be a ",{"type":36,"tag":51,"props":1019,"children":1021},{"className":1020},[],[1022],{"type":42,"value":397},{"type":42,"value":1024}," + ",{"type":36,"tag":51,"props":1026,"children":1028},{"className":1027},[],[1029],{"type":42,"value":1030},"LinkDeclaration",{"type":42,"value":1032}," reference, converted at runtime via ",{"type":36,"tag":51,"props":1034,"children":1036},{"className":1035},[],[1037],{"type":42,"value":1038},"MetaAdapterByDeclaration",{"type":42,"value":1040},"), the ",{"type":36,"tag":51,"props":1042,"children":1044},{"className":1043},[],[1045],{"type":42,"value":739},{"type":42,"value":1047}," extension-point spec (",{"type":36,"tag":51,"props":1049,"children":1051},{"className":1050},[],[1052],{"type":42,"value":762},{"type":42,"value":1054},", ",{"type":36,"tag":51,"props":1056,"children":1058},{"className":1057},[],[1059],{"type":42,"value":770},{"type":42,"value":1054},{"type":36,"tag":51,"props":1062,"children":1064},{"className":1063},[],[1065],{"type":42,"value":785},{"type":42,"value":1067},"), the two-step MCP creation flow, the ",{"type":36,"tag":51,"props":1069,"children":1071},{"className":1070},[],[1072],{"type":42,"value":636},{"type":42,"value":1074}," slot, and worked examples (",{"type":36,"tag":51,"props":1076,"children":1078},{"className":1077},[],[1079],{"type":42,"value":825},{"type":42,"value":1081},", generator macros, doc\u002Fcomment annotations).",{"items":1083,"total":1202},[1084,1100,1108,1116,1126,1136,1149,1157,1166,1176,1185,1198],{"slug":1085,"name":1085,"fn":1086,"description":1087,"org":1088,"tags":1089,"stars":16,"repoUrl":17,"updatedAt":1099},"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},[1090,1093,1096],{"name":1091,"slug":1092,"type":15},"Architecture","architecture",{"name":1094,"slug":1095,"type":15},"Configuration","configuration",{"name":1097,"slug":1098,"type":15},"Engineering","engineering","2026-07-17T06:06:57.311661",{"slug":905,"name":905,"fn":1101,"description":1102,"org":1103,"tags":1104,"stars":16,"repoUrl":17,"updatedAt":1107},"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},[1105,1106],{"name":1091,"slug":1092,"type":15},{"name":1097,"slug":1098,"type":15},"2026-07-17T06:04:48.066901",{"slug":891,"name":891,"fn":1109,"description":1110,"org":1111,"tags":1112,"stars":16,"repoUrl":17,"updatedAt":1115},"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},[1113,1114],{"name":1091,"slug":1092,"type":15},{"name":1097,"slug":1098,"type":15},"2026-07-13T06:45:21.757084",{"slug":869,"name":869,"fn":1117,"description":1118,"org":1119,"tags":1120,"stars":16,"repoUrl":17,"updatedAt":1125},"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},[1121,1122],{"name":1091,"slug":1092,"type":15},{"name":1123,"slug":1124,"type":15},"Code Analysis","code-analysis","2026-07-23T05:41:33.639365",{"slug":1127,"name":1127,"fn":1128,"description":1129,"org":1130,"tags":1131,"stars":16,"repoUrl":17,"updatedAt":1135},"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},[1132],{"name":1133,"slug":1134,"type":15},"Data Analysis","data-analysis","2026-07-13T06:45:19.114674",{"slug":1137,"name":1137,"fn":1138,"description":1139,"org":1140,"tags":1141,"stars":16,"repoUrl":17,"updatedAt":1148},"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},[1142,1145],{"name":1143,"slug":1144,"type":15},"Design","design",{"name":1146,"slug":1147,"type":15},"UI Components","ui-components","2026-07-23T05:41:56.638151",{"slug":855,"name":855,"fn":1150,"description":1151,"org":1152,"tags":1153,"stars":16,"repoUrl":17,"updatedAt":1156},"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},[1154,1155],{"name":1097,"slug":1098,"type":15},{"name":1146,"slug":1147,"type":15},"2026-07-23T05:41:49.666535",{"slug":1158,"name":1158,"fn":1159,"description":1160,"org":1161,"tags":1162,"stars":16,"repoUrl":17,"updatedAt":1165},"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},[1163,1164],{"name":1091,"slug":1092,"type":15},{"name":1097,"slug":1098,"type":15},"2026-07-13T06:44:59.507855",{"slug":1167,"name":1167,"fn":1168,"description":1169,"org":1170,"tags":1171,"stars":16,"repoUrl":17,"updatedAt":1175},"mps-aspect-generator","define JetBrains MPS generator rules","Use when defining or modifying MPS generators — author a generator module, add or edit root\u002Freduction\u002Fweaving\u002Fpattern mapping rules, attach template macros ($COPY_SRC, $LOOP, $IF, $PROPERTY, $REF, $SWITCH, $MAP_SRC, $WEAVE, $INSERT, $LABEL, $TRACE, $VAR), wire mapping labels, build template switches, write pre\u002Fpost mapping scripts, navigate `genContext`, or debug \"rule didn't fire\", missing references, empty output, infinite reduction loops, and generated-Java compile failures.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1172,1173,1174],{"name":1091,"slug":1092,"type":15},{"name":1123,"slug":1124,"type":15},{"name":1097,"slug":1098,"type":15},"2026-07-17T06:06:58.042999",{"slug":1177,"name":1177,"fn":1178,"description":1179,"org":1180,"tags":1181,"stars":16,"repoUrl":17,"updatedAt":1184},"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},[1182,1183],{"name":1091,"slug":1092,"type":15},{"name":1097,"slug":1098,"type":15},"2026-07-23T05:41:48.692899",{"slug":1186,"name":1186,"fn":1187,"description":1188,"org":1189,"tags":1190,"stars":16,"repoUrl":17,"updatedAt":1197},"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},[1191,1194],{"name":1192,"slug":1193,"type":15},"Debugging","debugging",{"name":1195,"slug":1196,"type":15},"Migration","migration","2026-07-13T06:45:20.372122",{"slug":4,"name":4,"fn":5,"description":6,"org":1199,"tags":1200,"stars":16,"repoUrl":17,"updatedAt":18},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1201],{"name":13,"slug":14,"type":15},188,{"items":1204,"total":1240},[1205,1211,1216,1221,1226,1230,1235],{"slug":1085,"name":1085,"fn":1086,"description":1087,"org":1206,"tags":1207,"stars":16,"repoUrl":17,"updatedAt":1099},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1208,1209,1210],{"name":1091,"slug":1092,"type":15},{"name":1094,"slug":1095,"type":15},{"name":1097,"slug":1098,"type":15},{"slug":905,"name":905,"fn":1101,"description":1102,"org":1212,"tags":1213,"stars":16,"repoUrl":17,"updatedAt":1107},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1214,1215],{"name":1091,"slug":1092,"type":15},{"name":1097,"slug":1098,"type":15},{"slug":891,"name":891,"fn":1109,"description":1110,"org":1217,"tags":1218,"stars":16,"repoUrl":17,"updatedAt":1115},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1219,1220],{"name":1091,"slug":1092,"type":15},{"name":1097,"slug":1098,"type":15},{"slug":869,"name":869,"fn":1117,"description":1118,"org":1222,"tags":1223,"stars":16,"repoUrl":17,"updatedAt":1125},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1224,1225],{"name":1091,"slug":1092,"type":15},{"name":1123,"slug":1124,"type":15},{"slug":1127,"name":1127,"fn":1128,"description":1129,"org":1227,"tags":1228,"stars":16,"repoUrl":17,"updatedAt":1135},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1229],{"name":1133,"slug":1134,"type":15},{"slug":1137,"name":1137,"fn":1138,"description":1139,"org":1231,"tags":1232,"stars":16,"repoUrl":17,"updatedAt":1148},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1233,1234],{"name":1143,"slug":1144,"type":15},{"name":1146,"slug":1147,"type":15},{"slug":855,"name":855,"fn":1150,"description":1151,"org":1236,"tags":1237,"stars":16,"repoUrl":17,"updatedAt":1156},{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1238,1239],{"name":1097,"slug":1098,"type":15},{"name":1146,"slug":1147,"type":15},31]