@bonesofspring/ai-rules 0.2.25 → 0.2.26

package/scripts/aggregate-agent-task-metrics.mjs

@@ -1,11 +1,11 @@
 #!/usr/bin/env node
 /**
- * Aggregate `metrics.json` ledgers across `.cursor/team/tasks/*` and emit a JSON report.
+ * Aggregate `metrics.json` ledgers across `.ai.local/team/tasks/*` and emit a JSON report.
  *
  * Usage:
  *   node scripts/aggregate-agent-task-metrics.mjs [--team-root <dir>] [--help]
  *
- * Defaults to `<cwd>/.cursor/team` when --team-root is omitted.
+ * Defaults to `<cwd>/.ai.local/team` when --team-root is omitted.
  */
 
 import fs from 'node:fs';
@@ -21,7 +21,7 @@ Usage:
 
 Options:
   --team-root <dir>  Directory containing a 'tasks/' subfolder with *.metrics.json ledgers
-                     (default: <cwd>/.cursor/team)
+                     (default: <cwd>/.ai.local/team)
 
 Output: JSON report on stdout (machine-readable).`);
   process.exit(0);
@@ -31,7 +31,7 @@ const teamRootIndex = args.indexOf('--team-root');
 const teamRoot =
   teamRootIndex >= 0
     ? path.resolve(args[teamRootIndex + 1] ?? '')
-    : path.join(process.cwd(), '.cursor', 'team');
+    : path.join(process.cwd(), '.ai.local', 'team');
 const tasksDir = path.join(teamRoot, 'tasks');
 const incomplete = [];
 const attempts = [];

package/scripts/check-chain-hook-coverage.sh

@@ -17,6 +17,7 @@ export AI_RULES_PRESETS_ROOT="$ROOT/packages/ai-rules/presets"
 python3 <<'PY'
 from __future__ import annotations
 
+import json
 import os
 import re
 import sys
@@ -45,10 +46,22 @@ STACKS_WITH_OPENSPEC = {
     ("claude", "php-hexagonal"),
     ("claude", "php-laravel"),
     ("claude", "svelte"),
-    ("mavis", "next"),
-    ("opencode", "next"),
 }
 
+
+def released_contract_stacks(platform: str) -> list[str]:
+    contract = presets / platform / "platform-contract.json"
+    if not contract.is_file():
+        return []
+    data = json.loads(contract.read_text(encoding="utf-8"))
+    stacks = data.get("releasedStacks") or []
+    return [stack for stack in stacks if stack != "mcp-ts"]
+
+
+for platform in ("mavis", "opencode"):
+    for stack in released_contract_stacks(platform):
+        STACKS_WITH_OPENSPEC.add((platform, stack))
+
 # Agents used only outside the pipeline (no chain hook entry expected).
 PIPELINE_EXEMPT = {"task-router", "codebase-analyzer"}
 

package/scripts/check-local-overlay.sh

@@ -3,6 +3,13 @@
 # sides (Cursor `.mdc` and Claude `.md`) and that the body contains the
 # mandatory acknowledgement format.
 #
+# Also enforce the conventions-path contract: living gotchas live at
+# `.ai.local/conventions.md`; `.ai.local/team/**` is pipeline artifacts and is
+# never loaded as rules. No preset or doc may name a `team/conventions` path in
+# any form (`.ai.local/team/…`, legacy `.<tool>/team/…`, or the bare relative
+# `team/conventions.md` shorthand), and every stack must ship the
+# `ai-local/conventions.md` template the CLI seeder installs.
+#
 # Exit 0 on OK; exit 1 on any FAIL.
 set -euo pipefail
 
@@ -127,6 +134,71 @@ for stack in STACKS:
     failed += sf
     print()
 
+# --- Conventions-path contract -------------------------------------------
+# `.ai.local/conventions.md` is the living-conventions file the overlay probes.
+# `.ai.local/team/**` is the shared pipeline tree and must never be advertised
+# as the conventions location.
+print("=== conventions path ===")
+# Any `team/conventions` is wrong, in every form: the absolute
+# `.ai.local/team/conventions.md`, the legacy `.<tool>/team/conventions.md`, and
+# the bare relative `team/conventions.md` shorthand — a consumer resolves all
+# three to the pipeline-artifact tree. Legitimate mentions of that tree never
+# name a conventions file.
+#
+# The one exception is documentation that describes the *old* location as
+# history. Those are allowlisted by exact line count so new occurrences still
+# fail: bump a count only after confirming the line is upgrade-path prose, not
+# live guidance.
+FORBIDDEN = "team/conventions"
+LEGACY_DOC_ALLOWLIST = {
+    # "upgrade path of the old per-tool `.cursor/team/conventions.md`" — names
+    # the pre-migration location so a migrating consumer recognises it.
+    "docs/LOCAL-OVERLAY.md": 1,
+}
+package_root = presets.parent
+SCAN_ROOTS = (presets, package_root / "docs")
+SCAN_SUFFIXES = {".md", ".mdc", ".sh", ".json", ".mjs", ".js"}
+
+offenders: list[tuple[str, int, str]] = []
+for root in SCAN_ROOTS:
+    if not root.is_dir():
+        continue
+    for path in sorted(root.rglob("*")):
+        if not path.is_file() or path.suffix not in SCAN_SUFFIXES:
+            continue
+        text = path.read_text(encoding="utf-8", errors="ignore")
+        if FORBIDDEN not in text:
+            continue
+        rel = str(path.relative_to(package_root))
+        hits = [
+            (rel, lineno, line.strip())
+            for lineno, line in enumerate(text.splitlines(), start=1)
+            if FORBIDDEN in line
+        ]
+        allowed = LEGACY_DOC_ALLOWLIST.get(rel, 0)
+        if len(hits) == allowed:
+            continue
+        if len(hits) > allowed:
+            print(
+                f"  note: {rel} allowlists {allowed} legacy mention(s) but has {len(hits)}"
+            )
+        offenders.extend(hits)
+
+for rel, lineno, line in offenders:
+    print(f"FAIL: {rel}:{lineno} references `{FORBIDDEN}` (use `.ai.local/conventions.md`): {line}")
+failed += len(offenders)
+
+for stack in STACKS:
+    for platform in ("cursor", "claude"):
+        template = presets / platform / stack / "ai-local" / "conventions.md"
+        if not template.is_file():
+            print(f"FAIL: missing {template.relative_to(package_root)} (CLI seeds it to .ai.local/conventions.md)")
+            failed += 1
+
+if not offenders:
+    print("  OK: no `team/conventions` references in any form; conventions templates present")
+print()
+
 if failed:
     print(f"Result: FAIL ({failed} issue(s) across {sum(1 for v in stack_failed.values() if v > 0)} stack(s))")
     sys.exit(1)

package/scripts/check-mavis-adapter-map.mjs

@@ -11,6 +11,10 @@ import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import {
+  assertReleasedStacksMatchOnDisk,
+  loadReleasedStacks,
+} from './lib/generate-adapter-common.mjs';
 
 const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.join(scriptDirectory, '..');
@@ -249,7 +253,7 @@ function runSelfTest() {
 }
 
 function parseArgs(argv) {
-  const options = { stack: 'next', selfTest: false };
+  const options = { stack: null, selfTest: false };
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
     if (arg === '--self-test') {
@@ -273,12 +277,20 @@ function main() {
     }
   }
   if (!options.selfTest || exitCode === 0) {
-    const failures = checkLive(options.stack);
-    if (failures.length > 0) {
-      printFailures(`mavis/${options.stack}`, failures);
-      exitCode = 1;
-    } else {
-      console.log(`ok presets/mavis/${options.stack}/adapter-map.json`);
+    if (!options.stack) {
+      assertReleasedStacksMatchOnDisk(presetsRoot, 'mavis');
+    }
+    const stacks = options.stack
+      ? [options.stack]
+      : loadReleasedStacks(presetsRoot, 'mavis');
+    for (const stack of stacks) {
+      const failures = checkLive(stack);
+      if (failures.length > 0) {
+        printFailures(`mavis/${stack}`, failures);
+        exitCode = 1;
+      } else {
+        console.log(`ok presets/mavis/${stack}/adapter-map.json`);
+      }
     }
   }
   process.exit(exitCode);

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

@@ -70,7 +70,6 @@ const REQUIRED_DIRECTORY_SOURCES = [
   'skills',
   'commands',
   'hooks',
-  'team',
 ];
 const FORBIDDEN_PATH_RE =
   /(?:^|[\\/])\.minimax(?:[\\/]|$)|(?:^|[\\/])\.minimax-code(?:[\\/]|$)|~\/\.minimax|\$HOME\/\.minimax/i;

package/scripts/check-opencode-adapter-map.mjs

@@ -11,6 +11,10 @@ import crypto from 'node:crypto';
 import fs from 'node:fs';
 import path from 'node:path';
 import { fileURLToPath } from 'node:url';
+import {
+  assertReleasedStacksMatchOnDisk,
+  loadReleasedStacks,
+} from './lib/generate-adapter-common.mjs';
 
 const scriptDirectory = path.dirname(fileURLToPath(import.meta.url));
 const packageRoot = path.join(scriptDirectory, '..');
@@ -249,7 +253,7 @@ function runSelfTest() {
 }
 
 function parseArgs(argv) {
-  const options = { stack: 'next', selfTest: false };
+  const options = { stack: null, selfTest: false };
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
     if (arg === '--self-test') {
@@ -273,12 +277,20 @@ function main() {
     }
   }
   if (!options.selfTest || exitCode === 0) {
-    const failures = checkLive(options.stack);
-    if (failures.length > 0) {
-      printFailures(`opencode/${options.stack}`, failures);
-      exitCode = 1;
-    } else {
-      console.log(`ok presets/opencode/${options.stack}/adapter-map.json`);
+    if (!options.stack) {
+      assertReleasedStacksMatchOnDisk(presetsRoot, 'opencode');
+    }
+    const stacks = options.stack
+      ? [options.stack]
+      : loadReleasedStacks(presetsRoot, 'opencode');
+    for (const stack of stacks) {
+      const failures = checkLive(stack);
+      if (failures.length > 0) {
+        printFailures(`opencode/${stack}`, failures);
+        exitCode = 1;
+      } else {
+        console.log(`ok presets/opencode/${stack}/adapter-map.json`);
+      }
     }
   }
   process.exit(exitCode);

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

@@ -70,7 +70,6 @@ const REQUIRED_DIRECTORY_SOURCES = [
   'skills',
   'commands',
   'hooks',
-  'team',
 ];
 const FORBIDDEN_PATH_RE =
   /(?:^|[\\/])\.config[\\/]opencode(?:[\\/]|$)|~\/\.config\/opencode|\$HOME\/\.config\/opencode|~\/\.opencode/i;

package/scripts/check-preset-leakage.sh

@@ -8,6 +8,11 @@ set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/../../.." && pwd)"
 export AI_RULES_PRESETS_ROOT="$ROOT/packages/ai-rules/presets"
 
+if [[ ! -d "$AI_RULES_PRESETS_ROOT" ]]; then
+  echo "FAIL: presets root not found: $AI_RULES_PRESETS_ROOT"
+  exit 1
+fi
+
 python3 <<'PY'
 from __future__ import annotations
 
@@ -18,6 +23,9 @@ import sys
 from pathlib import Path
 
 presets = Path(os.environ["AI_RULES_PRESETS_ROOT"])
+if not presets.is_dir():
+    print(f"FAIL: presets root not found: {presets}")
+    sys.exit(1)
 PLATFORMS = ("cursor", "claude", "mavis", "opencode")
 STACKS = ("next", "nuxt", "svelte", "ios-swift", "android-kotlin", "go", "java", "mcp-ts", "php-hexagonal", "php-laravel")
 
@@ -494,6 +502,29 @@ for stack in released_opencode_stacks():
         elif other.is_file():
             print(f"OK: [opencode/{stack}] chain ≠ [{platform}/{stack}] chain")
 
+TEXT_SUFFIXES = {".sh", ".md", ".json", ".mjs", ".txt"}
+for platform in ("mavis", "opencode"):
+    root = presets / platform
+    if not root.is_dir():
+        continue
+    for path in root.rglob("*"):
+        if not path.is_file() or path.suffix not in TEXT_SUFFIXES:
+            continue
+        try:
+            text = path.read_text(encoding="utf-8")
+        except (OSError, UnicodeDecodeError):
+            continue
+        rel = path.relative_to(presets)
+        if "const PLATFORM = 'cursor'" in text:
+            print(f"FAIL: [{rel}] leaked const PLATFORM = 'cursor'")
+            failed += 1
+        if re.search(r"^## Frontmatter `readonly`", text, re.M):
+            print(f"FAIL: [{rel}] leftover ## Frontmatter `readonly`")
+            failed += 1
+        if re.search(r"claude-opus", text) or "[effort=" in text:
+            print(f"FAIL: [{rel}] leaked Cursor model pin (claude-opus / [effort=)")
+            failed += 1
+
 print()
 print(f"WARN count: {warned} (build-verifier packaging refs / chain skips)")
 print(

package/scripts/close-agent-task-human-gate.mjs

@@ -4,17 +4,17 @@
  * Prefer invoking the hook directly from /task-continue (see command Metrics section).
  *
  * Usage:
- *   node close-agent-task-human-gate.mjs [--cwd <repo>] [--platform cursor|claude] [--slug <slug>]
+ *   node close-agent-task-human-gate.mjs [--cwd <repo>] [--platform cursor|claude|mavis|opencode] [--slug <slug>]
  */
 
 import { execFileSync } from 'node:child_process';
 import fs from 'node:fs';
 import path from 'node:path';
 
+const PLATFORMS = new Set(['cursor', 'claude', 'mavis', 'opencode']);
+
 function parseArgs(argv) {
   const options = { cwd: process.cwd(), platform: 'cursor', slug: null };
-  // Read the next token from argv for value-taking flags. Returns the value or null
-  // when the flag is missing its value; the caller exits with a friendly error.
   function nextValue(flag, i) {
     const next = argv[i + 1];
     if (next === undefined || next.startsWith('-')) {
@@ -37,10 +37,12 @@ function parseArgs(argv) {
     } else if (arg === '--activate-next') {
       /* always activate via hook payload */
     } else if (arg === '--team-root') {
-      // Compatibility with earlier docs: derive platform + cwd from team root.
       const teamRoot = path.resolve(nextValue(arg, i));
       options.cwd = path.resolve(teamRoot, '..', '..');
-      options.platform = path.basename(path.dirname(teamRoot)) === '.claude' ? 'claude' : 'cursor';
+      const parent = path.basename(path.dirname(teamRoot));
+      if (parent.startsWith('.') && PLATFORMS.has(parent.slice(1))) {
+        options.platform = parent.slice(1);
+      }
       i += 1;
     } else {
       console.error(`Unknown argument: ${arg}`);
@@ -51,6 +53,13 @@ function parseArgs(argv) {
 }
 
 const options = parseArgs(process.argv);
+if (!PLATFORMS.has(options.platform)) {
+  console.error(
+    `Unknown --platform ${options.platform}. Use cursor|claude|mavis|opencode.`,
+  );
+  process.exit(2);
+}
+
 const toolRoot = path.join(options.cwd, `.${options.platform}`);
 const hookPath = path.join(toolRoot, 'hooks', 'chain-team-phases.sh');
 if (!fs.existsSync(hookPath)) {
@@ -59,7 +68,7 @@ if (!fs.existsSync(hookPath)) {
 }
 
 if (options.slug) {
-  const activePath = path.join(toolRoot, 'team', 'active-task.json');
+  const activePath = path.join(options.cwd, '.ai.local', 'team', 'active-task.json');
   fs.mkdirSync(path.dirname(activePath), { recursive: true });
   fs.writeFileSync(activePath, `${JSON.stringify({ slug: options.slug }, null, 2)}\n`);
 }

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

@@ -3,40 +3,53 @@
   "tool": "claude",
   "preset": "next",
   "files": {
-    ".claude/CLAUDE.md": "78ffc0009705747ce0c07362d0c4259472cc011fe1667faf801da453204a444b",
+    ".ai.local/conventions.md": "c6109f4a61b5143fc214856b4827c1156fd4841771e008edad8d2f2991b24f44",
+    ".ai.local/team/README.md": "3a06d52aada40ae63f2d0713657920ef0215905248dfcfa60f704060959cb077",
+    ".ai.local/team/fixtures/artifact-manifest.example.json": "bf4d0f00838f957643646b8407b4cec12aff3dec45893c1e776f44f3de08fb42",
+    ".ai.local/team/fixtures/bugfix-standard.json": "209cc0cc1844befee4bdbec9dcee27337dd7019f9f459dfcb8996db291fcae81",
+    ".ai.local/team/fixtures/feature-full.json": "1110b152cdcb5508e8ce4179aa2e760f7f7c66569ba081d6bdf0a49a0a449470",
+    ".ai.local/team/fixtures/feature-light.json": "618ac9da9527d688ec7dac849eafb869ae342ec890d0e7c73c1e57c0f8fb5a1b",
+    ".ai.local/team/fixtures/feature-with-figma-url.json": "8aec2ac11ba552bc9135721678af58c73ca5a74b3038c5f4dc878b1080ade9be",
+    ".ai.local/team/fixtures/feature-with-ux-no-figma.json": "526c103a26c83afef60ebadd289735b6dfea14c8191acd9780fc72e72da2ff45",
+    ".ai.local/team/fixtures/memlog.example.md": "53d281ddd383e0337b038a0dc6dd4e14f84743066a1a99bf45fc2e7064cce222",
+    ".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",
+    ".ai.local/team/tasks/.gitkeep": "aca85ed348a49b11d68188be6ab245b521e5a706bbe0fbca1a28abfdc7155893",
+    ".claude/CLAUDE.md": "dc7acadbbd08ab941923141c434e3a799e4c4b740deba1c59d0a61a43c6621be",
     ".claude/MCP.md": "a40a7f9cd8a11a031a5fb3f2e4ccdb6cb2186461600146765d3255990e6133d0",
-    ".claude/agents/README.md": "10e8eac494611ad037fc2be118ed6f2e4ae3fca77a8f82171f5c0d3ae7f37249",
-    ".claude/agents/accessibility-reviewer.md": "87030cc8a0c4ed7224b784655002c2efe0629ca39253dfa20379a64ad942c332",
-    ".claude/agents/api-contract-reviewer.md": "930374aea3b8aae083ceceac7efc74034b231ed2337608f4b19afa563becb1c4",
-    ".claude/agents/build-verifier.md": "709f5d1099d15356a9e74b9f465762dd038dda72a266eccdf3a5dc99d021d2a4",
-    ".claude/agents/ci-investigator.md": "ea6b26e97498edd5696514bcea543bf88f47a1c123664a45dd6d3563f28ece8c",
-    ".claude/agents/code-reviewer.md": "3bb4d752922b33ab741a5032d778c0e5d26f065fb4e8f67af9e31d9487f53366",
+    ".claude/agents/README.md": "98fd8018a96eb924977217f81eb9cf966e88dee151b60af2c7c94ae2a8b32730",
+    ".claude/agents/accessibility-reviewer.md": "2dfe18461dde7517fc2c1ea9c74f13985b4b3c041737795c5dafa0f13eb7d252",
+    ".claude/agents/api-contract-reviewer.md": "4def3aa919c617f5da68ae082f9fe914bad849c76af76b8b10eecb1ff3b13804",
+    ".claude/agents/build-verifier.md": "1412b094be89e24603248276a9d0847057df845595ec92ab95915d5552794dc7",
+    ".claude/agents/ci-investigator.md": "3707b479fa868cee38c7514244610397e6e668dc5f038159d960df321b2dca95",
+    ".claude/agents/code-reviewer.md": "b7f334ea4d83a1d06c4e923fd74e026f840e3124e5b7e748535b09bc69288697",
     ".claude/agents/codebase-analyzer.md": "cae5586fd9a5fc0ea12a7578c5a9f5a4c72229b1e5c4f1eeb9ff9b6b243becf0",
-    ".claude/agents/debugger.md": "37848ae158132898d195749e35e6dbc2efe8b13adc4673f336706c0395d864c1",
-    ".claude/agents/feature-developer.md": "8ce49c81785e6f6b29303dae55de8e30e4edd55f14501f6e8f570de9bfe8e1a2",
-    ".claude/agents/migration-specialist.md": "8d951d4efe13a673fb95a06f065939c6a7d0d9535b7bdca616fda5b416e67930",
-    ".claude/agents/mockup-reviewer.md": "eca45c653aaf44ce5363a43a510a8f9587d3c451e63a9ddf72b12e7d21e43bed",
-    ".claude/agents/openspec-author.md": "a0166a4e292e53dde8e0aa8a1970e0030fdb43fa4e7e7c3010dc0f96fc18d724",
-    ".claude/agents/performance-auditor.md": "c849819ceb157aacd83c8ffdfbd83f10b0b0cdd004feb6b716cf16bfc846421c",
+    ".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": "031eb903d7dfd842f263f63817483af2f37079242bb6ae89f54398fef2d8023f",
-    ".claude/agents/security-reviewer.md": "2eb87b289083a393f6a69527af11393631c8cba2b0d601666b06b660e6be91bd",
-    ".claude/agents/solution-architect.md": "660c9a610e5a83417f3fa4953b7776bfccfe6eaf16c1e46386c7e420f3a3aaa3",
-    ".claude/agents/task-analyst.md": "359a9f9ce4ae20d72d160eec3ae4787eb19702830ff434efe390519374d6c362",
-    ".claude/agents/task-router.md": "409764b6a67424d02255fda6b5d5a5c693203f015be916e5ead589c692e2ec46",
-    ".claude/agents/tech-writer.md": "f01af5569f4e73cf331539c67e7fb142f91ec099b86e3daad5af5b588eaf36ea",
-    ".claude/agents/unit-test-generator.md": "08472db05d1615d79a3d51abd980d5d6c252c65cfeef3f09956727537ae87a11",
-    ".claude/agents/unit-test-healer.md": "11ab2b89de31acd98115da94aaa515c163409f0e9118bdb37718f8906218d79f",
-    ".claude/agents/unit-test-planner.md": "c86dbe763e2020f5bbcd9c566655389df7ff3aa9dfacd44096752a2e39bee920",
-    ".claude/commands/README.md": "bb295e65506b38c6f714f70216fca5825b9b2476c16d55d0b8139d5814e65682",
-    ".claude/commands/spec-start.md": "40102dda4a19e37a97666eee90454b71e9fa89740a9e70b93e5ad8da49896c59",
-    ".claude/commands/task-continue.md": "a1082320020fd7b6336a8377dbe7cbcb1099f5c449e0365c0eb0424259284dee",
-    ".claude/commands/task.md": "1ec4421d426cdba5dd17e9fe8b43949f1070fe3691d944338a75d9e9e5073159",
+    ".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/commands/README.md": "30574717de5deb51a4f5bbe8da7373e560403cc4710acaf0c730d27dd1cf964f",
+    ".claude/commands/spec-start.md": "4c6ca849ea2d8835a9cc0902a4e39749510db1021fbc0b1a623a46c9644afbf1",
+    ".claude/commands/task-continue.md": "8c2bec3c204c25910e8fc349c571778275905380e90d8bd02c0092c83ecfe6f6",
+    ".claude/commands/task.md": "1f327f836917795945bb4b26722e67ae8c1bbe71f222029cb7cae548556f7721",
     ".claude/commands/technical-retro.md": "6195206cc687645fadcbe011306f6c62f1d082508c9182d880e5e4485d17214c",
-    ".claude/hooks/README.md": "34bd123b0f4773a6a86b79b9e5ea7c53d81d920ad6ee2867c79fe4ba21f9f284",
-    ".claude/hooks/chain-team-phases.sh": "eb5c0de5d481231bbe60f76711b45e114c37128b36b769284fe849186045dc9f",
+    ".claude/hooks/README.md": "2d76085d8319a9c6cf579800fba52288bd43e29d2434df31a28d34d2a4a6a61d",
+    ".claude/hooks/chain-team-phases.sh": "4766a5daf49509ae0dbf9d6156c11aeeb285258479e917c972cdaeec3873bf39",
     ".claude/hooks/examples/README.md": "337b1f81fb3add28f6fd24a0433f5578077b031d649bd5200996eb44f9e43e22",
     ".claude/hooks/examples/format-edited.example.sh": "fd4df1d6c2a5673f963febd4f3f21ec8c42899645bdc53144d713c66b2affc76",
     ".claude/hooks/examples/secret-guard.example.sh": "51cbc95c3a1b64dfc5b19901932b4e3a047ade9332451282f254bf5f8d45a58f",
@@ -56,7 +69,7 @@
     ".claude/rules/architecture/product-specs-authoring.md": "2266a429713741e0653204df04516bbd5c2f95da146d7c813c7a84bb7fcd9bfe",
     ".claude/rules/architecture/product-specs.md": "83ca98fd58c32504eef5745f986b82a6a5ddae202a3d357891e9f0f8233caab9",
     ".claude/rules/architecture/public-imports.md": "da67712b2bb2462967d0869555fb145063fd7ecce53e4b0a08ffc7e53ffac6f3",
-    ".claude/rules/architecture/reference-features.md": "92c31f368ea05a324940c623caf2cc6305ed02550f3effde6f9a1b3b31f0a68a",
+    ".claude/rules/architecture/reference-features.md": "31ff422b9e29d585b65a9d8bd4cc6f7e6761d0e4eba77c7b828ab9216fdedb34",
     ".claude/rules/stack/README.md": "8dda2a6cacc3346300ea445bcb87d157c898fabdc820ca202667b915f9088de2",
     ".claude/rules/stack/arrow-functions.md": "4e382cc791c2d057431830baccff4f7043c4a39424370fe2fa0c57c62a646ea4",
     ".claude/rules/stack/navigation-router-ui.md": "8cabe15ed92ae9574c152dd1c001f4771ac1e1d287b0d2f2b12b7f84ddd5fa73",
@@ -70,25 +83,25 @@
     ".claude/rules/testing/tests-e2e-structure.md": "bf0833d342a0c856e89f67c6a2f78e29499b56f00c4d145df53f9e9b1803e253",
     ".claude/rules/testing/tests-unit.md": "a123d75a6c6f128b01f55e801f596c4b875d4f0841662e4d39a62dbf51846e7d",
     ".claude/rules/tooling-and-review/README.md": "27a956fa7fa68c58cd17a9b598580b06cb2241aadef29e3b647a31ab418d99ec",
-    ".claude/rules/tooling-and-review/agent-team-intake.md": "4880f2d91c221c5be3d75650973403402a4705d9bd66178e3ca4b163a3704ebc",
-    ".claude/rules/tooling-and-review/agent-team-orchestrator.md": "95d7f915a03d6317f32d0de77879aee2b41db71c629c4baf18f36ad6316d7fe9",
-    ".claude/rules/tooling-and-review/ai-local-overlay.md": "beb18a5047085e0376797e5240156f0423027a02b2e66e3e24b59ef4433b9a06",
+    ".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/anti-sycophancy-discipline.md": "6d359631dde6dbe6588397aa1108752cfdad9764d90d6d9da31606a463b72226",
     ".claude/rules/tooling-and-review/code-quality.md": "9aee7805102788d8a9d21504127f2fe94209d98abd1c880719097a42fb70bf94",
-    ".claude/rules/tooling-and-review/code-review-mr.md": "2e2353585d9ce54b799463031e17fc7cf8d81b6dc1670e385d8f6065c53ce862",
+    ".claude/rules/tooling-and-review/code-review-mr.md": "30b31277be1f6df878712d79cb54bc157edb97640e3bc7e77c0121273821ab03",
     ".claude/rules/tooling-and-review/design-guidance.md": "6eb8a48f9d9f69896c047c9418577e47eda6d2ad6bf18b3dff761c6de675f7d3",
     ".claude/rules/tooling-and-review/mcp-usage.md": "37cafc7c5271f3d846223e1f82eef5f8a85b88e6f1ff00603d39849e154033e2",
-    ".claude/rules/tooling-and-review/mockup-review.md": "6ace9a2be32595c2307bdb2d1c6b9952d3fa37e3ca8bb7b2398d86110fec7a8c",
+    ".claude/rules/tooling-and-review/mockup-review.md": "a8305658ed3db90154ad9ce612785c4704b8d54fe65abb8f7ab69c9af23b826e",
     ".claude/rules/tooling-and-review/package-manager.md": "1e80459ac986a61eee45a6d0aef67177aa449279784848397c32ac0511b0c208",
-    ".claude/rules/tooling-and-review/post-change-lint.md": "9fc3151e022866f7a14ca5bbfaa4b2889f7ea049cfde545633ba5daaf319398e",
-    ".claude/rules/tooling-and-review/preset-layering.md": "8f1fc67a0ff5f8194507c039fa6ae461c23cf7a227ceb08a5f9d7da1e281034f",
-    ".claude/rules/tooling-and-review/preset-no-cross-stack-leakage.md": "0e8ea45b160d0ee0b56c64bb74d9ae6190c47e8a41139e83040dc2d9bd8e7dd0",
-    ".claude/rules/tooling-and-review/preset-pr-checklist.md": "a8a65497c25e5418e2b7d27fb806a00349e8e749d8e50531872b957782e9f0f7",
-    ".claude/rules/tooling-and-review/preset-token-budget.md": "5faea90cd9037b84e42aeb11da7ee37c4dccbe47fae28e5f081cd4418f6f539e",
-    ".claude/rules/tooling-and-review/preset-twin-sync.md": "456768516f288fb83a398cdd8b8cd81c9a563f433150f1b8ec0a35411ae1226a",
+    ".claude/rules/tooling-and-review/post-change-lint.md": "ea16a0311ef354c101efc697e738d852742f74f60f49f421b776ccf0e19ad53c",
+    ".claude/rules/tooling-and-review/preset-layering.md": "6e5f905249d35b0fa1749cf275481ab7c75f80571a7672c439ea8efde373a832",
+    ".claude/rules/tooling-and-review/preset-no-cross-stack-leakage.md": "f243dd9a5790512a5ceadcf9fd542bdea100403e788c5823926161363bdf5aa7",
+    ".claude/rules/tooling-and-review/preset-pr-checklist.md": "9cf71779411aa773a11e7339d0ea12193379a75e2a64efe1dd28b63ef98f0182",
+    ".claude/rules/tooling-and-review/preset-token-budget.md": "4dd2910a8077410e8f41599c3df469fb0e71c69befcaa71dbd13fd7a849852f0",
+    ".claude/rules/tooling-and-review/preset-twin-sync.md": "f3b13d83df63d813394d59e89bc9424e3d34c5466c00c23eff1141863482e595",
     ".claude/rules/tooling-and-review/security-next.md": "3e5c733925a0040928a9fbb7d841e69a471a03c5cb02d2fa986b81d29d7e31ca",
-    ".claude/rules/tooling-and-review/technical-retro.md": "afed167d7f9dc26b25ce47368998df665cc779550b101041ab3ee5bcdd81a96b",
-    ".claude/rules/tooling-and-review/ux-design.md": "732e9f290155ac5255bde9bf3fe6430ca1b1fd9c0ccbf5ea4467a3ccc22f12b5",
+    ".claude/rules/tooling-and-review/technical-retro.md": "45e059219204712dbaaeda860b553eb557a539ff164e425ff4181da43c86f24a",
+    ".claude/rules/tooling-and-review/ux-design.md": "df354f533cb2c3593758a68d2e276d9fa89f9ae15d408fb94b49040a3545be6c",
     ".claude/rules/ui-and-accessibility/README.md": "a3f6fed71b29b82c107014461f7546c341fea7f2c46a39e99181816b57e979d2",
     ".claude/rules/ui-and-accessibility/css-property-order.md": "1f3ed3e5891adb0114e203e26a4ad86c12d0bfeeadb7d425104e92fd5bf20dc1",
     ".claude/rules/ui-and-accessibility/no-props-spread.md": "60aa9ca9c94db981bcceb05a090734e540644febfa88f4e40089f5d16a8a5d7f",
@@ -96,33 +109,20 @@
     ".claude/rules/ui-and-accessibility/react-ui.md": "b5e3c8875f0fd9b8325f4bc9a10fad75bda56bf87c8be7a7993f4e593c055d07",
     ".claude/skills/README.md": "1aeac616a5270d0ce6be132a3dff3e0bbca1371191503f0ecf3eeeeea5b4e9f3",
     ".claude/skills/ci-investigation/SKILL.md": "b13ed9de0716671b7d192dc2ba7fec139466a933b52f25c075623dcdef38b399",
-    ".claude/skills/code-review/SKILL.md": "5da3983387e9854ed8ae57de02ae9d115443c0448c2ce7723c50d590cc9cccfc",
-    ".claude/skills/debug-investigation/SKILL.md": "bf3deed2871089de2bafd0164781f1baa6aa3a2853244278fcbaeefe0db04205",
+    ".claude/skills/code-review/SKILL.md": "068f995e00e4baa4baf02098cef865fd837f3dad33a5c063b778aa84b0878b02",
+    ".claude/skills/debug-investigation/SKILL.md": "a3bf3d1dc50366b983fa89b84ee9bfeb491ce11fbd005f5949baf273c79cb99f",
     ".claude/skills/feature-delivery/SKILL.md": "0d73925b4670eb7c81fa870e85c9c058e5416dfce53b9ebcde8b421ab36498eb",
-    ".claude/skills/mockup-review/SKILL.md": "44eca5265ca666948cb507fb92872105675bab21e93a4ecc2e42607c1e4e43ea",
+    ".claude/skills/mockup-review/SKILL.md": "d94afc1e0de13769c12a8a3d0659ade310208cdd8bff47353f30761ec1ce180d",
     ".claude/skills/playwright-e2e/SKILL.md": "df1ef0a4febcd7939757d8ffdffa4f347aa09e4fb030a84be2d89cd80701ffe8",
     ".claude/skills/react-performance/SKILL.md": "aaca660b87207e73cdaac123d523bf4cd57a4b2b8156431b11c1bd0bcdae6224",
     ".claude/skills/spec-authoring/SKILL.md": "37fcaf06088daee07de6b620a522143823d831579aa9c824bc1d7040f1d25e9d",
-    ".claude/skills/spec-discovery/SKILL.md": "ee58903bf84dac5f78d2cd2d38a62cc73c1dc4c39b2f8a14c5a63e842b6c002d",
-    ".claude/skills/technical-retro/SKILL.md": "a8a013b9e65522aa66e5d51651ac19ea007c962241a9c1204f9f1ee4196bcbcf",
-    ".claude/skills/unit-testing/SKILL.md": "218e5410726832dd67ef72cb12afeb74dfc4e9624eb36099479c78eded185a59",
-    ".claude/skills/ux-design/SKILL.md": "19108cc47ea203d0e4ac7e99282cf750224a963febf85a406bd420ded344032d",
-    ".claude/skills/write-adr/SKILL.md": "40eab263a26ad3b367ff7bd406f55a568164a1a7ba8c22c69e2212e833f0cb68",
-    ".claude/team/README.md": "af484580de898bbfa5a486be23ead58d165bc8d758c97be24a0bce669bf3ba27",
-    ".claude/team/conventions.md": "af977857ae0b3f10ccc36236f350eb8dccbec409530abf51a53de81a150a0442",
-    ".claude/team/fixtures/artifact-manifest.example.json": "bf4d0f00838f957643646b8407b4cec12aff3dec45893c1e776f44f3de08fb42",
-    ".claude/team/fixtures/bugfix-standard.json": "209cc0cc1844befee4bdbec9dcee27337dd7019f9f459dfcb8996db291fcae81",
-    ".claude/team/fixtures/feature-full.json": "1110b152cdcb5508e8ce4179aa2e760f7f7c66569ba081d6bdf0a49a0a449470",
-    ".claude/team/fixtures/feature-light.json": "618ac9da9527d688ec7dac849eafb869ae342ec890d0e7c73c1e57c0f8fb5a1b",
-    ".claude/team/fixtures/feature-with-figma-url.json": "8aec2ac11ba552bc9135721678af58c73ca5a74b3038c5f4dc878b1080ade9be",
-    ".claude/team/fixtures/feature-with-ux-no-figma.json": "526c103a26c83afef60ebadd289735b6dfea14c8191acd9780fc72e72da2ff45",
-    ".claude/team/fixtures/memlog.example.md": "53d281ddd383e0337b038a0dc6dd4e14f84743066a1a99bf45fc2e7064cce222",
-    ".claude/team/fixtures/mockup-review-fail-embedded-status.json": "2e1f3ff8e5e3668f20f2b0e329f26b884c79e426dd6b5952c0896bd4f0c7f9a4",
-    ".claude/team/fixtures/mockup-review-standalone.json": "edda49b1298e94f9a33496317e9f6ccbbb047659e044e05ba35669bfe800eda6",
-    ".claude/team/fixtures/ux-design-standalone.json": "528aeb9db4c310d1b5e3eacae0ad39a4fd1dd49c04154b064e7027981488a07a",
-    ".claude/team/tasks/.gitkeep": "aca85ed348a49b11d68188be6ab245b521e5a706bbe0fbca1a28abfdc7155893",
+    ".claude/skills/spec-discovery/SKILL.md": "bce9d01acab4d24015eda8c268c0c13d3893c1b258c2689b36ae25014ac47d91",
+    ".claude/skills/technical-retro/SKILL.md": "53d10a0d2ebf9ef54d2391d49c8ce424072795d9cc8203307b1f5f77a4045649",
+    ".claude/skills/unit-testing/SKILL.md": "2277f0097ea0665e73bf810acbb515a6fa3214e528f8679fefeba89b8cb04c30",
+    ".claude/skills/ux-design/SKILL.md": "74b70875ba3d41ffb8401c42bc8c9e442e73b36c6a6b0d8d9d2aae0a6017479c",
+    ".claude/skills/write-adr/SKILL.md": "607d70eff78d6a7b67b783237721fdc42eaa5170cb6175882e7e2a4adf132242",
     ".mcp.json": "f68a14db68a491a982975a3e6cc985057072a68eebdcedf33d8ac2a4a3b284ca",
-    "AGENTS.md": "0eaef34cabb183f665f25bc85863cbd528967589f49e808a71196748f882a085",
+    "AGENTS.md": "2d3c64960ee9adb11d850ce5da390d3c9571d1e9a02f1fd7114f5ea68d00c6ff",
     "docs/specs/INDEX.md": "cab59f2093e6aaa376246a56d53e4268cb59070a6b10e87a94895192c35f422d",
     "docs/specs/_templates/feature.md": "83c47b90334c555fb5144749837e2ddfe1cae5bb89031f885ba98671075d59e7",
     "docs/specs/_templates/page.md": "a668c584e28edd52afaf3f9f8f898a75e43cb82fa12822c7a016033441e12e54"