[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill-jetbrains-spring-context-di-reasoning":3,"mdc--4iu8p3-key":36,"related-org-jetbrains-spring-context-di-reasoning":863,"related-repo-jetbrains-spring-context-di-reasoning":994},{"slug":4,"name":4,"fn":5,"description":6,"org":7,"tags":11,"stars":25,"repoUrl":26,"updatedAt":27,"license":28,"forks":29,"topics":30,"repo":31,"sourceUrl":34,"mdContent":35},"spring-context-di-reasoning","diagnose Spring application context startup failures","Diagnose Spring application context startup failures, bean graph problems, missing or duplicate beans, circular dependencies, conditional auto-configuration mismatches, and profile-related wiring issues in Kotlin + Spring projects. Use when the app does not start, a bean is not created or is created unexpectedly, auto-configuration behaves strangely, or a minimal DI fix is needed instead of a broad rewrite.",{"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,22],{"name":13,"slug":14,"type":15},"Backend","backend","tag",{"name":17,"slug":18,"type":15},"Java","java",{"name":20,"slug":21,"type":15},"Spring","spring",{"name":23,"slug":24,"type":15},"Debugging","debugging",252,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002Fskills","2026-07-17T06:06:17.202278",null,17,[],{"repoUrl":26,"stars":25,"forks":29,"topics":32,"description":33},[],"Curated agent skills collection verified by JetBrains","https:\u002F\u002Fgithub.com\u002FJetBrains\u002Fskills\u002Ftree\u002FHEAD\u002Fspring-context-di-reasoning","---\nname: spring-context-di-reasoning\ndescription: Diagnose Spring application context startup failures, bean graph problems, missing or duplicate beans, circular dependencies, conditional auto-configuration mismatches, and profile-related wiring issues in Kotlin + Spring projects. Use when the app does not start, a bean is not created or is created unexpectedly, auto-configuration behaves strangely, or a minimal DI fix is needed instead of a broad rewrite.\nmetadata:\n  short-description: \"Resolve bean graph and context failures\"\n  author: Kotlin\n  source: https:\u002F\u002Fgithub.com\u002FKotlin\u002Fkotlin-backend-agent-skills\u002Ftree\u002Fmain\u002F.agents\u002Fskills\u002Fspring-context-di-reasoning\n---\n\n# Spring Context DI Reasoning\n\nSource mapping: Tier 1 critical skill derived from `Kotlin_Spring_Developer_Pipeline.md` (`SK-02`).\n\n## Mission\n\nReconstruct why the Spring container made a specific decision and propose the narrowest fix that restores correct wiring.\nAssume the visible exception is often a wrapper, not the real cause.\n\n## Collect Evidence First\n\n- Read the full exception chain, not only the top exception.\n- Read the startup log lines around the first failure and around any `Caused by:` entries.\n- Read the relevant `@Configuration`, component classes, `@Bean` methods, `@ConfigurationProperties`, and active profiles.\n- Read the build context if it is not already known. Reuse output from `project-context-ingestion` when available.\n- If a condition evaluation report or auto-configuration report exists, use it.\n\n## Reconstruct The Bean Path\n\n- Identify the bean that failed first.\n- Walk constructor arguments, method parameters, and factory methods to build the dependency chain.\n- Separate symptom from cause:\n  - `BeanCreationException` is usually a wrapper.\n  - `UnsatisfiedDependencyException` usually points to a missing or ambiguous dependency one hop deeper.\n  - property binding failures often surface as bean creation failures.\n- Record whether the failing bean is user-defined, auto-configured, conditional, profile-specific, or imported from another module.\n\n## Diagnose By Category\n\nCheck these categories in order:\n\n1. Missing bean:\n   - package not scanned\n   - bean class not annotated\n   - `@Bean` method not imported\n   - wrong module dependency\n2. Ambiguous bean:\n   - multiple beans of same type\n   - missing `@Qualifier`\n   - missing `@Primary`\n3. Conditional mismatch:\n   - `@Profile` not active\n   - `@ConditionalOnProperty` false or missing\n   - classpath condition not satisfied\n4. Configuration binding failure:\n   - wrong prefix\n   - missing required property\n   - invalid type conversion\n5. Circular dependency:\n   - constructor cycle\n   - configuration class cycle\n   - bean factory method recursion\n6. Auto-configuration collision:\n   - user bean unintentionally overrides or blocks auto-config\n   - excluded auto-config removes a dependency chain\n7. Lifecycle or initialization side effects:\n   - bean does work too early in `@PostConstruct`\n   - external system call during initialization\n\n## Fix Hierarchy\n\nPrefer fixes in this order:\n\n1. Correct the missing import, annotation, qualifier, or profile.\n2. Correct the configuration property source or binding model.\n3. Narrow the scan or import boundary to the intended package or module.\n4. Resolve ambiguity with `@Qualifier` or `@Primary`.\n5. Refactor an actual cycle into a cleaner dependency direction.\n6. Use `@Lazy` only as a deliberate escape hatch, and explain the tradeoff.\n\n## Advanced Container Traps\n\n- Check whether a `@Configuration` class uses `proxyBeanMethods = false`. In that mode, direct calls between `@Bean` methods do not return the managed singleton unless dependencies are expressed through method parameters.\n- Check whether the missing bean is actually a `FactoryBean` product versus the factory itself.\n- Check generic type narrowing. `Foo\u003CBar>` and `Foo\u003CBaz>` may both exist while raw-type reasoning makes the graph look ambiguous or missing.\n- Check collection and map injection semantics. `List\u003CBeanType>` ordering, bean names, and conditional registration can hide the real cause.\n- Check whether `ObjectProvider\u003CT>`, `Optional\u003CT>`, or lazy lookup is masking a missing dependency until first use.\n- Check whether `@ConditionalOnMissingBean`, `@ConditionalOnSingleCandidate`, or ordering annotations caused an auto-configuration branch to back off unexpectedly.\n- Check for environment post-processors, imported configs, or test slices that change the bean graph compared with main runtime.\n- If the project uses AOT or native image workflows, check whether reflection or generated context metadata, not the source annotations alone, is the true source of failure.\n\n## Expert Heuristics\n\n- Prefer following the bean creation path from the first failing constructor argument over scanning all annotations in the module.\n- If one fix would \"make startup pass\" but leaves the graph semantically wrong, reject it and explain the deeper issue.\n- When the problem surfaces only in tests, compare the test slice graph with the production graph before changing production code.\n- If a bean exists but the wrong implementation is selected, explain the selection mechanism, not only the missing qualifier.\n- If property binding and bean creation both fail, fix property binding first. Bean graph symptoms often disappear afterward.\n\n## Output Contract\n\nReturn these sections:\n\n- `Diagnosis`: the most probable root cause in one or two sentences.\n- `Evidence`: the exact lines, bean path, condition, or configuration fact that supports the diagnosis.\n- `Minimal fix`: the smallest code or config change that addresses the root cause.\n- `Alternatives`: only if there is more than one legitimate fix.\n- `Verification`: how to confirm the fix, such as `.\u002Fgradlew test`, `bootRun`, or a specific startup assertion.\n\n## Guardrails\n\n- Do not suggest `@ComponentScan(\"*\")`, giant `scanBasePackages`, or other \"scan the world\" fixes.\n- Do not guess bean names or qualifiers that are not present in the code.\n- Do not recommend disabling auto-configuration broadly to silence a symptom.\n- Do not use `@Lazy` as the default answer to cycles.\n- Do not ignore profiles, conditions, or property sources when explaining bean behavior.\n\n## Common Spring-Specific Checks\n\n- Verify `@EnableConfigurationProperties` or equivalent registration if properties beans are missing.\n- Verify whether the failing type is an interface with multiple implementations.\n- Verify whether a bean lives in another Gradle module that is not on the runtime classpath.\n- Verify whether a `@TestConfiguration` or test slice changes the graph only in tests.\n- Verify whether the issue is really a classpath problem disguised as a bean problem.\n\n## Quality Bar\n\nA good run of this skill explains why Spring made the wrong decision and gives a minimal, testable fix.\nA bad run waves at annotations, suggests broad scans, or ignores the dependency chain that actually failed.\n",{"data":37,"body":42},{"name":4,"description":6,"metadata":38},{"short-description":39,"author":40,"source":41},"Resolve bean graph and context failures","Kotlin","https:\u002F\u002Fgithub.com\u002FKotlin\u002Fkotlin-backend-agent-skills\u002Ftree\u002Fmain\u002F.agents\u002Fskills\u002Fspring-context-di-reasoning",{"type":43,"children":44},"root",[45,53,76,83,88,94,164,170,223,229,234,428,434,439,494,500,627,633,661,667,672,745,751,802,808,852,858],{"type":46,"tag":47,"props":48,"children":49},"element","h1",{"id":4},[50],{"type":51,"value":52},"text","Spring Context DI Reasoning",{"type":46,"tag":54,"props":55,"children":56},"p",{},[57,59,66,68,74],{"type":51,"value":58},"Source mapping: Tier 1 critical skill derived from ",{"type":46,"tag":60,"props":61,"children":63},"code",{"className":62},[],[64],{"type":51,"value":65},"Kotlin_Spring_Developer_Pipeline.md",{"type":51,"value":67}," (",{"type":46,"tag":60,"props":69,"children":71},{"className":70},[],[72],{"type":51,"value":73},"SK-02",{"type":51,"value":75},").",{"type":46,"tag":77,"props":78,"children":80},"h2",{"id":79},"mission",[81],{"type":51,"value":82},"Mission",{"type":46,"tag":54,"props":84,"children":85},{},[86],{"type":51,"value":87},"Reconstruct why the Spring container made a specific decision and propose the narrowest fix that restores correct wiring.\nAssume the visible exception is often a wrapper, not the real cause.",{"type":46,"tag":77,"props":89,"children":91},{"id":90},"collect-evidence-first",[92],{"type":51,"value":93},"Collect Evidence First",{"type":46,"tag":95,"props":96,"children":97},"ul",{},[98,104,117,146,159],{"type":46,"tag":99,"props":100,"children":101},"li",{},[102],{"type":51,"value":103},"Read the full exception chain, not only the top exception.",{"type":46,"tag":99,"props":105,"children":106},{},[107,109,115],{"type":51,"value":108},"Read the startup log lines around the first failure and around any ",{"type":46,"tag":60,"props":110,"children":112},{"className":111},[],[113],{"type":51,"value":114},"Caused by:",{"type":51,"value":116}," entries.",{"type":46,"tag":99,"props":118,"children":119},{},[120,122,128,130,136,138,144],{"type":51,"value":121},"Read the relevant ",{"type":46,"tag":60,"props":123,"children":125},{"className":124},[],[126],{"type":51,"value":127},"@Configuration",{"type":51,"value":129},", component classes, ",{"type":46,"tag":60,"props":131,"children":133},{"className":132},[],[134],{"type":51,"value":135},"@Bean",{"type":51,"value":137}," methods, ",{"type":46,"tag":60,"props":139,"children":141},{"className":140},[],[142],{"type":51,"value":143},"@ConfigurationProperties",{"type":51,"value":145},", and active profiles.",{"type":46,"tag":99,"props":147,"children":148},{},[149,151,157],{"type":51,"value":150},"Read the build context if it is not already known. Reuse output from ",{"type":46,"tag":60,"props":152,"children":154},{"className":153},[],[155],{"type":51,"value":156},"project-context-ingestion",{"type":51,"value":158}," when available.",{"type":46,"tag":99,"props":160,"children":161},{},[162],{"type":51,"value":163},"If a condition evaluation report or auto-configuration report exists, use it.",{"type":46,"tag":77,"props":165,"children":167},{"id":166},"reconstruct-the-bean-path",[168],{"type":51,"value":169},"Reconstruct The Bean Path",{"type":46,"tag":95,"props":171,"children":172},{},[173,178,183,218],{"type":46,"tag":99,"props":174,"children":175},{},[176],{"type":51,"value":177},"Identify the bean that failed first.",{"type":46,"tag":99,"props":179,"children":180},{},[181],{"type":51,"value":182},"Walk constructor arguments, method parameters, and factory methods to build the dependency chain.",{"type":46,"tag":99,"props":184,"children":185},{},[186,188],{"type":51,"value":187},"Separate symptom from cause:\n",{"type":46,"tag":95,"props":189,"children":190},{},[191,202,213],{"type":46,"tag":99,"props":192,"children":193},{},[194,200],{"type":46,"tag":60,"props":195,"children":197},{"className":196},[],[198],{"type":51,"value":199},"BeanCreationException",{"type":51,"value":201}," is usually a wrapper.",{"type":46,"tag":99,"props":203,"children":204},{},[205,211],{"type":46,"tag":60,"props":206,"children":208},{"className":207},[],[209],{"type":51,"value":210},"UnsatisfiedDependencyException",{"type":51,"value":212}," usually points to a missing or ambiguous dependency one hop deeper.",{"type":46,"tag":99,"props":214,"children":215},{},[216],{"type":51,"value":217},"property binding failures often surface as bean creation failures.",{"type":46,"tag":99,"props":219,"children":220},{},[221],{"type":51,"value":222},"Record whether the failing bean is user-defined, auto-configured, conditional, profile-specific, or imported from another module.",{"type":46,"tag":77,"props":224,"children":226},{"id":225},"diagnose-by-category",[227],{"type":51,"value":228},"Diagnose By Category",{"type":46,"tag":54,"props":230,"children":231},{},[232],{"type":51,"value":233},"Check these categories in order:",{"type":46,"tag":235,"props":236,"children":237},"ol",{},[238,271,305,340,363,386,404],{"type":46,"tag":99,"props":239,"children":240},{},[241,243],{"type":51,"value":242},"Missing bean:\n",{"type":46,"tag":95,"props":244,"children":245},{},[246,251,256,266],{"type":46,"tag":99,"props":247,"children":248},{},[249],{"type":51,"value":250},"package not scanned",{"type":46,"tag":99,"props":252,"children":253},{},[254],{"type":51,"value":255},"bean class not annotated",{"type":46,"tag":99,"props":257,"children":258},{},[259,264],{"type":46,"tag":60,"props":260,"children":262},{"className":261},[],[263],{"type":51,"value":135},{"type":51,"value":265}," method not imported",{"type":46,"tag":99,"props":267,"children":268},{},[269],{"type":51,"value":270},"wrong module dependency",{"type":46,"tag":99,"props":272,"children":273},{},[274,276],{"type":51,"value":275},"Ambiguous bean:\n",{"type":46,"tag":95,"props":277,"children":278},{},[279,284,295],{"type":46,"tag":99,"props":280,"children":281},{},[282],{"type":51,"value":283},"multiple beans of same type",{"type":46,"tag":99,"props":285,"children":286},{},[287,289],{"type":51,"value":288},"missing ",{"type":46,"tag":60,"props":290,"children":292},{"className":291},[],[293],{"type":51,"value":294},"@Qualifier",{"type":46,"tag":99,"props":296,"children":297},{},[298,299],{"type":51,"value":288},{"type":46,"tag":60,"props":300,"children":302},{"className":301},[],[303],{"type":51,"value":304},"@Primary",{"type":46,"tag":99,"props":306,"children":307},{},[308,310],{"type":51,"value":309},"Conditional mismatch:\n",{"type":46,"tag":95,"props":311,"children":312},{},[313,324,335],{"type":46,"tag":99,"props":314,"children":315},{},[316,322],{"type":46,"tag":60,"props":317,"children":319},{"className":318},[],[320],{"type":51,"value":321},"@Profile",{"type":51,"value":323}," not active",{"type":46,"tag":99,"props":325,"children":326},{},[327,333],{"type":46,"tag":60,"props":328,"children":330},{"className":329},[],[331],{"type":51,"value":332},"@ConditionalOnProperty",{"type":51,"value":334}," false or missing",{"type":46,"tag":99,"props":336,"children":337},{},[338],{"type":51,"value":339},"classpath condition not satisfied",{"type":46,"tag":99,"props":341,"children":342},{},[343,345],{"type":51,"value":344},"Configuration binding failure:\n",{"type":46,"tag":95,"props":346,"children":347},{},[348,353,358],{"type":46,"tag":99,"props":349,"children":350},{},[351],{"type":51,"value":352},"wrong prefix",{"type":46,"tag":99,"props":354,"children":355},{},[356],{"type":51,"value":357},"missing required property",{"type":46,"tag":99,"props":359,"children":360},{},[361],{"type":51,"value":362},"invalid type conversion",{"type":46,"tag":99,"props":364,"children":365},{},[366,368],{"type":51,"value":367},"Circular dependency:\n",{"type":46,"tag":95,"props":369,"children":370},{},[371,376,381],{"type":46,"tag":99,"props":372,"children":373},{},[374],{"type":51,"value":375},"constructor cycle",{"type":46,"tag":99,"props":377,"children":378},{},[379],{"type":51,"value":380},"configuration class cycle",{"type":46,"tag":99,"props":382,"children":383},{},[384],{"type":51,"value":385},"bean factory method recursion",{"type":46,"tag":99,"props":387,"children":388},{},[389,391],{"type":51,"value":390},"Auto-configuration collision:\n",{"type":46,"tag":95,"props":392,"children":393},{},[394,399],{"type":46,"tag":99,"props":395,"children":396},{},[397],{"type":51,"value":398},"user bean unintentionally overrides or blocks auto-config",{"type":46,"tag":99,"props":400,"children":401},{},[402],{"type":51,"value":403},"excluded auto-config removes a dependency chain",{"type":46,"tag":99,"props":405,"children":406},{},[407,409],{"type":51,"value":408},"Lifecycle or initialization side effects:\n",{"type":46,"tag":95,"props":410,"children":411},{},[412,423],{"type":46,"tag":99,"props":413,"children":414},{},[415,417],{"type":51,"value":416},"bean does work too early in ",{"type":46,"tag":60,"props":418,"children":420},{"className":419},[],[421],{"type":51,"value":422},"@PostConstruct",{"type":46,"tag":99,"props":424,"children":425},{},[426],{"type":51,"value":427},"external system call during initialization",{"type":46,"tag":77,"props":429,"children":431},{"id":430},"fix-hierarchy",[432],{"type":51,"value":433},"Fix Hierarchy",{"type":46,"tag":54,"props":435,"children":436},{},[437],{"type":51,"value":438},"Prefer fixes in this order:",{"type":46,"tag":235,"props":440,"children":441},{},[442,447,452,457,476,481],{"type":46,"tag":99,"props":443,"children":444},{},[445],{"type":51,"value":446},"Correct the missing import, annotation, qualifier, or profile.",{"type":46,"tag":99,"props":448,"children":449},{},[450],{"type":51,"value":451},"Correct the configuration property source or binding model.",{"type":46,"tag":99,"props":453,"children":454},{},[455],{"type":51,"value":456},"Narrow the scan or import boundary to the intended package or module.",{"type":46,"tag":99,"props":458,"children":459},{},[460,462,467,469,474],{"type":51,"value":461},"Resolve ambiguity with ",{"type":46,"tag":60,"props":463,"children":465},{"className":464},[],[466],{"type":51,"value":294},{"type":51,"value":468}," or ",{"type":46,"tag":60,"props":470,"children":472},{"className":471},[],[473],{"type":51,"value":304},{"type":51,"value":475},".",{"type":46,"tag":99,"props":477,"children":478},{},[479],{"type":51,"value":480},"Refactor an actual cycle into a cleaner dependency direction.",{"type":46,"tag":99,"props":482,"children":483},{},[484,486,492],{"type":51,"value":485},"Use ",{"type":46,"tag":60,"props":487,"children":489},{"className":488},[],[490],{"type":51,"value":491},"@Lazy",{"type":51,"value":493}," only as a deliberate escape hatch, and explain the tradeoff.",{"type":46,"tag":77,"props":495,"children":497},{"id":496},"advanced-container-traps",[498],{"type":51,"value":499},"Advanced Container Traps",{"type":46,"tag":95,"props":501,"children":502},{},[503,530,543,564,577,598,617,622],{"type":46,"tag":99,"props":504,"children":505},{},[506,508,513,515,521,523,528],{"type":51,"value":507},"Check whether a ",{"type":46,"tag":60,"props":509,"children":511},{"className":510},[],[512],{"type":51,"value":127},{"type":51,"value":514}," class uses ",{"type":46,"tag":60,"props":516,"children":518},{"className":517},[],[519],{"type":51,"value":520},"proxyBeanMethods = false",{"type":51,"value":522},". In that mode, direct calls between ",{"type":46,"tag":60,"props":524,"children":526},{"className":525},[],[527],{"type":51,"value":135},{"type":51,"value":529}," methods do not return the managed singleton unless dependencies are expressed through method parameters.",{"type":46,"tag":99,"props":531,"children":532},{},[533,535,541],{"type":51,"value":534},"Check whether the missing bean is actually a ",{"type":46,"tag":60,"props":536,"children":538},{"className":537},[],[539],{"type":51,"value":540},"FactoryBean",{"type":51,"value":542}," product versus the factory itself.",{"type":46,"tag":99,"props":544,"children":545},{},[546,548,554,556,562],{"type":51,"value":547},"Check generic type narrowing. ",{"type":46,"tag":60,"props":549,"children":551},{"className":550},[],[552],{"type":51,"value":553},"Foo\u003CBar>",{"type":51,"value":555}," and ",{"type":46,"tag":60,"props":557,"children":559},{"className":558},[],[560],{"type":51,"value":561},"Foo\u003CBaz>",{"type":51,"value":563}," may both exist while raw-type reasoning makes the graph look ambiguous or missing.",{"type":46,"tag":99,"props":565,"children":566},{},[567,569,575],{"type":51,"value":568},"Check collection and map injection semantics. ",{"type":46,"tag":60,"props":570,"children":572},{"className":571},[],[573],{"type":51,"value":574},"List\u003CBeanType>",{"type":51,"value":576}," ordering, bean names, and conditional registration can hide the real cause.",{"type":46,"tag":99,"props":578,"children":579},{},[580,582,588,590,596],{"type":51,"value":581},"Check whether ",{"type":46,"tag":60,"props":583,"children":585},{"className":584},[],[586],{"type":51,"value":587},"ObjectProvider\u003CT>",{"type":51,"value":589},", ",{"type":46,"tag":60,"props":591,"children":593},{"className":592},[],[594],{"type":51,"value":595},"Optional\u003CT>",{"type":51,"value":597},", or lazy lookup is masking a missing dependency until first use.",{"type":46,"tag":99,"props":599,"children":600},{},[601,602,608,609,615],{"type":51,"value":581},{"type":46,"tag":60,"props":603,"children":605},{"className":604},[],[606],{"type":51,"value":607},"@ConditionalOnMissingBean",{"type":51,"value":589},{"type":46,"tag":60,"props":610,"children":612},{"className":611},[],[613],{"type":51,"value":614},"@ConditionalOnSingleCandidate",{"type":51,"value":616},", or ordering annotations caused an auto-configuration branch to back off unexpectedly.",{"type":46,"tag":99,"props":618,"children":619},{},[620],{"type":51,"value":621},"Check for environment post-processors, imported configs, or test slices that change the bean graph compared with main runtime.",{"type":46,"tag":99,"props":623,"children":624},{},[625],{"type":51,"value":626},"If the project uses AOT or native image workflows, check whether reflection or generated context metadata, not the source annotations alone, is the true source of failure.",{"type":46,"tag":77,"props":628,"children":630},{"id":629},"expert-heuristics",[631],{"type":51,"value":632},"Expert Heuristics",{"type":46,"tag":95,"props":634,"children":635},{},[636,641,646,651,656],{"type":46,"tag":99,"props":637,"children":638},{},[639],{"type":51,"value":640},"Prefer following the bean creation path from the first failing constructor argument over scanning all annotations in the module.",{"type":46,"tag":99,"props":642,"children":643},{},[644],{"type":51,"value":645},"If one fix would \"make startup pass\" but leaves the graph semantically wrong, reject it and explain the deeper issue.",{"type":46,"tag":99,"props":647,"children":648},{},[649],{"type":51,"value":650},"When the problem surfaces only in tests, compare the test slice graph with the production graph before changing production code.",{"type":46,"tag":99,"props":652,"children":653},{},[654],{"type":51,"value":655},"If a bean exists but the wrong implementation is selected, explain the selection mechanism, not only the missing qualifier.",{"type":46,"tag":99,"props":657,"children":658},{},[659],{"type":51,"value":660},"If property binding and bean creation both fail, fix property binding first. Bean graph symptoms often disappear afterward.",{"type":46,"tag":77,"props":662,"children":664},{"id":663},"output-contract",[665],{"type":51,"value":666},"Output Contract",{"type":46,"tag":54,"props":668,"children":669},{},[670],{"type":51,"value":671},"Return these sections:",{"type":46,"tag":95,"props":673,"children":674},{},[675,686,697,708,719],{"type":46,"tag":99,"props":676,"children":677},{},[678,684],{"type":46,"tag":60,"props":679,"children":681},{"className":680},[],[682],{"type":51,"value":683},"Diagnosis",{"type":51,"value":685},": the most probable root cause in one or two sentences.",{"type":46,"tag":99,"props":687,"children":688},{},[689,695],{"type":46,"tag":60,"props":690,"children":692},{"className":691},[],[693],{"type":51,"value":694},"Evidence",{"type":51,"value":696},": the exact lines, bean path, condition, or configuration fact that supports the diagnosis.",{"type":46,"tag":99,"props":698,"children":699},{},[700,706],{"type":46,"tag":60,"props":701,"children":703},{"className":702},[],[704],{"type":51,"value":705},"Minimal fix",{"type":51,"value":707},": the smallest code or config change that addresses the root cause.",{"type":46,"tag":99,"props":709,"children":710},{},[711,717],{"type":46,"tag":60,"props":712,"children":714},{"className":713},[],[715],{"type":51,"value":716},"Alternatives",{"type":51,"value":718},": only if there is more than one legitimate fix.",{"type":46,"tag":99,"props":720,"children":721},{},[722,728,730,736,737,743],{"type":46,"tag":60,"props":723,"children":725},{"className":724},[],[726],{"type":51,"value":727},"Verification",{"type":51,"value":729},": how to confirm the fix, such as ",{"type":46,"tag":60,"props":731,"children":733},{"className":732},[],[734],{"type":51,"value":735},".\u002Fgradlew test",{"type":51,"value":589},{"type":46,"tag":60,"props":738,"children":740},{"className":739},[],[741],{"type":51,"value":742},"bootRun",{"type":51,"value":744},", or a specific startup assertion.",{"type":46,"tag":77,"props":746,"children":748},{"id":747},"guardrails",[749],{"type":51,"value":750},"Guardrails",{"type":46,"tag":95,"props":752,"children":753},{},[754,775,780,785,797],{"type":46,"tag":99,"props":755,"children":756},{},[757,759,765,767,773],{"type":51,"value":758},"Do not suggest ",{"type":46,"tag":60,"props":760,"children":762},{"className":761},[],[763],{"type":51,"value":764},"@ComponentScan(\"*\")",{"type":51,"value":766},", giant ",{"type":46,"tag":60,"props":768,"children":770},{"className":769},[],[771],{"type":51,"value":772},"scanBasePackages",{"type":51,"value":774},", or other \"scan the world\" fixes.",{"type":46,"tag":99,"props":776,"children":777},{},[778],{"type":51,"value":779},"Do not guess bean names or qualifiers that are not present in the code.",{"type":46,"tag":99,"props":781,"children":782},{},[783],{"type":51,"value":784},"Do not recommend disabling auto-configuration broadly to silence a symptom.",{"type":46,"tag":99,"props":786,"children":787},{},[788,790,795],{"type":51,"value":789},"Do not use ",{"type":46,"tag":60,"props":791,"children":793},{"className":792},[],[794],{"type":51,"value":491},{"type":51,"value":796}," as the default answer to cycles.",{"type":46,"tag":99,"props":798,"children":799},{},[800],{"type":51,"value":801},"Do not ignore profiles, conditions, or property sources when explaining bean behavior.",{"type":46,"tag":77,"props":803,"children":805},{"id":804},"common-spring-specific-checks",[806],{"type":51,"value":807},"Common Spring-Specific Checks",{"type":46,"tag":95,"props":809,"children":810},{},[811,824,829,834,847],{"type":46,"tag":99,"props":812,"children":813},{},[814,816,822],{"type":51,"value":815},"Verify ",{"type":46,"tag":60,"props":817,"children":819},{"className":818},[],[820],{"type":51,"value":821},"@EnableConfigurationProperties",{"type":51,"value":823}," or equivalent registration if properties beans are missing.",{"type":46,"tag":99,"props":825,"children":826},{},[827],{"type":51,"value":828},"Verify whether the failing type is an interface with multiple implementations.",{"type":46,"tag":99,"props":830,"children":831},{},[832],{"type":51,"value":833},"Verify whether a bean lives in another Gradle module that is not on the runtime classpath.",{"type":46,"tag":99,"props":835,"children":836},{},[837,839,845],{"type":51,"value":838},"Verify whether a ",{"type":46,"tag":60,"props":840,"children":842},{"className":841},[],[843],{"type":51,"value":844},"@TestConfiguration",{"type":51,"value":846}," or test slice changes the graph only in tests.",{"type":46,"tag":99,"props":848,"children":849},{},[850],{"type":51,"value":851},"Verify whether the issue is really a classpath problem disguised as a bean problem.",{"type":46,"tag":77,"props":853,"children":855},{"id":854},"quality-bar",[856],{"type":51,"value":857},"Quality Bar",{"type":46,"tag":54,"props":859,"children":860},{},[861],{"type":51,"value":862},"A good run of this skill explains why Spring made the wrong decision and gives a minimal, testable fix.\nA bad run waves at annotations, suggests broad scans, or ignores the dependency chain that actually failed.",{"items":864,"total":993},[865,883,892,901,912,922,935,944,953,963,972,983],{"slug":866,"name":866,"fn":867,"description":868,"org":869,"tags":870,"stars":880,"repoUrl":881,"updatedAt":882},"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},[871,874,877],{"name":872,"slug":873,"type":15},"Architecture","architecture",{"name":875,"slug":876,"type":15},"Configuration","configuration",{"name":878,"slug":879,"type":15},"Engineering","engineering",1650,"https:\u002F\u002Fgithub.com\u002FJetBrains\u002FMPS","2026-07-17T06:06:57.311661",{"slug":884,"name":884,"fn":885,"description":886,"org":887,"tags":888,"stars":880,"repoUrl":881,"updatedAt":891},"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},[889,890],{"name":872,"slug":873,"type":15},{"name":878,"slug":879,"type":15},"2026-07-17T06:04:48.066901",{"slug":893,"name":893,"fn":894,"description":895,"org":896,"tags":897,"stars":880,"repoUrl":881,"updatedAt":900},"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},[898,899],{"name":872,"slug":873,"type":15},{"name":878,"slug":879,"type":15},"2026-07-13T06:45:21.757084",{"slug":902,"name":902,"fn":903,"description":904,"org":905,"tags":906,"stars":880,"repoUrl":881,"updatedAt":911},"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},[907,908],{"name":872,"slug":873,"type":15},{"name":909,"slug":910,"type":15},"Code Analysis","code-analysis","2026-07-23T05:41:33.639365",{"slug":913,"name":913,"fn":914,"description":915,"org":916,"tags":917,"stars":880,"repoUrl":881,"updatedAt":921},"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},[918],{"name":919,"slug":920,"type":15},"Data Analysis","data-analysis","2026-07-13T06:45:19.114674",{"slug":923,"name":923,"fn":924,"description":925,"org":926,"tags":927,"stars":880,"repoUrl":881,"updatedAt":934},"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},[928,931],{"name":929,"slug":930,"type":15},"Design","design",{"name":932,"slug":933,"type":15},"UI Components","ui-components","2026-07-23T05:41:56.638151",{"slug":936,"name":936,"fn":937,"description":938,"org":939,"tags":940,"stars":880,"repoUrl":881,"updatedAt":943},"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},[941,942],{"name":878,"slug":879,"type":15},{"name":932,"slug":933,"type":15},"2026-07-23T05:41:49.666535",{"slug":945,"name":945,"fn":946,"description":947,"org":948,"tags":949,"stars":880,"repoUrl":881,"updatedAt":952},"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},[950,951],{"name":872,"slug":873,"type":15},{"name":878,"slug":879,"type":15},"2026-07-13T06:44:59.507855",{"slug":954,"name":954,"fn":955,"description":956,"org":957,"tags":958,"stars":880,"repoUrl":881,"updatedAt":962},"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},[959,960,961],{"name":872,"slug":873,"type":15},{"name":909,"slug":910,"type":15},{"name":878,"slug":879,"type":15},"2026-07-17T06:06:58.042999",{"slug":964,"name":964,"fn":965,"description":966,"org":967,"tags":968,"stars":880,"repoUrl":881,"updatedAt":971},"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},[969,970],{"name":872,"slug":873,"type":15},{"name":878,"slug":879,"type":15},"2026-07-23T05:41:48.692899",{"slug":973,"name":973,"fn":974,"description":975,"org":976,"tags":977,"stars":880,"repoUrl":881,"updatedAt":982},"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},[978,979],{"name":23,"slug":24,"type":15},{"name":980,"slug":981,"type":15},"Migration","migration","2026-07-13T06:45:20.372122",{"slug":984,"name":984,"fn":985,"description":986,"org":987,"tags":988,"stars":880,"repoUrl":881,"updatedAt":992},"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},[989],{"name":990,"slug":991,"type":15},"Data Modeling","data-modeling","2026-07-23T05:41:30.705975",188,{"items":995,"total":1110},[996,1015,1030,1044,1059,1079,1096],{"slug":997,"name":997,"fn":998,"description":999,"org":1000,"tags":1001,"stars":25,"repoUrl":26,"updatedAt":1014},"algorithmic-art","create generative art with p5.js","Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1002,1005,1008,1011],{"name":1003,"slug":1004,"type":15},"Creative","creative",{"name":1006,"slug":1007,"type":15},"Generative Art","generative-art",{"name":1009,"slug":1010,"type":15},"Graphics","graphics",{"name":1012,"slug":1013,"type":15},"JavaScript","javascript","2026-07-13T06:41:35.540127",{"slug":1016,"name":1016,"fn":1017,"description":1018,"org":1019,"tags":1020,"stars":25,"repoUrl":26,"updatedAt":1029},"antfu","configure JavaScript projects with Anthony Fu's tools","Anthony Fu's opinionated tooling and conventions for JavaScript\u002FTypeScript projects. Use when setting up new projects, configuring ESLint\u002FPrettier alternatives, monorepos, library publishing, or when the user mentions Anthony Fu's preferences.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1021,1024,1025,1026],{"name":1022,"slug":1023,"type":15},"Best Practices","best-practices",{"name":878,"slug":879,"type":15},{"name":1012,"slug":1013,"type":15},{"name":1027,"slug":1028,"type":15},"TypeScript","typescript","2026-07-13T06:43:13.153309",{"slug":1031,"name":1031,"fn":1032,"description":1033,"org":1034,"tags":1035,"stars":25,"repoUrl":26,"updatedAt":1043},"brand-guidelines","apply Anthropic brand guidelines","Applies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1036,1039,1040],{"name":1037,"slug":1038,"type":15},"Branding","branding",{"name":929,"slug":930,"type":15},{"name":1041,"slug":1042,"type":15},"Typography","typography","2026-07-13T06:43:06.077629",{"slug":1045,"name":1045,"fn":1046,"description":1047,"org":1048,"tags":1049,"stars":25,"repoUrl":26,"updatedAt":1058},"canvas-design","create visual art and design assets","Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1050,1051,1052,1055],{"name":1003,"slug":1004,"type":15},{"name":929,"slug":930,"type":15},{"name":1053,"slug":1054,"type":15},"Images","images",{"name":1056,"slug":1057,"type":15},"PDF","pdf","2026-07-13T06:39:58.803113",{"slug":1060,"name":1060,"fn":1061,"description":1062,"org":1063,"tags":1064,"stars":25,"repoUrl":26,"updatedAt":1078},"ci-cd-containerization-advisor","design CI\u002FCD pipelines for Kotlin applications","Design reproducible build, image, and deployment pipelines for Kotlin plus Spring applications, including CI verification, layered containers, rollout safety, and deployment-time migration coordination. Use when creating or improving Dockerfiles, CI workflows, image hardening, Kubernetes manifests, release gates, or deployment strategies for Spring Boot services, especially where build reproducibility and operational safety matter.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1065,1068,1071,1074,1075,1077],{"name":1066,"slug":1067,"type":15},"CI\u002FCD","ci-cd",{"name":1069,"slug":1070,"type":15},"Containers","containers",{"name":1072,"slug":1073,"type":15},"Deployment","deployment",{"name":878,"slug":879,"type":15},{"name":40,"slug":1076,"type":15},"kotlin",{"name":20,"slug":21,"type":15},"2026-07-13T06:41:47.83899",{"slug":1080,"name":1080,"fn":1081,"description":1082,"org":1083,"tags":1084,"stars":25,"repoUrl":26,"updatedAt":1095},"cloudflare-deploy","deploy applications to Cloudflare","Deploy applications and infrastructure to Cloudflare using Workers, Pages, and related platform services. Use when the user asks to deploy, host, publish, or set up a project on Cloudflare.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1085,1088,1091,1094],{"name":1086,"slug":1087,"type":15},"Cloudflare","cloudflare",{"name":1089,"slug":1090,"type":15},"Cloudflare Pages","cloudflare-pages",{"name":1092,"slug":1093,"type":15},"Cloudflare Workers","cloudflare-workers",{"name":1072,"slug":1073,"type":15},"2026-07-17T06:04:42.853896",{"slug":1097,"name":1097,"fn":1098,"description":1099,"org":1100,"tags":1101,"stars":25,"repoUrl":26,"updatedAt":1109},"compose-ui-control","interact with Compose Desktop applications","Control a running Compose Desktop application via HTTP. Use when you need to interact with UI elements, click buttons, enter text, wait for elements to appear, or capture screenshots in a Compose Desktop app that has compose-ui-test-server enabled.",{"slug":8,"name":9,"logoUrl":10,"githubOrg":9},[1102,1105,1108],{"name":1103,"slug":1104,"type":15},"Automation","automation",{"name":1106,"slug":1107,"type":15},"Desktop","desktop",{"name":932,"slug":933,"type":15},"2026-07-13T06:40:38.798626",128]