@bonesofspring/ai-rules 0.2.27 → 0.2.29

package/scripts/check-claude-agent-blocks.mjs

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+/**
+ * Fail when a committed Claude agent «Rules to load» section differs from
+ * `expectedRulesToLoadBlock` (same helper as the inject codemod and the
+ * OpenCode/Mavis generators).
+ *
+ * Usage: node scripts/check-claude-agent-blocks.mjs [--stack <name>]
+ */
+import fs from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import {
+  expectedRulesToLoadBlock,
+  extractRulesToLoadBlock,
+  indexClaudeRuleStems,
+  loadReleasedStacks,
+  PLATFORM_RULES_INTRO,
+} from './lib/generate-adapter-common.mjs';
+import { getStackProfile, getZoneRulesForAgent, parseStackArg } from './lib/stack-platform-profiles.mjs';
+
+const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
+const packageRoot = path.join(scriptDirectory, '..');
+const presetsRoot = path.join(packageRoot, 'presets');
+
+function normalize(text) {
+  return text.replace(/\r\n/g, '\n').trim();
+}
+
+function checkStack(stack, mismatches) {
+  const profile = getStackProfile(stack);
+  const claudeRulesDir = path.join(presetsRoot, 'claude', stack, 'rules');
+  const { availableStems, pathForStem } = indexClaudeRuleStems(claudeRulesDir);
+  const agentsDir = path.join(presetsRoot, 'claude', stack, 'agents');
+  if (!fs.existsSync(agentsDir)) {
+    mismatches.push(`claude/${stack}: missing agents dir`);
+    return;
+  }
+  const agents = fs
+    .readdirSync(agentsDir)
+    .filter((entry) => entry.endsWith('.md') && entry !== 'README.md');
+  if (agents.length === 0) {
+    mismatches.push(`claude/${stack}: no agent files`);
+    return;
+  }
+  for (const entry of agents) {
+    const agentStem = entry.slice(0, -'.md'.length);
+    const text = fs.readFileSync(path.join(agentsDir, entry), 'utf8');
+    const expected = normalize(
+      expectedRulesToLoadBlock({
+        rulesPath: '.claude/rules',
+        alwaysOn: profile.alwaysOn,
+        zoneRules: getZoneRulesForAgent(stack, agentStem),
+        availableStems,
+        intro: PLATFORM_RULES_INTRO.claude,
+        pathForStem,
+      }),
+    );
+    const actual = normalize(extractRulesToLoadBlock(text));
+    if (actual !== expected) {
+      mismatches.push(`claude/${stack}/agents/${entry}`);
+    }
+  }
+}
+
+function main() {
+  const explicitStack = parseStackArg(process.argv.slice(2), { required: false });
+  const stacks = explicitStack ? [explicitStack] : loadReleasedStacks(presetsRoot, 'opencode');
+  const mismatches = [];
+  for (const stack of stacks) {
+    checkStack(stack, mismatches);
+  }
+  if (mismatches.length > 0) {
+    console.error(`FAIL: ${mismatches.length} Claude agent block(s) differ from expectedRulesToLoadBlock`);
+    for (const item of mismatches) {
+      console.error(`  ${item}`);
+    }
+    process.exit(1);
+  }
+  console.log(`OK: Claude agent blocks match expectedRulesToLoadBlock (${stacks.length} stacks)`);
+}
+
+main();

package/scripts/check-local-overlay.sh

@@ -95,7 +95,7 @@ for stack in STACKS:
         if sf == 0:
             print(f"  OK: {cursor_path.name} (alwaysApply + MANDATORY + ack + pointer)")
 
-    # Claude must exist (flat or topic folder) + paths: includes .ai.local + ack format + pointer.
+    # Claude must exist (flat or topic folder) as session-start (no paths:) + ack + pointer.
     if not claude_path.is_file():
         # Try to find a topic-folder placement (e.g. tooling-and-review/ai-local-overlay.md).
         candidates = list((presets / "claude" / stack / "rules").rglob(CLAUDE_NAME))
@@ -107,8 +107,11 @@ for stack in STACKS:
     if claude_path.is_file():
         text = claude_path.read_text(encoding="utf-8")
         fm, body = strip_frontmatter(text)
-        if "**/.ai.local/**" not in fm:
-            print(f"FAIL: {claude_path.name} frontmatter must include `**/.ai.local/**` in paths")
+        if re.search(r"(?m)^paths:\s*", fm):
+            print(
+                f"FAIL: {claude_path.relative_to(presets)} must be session-start "
+                "(no paths:). ai-local-overlay is the reserved 4th slot inside the 3–5 cap."
+            )
             sf += 1
         if FRONTMATTER_DESCRIPTION not in fm:
             print(f"FAIL: {claude_path.name} frontmatter description must include 'MANDATORY'")
@@ -120,7 +123,7 @@ for stack in STACKS:
             print(f"FAIL: {claude_path.name} body must reference `docs/LOCAL-OVERLAY.md`")
             sf += 1
         if sf == 0:
-            print(f"  OK: {claude_path.name} (paths + MANDATORY + ack + pointer)")
+            print(f"  OK: {claude_path.name} (session-start + MANDATORY + ack + pointer)")
 
     # Twin-map coverage: the Claude twin must be listed in claude/<stack>/rules/README.md.
     claude_readme = presets / "claude" / stack / "rules" / "README.md"
@@ -129,6 +132,39 @@ for stack in STACKS:
         if CURSOR_NAME not in readme_text:
             print(f"FAIL: {claude_readme} mapping table must include `{CURSOR_NAME}`")
             sf += 1
+        session_lines = [
+            line
+            for line in readme_text.splitlines()
+            if "Session" in line and "paths" in line
+        ]
+        if not any("ai-local-overlay" in line for line in session_lines):
+            print(
+                f"FAIL: {claude_readme} session-start line must name `ai-local-overlay`"
+            )
+            sf += 1
+
+    claude_entry = presets / "claude" / stack / "CLAUDE.md"
+    if not claude_entry.is_file():
+        print(f"FAIL: missing {claude_entry}")
+        sf += 1
+    else:
+        entry = claude_entry.read_text(encoding="utf-8")
+        for needle in (
+            "ls -la .ai.local",
+            ".ai.local/rules/*.md",
+            ".ai.local/conventions.md",
+            "Using .ai.local: <rule-name>",
+            POINTER_DOCS,
+            "ai-local-overlay",
+        ):
+            if needle not in entry:
+                print(f"FAIL: {claude_entry.relative_to(presets)} missing `{needle}`")
+                sf += 1
+        if "exactly three" in entry or "exactly **three**" in entry:
+            print(
+                f"FAIL: {claude_entry.relative_to(presets)} still says session-start is exactly three"
+            )
+            sf += 1
 
     stack_failed[stack] = sf
     failed += sf

package/scripts/check-mavis-local-overlay.mjs

@@ -24,6 +24,7 @@ for (const stack of stacks) {
   const root = path.join(presetsRoot, 'mavis', stack);
   const files = [
     path.join(root, 'REPO_AGENTS.md'),
+    path.join(root, 'MAVIS.md'),
     path.join(root, 'rules', 'ai-local-overlay.md'),
   ];
   for (const filePath of files) {
@@ -50,6 +51,28 @@ for (const stack of stacks) {
       console.error(`FAIL ${label}: missing Local overlay section`);
       failed += 1;
     }
+    if (filePath.endsWith('REPO_AGENTS.md') || filePath.endsWith('MAVIS.md')) {
+      for (const needle of [PROBE, ACK, 'ai-local-overlay', '.ai.local/rules/*.md', '.ai.local/conventions.md']) {
+        if (!text.includes(needle)) {
+          console.error(`FAIL ${label}: missing ${needle}`);
+          failed += 1;
+        }
+      }
+    }
+    if (filePath.endsWith('MAVIS.md')) {
+      if (!text.includes('nativeProjectRules') || !text.includes('unknown')) {
+        console.error(`FAIL ${label}: must keep nativeProjectRules unknown (no alwaysApply claim)`);
+        failed += 1;
+      }
+      if (!text.includes('fallback-manual-import') || !text.includes('freshInit')) {
+        console.error(`FAIL ${label}: must document fallback-manual-import and freshInit`);
+        failed += 1;
+      }
+      if (!text.includes('projectHooks') || !text.includes('manual')) {
+        console.error(`FAIL ${label}: must document manual projectHooks invoke`);
+        failed += 1;
+      }
+    }
   }
 }
 

package/scripts/check-mavis-platform-contract.mjs

@@ -30,6 +30,7 @@ const ALLOWED_STATUS = new Set([
   'partial',
   'unknown',
   'no-equivalent',
+  'manual',
 ]);
 const KNOWN_STACKS = new Set([
   'next',
@@ -245,7 +246,7 @@ export function validateContract(contract, options = {}) {
       }
       if (!ALLOWED_STATUS.has(capability.status)) {
         fail(
-          `nativeCapabilities.${key}.status must be confirmed|partial|unknown|no-equivalent`,
+          `nativeCapabilities.${key}.status must be confirmed|partial|unknown|no-equivalent|manual`,
         );
       }
       if (
@@ -262,7 +263,9 @@ export function validateContract(contract, options = {}) {
         continue;
       }
       if (
-        (capability.status === 'unknown' || capability.status === 'no-equivalent') &&
+        (capability.status === 'unknown' ||
+          capability.status === 'no-equivalent' ||
+          capability.status === 'manual') &&
         nativePath
       ) {
         fail(

package/scripts/check-opencode-local-overlay.mjs

@@ -24,6 +24,7 @@ for (const stack of stacks) {
   const root = path.join(presetsRoot, 'opencode', stack);
   const files = [
     path.join(root, 'REPO_AGENTS.md'),
+    path.join(root, 'OPENCODE.md'),
     path.join(root, 'rules', 'ai-local-overlay.md'),
   ];
   for (const filePath of files) {
@@ -50,6 +51,24 @@ for (const stack of stacks) {
       console.error(`FAIL ${label}: missing Local overlay section`);
       failed += 1;
     }
+    if (filePath.endsWith('REPO_AGENTS.md') || filePath.endsWith('OPENCODE.md')) {
+      for (const needle of [PROBE, ACK, 'ai-local-overlay', '.ai.local/rules/*.md', '.ai.local/conventions.md']) {
+        if (!text.includes(needle)) {
+          console.error(`FAIL ${label}: missing ${needle}`);
+          failed += 1;
+        }
+      }
+    }
+    if (filePath.endsWith('OPENCODE.md')) {
+      if (!text.includes('nativeProjectRules') || !text.includes('no-equivalent')) {
+        console.error(`FAIL ${label}: must keep nativeProjectRules no-equivalent (no alwaysApply claim)`);
+        failed += 1;
+      }
+      if (!text.includes('projectHooks') || !text.includes('manual')) {
+        console.error(`FAIL ${label}: must document manual projectHooks invoke`);
+        failed += 1;
+      }
+    }
   }
 }
 

package/scripts/check-opencode-platform-contract.mjs

@@ -30,6 +30,7 @@ const ALLOWED_STATUS = new Set([
   'partial',
   'unknown',
   'no-equivalent',
+  'manual',
 ]);
 const KNOWN_STACKS = new Set([
   'next',
@@ -245,7 +246,7 @@ export function validateContract(contract, options = {}) {
       }
       if (!ALLOWED_STATUS.has(capability.status)) {
         fail(
-          `nativeCapabilities.${key}.status must be confirmed|partial|unknown|no-equivalent`,
+          `nativeCapabilities.${key}.status must be confirmed|partial|unknown|no-equivalent|manual`,
         );
       }
       if (
@@ -262,7 +263,9 @@ export function validateContract(contract, options = {}) {
         continue;
       }
       if (
-        (capability.status === 'unknown' || capability.status === 'no-equivalent') &&
+        (capability.status === 'unknown' ||
+          capability.status === 'no-equivalent' ||
+          capability.status === 'manual') &&
         nativePath
       ) {
         fail(

package/scripts/check-preset-structure.sh

@@ -56,6 +56,15 @@ else
 fi
 echo
 
+echo ">>> claude-agent-blocks"
+if node "$SCRIPT_DIR/check-claude-agent-blocks.mjs"; then
+  echo "<<< claude-agent-blocks: OK"
+else
+  echo "<<< claude-agent-blocks: FAIL"
+  status=1
+fi
+echo
+
 echo ">>> opencode-token-budget"
 if node "$SCRIPT_DIR/check-opencode-token-budget.mjs"; then
   echo "<<< opencode-token-budget: OK"

package/scripts/check-preset-token-budget.sh

@@ -178,6 +178,13 @@ for stack in STACKS:
             f"expected {MIN_ALWAYS_ON}..{MAX_ALWAYS_ON} (Option A excludes **/README.md)"
         )
         failed += 1
+    elif len(session) > 3:
+        if not any(p.stem == "ai-local-overlay" for p in session):
+            print(
+                f"FAIL: Claude session-start={len(session)} but no ai-local-overlay; "
+                "extra slots are reserved for the local overlay rule"
+            )
+            failed += 1
 
     # --- Body sum of intended session-start set (Cursor alwaysApply + Claude session) ---
     # Cursor and Claude allow 3..5 always-on rules; extra slots reserved for ai-local-overlay.

package/scripts/fixtures/cli-golden/claude/next.json

@@ -22,46 +22,46 @@
     ".ai.local/team/fixtures/mockup-review-standalone.json": "edda49b1298e94f9a33496317e9f6ccbbb047659e044e05ba35669bfe800eda6",
     ".ai.local/team/fixtures/ux-design-standalone.json": "528aeb9db4c310d1b5e3eacae0ad39a4fd1dd49c04154b064e7027981488a07a",
     ".ai.local/team/tasks/.gitkeep": "aca85ed348a49b11d68188be6ab245b521e5a706bbe0fbca1a28abfdc7155893",
-    ".claude/CLAUDE.md": "dc7acadbbd08ab941923141c434e3a799e4c4b740deba1c59d0a61a43c6621be",
+    ".claude/CLAUDE.md": "2adbeb71dbadbaefeb4f7576e6ce5db395f7bfd566b665532e156265f9457293",
     ".claude/MCP.md": "a40a7f9cd8a11a031a5fb3f2e4ccdb6cb2186461600146765d3255990e6133d0",
     ".claude/agents/README.md": "98fd8018a96eb924977217f81eb9cf966e88dee151b60af2c7c94ae2a8b32730",
-    ".claude/agents/accessibility-reviewer.md": "2dfe18461dde7517fc2c1ea9c74f13985b4b3c041737795c5dafa0f13eb7d252",
-    ".claude/agents/api-contract-reviewer.md": "4def3aa919c617f5da68ae082f9fe914bad849c76af76b8b10eecb1ff3b13804",
-    ".claude/agents/build-verifier.md": "c8e03d50d9cbcfc9facc5df83f3b1307b16785fa6e389803bc424c98e1ab9b0b",
-    ".claude/agents/ci-investigator.md": "3707b479fa868cee38c7514244610397e6e668dc5f038159d960df321b2dca95",
-    ".claude/agents/code-reviewer.md": "b7f334ea4d83a1d06c4e923fd74e026f840e3124e5b7e748535b09bc69288697",
-    ".claude/agents/codebase-analyzer.md": "cae5586fd9a5fc0ea12a7578c5a9f5a4c72229b1e5c4f1eeb9ff9b6b243becf0",
-    ".claude/agents/debugger.md": "ec46e4964ebb68f1e39ea9ae7116b1bdb7fcd2a73b4df657a1c2c57f1373098a",
-    ".claude/agents/feature-developer.md": "563aface9d76f2f11aa7482c8bbf2c7975f333882e846c3f1b56c8519de16add",
-    ".claude/agents/migration-specialist.md": "4a410448cc8e94bd22200b89b1fd615c11c934f6e55c048608f93988721ec67d",
-    ".claude/agents/mockup-reviewer.md": "4ceddce834f65de0f131b55803092eddff5d350cd3ebeba5f517f2442c8f9f03",
-    ".claude/agents/openspec-author.md": "dde516b3e8341286eda6005cafddc0be223f9594ada635ea3d8aa7597400c9ea",
-    ".claude/agents/performance-auditor.md": "681ac2be6db2556bd9a2d00776643bbb8fe973fa8aa3311cdfc607a6e98a2b1a",
-    ".claude/agents/playwright-test-generator.md": "dd06c7ed43ebdde73f0c7c30ff4fde82a66f93f519d03a30a7384067efcdfab5",
-    ".claude/agents/playwright-test-healer.md": "3db0eca9b388d5bbee1b8f884bd7e296ae5c8078122463a6fae10fd0445447f1",
-    ".claude/agents/playwright-test-planner.md": "50760360548a943c36d1cf3f18b66e083b0a09e1244acbc4e319e80f139a8250",
-    ".claude/agents/qa-tester.md": "1d32dd82eb3ea6208222e81e8590c18a45c831adba441c9763bd0d7ec1c3d8bb",
-    ".claude/agents/security-reviewer.md": "738fdf5a10549526bc414c02b33810e74040171049671bf62f27e4b6a39fc2d6",
-    ".claude/agents/solution-architect.md": "0c1cb48876fd1fff8b298bb6faeb00e5200c112b69600c61be1aea78d92830ec",
-    ".claude/agents/task-analyst.md": "324857e0167a8113a09d6a886b163e8941a5547526c4d59cdb47a24bc6b98757",
-    ".claude/agents/task-router.md": "b9e7bf9367c682652427e7216f2b3795fd98f51e3b1434616970e514ab72c087",
-    ".claude/agents/tech-writer.md": "02f704099e7585a1063067479648a092f28666796955836dc0e4d27b5595f28c",
-    ".claude/agents/unit-test-generator.md": "8eed919b44e4d6aeb4b93399cb1c74e67b9e32036eaed220a35798b9192c44da",
-    ".claude/agents/unit-test-healer.md": "48c0c50b20bfe2d2eb57c774baa3337a6e742c4e00e632fbc3b5fd080b32ef83",
-    ".claude/agents/unit-test-planner.md": "a93ace116377d0ee308afcd91e100cd72851e1e39ed984cc42323c6f9f0fdd50",
+    ".claude/agents/accessibility-reviewer.md": "795072716b23b0ce3b95703bbaf4de963f24308088046c6656066e0b34c792e1",
+    ".claude/agents/api-contract-reviewer.md": "b7c974e7ff129be3f3be3af168064434255a47384d74ee4fbd464125b59e63ab",
+    ".claude/agents/build-verifier.md": "61e57cbaea65e3618afbce8026737edcf7eebd3b9adfcf50315eee43c814d6f2",
+    ".claude/agents/ci-investigator.md": "132157b20b1dc47927e40774fe89b46c3c5471ef89591269826ea478c3c3b6a9",
+    ".claude/agents/code-reviewer.md": "d544e80981784af2903f8cbfbe55b34a399f201939d4ea96b7a2d18df2be89b9",
+    ".claude/agents/codebase-analyzer.md": "73810a9283924c64d14eb2e6e9a515c8edf03fbdacb1f58cda5725b3dd17cc8b",
+    ".claude/agents/debugger.md": "f303a032f7b0731d0a1a48aeffe6dfb881f291be45ed1fe22771217aae410298",
+    ".claude/agents/feature-developer.md": "ed5cfedc48a6ed40af548998c39ba725adb336a19f08f4a5eff2f1c43975e3e3",
+    ".claude/agents/migration-specialist.md": "7e1282e06347f226b865040cd711d4abc0a00cee36e58019a4a50237f5012d8e",
+    ".claude/agents/mockup-reviewer.md": "9d6e92934206cfcd78eb970d71f5236f3fdc5b451858a78944a197bdae943ee0",
+    ".claude/agents/openspec-author.md": "a1a50bee708bb2d9dfe724542ee44dfe824e7d6800e0d5440bb3d23b73948d49",
+    ".claude/agents/performance-auditor.md": "e5479aa5f523903064d54a275a838691a7b7c73ebf46a7163abffb70da12b306",
+    ".claude/agents/playwright-test-generator.md": "b52015503915632f6562091c468589e8d9441b8f1f99c0a1434b2c0cb1cf0af2",
+    ".claude/agents/playwright-test-healer.md": "54ff2800f93fe67fa63f32a1183d13818f69a669fe60c7f8297c1e7c6272bca4",
+    ".claude/agents/playwright-test-planner.md": "23937e4eea308eea970859a40c02accdf7cb974f2b79505bd7b9408796506aab",
+    ".claude/agents/qa-tester.md": "9882cd281347a2aecb37fe4ca4213c24944eb9d2bb256722383fc6342963d4e8",
+    ".claude/agents/security-reviewer.md": "555aecb092869c7f8a142ef9b16cbd6371b1c3a05f0d1cbb463a809e341b0244",
+    ".claude/agents/solution-architect.md": "5dbfe3b8d6173afa767bbcbe73167c6c073003a503c09450966c0f5d55b3729e",
+    ".claude/agents/task-analyst.md": "83a14cadeae9875f90ecb901dc76d67e15d5e35876dcbe4c47430e3e5f2009cb",
+    ".claude/agents/task-router.md": "7c4eb96b7e3fa2824301d40d06d46bcf41f49070a02491d7ce389e46247a462e",
+    ".claude/agents/tech-writer.md": "0a983103bba3a304f2df68908bf886a2518c71047a3e134b1b25d970a57e8cb7",
+    ".claude/agents/unit-test-generator.md": "71b08fc1663f7d03b637526506b8901de2b7d86cf1bd4c6bc9fa6f2f8d5481fa",
+    ".claude/agents/unit-test-healer.md": "247bbd616ddbab7688d584f3343a3f2ccecda138e41120d91cd05b7bbada525d",
+    ".claude/agents/unit-test-planner.md": "19219de9cdd79ca9032aa939617da3272c8c08de21acb7f71a22e9b6b7c530be",
     ".claude/commands/README.md": "30574717de5deb51a4f5bbe8da7373e560403cc4710acaf0c730d27dd1cf964f",
     ".claude/commands/spec-start.md": "4c6ca849ea2d8835a9cc0902a4e39749510db1021fbc0b1a623a46c9644afbf1",
     ".claude/commands/task-continue.md": "8c2bec3c204c25910e8fc349c571778275905380e90d8bd02c0092c83ecfe6f6",
     ".claude/commands/task.md": "4db4b9245e7d5d0d56fb06d86196502aa8fa6487c747c2c103d09da27b02941e",
     ".claude/commands/technical-retro.md": "6195206cc687645fadcbe011306f6c62f1d082508c9182d880e5e4485d17214c",
-    ".claude/hooks/README.md": "2d76085d8319a9c6cf579800fba52288bd43e29d2434df31a28d34d2a4a6a61d",
-    ".claude/hooks/chain-team-phases.sh": "ab0f689747f3f79b6cbb598c0d2b8cba8a694322f9902d7d853be6862565f5fc",
-    ".claude/hooks/examples/README.md": "e287392fe719476053a1998d35fe08924be58f065e9d2bfdab7727a050ba7efe",
+    ".claude/hooks/README.md": "dc22793bce005fa1b29960f44fb9162de47095a501ce639239ae7210b7cb9003",
+    ".claude/hooks/chain-team-phases.sh": "e6790f4512bba38a17ba7f13ec9c1dc1a00db423e9ece24bf6c359107039a585",
+    ".claude/hooks/examples/README.md": "c5bdc1398bdaad95a15051d75c9f896f5c4991d66641982e675db648e9591813",
     ".claude/hooks/examples/format-edited.example.sh": "fd4df1d6c2a5673f963febd4f3f21ec8c42899645bdc53144d713c66b2affc76",
     ".claude/hooks/examples/secret-guard.example.sh": "51cbc95c3a1b64dfc5b19901932b4e3a047ade9332451282f254bf5f8d45a58f",
     ".claude/hooks/examples/test-on-save.example.sh": "ae185e383811e2f8f89ae5f631993705c06fc8cf7216cf8f0862a5b55c64ca2a",
-    ".claude/hooks/guard-shell-command.sh": "d1eae59b78aac8155668528ceb87abaf54624466a60f7d2df8716c25aad3fe96",
-    ".claude/rules/README.md": "f047c1fb6cd7ffbeee5cd8e7dd958db41a404c275c50a16e1b02ce6b5754caf4",
+    ".claude/hooks/guard-shell-command.sh": "31e1451148c17aedbcc2e9f372e50f079624f2624fb93505ba74850543749c75",
+    ".claude/rules/README.md": "8fb263352c7c2325fafb0ff2b6f7a328e47ac974cc730a14e5764aedea349e02",
     ".claude/rules/anti-hallucination/react-next-anti-hallucination.md": "021d22a4178aad43b8ba8b332cc677dbe8130a0cf673407acbb34d47c5367d32",
     ".claude/rules/api-and-data/README.md": "1caace24921f00d60a58bea551988abd15c32f13a2711ae799ce1e689b838de2",
     ".claude/rules/api-and-data/api-services.md": "30b50d49c4281c4e0f9169d453c285f7dfc828d9991520e0c204101b5b634cb9",
@@ -91,7 +91,7 @@
     ".claude/rules/tooling-and-review/README.md": "27a956fa7fa68c58cd17a9b598580b06cb2241aadef29e3b647a31ab418d99ec",
     ".claude/rules/tooling-and-review/agent-team-intake.md": "e05a5879d587a9c4774e9e36cfcadca5664eedaabe02051745fb6c87a6143e42",
     ".claude/rules/tooling-and-review/agent-team-orchestrator.md": "810afc6e3d3a97b652af215bbc03433727b87c063d79613e3588e1d955d192d6",
-    ".claude/rules/tooling-and-review/ai-local-overlay.md": "2b8373351357a6df002e714302c130c6e79dd90c5a9cc852e45271f09b7d2726",
+    ".claude/rules/tooling-and-review/ai-local-overlay.md": "bb96bf00cf76c58d5db4e6c12622164b0d700d8330e9805c0aa7c1542bffbde4",
     ".claude/rules/tooling-and-review/anti-sycophancy-discipline.md": "6d359631dde6dbe6588397aa1108752cfdad9764d90d6d9da31606a463b72226",
     ".claude/rules/tooling-and-review/code-quality.md": "fc764e9fbf7101475fc709a4610d09758a3a959f2fe82d3d1a487f2c8556c1b4",
     ".claude/rules/tooling-and-review/code-review-mr.md": "30b31277be1f6df878712d79cb54bc157edb97640e3bc7e77c0121273821ab03",
@@ -102,7 +102,7 @@
     ".claude/rules/tooling-and-review/post-change-lint.md": "ea16a0311ef354c101efc697e738d852742f74f60f49f421b776ccf0e19ad53c",
     ".claude/rules/tooling-and-review/preset-layering.md": "006b9ea97f55d039debc16847ac9b0bfae6b26b56f44e812081ddd65760289ca",
     ".claude/rules/tooling-and-review/preset-no-cross-stack-leakage.md": "01e045b7f6f5a472581804499ec97dc4296264da90e3a6e3a25807501a300dad",
-    ".claude/rules/tooling-and-review/preset-pr-checklist.md": "d89e936da90b0f5a8ee23292a5f78946dc10fb53ae55f9aad20d6674d378fa40",
+    ".claude/rules/tooling-and-review/preset-pr-checklist.md": "769addcfbde87d6681291ee038ff57842e03a4634dbc90f2562fb95efd5fc625",
     ".claude/rules/tooling-and-review/preset-token-budget.md": "bc22059a066d3ba21d8813f5e50d5cc9eef3a28860372d122d31b50977438e18",
     ".claude/rules/tooling-and-review/preset-twin-sync.md": "bdd98171bc8218fdd84834aa8051e8c899f87bb1063f9a5fd539af1154cb618f",
     ".claude/rules/tooling-and-review/security-next.md": "3e5c733925a0040928a9fbb7d841e69a471a03c5cb02d2fa986b81d29d7e31ca",
@@ -113,6 +113,7 @@
     ".claude/rules/ui-and-accessibility/no-props-spread.md": "60aa9ca9c94db981bcceb05a090734e540644febfa88f4e40089f5d16a8a5d7f",
     ".claude/rules/ui-and-accessibility/react-a11y-coding.md": "8709f43c13f7071b2cd645c29b171de218551c3895479901efa1a817585b245d",
     ".claude/rules/ui-and-accessibility/react-ui.md": "06233a81f4eb4d6686f5a5ced351ddde43aed2cf753d6a6be072e6507b71572f",
+    ".claude/settings.json": "930a46deffc5aee8161328b29ca7122d32a8434415988462f3be6578fcf5036f",
     ".claude/skills/README.md": "1aeac616a5270d0ce6be132a3dff3e0bbca1371191503f0ecf3eeeeea5b4e9f3",
     ".claude/skills/ci-investigation/SKILL.md": "b13ed9de0716671b7d192dc2ba7fec139466a933b52f25c075623dcdef38b399",
     ".claude/skills/code-review/SKILL.md": "068f995e00e4baa4baf02098cef865fd837f3dad33a5c063b778aa84b0878b02",
@@ -128,7 +129,7 @@
     ".claude/skills/ux-design/SKILL.md": "74b70875ba3d41ffb8401c42bc8c9e442e73b36c6a6b0d8d9d2aae0a6017479c",
     ".claude/skills/write-adr/SKILL.md": "607d70eff78d6a7b67b783237721fdc42eaa5170cb6175882e7e2a4adf132242",
     ".mcp.json": "f68a14db68a491a982975a3e6cc985057072a68eebdcedf33d8ac2a4a3b284ca",
-    "AGENTS.md": "2d3c64960ee9adb11d850ce5da390d3c9571d1e9a02f1fd7114f5ea68d00c6ff",
+    "AGENTS.md": "dbfbbb0fb243c67bed8c02dd2ba45dfc92163ebed8914d7dee6e8d359638ec08",
     "docs/specs/INDEX.md": "cab59f2093e6aaa376246a56d53e4268cb59070a6b10e87a94895192c35f422d",
     "docs/specs/_templates/feature.md": "83c47b90334c555fb5144749837e2ddfe1cae5bb89031f885ba98671075d59e7",
     "docs/specs/_templates/page.md": "a668c584e28edd52afaf3f9f8f898a75e43cb82fa12822c7a016033441e12e54"

package/scripts/fixtures/cli-golden/cursor/next.json

@@ -4,6 +4,13 @@
   "preset": "next",
   "files": {
     ".ai.local/conventions.md": "c6109f4a61b5143fc214856b4827c1156fd4841771e008edad8d2f2991b24f44",
+    ".ai.local/rules-library/agent-artifacts-no-local-paths.md": "b0ce50f681f7f4926ddd1716e199bc642536b98265062ed56dfc4705554c6b4c",
+    ".ai.local/rules-library/commit-hygiene.md": "6ffb84f71dc4f63315bd2c617049c10331a359a506148e28c6cfaf4d338c383c",
+    ".ai.local/rules-library/mcp-required-for-ui-layout.md": "394c20c7c689e0b09e37dbca52b7ab7301d2fe642a8b4fb1887a463a1993121a",
+    ".ai.local/rules-library/no-test-driven-behavior-change.md": "f2a7066dbd7b9512ea2e5310d9d9c7b24201e897596c16f03d768778144e425a",
+    ".ai.local/rules-library/pre-pr-checklist.md": "cc2f8acfdde9a6530830bd65dbf6af7f8f8b9ef6060cda4e7523e0487dafe5a2",
+    ".ai.local/rules-library/router-pages.md": "ec25868a3b05e0655e58620302d7c44fa3d29dc3d9e6124687db70ee4423d0c1",
+    ".ai.local/rules-library/single-source-copy-constants.md": "6f7a992ddb3eb8aae6e1de6f621f42e69f5539d4af042e995d5964c8b40c3f06",
     ".ai.local/team/README.md": "443049295620ba56c49830893bb602077b87fd685b38ab4ed9887dede660dbda",
     ".ai.local/team/fixtures/artifact-manifest.example.json": "bf4d0f00838f957643646b8407b4cec12aff3dec45893c1e776f44f3de08fb42",
     ".ai.local/team/fixtures/bugfix-standard.json": "209cc0cc1844befee4bdbec9dcee27337dd7019f9f459dfcb8996db291fcae81",
@@ -93,7 +100,7 @@
     ".cursor/rules/post-change-lint.mdc": "2f9398a6ae81636d7a401e5fc38bb300579e10d29df9a375a3ed592dfb028529",
     ".cursor/rules/preset-layering.mdc": "13f3c7781219c18766b5fdc73aafa31769a85843f2d0ba4e175b2091baf1bcb1",
     ".cursor/rules/preset-no-cross-stack-leakage.mdc": "fe9a63a1c63b329d9954bcbf8f60e5786ae77cc937c31e106adbaba7404e4f1e",
-    ".cursor/rules/preset-pr-checklist.mdc": "b41059caf4764301a3a4626f6c20440a724a70641118da8c205adc2cdf7ced14",
+    ".cursor/rules/preset-pr-checklist.mdc": "a2d92f1f24c4af0a7667de90537ba14c59f67ad1fa9c493318ea5845e5f23df0",
     ".cursor/rules/preset-token-budget.mdc": "65eb11910cc2c31b1be2d568417af33f556d88df322dab4e9a028933af5dc482",
     ".cursor/rules/preset-twin-sync.mdc": "336b018e2ff10dbe31ffe2354c22fbd87d330d43cf7359e5a8a1d5a9c53772aa",
     ".cursor/rules/product-specs-authoring.mdc": "590bbfe9f1d3c6b9acd363cd9658f9bb509702071410ef753a49d9a0a90122d2",
@@ -124,7 +131,7 @@
     ".cursor/skills/unit-testing/SKILL.md": "db25250cb6ec9f5ac487cacf47d4ad7fb649f130eae2a757b0eaf50e4a37ff6f",
     ".cursor/skills/ux-design/SKILL.md": "74b70875ba3d41ffb8401c42bc8c9e442e73b36c6a6b0d8d9d2aae0a6017479c",
     ".cursor/skills/write-adr/SKILL.md": "607d70eff78d6a7b67b783237721fdc42eaa5170cb6175882e7e2a4adf132242",
-    "AGENTS.md": "2d3c64960ee9adb11d850ce5da390d3c9571d1e9a02f1fd7114f5ea68d00c6ff",
+    "AGENTS.md": "dbfbbb0fb243c67bed8c02dd2ba45dfc92163ebed8914d7dee6e8d359638ec08",
     "docs/specs/INDEX.md": "cab59f2093e6aaa376246a56d53e4268cb59070a6b10e87a94895192c35f422d",
     "docs/specs/_templates/feature.md": "83c47b90334c555fb5144749837e2ddfe1cae5bb89031f885ba98671075d59e7",
     "docs/specs/_templates/page.md": "a668c584e28edd52afaf3f9f8f898a75e43cb82fa12822c7a016033441e12e54"

package/scripts/fixtures/cli-golden/mavis/android-kotlin.json

@@ -15,33 +15,33 @@
     ".ai.local/team/fixtures/mockup-review-fail-embedded-status.json": "2e1f3ff8e5e3668f20f2b0e329f26b884c79e426dd6b5952c0896bd4f0c7f9a4",
     ".ai.local/team/fixtures/mockup-review-standalone.json": "edda49b1298e94f9a33496317e9f6ccbbb047659e044e05ba35669bfe800eda6",
     ".ai.local/team/fixtures/ux-design-standalone.json": "528aeb9db4c310d1b5e3eacae0ad39a4fd1dd49c04154b064e7027981488a07a",
-    ".mavis/AGENTS.md": "2110dea1f4cba7288a33d197af94cca794d3874c1422e31349327bbe8c5d49c1",
+    ".mavis/AGENTS.md": "27b1dce99ded144503f8ab67d466321c7b7c62c735bb8cd05895ca2b2a2c7af5",
     ".mavis/MCP.md": "d76a903a75e7fa7a058e2da9fcb568bbcaab0bf3c6b39c8bc8507c63612e424a",
     ".mavis/agents/README.md": "6c4dcd1a548a6288d9c8a6b2951a0706a3eeea106c8ce727ae535f72aeaacdc0",
-    ".mavis/agents/accessibility-reviewer.md": "030e0fdcf0c512e922edf2358bba1b01950d8768dd0283729463595bb58f19b0",
-    ".mavis/agents/api-contract-reviewer.md": "12000bca561f55954a144ae861fafdfc172e63ae6d222dc6ca4337f9ba1764da",
-    ".mavis/agents/build-verifier.md": "27e992d09c1fa22678d4d2100aed2f6e480dddfca1f7d9ca856f101332fdc973",
-    ".mavis/agents/ci-investigator.md": "4c02587e8b600bc3bb39605714abcc1f0235cf6fbb2f14e0e5d46f5cdd63d306",
-    ".mavis/agents/code-reviewer.md": "fce16583d53d6720f1387fe8e9a65523565ab109153bf3596da751e2957b0596",
-    ".mavis/agents/codebase-analyzer.md": "45a022b6280755733e6a11a9ccfdb169c3bbd92bae15e6fb6dd172af1317d2a8",
-    ".mavis/agents/debugger.md": "e28033abad768a28305de2440e61da79d2aaff27f34c2ff7180425b62297c699",
-    ".mavis/agents/feature-developer.md": "30dc7cfa9436b0c0bdd4373d1f4481619cdf937b1288b162520f781650512471",
-    ".mavis/agents/instrumentation-test-generator.md": "0d7a37f75253296105d11fd29e7d34c0402b6d0e08f4b07a06d9ad744268c7dd",
-    ".mavis/agents/instrumentation-test-healer.md": "ba0ceab419d2a02fb7899a1c54bb69d666415c272f837f7d6bf78187b2c47d86",
-    ".mavis/agents/instrumentation-test-planner.md": "25723ada7b6f7d1a3bc59faa574855a50c3d80bec5cd79692b9eed523d3e0c08",
-    ".mavis/agents/migration-specialist.md": "3d2bd5076a7eae98f8f3dbff2fe361ad411e59d83d2cc99212e8702f58a8ffe5",
-    ".mavis/agents/mockup-reviewer.md": "028a06779ca989146be9184b4cd93121a0fe5b202d7e4683fce2999cfb74cd0a",
-    ".mavis/agents/openspec-author.md": "4637e426853969369d760386b2a5bac45a17e1669e6030191dcdaaa65a358423",
-    ".mavis/agents/performance-auditor.md": "1d38defae00289686d61865527c05ec3bd92b3b82f3bf871394ff83e84fdee7a",
-    ".mavis/agents/qa-tester.md": "b9453fba138386023c640995d3c9f0cc473f8fa543aadf716323165bffbfc35f",
-    ".mavis/agents/security-reviewer.md": "0429c078ac25b12ce25ffc329ad91cb275d375c494b03a7717d71287ef39bdbb",
-    ".mavis/agents/solution-architect.md": "a1d9b71f51e2b47aedca90a9bb6571e3bf7edfe00be0d2ac2dbdedb340756fe6",
-    ".mavis/agents/task-analyst.md": "fd21874f31621eae6eb52616096ce3c33bb7f3906febc17c28d831146732c1c8",
-    ".mavis/agents/task-router.md": "173a38c014fc790f63e03d003e2be8d37352d97d393e6cd49273bf652bc5491a",
-    ".mavis/agents/tech-writer.md": "e271f335a578d898dbfbe1c74a688e0bc7ea827f257be31c5df027e104e77633",
-    ".mavis/agents/unit-test-generator.md": "030587f9fed17e6255b5d0fe36938a5d4242f811bc7eee4c146035a1d628577d",
-    ".mavis/agents/unit-test-healer.md": "f7823e78f27ecae7cc7ed4d7e09f945668065603edc43a38432864f298c52ffb",
-    ".mavis/agents/unit-test-planner.md": "716ad42b6c57f6cdfe45cff21ee7df2c3ed08e64abe433cbe0fa129cfcc66fba",
+    ".mavis/agents/accessibility-reviewer.md": "ece45559e1e2a26de6c46e59d73ecc9d393fd4d4bf2d80b0bc5464e507b7386d",
+    ".mavis/agents/api-contract-reviewer.md": "db60f770338e9cc540bf551f96f1109e16ecd095525d5443c13f06a04250ad86",
+    ".mavis/agents/build-verifier.md": "af97d53a03302c6faa23f5f0b174444190cac8a049912ac2cfb0ab8e008c41cb",
+    ".mavis/agents/ci-investigator.md": "9ff6ac99c3d974873de97b0641a0f503c14cf0d540c26fdadb774087608d1d8d",
+    ".mavis/agents/code-reviewer.md": "fe336d153ffdc0a5396b72337ef3bec4ccb9ddc966c6add8cf3d876ad026334e",
+    ".mavis/agents/codebase-analyzer.md": "3062e3e8a5256423b027f34b23e09e9f7fa41a31c497a0156752e76cafef68fb",
+    ".mavis/agents/debugger.md": "1e244025507df015f10ecb0ee7ea9c1c21e127e5aadeb0f23281eb42fef878b2",
+    ".mavis/agents/feature-developer.md": "002dc17ac0d80420bb2c196131d6ae8a179c08f0ae3b90b32fb80fcaeafc02c5",
+    ".mavis/agents/instrumentation-test-generator.md": "7b1e6528b63fbb9d3705aa566841cef8e22fe3e1eb7fa65ac446b51e4e0c0afb",
+    ".mavis/agents/instrumentation-test-healer.md": "83f94571ec8b4b651238de608ed21e1d2743ad29b0a4348d2acef87d953ccd8f",
+    ".mavis/agents/instrumentation-test-planner.md": "9a0d7fc4eb4a0e5b31a7a1af9dbe8b8cfceb7fa43754c1abb9e6d736f17b1b84",
+    ".mavis/agents/migration-specialist.md": "89ade0438ff7761cc794ddfd34b9e0f88e5f48fc978c586cdef4d1b778e2c9d5",
+    ".mavis/agents/mockup-reviewer.md": "caa6623e4dca63dc4877b17ac85e487fad27d2893b218f3cb27532a0f06bce3b",
+    ".mavis/agents/openspec-author.md": "970881bc7d05282ac644ac369506b2e5e66863122f82a6457bfa43278881e7d5",
+    ".mavis/agents/performance-auditor.md": "6577e288e120aa8587728d05eb3e792742f63e99c072168ebd318b1ebbcfb3e9",
+    ".mavis/agents/qa-tester.md": "8648c13fdd67ff56f81d31f397e15bfbd979a1fdbae26da213639a16b99e5834",
+    ".mavis/agents/security-reviewer.md": "b826106e66453308ff64a59f9fe95062cc38c61fe863486f6fd60c3c19509265",
+    ".mavis/agents/solution-architect.md": "f540d3572021ff3fb96c8fd184fe1cefb912876ab79452fdcc8d589d6fa340ab",
+    ".mavis/agents/task-analyst.md": "240e11d0a9da9f37a4ec9b083eb4ffa4a3a487b51935ddcc84b36978462f11e9",
+    ".mavis/agents/task-router.md": "af356b32f87f8ffc7179a1ff0b772d92d05faa4f3781609024d0ac34b631adc8",
+    ".mavis/agents/tech-writer.md": "86dc179483c242adec804a27dab2161b913f612577958307e22606c5048b26d3",
+    ".mavis/agents/unit-test-generator.md": "2ef0ae21ad7e24eff222d0a6ca083fede94460895eba26da4cc951f5c53ea9a7",
+    ".mavis/agents/unit-test-healer.md": "8f420c8be0a5a4e7c92f1de34492201bf87609a3d76905c0a8433dcda47fb348",
+    ".mavis/agents/unit-test-planner.md": "d86126f26eadc254e4b502f623855539bf8d146b0c9787a240b64af5dae94e14",
     ".mavis/commands/README.md": "fe7318c28c2e0b6869e0ca84507e34e04d22b148bfe414cf23b14f12794ac842",
     ".mavis/commands/spec-start.md": "cf900f7284d308e74b1c630cf95faeb2d9edd44f24f27d33bcfb0ae329be64ad",
     ".mavis/commands/task-continue.md": "a31ccde1a76ae759f6360b3b8a81a62ec41d82d4ef1eb916e7ffd2cffbd340e2",
@@ -74,7 +74,7 @@
     ".mavis/rules/post-change-build.md": "0535533ea2d68b57571193ba657711dd1965656e14b28734def10cfc990c56be",
     ".mavis/rules/preset-layering.md": "c63d6b6aa921b70c6c9b531e9d9bcb8b3d81b6a6354da9e4109b5149f5cb8a73",
     ".mavis/rules/preset-no-cross-stack-leakage.md": "608588571985875353b6939adcc0ead0e9a9d7edc5486094a807edb1c80b6a22",
-    ".mavis/rules/preset-pr-checklist.md": "6dcfb78d2cf68c11944243e3e4e10f6be210a4dad1497986f4aa439d1c04543f",
+    ".mavis/rules/preset-pr-checklist.md": "014c6bfb23b3db0ec5f46b5cbff8effe7126a1e680103f8e3cdbfaba280eabd3",
     ".mavis/rules/preset-token-budget.md": "d539545f8ab0dc6117f87c76c044fce9a01256d8cdea8a63b69ff48ccb8b7ac0",
     ".mavis/rules/preset-twin-sync.md": "b3061cbb09ff75ecb47e98b7f7fa351240866ee8962a1d128b7c15206ef89dee",
     ".mavis/rules/product-specs-authoring.md": "1dd87837b55e861b2a6ae7fa1333bc0eb6cfe6234a4f1f596b7e243c4fdbeec7",
@@ -99,7 +99,7 @@
     ".mavis/skills/unit-testing/SKILL.md": "410dac20af0c2575013413a5449ba291e502780388cf08eb7046124ed3d38143",
     ".mavis/skills/ux-design/SKILL.md": "00fea92f82d6350acd44c0eef8f08fa8f09beecd4c8a01e3c2609c0ae24c6167",
     ".mavis/skills/write-adr/SKILL.md": "1ab67e1af6213a945c0dcb9fe8d80b25b5b3483989cac2aeda750e7a245fbab7",
-    "AGENTS.md": "80e64420529f92c937a20b4933e88e99ec007925ef40550b0cd8c058961f98e0",
+    "AGENTS.md": "24782a1e8bc96b1ae961cf7b3eb1e211874c492a182aba15fd42fbd97080dfd5",
     "docs/specs/INDEX.md": "cab59f2093e6aaa376246a56d53e4268cb59070a6b10e87a94895192c35f422d",
     "docs/specs/_templates/feature.md": "83c47b90334c555fb5144749837e2ddfe1cae5bb89031f885ba98671075d59e7",
     "docs/specs/_templates/page.md": "a668c584e28edd52afaf3f9f8f898a75e43cb82fa12822c7a016033441e12e54"