@bonesofspring/ai-rules 0.2.28 → 0.2.30

package/presets/opencode/next/rules/preset-pr-checklist.md

@@ -21,7 +21,7 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change
 - [ ] **i18n anchors:** kept-marked Cyrillic fragments in `tests-unit.md(c)` stay consistent with their English counterparts. Run `packages/ai-rules/scripts/check-preset-i18n.sh`.
-- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh` (and `sync-dogfood-mavis.sh` / `sync-dogfood-opencode.sh` when those platforms changed), or document an intentional skip, when maintaining this monorepo
+- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, and `sync-dogfood-opencode.sh` when those platforms changed, or document an intentional skip, when maintaining this monorepo
 - [ ] **shared-core drift:** for embed-mode stems, run `packages/ai-rules/scripts/check-shared-core-drift.sh` (or document intentional fork)
 
 ## Pointers
@@ -31,6 +31,6 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - Budget: `preset-token-budget`
 - Leakage: `preset-no-cross-stack-leakage`
 - Validation: stack `agents/build-verifier.md` → preset-structure section
-- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
+- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
 - Drift script: `packages/ai-rules/scripts/check-shared-core-drift.sh`
 - Orchestrator: when editing presets, load this checklist + twin-sync

package/presets/opencode/next/rules/react-ui.md

@@ -90,6 +90,7 @@ For a reusable component:
 - **Forbidden** to import another component's `styles` (`../Other/styles`, `../../styles`). Allowed: `./styles`, shared primitives from `@/ui/components/...` or design-system packages.
 - CSS / `styled` order — Stylelint idiomatic-order: `css-property-order-stylelint.md` (loads on `styles.ts` / `.css`).
 - For visuals use **the style stack and tokens already in the project** (variables, theme, shared classes, design package).
+- **Token binding (Figma → repo):** typography, color, spacing, radius, shadow, and imagery must bind to the project token module and the design system (`@sds/tokens-*` / `@sds/brand-colors` / DS components like `Text variant="…"`, `@sds/icon`, `next/image`). Raw `#…` / `rgb(…)` / `px` where a token exists is a finding. The full discipline — including the per-element parity checklist and the developer self-check vs Figma — is in **`design-tokens-binding.md`**. When a Figma reference exists, the `mockup-review.md` `## Design contract` section is the binding table; use it.
 - Avoid:
   - inline styles except simple cases;
   - duplicating styling already covered by shared primitives;

package/presets/opencode/next/skills/code-review/SKILL.md

@@ -20,6 +20,7 @@ Use the local repository as the source of truth: `git status`, `git diff`, task
 7. **Reuse lens:** flag new helpers that duplicate existing utilities; prefer adjacent shared modules over copy-paste.
 8. **Efficiency lens:** unnecessary work, sequential ops that should be parallel, hot-path bloat, no-op store updates, overly broad reads.
 9. Report validation gaps: lint, stylelint, type-check, or relevant tests not run.
+10. **UI / Figma parity (when the diff touches UI/layout AND a Figma reference exists):** perform a detailed, pixel-accurate comparison of the implementation against the mockup across **every project viewport** (mockup-review AC-8 / Stack notes set and the repo’s Storybook viewport toolbar). Figma frames via Figma MCP `get_screenshot`; the running app via Playwright MCP / Chrome DevTools MCP at the matching width. Compare **per element** — typography, color, spacing, imagery, states, structure/responsive, auto-layout intent — bound to the `mockup-review.md` `## Design contract` and the `design-tokens-binding` discipline (`@sds/tokens-*` / DS components; raw `#…` / `px` where a token exists is a finding). Emit a `## Figma parity (UI)` section in `review.md`. **Storybook visual baselines are not a substitute.** Missing or `unable_to_compare` parity on a UI MR with a Figma reference → `REQUEST_CHANGES`. Unbound raw values → `blocker` / `important`.
 
 ## Output
 

package/presets/opencode/nuxt/OPENCODE.md

@@ -12,7 +12,9 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - Other rules: lazy `Read` `.opencode/rules/<stem>.md` when the task matches.
 - Agents: native `@name` / Task from `.opencode/agents/`.
 - Commands: native `/task` from `.opencode/commands/`.
-- After a producer receipt, run `bash .opencode/hooks/chain-team-phases.sh`.
+- After a producer receipt, run the chain by hand (`projectHooks` is `manual`; this preset ships no plugin):
+  `printf '%s\n' '{"status":"completed"}' | bash .opencode/hooks/chain-team-phases.sh`.
+  Slash commands are native (`/task` from `.opencode/commands/`). Do not assume `SubagentStop` auto-chain.
   Agents must not write lifecycle fields in `status.json` / `metrics.json`.
 
 ## Essential rules (read every turn)
@@ -22,6 +24,11 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - `.opencode/rules/code-quality-and-refactoring.md`
 - `.opencode/rules/ai-local-overlay.md`
 
+Every turn, probe `ls -la .ai.local`, then apply `.ai.local/rules/*.md` and
+`.ai.local/conventions.md`. Acknowledge `Using .ai.local: <rule-name>`.
+Guide: `docs/LOCAL-OVERLAY.md`. These essential rules are a prompt contract.
+`nativeProjectRules` is `no-equivalent` — do not claim engine `alwaysApply`.
+
 See `.opencode/rules/README.md` for the full catalog and loading strategy.
 
 ## Harness wiring

package/presets/opencode/nuxt/REPO_AGENTS.md

@@ -72,4 +72,4 @@ A `.ai.local/` directory MAY exist at the repo root or at any nesting depth in m
 
 Plain markdown rules under `.ai.local/rules/*.md` are read by the agent with higher priority than preset rules. Living gotchas live in `.ai.local/conventions.md`.
 
-Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule (always-on for Cursor, on-demand for Claude) is the mechanism; this `MANDATORY` section is the reinforcement.
+On every turn, probe `ls -la .ai.local`, apply `.ai.local/rules/*.md` and `.ai.local/conventions.md`, and acknowledge `Using .ai.local: <rule-name>`. Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule is always-on on Cursor and session-start on Claude (no `paths:`). Mavis and OpenCode have no native `alwaysApply`; this section plus the platform entry's essential-rules list is the reinforcement.

package/presets/opencode/nuxt/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "nuxt",
   "semanticSource": "cursor/nuxt",
-  "sourceRevision": "f984f1917ef8328f0784adadc00e0224caee7ac1eb96a609e95839c769ed20d7",
+  "sourceRevision": "f7f0e3abbcd5d9c3a51bc16d2c1e1ed8d6cae98351f48f74fc9984e1e374675d",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/nuxt/rules/preset-pr-checklist.md

@@ -21,7 +21,7 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change
 - [ ] **i18n anchors:** kept-marked Cyrillic fragments in `tests-unit.md(c)` stay consistent with their English counterparts. Run `packages/ai-rules/scripts/check-preset-i18n.sh`.
-- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh` (and `sync-dogfood-mavis.sh` / `sync-dogfood-opencode.sh` when those platforms changed), or document an intentional skip, when maintaining this monorepo
+- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, and `sync-dogfood-opencode.sh` when those platforms changed, or document an intentional skip, when maintaining this monorepo
 - [ ] **shared-core drift:** for embed-mode stems, run `packages/ai-rules/scripts/check-shared-core-drift.sh` (or document intentional fork)
 
 ## Pointers
@@ -31,6 +31,6 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - Budget: `preset-token-budget`
 - Leakage: `preset-no-cross-stack-leakage`
 - Validation: stack `agents/build-verifier.md` → preset-structure section
-- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
+- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
 - Drift script: `packages/ai-rules/scripts/check-shared-core-drift.sh`
 - Orchestrator: when editing presets, load this checklist + twin-sync

package/presets/opencode/php-hexagonal/OPENCODE.md

@@ -12,7 +12,9 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - Other rules: lazy `Read` `.opencode/rules/<stem>.md` when the task matches.
 - Agents: native `@name` / Task from `.opencode/agents/`.
 - Commands: native `/task` from `.opencode/commands/`.
-- After a producer receipt, run `bash .opencode/hooks/chain-team-phases.sh`.
+- After a producer receipt, run the chain by hand (`projectHooks` is `manual`; this preset ships no plugin):
+  `printf '%s\n' '{"status":"completed"}' | bash .opencode/hooks/chain-team-phases.sh`.
+  Slash commands are native (`/task` from `.opencode/commands/`). Do not assume `SubagentStop` auto-chain.
   Agents must not write lifecycle fields in `status.json` / `metrics.json`.
 
 ## Essential rules (read every turn)
@@ -22,6 +24,11 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - `.opencode/rules/code-quality-and-refactoring.md`
 - `.opencode/rules/ai-local-overlay.md`
 
+Every turn, probe `ls -la .ai.local`, then apply `.ai.local/rules/*.md` and
+`.ai.local/conventions.md`. Acknowledge `Using .ai.local: <rule-name>`.
+Guide: `docs/LOCAL-OVERLAY.md`. These essential rules are a prompt contract.
+`nativeProjectRules` is `no-equivalent` — do not claim engine `alwaysApply`.
+
 See `.opencode/rules/README.md` for the full catalog and loading strategy.
 
 ## Harness wiring

package/presets/opencode/php-hexagonal/REPO_AGENTS.md

@@ -70,4 +70,4 @@ A `.ai.local/` directory MAY exist at the repo root or at any nesting depth in m
 
 Plain markdown rules under `.ai.local/rules/*.md` are read by the agent with higher priority than preset rules. Living gotchas live in `.ai.local/conventions.md`.
 
-Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule (always-on for Cursor, on-demand for Claude) is the mechanism; this `MANDATORY` section is the reinforcement.
+On every turn, probe `ls -la .ai.local`, apply `.ai.local/rules/*.md` and `.ai.local/conventions.md`, and acknowledge `Using .ai.local: <rule-name>`. Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule is always-on on Cursor and session-start on Claude (no `paths:`). Mavis and OpenCode have no native `alwaysApply`; this section plus the platform entry's essential-rules list is the reinforcement.

package/presets/opencode/php-hexagonal/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "php-hexagonal",
   "semanticSource": "cursor/php-hexagonal",
-  "sourceRevision": "22efe7082bbb1b37a232cfbaad1681335973894ab3878bda61f461575f69bc1e",
+  "sourceRevision": "024d2f6c371002d6a02c2c92d52ee17c3d9aea24991f692b1581a06ed7734f5c",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/php-hexagonal/rules/preset-pr-checklist.md

@@ -21,7 +21,7 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change
 - [ ] **i18n anchors:** kept-marked Cyrillic fragments in `tests-unit.md(c)` stay consistent with their English counterparts. Run `packages/ai-rules/scripts/check-preset-i18n.sh`.
-- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh` (and `sync-dogfood-mavis.sh` / `sync-dogfood-opencode.sh` when those platforms changed), or document an intentional skip, when maintaining this monorepo
+- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, and `sync-dogfood-opencode.sh` when those platforms changed, or document an intentional skip, when maintaining this monorepo
 - [ ] **shared-core drift:** for embed-mode stems, run `packages/ai-rules/scripts/check-shared-core-drift.sh` (or document intentional fork)
 
 ## Pointers
@@ -31,6 +31,6 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - Budget: `preset-token-budget`
 - Leakage: `preset-no-cross-stack-leakage`
 - Validation: stack `agents/build-verifier.md` → preset-structure section
-- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
+- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
 - Drift script: `packages/ai-rules/scripts/check-shared-core-drift.sh`
 - Orchestrator: when editing presets, load this checklist + twin-sync

package/presets/opencode/php-laravel/OPENCODE.md

@@ -12,7 +12,9 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - Other rules: lazy `Read` `.opencode/rules/<stem>.md` when the task matches.
 - Agents: native `@name` / Task from `.opencode/agents/`.
 - Commands: native `/task` from `.opencode/commands/`.
-- After a producer receipt, run `bash .opencode/hooks/chain-team-phases.sh`.
+- After a producer receipt, run the chain by hand (`projectHooks` is `manual`; this preset ships no plugin):
+  `printf '%s\n' '{"status":"completed"}' | bash .opencode/hooks/chain-team-phases.sh`.
+  Slash commands are native (`/task` from `.opencode/commands/`). Do not assume `SubagentStop` auto-chain.
   Agents must not write lifecycle fields in `status.json` / `metrics.json`.
 
 ## Essential rules (read every turn)
@@ -22,6 +24,11 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - `.opencode/rules/code-quality-and-refactoring.md`
 - `.opencode/rules/ai-local-overlay.md`
 
+Every turn, probe `ls -la .ai.local`, then apply `.ai.local/rules/*.md` and
+`.ai.local/conventions.md`. Acknowledge `Using .ai.local: <rule-name>`.
+Guide: `docs/LOCAL-OVERLAY.md`. These essential rules are a prompt contract.
+`nativeProjectRules` is `no-equivalent` — do not claim engine `alwaysApply`.
+
 See `.opencode/rules/README.md` for the full catalog and loading strategy.
 
 ## Harness wiring

package/presets/opencode/php-laravel/REPO_AGENTS.md

@@ -71,4 +71,4 @@ A `.ai.local/` directory MAY exist at the repo root or at any nesting depth in m
 
 Plain markdown rules under `.ai.local/rules/*.md` are read by the agent with higher priority than preset rules. Living gotchas live in `.ai.local/conventions.md`.
 
-Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule (always-on for Cursor, on-demand for Claude) is the mechanism; this `MANDATORY` section is the reinforcement.
+On every turn, probe `ls -la .ai.local`, apply `.ai.local/rules/*.md` and `.ai.local/conventions.md`, and acknowledge `Using .ai.local: <rule-name>`. Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule is always-on on Cursor and session-start on Claude (no `paths:`). Mavis and OpenCode have no native `alwaysApply`; this section plus the platform entry's essential-rules list is the reinforcement.

package/presets/opencode/php-laravel/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "php-laravel",
   "semanticSource": "cursor/php-laravel",
-  "sourceRevision": "c9cb7fb568009a1d15b619b194f62899cd25e1b9a2349c8fb1b4d737b778414a",
+  "sourceRevision": "79fe8a7f094030719cb421ad283f548b993ec8d198b7e4656d0d3ef30c9c33b0",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/php-laravel/rules/preset-pr-checklist.md

@@ -21,7 +21,7 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change
 - [ ] **i18n anchors:** kept-marked Cyrillic fragments in `tests-unit.md(c)` stay consistent with their English counterparts. Run `packages/ai-rules/scripts/check-preset-i18n.sh`.
-- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh` (and `sync-dogfood-mavis.sh` / `sync-dogfood-opencode.sh` when those platforms changed), or document an intentional skip, when maintaining this monorepo
+- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, and `sync-dogfood-opencode.sh` when those platforms changed, or document an intentional skip, when maintaining this monorepo
 - [ ] **shared-core drift:** for embed-mode stems, run `packages/ai-rules/scripts/check-shared-core-drift.sh` (or document intentional fork)
 
 ## Pointers
@@ -31,6 +31,6 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - Budget: `preset-token-budget`
 - Leakage: `preset-no-cross-stack-leakage`
 - Validation: stack `agents/build-verifier.md` → preset-structure section
-- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
+- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
 - Drift script: `packages/ai-rules/scripts/check-shared-core-drift.sh`
 - Orchestrator: when editing presets, load this checklist + twin-sync

package/presets/opencode/platform-contract.json

@@ -115,7 +115,7 @@
       "nativePath": "opencode.json"
     },
     "projectHooks": {
-      "status": "unknown",
+      "status": "manual",
       "evidence": "docs/OPENCODE-COMPATIBILITY.md",
       "nativePath": null
     },

package/presets/opencode/svelte/OPENCODE.md

@@ -12,7 +12,9 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - Other rules: lazy `Read` `.opencode/rules/<stem>.md` when the task matches.
 - Agents: native `@name` / Task from `.opencode/agents/`.
 - Commands: native `/task` from `.opencode/commands/`.
-- After a producer receipt, run `bash .opencode/hooks/chain-team-phases.sh`.
+- After a producer receipt, run the chain by hand (`projectHooks` is `manual`; this preset ships no plugin):
+  `printf '%s\n' '{"status":"completed"}' | bash .opencode/hooks/chain-team-phases.sh`.
+  Slash commands are native (`/task` from `.opencode/commands/`). Do not assume `SubagentStop` auto-chain.
   Agents must not write lifecycle fields in `status.json` / `metrics.json`.
 
 ## Essential rules (read every turn)
@@ -22,6 +24,11 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 - `.opencode/rules/code-quality-and-refactoring.md`
 - `.opencode/rules/ai-local-overlay.md`
 
+Every turn, probe `ls -la .ai.local`, then apply `.ai.local/rules/*.md` and
+`.ai.local/conventions.md`. Acknowledge `Using .ai.local: <rule-name>`.
+Guide: `docs/LOCAL-OVERLAY.md`. These essential rules are a prompt contract.
+`nativeProjectRules` is `no-equivalent` — do not claim engine `alwaysApply`.
+
 See `.opencode/rules/README.md` for the full catalog and loading strategy.
 
 ## Harness wiring

package/presets/opencode/svelte/REPO_AGENTS.md

@@ -72,4 +72,4 @@ A `.ai.local/` directory MAY exist at the repo root or at any nesting depth in m
 
 Plain markdown rules under `.ai.local/rules/*.md` are read by the agent with higher priority than preset rules. Living gotchas live in `.ai.local/conventions.md`.
 
-Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule (always-on for Cursor, on-demand for Claude) is the mechanism; this `MANDATORY` section is the reinforcement.
+On every turn, probe `ls -la .ai.local`, apply `.ai.local/rules/*.md` and `.ai.local/conventions.md`, and acknowledge `Using .ai.local: <rule-name>`. Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule is always-on on Cursor and session-start on Claude (no `paths:`). Mavis and OpenCode have no native `alwaysApply`; this section plus the platform entry's essential-rules list is the reinforcement.

package/presets/opencode/svelte/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "svelte",
   "semanticSource": "cursor/svelte",
-  "sourceRevision": "8023483a35bad6db47f68f7320fd24e31c024004d0409a105fd2f78ef249e9c0",
+  "sourceRevision": "e2647db5026c557c38d7dcfdc4595afac8832b3459c75ab3f663568d8dbc0289",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/svelte/rules/preset-pr-checklist.md

@@ -21,7 +21,7 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - [ ] **README:** stack `rules/README.md` core→stack mapping / catalog updated if stems added
 - [ ] **CHANGELOG / package README:** note when public preset paths or install surface change
 - [ ] **i18n anchors:** kept-marked Cyrillic fragments in `tests-unit.md(c)` stay consistent with their English counterparts. Run `packages/ai-rules/scripts/check-preset-i18n.sh`.
-- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh` (and `sync-dogfood-mavis.sh` / `sync-dogfood-opencode.sh` when those platforms changed), or document an intentional skip, when maintaining this monorepo
+- [ ] **Dogfood:** run `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, and `sync-dogfood-opencode.sh` when those platforms changed, or document an intentional skip, when maintaining this monorepo
 - [ ] **shared-core drift:** for embed-mode stems, run `packages/ai-rules/scripts/check-shared-core-drift.sh` (or document intentional fork)
 
 ## Pointers
@@ -31,6 +31,6 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - Budget: `preset-token-budget`
 - Leakage: `preset-no-cross-stack-leakage`
 - Validation: stack `agents/build-verifier.md` → preset-structure section
-- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
+- Dogfood scripts: `packages/ai-rules/scripts/sync-dogfood-cursor.sh`, `sync-dogfood-claude.sh`, `sync-dogfood-mavis.sh`, `sync-dogfood-opencode.sh`
 - Drift script: `packages/ai-rules/scripts/check-shared-core-drift.sh`
 - Orchestrator: when editing presets, load this checklist + twin-sync

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-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.