@bonesofspring/ai-rules 0.2.31 → 0.2.32

package/scripts/fixtures/cli-golden/opencode/php-laravel.json

@@ -13,23 +13,23 @@
     ".opencode/MCP.md": "82420d33d4b50e9f082b2a65c62657592f6eb541034771811c13015f9bd36660",
     ".opencode/agents/README.md": "b49bff590381deb0841766c785c4124a590315080b363f373416f445a630153c",
     ".opencode/agents/api-contract-reviewer.md": "aae9e9e4a831658ec193ce72d549023c7d8b11cafc2569ce07eb964a353bf1f0",
-    ".opencode/agents/build-verifier.md": "55ebcb0d266f965505951b0ef9f2313f6db4efe57c8c12973044052a0d98ceba",
+    ".opencode/agents/build-verifier.md": "b271082efd336123ddce17d7cf8b877eb549b07300002b6f882eff0cafa13b94",
     ".opencode/agents/ci-investigator.md": "d2f22009081bba3696550e779faf72f115e9f07ed4053d4dbe174375dcb3cb0a",
-    ".opencode/agents/code-reviewer.md": "ffa1d9d455006f11251fbcf2f1b499a802e44b376ac9901b1853a9dcf8515254",
+    ".opencode/agents/code-reviewer.md": "fc4e1552310066ddfe80adccff1853cc4629793017eb4f8bf8ce0cdd25841e03",
     ".opencode/agents/codebase-analyzer.md": "2545bf58b383c205164f5c6d2db4f01722bd201c7bb272014256686daead90ad",
     ".opencode/agents/debugger.md": "d412fa153e291dbc6f2e3dd659905ff51cc8d8a112968325a67ec85277df76b0",
-    ".opencode/agents/feature-developer.md": "268afcacee7d34a49419f05c01d7cc20bbf2760a98d54a63d9c96083b812b2d5",
+    ".opencode/agents/feature-developer.md": "198fbca63d374d31a5f6a0f2fd16c8e6e2ac7956ea4baf8b0effac7bbc0bdec9",
     ".opencode/agents/integration-test-generator.md": "f43866c354a97377cbfbe84e740159b3eb81ebf688c58eb0bbed5effe7245d83",
     ".opencode/agents/integration-test-healer.md": "67c74f8d77b714788b16c671245b091552c598dd7115faf0610a0b639e6a9d9b",
     ".opencode/agents/integration-test-planner.md": "57e215b97fb4a245d320930239816a8ae38573c3086d90e2929da349b62a3587",
     ".opencode/agents/migration-specialist.md": "b44d5a6511e28f1033cced72fc20510db0de98ca4d05f93f4a771e9963eb4158",
-    ".opencode/agents/openspec-author.md": "ed529ee0e885cc0d625b1c61d82dccb054d60d94fa1cdbdc268172cf7f672046",
+    ".opencode/agents/openspec-author.md": "c4ce0951a6ac8583a2f901869067e883b7007c3efb810a89020282711ac2adbe",
     ".opencode/agents/performance-auditor.md": "20d11dde57fa797202c52d6d2c1b45a79656eaecc5e2d9702ec68c94ba07ed7c",
     ".opencode/agents/qa-tester.md": "158e71ed249f5d27f8fec8287a3060e42d3979fe032b992ecc6ea16a44d81d52",
     ".opencode/agents/security-reviewer.md": "c083ee23c2a43357e2fbd4ef58d882683eea8692f3ec665d788936aaf2bc25f3",
     ".opencode/agents/solution-architect.md": "8574f97b8675a9fd4a6a39c9ee567abd4975157c9b2f1e795c0bd9d2be06077c",
-    ".opencode/agents/task-analyst.md": "f14abd68cb75fd308f6371ab62377c842a02325e16d881762ab3d4ac93045db6",
-    ".opencode/agents/task-router.md": "47b7c2c798d8d4e43e0ad66dbbbd656fecb4c2dad96723ce8b9a4cdea85046f4",
+    ".opencode/agents/task-analyst.md": "520ddf61e49f227d0637a39e11aa95d546f75803bb73dd07b76ae26a2cda17b6",
+    ".opencode/agents/task-router.md": "26bd5fd2a13fd041f5ed31eb24facc8778b14735e670c6e113c1cc8e8466dd65",
     ".opencode/agents/tech-writer.md": "8b40fc07f0a8073ac96f6cae11c8dfe60aba21ee1bdb0dd588a15fb63128da89",
     ".opencode/agents/unit-test-generator.md": "8cdff91a86ce70fdf67b73456fa2758258a514778c9d9f09a47c1f322635a842",
     ".opencode/agents/unit-test-healer.md": "5ec9f0f435ee24254fecc7f623f92a9225065e1edfc7ed7f680c5b2ceb43c243",
@@ -44,11 +44,11 @@
     ".opencode/rules/README.md": "92a21eb0103a6309ec8e0296bd9c02355d452257fb41ca27c524cba3c622b89e",
     ".opencode/rules/actions-services.md": "173a4aab9256ac8f3526a395d00cd62ef22acadd76c67f9ab176fd6058b6f9db",
     ".opencode/rules/agent-team-intake.md": "12a7d81ccb2b6f504b92cd08a4f8da52d65595750a8ad457649fe44f135adf01",
-    ".opencode/rules/agent-team-orchestrator.md": "c4d84f79b02422d25e94005cc79d25926f918c0500701def393293690c927a97",
+    ".opencode/rules/agent-team-orchestrator.md": "1d9e58a3509dc5262cad1eff9cddf7d65972223bac8ede5d259c3d0f62ff7ade",
     ".opencode/rules/ai-local-overlay.md": "5a5f8d29d15bfb76a8e6cc631abb729599cea347f6ebb8221195758a5eab87a1",
     ".opencode/rules/anti-sycophancy-discipline.md": "653231c835a98f944e2c125fe5f8cf818b56c0f3602e469488dac1b2267da023",
     ".opencode/rules/architecture-boundaries.md": "1b8d164445df36bbe2dd4db46ec2cfa187774e745112216661281e728b39ac0e",
-    ".opencode/rules/code-quality-and-refactoring.md": "cd884355b50b6bc5a769c235ca1178c22e850721257f3d6923a847c2ada1ab1e",
+    ".opencode/rules/code-quality-and-refactoring.md": "aff01ce1a59ac4022bd0f722224228ccb7f821d92fde6095220ac28eccd47506",
     ".opencode/rules/code-review-mr.md": "4a7ed7c34301b231e1c04e1c83afb00e3735b475f2261fe80d0126a843896f74",
     ".opencode/rules/design-guidance.md": "320aa9db3c014e5189130f24e81bfde59d065ac670d1361b1f3c4d3bbd9a35ee",
     ".opencode/rules/domain-layer.md": "41d8cdcdf2f7abd7035bec4bf498f1f945e2bc3041bbb1be8dffd466e5afba68",

package/scripts/fixtures/cli-golden/opencode/svelte.json

@@ -25,30 +25,30 @@
     ".opencode/AGENTS.md": "e52d6380b1d7c33dc0c819eb88b535ec28c4376016e0751e91877313de6bd0a2",
     ".opencode/MCP.md": "3a27ce1483e2c6df44a531556738558898f50a20e16450bea02f620c0ad84b54",
     ".opencode/agents/README.md": "8a9a4307b5326db65490cd73ff1e309d9bc8a678477d51b358b86dbc388d9b61",
-    ".opencode/agents/accessibility-reviewer.md": "d659f901142486a3240262571f63ab1991565ab6d360f61efaf64028b4134a20",
-    ".opencode/agents/api-contract-reviewer.md": "2fad826bb7beed6befa80f28c4569bdbe143da827652f5be559b6671a546e362",
-    ".opencode/agents/build-verifier.md": "de847ebc1813ed5468dcc8f54e9ae6cb0b90077549761e676870e9e262c51bf2",
-    ".opencode/agents/ci-investigator.md": "be21a51a8669170ee37503509164dea7a2ab5e781ac9ea491a67a6133c3b6eb7",
-    ".opencode/agents/code-reviewer.md": "4a9c6e53273c42db8fe22dea9dab22379e2ebb6370e90a896dd6f7c3678dc20d",
+    ".opencode/agents/accessibility-reviewer.md": "af2ca0cbe12864c4d5384396a3c63931c9ee105bb5dc31cd0a60eaa4f6c2129b",
+    ".opencode/agents/api-contract-reviewer.md": "d21cda31442838e51833c9b3f775f40865adb586ac14d36b2e5c61344564c633",
+    ".opencode/agents/build-verifier.md": "e2679ba112dcd97a81a6ba33913c73c14799eb6f9ee88837d9d1aaf8fba6f521",
+    ".opencode/agents/ci-investigator.md": "8b118897ac0b2e328317077d3ddf88c7d3de728ebca0513a71a0dad338e454df",
+    ".opencode/agents/code-reviewer.md": "586c57d090c53856b47e73d7396af434e06528d4789bdc911068e09140c8cae5",
     ".opencode/agents/codebase-analyzer.md": "38b19c35e0299fe2884a83c7dd6ffb45a4ed62761c667694651393a6e0d5b861",
-    ".opencode/agents/debugger.md": "3b7a7375849f6fa9262c7919582994a70083b19e771c6d8d138221ef7e683653",
-    ".opencode/agents/feature-developer.md": "e058f2b5b267673baa9e483142587f644d3c293b1898ef85440c169c94d05439",
-    ".opencode/agents/migration-specialist.md": "e892ef77e5c76e4e3596ac4a7b9815d844246da59410e2eaf6af46cf8c8b905a",
-    ".opencode/agents/mockup-reviewer.md": "50fd1428f5d8898819f264a3852a103840e542a7f991a09fd114513ab468456a",
-    ".opencode/agents/openspec-author.md": "32658aeb135c676b46bcdcceb43915c5ed0e378c47f110aa1f448ebbfd1aab13",
-    ".opencode/agents/performance-auditor.md": "ab0ce14d89bda9003d3cb3cbc6d1b9295c59fcbb6070c467a383d78109402901",
+    ".opencode/agents/debugger.md": "b47942a8af4a609c229b9412be6ced6203d2bf520dde23ae529f01c5d35eca04",
+    ".opencode/agents/feature-developer.md": "60dec7408836d4a430e6049777c79f3467f376664bbd71d95d2b2de36066e3dd",
+    ".opencode/agents/migration-specialist.md": "366d4ab3a5055be8119e997c659d439eb60af1a233158b040d0e81ad995dcb6d",
+    ".opencode/agents/mockup-reviewer.md": "b1601db31a43a684eafe604cd44f052c22dd260434a4cc6cb980cd74bfeb71b1",
+    ".opencode/agents/openspec-author.md": "f62ab57eb47b2bd659eb70b215b7e13d4fd6af43d9a504ec2b039da10aca0c43",
+    ".opencode/agents/performance-auditor.md": "5a143225080880604e2fb4b213175e237c7067dac91a5b89a72781226ec51408",
     ".opencode/agents/playwright-test-generator.md": "4a283aabd817cb78654c60fb62bd220c90deb13b628a0264ce7f513c3f54a697",
     ".opencode/agents/playwright-test-healer.md": "aab31a04e04a87fac8b24240bebcf011d0793ca9b205563e2c2f837ee3d6705b",
     ".opencode/agents/playwright-test-planner.md": "8079e3c765a1b696ecb1ab68f5c47cb8a4e0fb9c258e3ecf29e14a43310999fc",
-    ".opencode/agents/qa-tester.md": "8dc0958b4d2fe09b01b1efeea0bf188cde6d070f9ea7de07a71785a5eee1c441",
-    ".opencode/agents/security-reviewer.md": "c4ae786b608237839ca1ae1906ce29e04f1a95817c16801fc87fca4fc1ecd6e4",
-    ".opencode/agents/solution-architect.md": "c3388ba999eab99f9642d9d4ea9ba4650465c52cf7fd4bfa12f492c8dfc0177f",
-    ".opencode/agents/task-analyst.md": "3bb0b63fe0723a6aad25dec9d078e1e87759468a8dd94119649d8e9de7b11b3a",
-    ".opencode/agents/task-router.md": "8fa92d79651c1639b722c906c0d39e9e3a36ef6dbf754a58a8f6aed61fe2460a",
-    ".opencode/agents/tech-writer.md": "07277b92052962ae8b2dc4b5d4f0dd61514c08c9a8eec6f955647aadcb948a89",
-    ".opencode/agents/unit-test-generator.md": "a7e7c0c86da09420c70efae213af58c43afafe17d664b962a5343c14966fc753",
-    ".opencode/agents/unit-test-healer.md": "0afcd433b99184daf4229115a619c76ef938e9e18e7e19cecb89a2cd177b1015",
-    ".opencode/agents/unit-test-planner.md": "880fa52f10a12208762e8159b95885d22eefe182abdee53abcba8f60b60f4936",
+    ".opencode/agents/qa-tester.md": "120cdc3e41b570bd70889e01625870eab4ce3f72653d414578b8b0e76240946e",
+    ".opencode/agents/security-reviewer.md": "6e14abfd44e8c5fac6bd6a94287789f9e19816bd9842e81e525c3622ae285c59",
+    ".opencode/agents/solution-architect.md": "e4d66a58223722c1d2c6ddfc00f5dd83a86e13885eed84dcab0fed483611d412",
+    ".opencode/agents/task-analyst.md": "ee2503e6f2c1dcaa3b03bf2b9618a4a0dafad7d31943963be2356e87726fcc65",
+    ".opencode/agents/task-router.md": "18c554047c7705a78524d75883baf6223e9c77e964834bf3146ba463e4094c83",
+    ".opencode/agents/tech-writer.md": "7a15bdbe585036d070732a13b64961e19d656cd82b377b4375873e419426aba2",
+    ".opencode/agents/unit-test-generator.md": "f4de329360a65117cf03ad66959bc96e97fcaf9836cba5ed237e1ebf01179ee4",
+    ".opencode/agents/unit-test-healer.md": "32ba9e0aff1b600f8c55f704cbe51ce51ac0ed90de3b3889c6b637c3040127f8",
+    ".opencode/agents/unit-test-planner.md": "6c6fafa68b6294b15c9b0d950d602ffe1f5ea5afc87de5b327bb5bc6d78f7eb8",
     ".opencode/commands/README.md": "ea7561075abfa64140ecd467ed0107f0d9242b8194035f108826361157ab04c8",
     ".opencode/commands/spec-start.md": "0e7f610784a24c9feca8ecce14934d85233821265258fe09abab2892b9f81e0b",
     ".opencode/commands/task-continue.md": "f73926dd94b27dd34cbb99646bedb45fe8ad7f42623591e0760d4074941ecb4d",
@@ -58,17 +58,17 @@
     ".opencode/hooks/chain-team-phases.sh": "f4d2b6ba2765065d8cde93d6f9d8eb3f7866509cf5c473b76c12117aa6114448",
     ".opencode/rules/README.md": "a844bb203c33e8128c7841bde7a250db53a2cf4726af257aed323f822a9f1a82",
     ".opencode/rules/agent-team-intake.md": "6804fda59160de1f3720d7832c7227a8e5c9b8e4c2b9e60fd9a648edd59c2414",
-    ".opencode/rules/agent-team-orchestrator.md": "c4d84f79b02422d25e94005cc79d25926f918c0500701def393293690c927a97",
+    ".opencode/rules/agent-team-orchestrator.md": "1d9e58a3509dc5262cad1eff9cddf7d65972223bac8ede5d259c3d0f62ff7ade",
     ".opencode/rules/ai-local-overlay.md": "5a5f8d29d15bfb76a8e6cc631abb729599cea347f6ebb8221195758a5eab87a1",
     ".opencode/rules/anti-sycophancy-discipline.md": "653231c835a98f944e2c125fe5f8cf818b56c0f3602e469488dac1b2267da023",
     ".opencode/rules/api-services.md": "f9fb6e35114a54d3c41a2ae7098c5d2b3e548a64da28891a8596077860809365",
     ".opencode/rules/architecture-boundaries-ui.md": "42f07eb22802fd92204f2a3b155316a167a7382b6d818c961ae4656e47c9c790",
     ".opencode/rules/architecture-boundaries.md": "c35db8b3ad042d8569f6b99850e8bc3049856a0e66377d8be4b5657495b5e763",
     ".opencode/rules/code-quality-and-refactoring.md": "221426208f3bd19b3f97ed9e764e682f6ad56029daba0694a34b2c3bdf9ffd2f",
-    ".opencode/rules/code-review-mr.md": "81667a8477e49d9d3d307306821241048d04ae6c24b5a9e447961fa2c86453d6",
+    ".opencode/rules/code-review-mr.md": "f301078de63d5b0ce2df2dbcfe0328358ab1c08ad1013c2cd8389ed1890f3613",
     ".opencode/rules/css-property-order-stylelint.md": "d1de016aad731818bf3cf4705d42ca4a60d44663ada0cdf3c8f911dd76e500d3",
     ".opencode/rules/design-guidance.md": "0a5eaa999f5d5e930e0a54859c7f634968d8b3c7379b60a7cb7968c438d5e59e",
-    ".opencode/rules/feature-delivery-workflow.md": "520b09613dd36b82a9ffc90fec661cfcc9e8d53aa99830e7a27e54722899b0d1",
+    ".opencode/rules/feature-delivery-workflow.md": "4205458081fe28ef4143d3e87f80e2df5d33b5cbe5bbeb6a1a0e5fafe8631ada",
     ".opencode/rules/http-client.md": "19bc5fbb0070d000e3b0c6ffb1c4d818c8d7fc8e614595b1038433ae11760b0b",
     ".opencode/rules/layer-barrel-exports.md": "e0f6d1e6e10f84867660bdeb88799d9ffd4bfd778029fafde86a349d912573ec",
     ".opencode/rules/mcp-usage.md": "0726fa82721b16e0eeca6f32493f0e4411cf8e9ddc60f687c5d4a0357d8660eb",
@@ -88,7 +88,7 @@
     ".opencode/rules/product-specs-authoring.md": "e355387117e689cd957ec02a0c7c306014f7a21cdcaf0e85f57858c12ad0911e",
     ".opencode/rules/product-specs.md": "e1210aa455b65adcedef6c9d79b55273de989c459fc9a3564bfc167b61e481d8",
     ".opencode/rules/public-imports.md": "c6ec89498e372307f59472d640512f7ab7c7ad73a32b430fafe1eb7fcf1b3fec",
-    ".opencode/rules/reference-features.md": "6520de27ceb87b03088d2557ee7bdf18c47ee71a5e63632f3c80c2593ae89785",
+    ".opencode/rules/reference-features.md": "cc1cb58c1c8c4e4100b137bd756fcfbdd442057cc3e785db72cbac910f78f00e",
     ".opencode/rules/security-sveltekit.md": "d22fa9ad9ff3199b9932dab782ba0619d3827aabbfa0149537754f525c9e218d",
     ".opencode/rules/store-svelte.md": "e677453db5afb848775062061aeaaffe75b4c55ed162254da9e0f269c26ddd7b",
     ".opencode/rules/svelte-a11y-coding.md": "f27bb73f047f5ace9ec28e37bd94c42bc436bdfc5f62d5c0e4b84996ef5c53bb",
@@ -98,7 +98,7 @@
     ".opencode/rules/svelte-ui.md": "806656b8a77a17523808608a1cb2e463ad0fc56a95b7bc877ec9ec0e94cb8805",
     ".opencode/rules/sveltekit-routing.md": "376e1b079e27abc9cbdcb4cc7038185db54a86e018653a07d055cd8ff23decc8",
     ".opencode/rules/technical-retro.md": "5f9ed6b3b86035866e26d153a60805da08c4670f3d46581bde1839469861b179",
-    ".opencode/rules/tests-e2e-structure.md": "0a97610749432e1866bc81ab49bb8d6da22b944dd1b44bb52e84e42745fe5251",
+    ".opencode/rules/tests-e2e-structure.md": "ffbc196682d90b5b51f996d86e2578e0616638cdde355d221fb7ad985f722666",
     ".opencode/rules/tests-unit.md": "508506fd752f1641537b71361c34ffee2577b67888dccae5e16242e0a1a310ab",
     ".opencode/rules/types-jsdoc.md": "5827aeb0fba00ab115d37607b621eb8d562d12b8d404c9994ee17a5f4445ea5f",
     ".opencode/rules/ux-design.md": "a62ef0c176f0615c4a27ff3c5859eb858be5a8e28de430a41be4504f5f2fd960",

package/scripts/lib/generate-adapter-common.mjs

@@ -241,6 +241,23 @@ export function rewriteMdcToMd(text) {
     .replace(/(?<![\w./-])([\w-]+)\.mdc\b/g, '$1.md');
 }
 
+/**
+ * Rewrite `.mdc` cross-references to sibling rule stems only.
+ *
+ * The broad `rewriteMdcToMd` also rewrites backticked paths such as
+ * `presets/cursor/next/rules/*.mdc`, which is wrong inside embed-mode adapter
+ * bodies (Stack notes / preserved prose) where meta-rules legitimately describe
+ * the Cursor SoT. Restrict to stems that exist as rules in the target tree.
+ */
+export function rewriteRuleStemRefs(text, stems) {
+  if (!stems || stems.size === 0) {
+    return text;
+  }
+  return text.replace(/(?<![\w./-])([a-z][\w-]*)\.mdc\b/g, (match, stem) =>
+    stems.has(stem) ? `${stem}.md` : match,
+  );
+}
+
 export function rewriteConsumerRoot(text, fromRoot, toRoot) {
   return text
     // Living conventions live at `.ai.local/conventions.md`; `.ai.local/team/**`

package/scripts/lib/generate-mavis-adapter.mjs

@@ -21,6 +21,7 @@ import {
   rewriteCursorPipelineIntro,
   rewriteMdcToMd,
   rewriteOrchestratorCursorNotes,
+  rewriteRuleStemRefs,
   sharedCoreStem,
   standardTierCell,
   strongTierCell,
@@ -95,7 +96,7 @@ function stripEmbeddedCatalogLine(body) {
 function transformMarkdown(
   sourceText,
   stack,
-  { command = false, allowEmbedEntry = true, preserveStackNotes = true } = {},
+  { command = false, allowEmbedEntry = true, preserveStackNotes = true, ruleStems } = {},
 ) {
   const rewriteProse = (text) => finalizeMavisProse(text, stack);
   const { body } = stripFrontmatter(sourceText);
@@ -117,7 +118,7 @@ function transformMarkdown(
     if (stackNotes) {
       next += `\n${stackNotes}\n`;
     }
-    next = rewriteConsumerPaths(next);
+    next = rewriteRuleStemRefs(rewriteConsumerPaths(next), ruleStems);
   } else {
     next = rewriteProse(body);
   }
@@ -416,6 +417,8 @@ export function generateMavisStack(stack, { root = packageRoot } = {}) {
           // transformOrchestrator injects a platform-neutral note instead.
           let markdown = transformMarkdown(sourceText, stack, {
             preserveStackNotes: stem !== 'agent-team-orchestrator',
+            // Author meta-rules legitimately reference Cursor `.mdc` filenames.
+            ruleStems: stem.startsWith('preset-') ? undefined : availableStems,
           });
           if (stem === 'agent-team-orchestrator') {
             markdown = transformOrchestrator(markdown);
@@ -512,7 +515,10 @@ export function generateMavisStack(stack, { root = packageRoot } = {}) {
           category: 'ai-local',
           disposition: 'transform',
           loadMode: 'manual',
-          reason: 'Consumer-owned overlay template; seeded to .ai.local/conventions.md on init',
+          reason:
+            source === 'ai-local/conventions.md'
+              ? 'Consumer-owned overlay template; seeded to .ai.local/conventions.md on init'
+              : 'Staged-inactive local overlay rule template; copied to .ai.local/rules-library/ on init (activate by moving it to .ai.local/rules/)',
         }),
       },
       {

package/scripts/lib/generate-opencode-adapter.mjs

@@ -21,6 +21,7 @@ import {
   rewriteCursorPipelineIntro,
   rewriteMdcToMd,
   rewriteOrchestratorCursorNotes,
+  rewriteRuleStemRefs,
   sharedCoreStem,
   standardTierCell,
   strongTierCell,
@@ -92,7 +93,7 @@ function stripEmbeddedCatalogLine(body) {
 function transformMarkdown(
   sourceText,
   stack,
-  { allowEmbedEntry = true, preserveStackNotes = true } = {},
+  { allowEmbedEntry = true, preserveStackNotes = true, ruleStems } = {},
 ) {
   const rewriteProse = (text) => finalizeOpencodeProse(text, stack);
   const { body } = stripFrontmatter(sourceText);
@@ -114,7 +115,7 @@ function transformMarkdown(
     if (stackNotes) {
       next += `\n${stackNotes}\n`;
     }
-    next = rewriteConsumerPaths(next);
+    next = rewriteRuleStemRefs(rewriteConsumerPaths(next), ruleStems);
   } else {
     next = rewriteProse(body);
   }
@@ -528,6 +529,8 @@ export function generateOpencodeStack(stack, { root = packageRoot } = {}) {
           // transformOrchestrator injects a platform-neutral note instead.
           let markdown = transformMarkdown(sourceText, stack, {
             preserveStackNotes: stem !== 'agent-team-orchestrator',
+            // Author meta-rules legitimately reference Cursor `.mdc` filenames.
+            ruleStems: stem.startsWith('preset-') ? undefined : availableStems,
           });
           if (stem === 'agent-team-orchestrator') {
             markdown = transformOrchestrator(markdown);
@@ -624,7 +627,10 @@ export function generateOpencodeStack(stack, { root = packageRoot } = {}) {
           category: 'ai-local',
           disposition: 'transform',
           loadMode: 'manual',
-          reason: 'Consumer-owned overlay template; seeded to .ai.local/conventions.md on init',
+          reason:
+            source === 'ai-local/conventions.md'
+              ? 'Consumer-owned overlay template; seeded to .ai.local/conventions.md on init'
+              : 'Staged-inactive local overlay rule template; copied to .ai.local/rules-library/ on init (activate by moving it to .ai.local/rules/)',
         }),
       },
       {