@bonesofspring/ai-rules 0.2.28 → 0.2.30

package/presets/opencode/android-kotlin/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/android-kotlin/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/android-kotlin/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "android-kotlin",
   "semanticSource": "cursor/android-kotlin",
-  "sourceRevision": "94c31b7b1327d457759e866babcbceceff211ba6691ba6114c32b5ca8e1282fd",
+  "sourceRevision": "6e09f86a97133b60a3818076d68660709ce3b9119175f1e00ef160b3bc747def",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/android-kotlin/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/go/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/go/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/go/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "go",
   "semanticSource": "cursor/go",
-  "sourceRevision": "c80c2a8469a9d8c0b09042fa2dee8e9ba0193704587e9586d352e506126547a6",
+  "sourceRevision": "082c8aec1536c91c49993c58c6f9ad587da93c4a5bbef82b7b73eece4402eab9",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/go/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/ios-swift/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/ios-swift/REPO_AGENTS.md

@@ -69,4 +69,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/ios-swift/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "ios-swift",
   "semanticSource": "cursor/ios-swift",
-  "sourceRevision": "c9bca6893eaac1a4f71e0211d8dfa8b2967938027af0e7945e06410bfffa522d",
+  "sourceRevision": "6109fce820397ca0bc6b9a2f09290049e4a0e88a5c8dfb5267f52ff8b46f30e5",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/ios-swift/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/java/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/java/REPO_AGENTS.md

@@ -69,4 +69,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/java/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "java",
   "semanticSource": "cursor/java",
-  "sourceRevision": "19291099a0af90377f78d53ec28a657d3d69657561e267fe1addacf201860228",
+  "sourceRevision": "644b4a47fead34d4c5745a9290e800b99b6948a174edcf5c74621999068dd14e",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/java/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/mcp-ts/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/mcp-ts/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/mcp-ts/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "mcp-ts",
   "semanticSource": "cursor/mcp-ts",
-  "sourceRevision": "8d8d5d2737c689451c222cee97747f78dc10cf47ed25126cb0d51fdf73667550",
+  "sourceRevision": "008356a19bf3609e33b39cb6a5397384b45078380661e6b944b1f86ced6aae7d",
   "entries": [
     {
       "source": "AGENTS.md",

package/presets/opencode/mcp-ts/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/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/next/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/next/adapter-map.json

@@ -3,7 +3,7 @@
   "platform": "opencode",
   "stack": "next",
   "semanticSource": "cursor/next",
-  "sourceRevision": "27df1a96830a46bbc59319d9f695bae3ce3d4fccd71885feeea67d8a920b5cb6",
+  "sourceRevision": "be3247c939b52878a3d3d93245cd63c02e259418104111458f04ef0b737e5d27",
   "entries": [
     {
       "source": "AGENTS.md",
@@ -490,6 +490,14 @@
       "reason": "Requestable Cursor rule: lazy Read from .opencode/rules; not auto-loaded",
       "sharedCoreStem": "quality/design-guidance.md"
     },
+    {
+      "source": "rules/design-tokens-binding.mdc",
+      "target": "rules/design-tokens-binding.md",
+      "category": "rules",
+      "disposition": "transform",
+      "loadMode": "referenced",
+      "reason": "Requestable Cursor rule: lazy Read from .opencode/rules; not auto-loaded"
+    },
     {
       "source": "rules/feature-delivery-workflow.mdc",
       "target": "rules/feature-delivery-workflow.md",

package/presets/opencode/next/agents/code-reviewer.md

@@ -47,6 +47,35 @@ You **issue** reviews. Implementers acting on your findings must verify each ite
 - User-flow changes without e2e plan/spec updates → note in warnings; REQUEST_CHANGES when AC requires e2e.
 - If the MR touches `docs/specs/**`, load **`product-specs`** (+ **`product-specs-authoring`** when new/changed specs): **WARN** code/spec drift; **FAIL** broken INDEX `path` link or missing required frontmatter keys/arrays on touched spec files; required body headings missing → **FAIL** on touched files. Do not invent missing product behavior.
 
+## UI / Figma parity gate (UI-touching MR)
+
+When the diff touches **UI / layout / styling** — paths under `app/src/ui/**` (components, pages, styles, hooks used by UI), or edits to global layout/CSS/tokens, or renamed/reordered UI files — AND a Figma mockup reference exists in `brief.md` / `decomposition.md` (Figma URL, fileKey, or node id) **or** `mockup-review.md` is present in the task:
+
+- **Do a detailed, pixel-accurate comparison** of the implementation against the mockup, **across every viewport the project uses**. The project’s accepted viewport set is the one declared in the `mockup-review` AC-8 / Stack notes (web buckets ~375 / ~768 / ~1280 mapped to small / medium / large) and/or the Storybook viewport toolbar in this repo — fetch the full set, do not sample.
+- For each viewport: pull the Figma frame via Figma MCP `get_screenshot` (prefer the node-link if present) and capture the running app at the same width (Playwright MCP / Chrome DevTools MCP). Compare structure, spacing, typography, color, iconography, states, and interactive affordances. **Storybook visual baselines are not a substitute.**
+
+### Per-element parity checklist (mandatory)
+
+For every UI element in the diff scope, verify against the Figma node and the `mockup-review.md` `## Design contract` (when present) and the **`design-tokens-binding`** discipline. Findings cite **`path:line`** + Figma node id + viewport.
+
+1. **Typography** — font-family, size, line-height, weight, letter-spacing, color. Must match the Figma text style / `tokens-typography` mapping. A `Text variant="…"` DS component is the safe mirror; a raw `font-size: 14px; line-height: 20px;` wrapper is a finding unless the Figma text style maps to a raw token (and the token is used, not a literal).
+2. **Color** — fills, strokes, icon color, link color, placeholder color. Must bind to `@sds/tokens-colors` / `@sds/brand-colors` / the project token module (or the Figma variable mapped in the Design contract). Raw `#…` / `rgb(…)` is a finding. Hover / active / focus / disabled states must use the bound state color from the token set, not a literal.
+3. **Spacing** — padding, gap, margin, border-radius. Must match the Figma spacing / radius variable (Design contract) or the repo spacing scale. Raw `padding: 16px;` is a finding if a token exists. Auto-layout intent (direction, gap, alignment) preserved — no reflow to absolute positioning without a brief reason.
+4. **Imagery & icons** — image `src`, intrinsic `width`/`height`, aspect ratio match the Figma asset / `get_design_context` recommendation; rendered with `next/image` (or repo convention). Icons must use the `@sds/icon` (or DS) symbol name from the Figma component instance. A `placeholder`, an invented image URL, a guessed icon name, or a stretched aspect ratio is a finding. `alt` text matches the Figma node copy when meaningful.
+5. **States** — empty / loading / error / success / disabled / validation visible in the Figma must be implemented. Missing states present in the mockup → `blocker`.
+6. **Structure & responsive** — direction (row / column), alignment, wrap, overflow match the Figma. The implementation responds to the project viewport set without horizontal scroll or clipped content at any accepted width (unless the Figma explicitly clips).
+7. **Auto-layout vs absolute** — for a region that is the only responsive evidence in Figma, the implementation must use flex / grid with the same gap / padding, not absolute positioning.
+
+### Findings, severity, and section
+
+- Findings cite `path:line` + Figma node id + viewport + severity. Layout / style deviations from the mockup → **`important`**; user-visible / broken / missing-state → **`blocker`**; latent / cosmetic → **`nit`**.
+- Emit a `## Figma parity (UI)` section in `review.md` with the per-viewport verdict, a findings table, and screenshots / links. The section must reference the `## Design contract` from `mockup-review.md` and the **`design-tokens-binding`** discipline. **If you cannot perform the comparison** (no Figma URL in brief, or Figma MCP down with no manual screenshots) → still emit the section with verdict `unable_to_compare` and a one-line reason. **Never** skip the section on a UI-touching MR with a Figma reference.
+- **Hard rules:**
+  - UI-touching MR with a Figma reference and a missing or `unable_to_compare` parity section → **REQUEST_CHANGES**.
+  - Unbound raw values where a token exists (typography / color / spacing / imagery) → `blocker` (user-visible) or `important` (latent). Do not approve on Storybook baselines alone.
+
+The gate does **not** apply to MRs with no UI/layout diff and no Figma reference (e.g. pure store/reducer or test-only changes).
+
 ## Review artifact
 
 Write `.ai.local/team/tasks/<slug>/review.md` with this format:
@@ -66,6 +95,12 @@ APPROVE | APPROVE_WITH_NOTES | REQUEST_CHANGES
 ## Suggestions (nice to have)
 - ...
 
+## Figma parity (UI)
+- Viewports compared: …
+- Per-viewport verdict: …
+- Findings: `path:line` | node id | viewport | severity | note
+- (If UI gate not applicable: `N/A — no UI diff / no Figma reference`.)
+
 ## AC coverage
 | Criterion | Status | Notes |
 |-----------|--------|-------|

package/presets/opencode/next/agents/feature-developer.md

@@ -49,6 +49,7 @@ You are a senior frontend developer working in a Next.js monorepo with strict la
 3. Read `pipeline.json` for step context and scope.
 4. Follow the **`feature-delivery` skill** (layer order, reference features, validation handoff).
 5. **Verify carry-over at HEAD before applying** (refactor intent only). When the brief comes from a prior review's carry-over findings list, for each item run `git show HEAD:<path>` or `grep` to confirm the finding still applies at the current HEAD; if the file already contains the fix (carry-over was closed in a prior uncommitted batch), mark it as **NO-OP at HEAD** in `implementation.md` and skip the edit; if the file is unchanged, apply the fix and cite file:line. Target ≤2 NO-OP items per refactor pipeline.
+6. **Figma node-link precondition.** If `brief.md` / `decomposition.md` / the prompt contains a Figma URL with a node id (`?node-id=…`), do **not** start UI implementation until `mockup-review.md` contains **both** a `## Design contract` section (Figma variables, text styles, components/assets with the repo mapping) **and** a `## Node decomposition (AC-2)` section (child→component map with bindings) for that node. If either section is missing or empty, emit `blocked` and hand back to the analyst / mockup-reviewer (or ask the user to re-run mockup-review). The Design contract is the binding table for typography / color / spacing / imagery; the Node decomposition is the component map. Load requestable rule **`design-tokens-binding`** before writing UI — bind every value to a Figma variable / text style / repo token; raw `#…` / `px` are a finding.
 
 ## Task execution rules
 
@@ -93,6 +94,27 @@ Do not perform formal code review — that is the code-reviewer subagent's job.
 
 Before handoff, IDENTIFY→RUN→READ→VERIFY the scoped checks for this WP, THEN claim. Do not say the work is done without that evidence in the same turn. Full-project lint is `build-verifier`.
 
+## UI self-check vs Figma (mandatory for UI WPs with a Figma reference)
+
+When this WP touched UI / layout / styling (paths under `app/src/ui/**`, global layout/CSS/tokens) AND a Figma reference exists in `brief.md` / `decomposition.md` (or `mockup-review.md` is present):
+
+1. **Render** the changed routes at **each project viewport** (the set from `mockup-review` AC-8 / Stack notes — web buckets ~375 / ~768 / ~1280 small/medium/large — and the repo’s Storybook viewport toolbar). Use Playwright MCP or Chrome DevTools MCP (the app must be running; if not, note the limitation and still perform the self-check as far as possible).
+2. **Compare** each rendered viewport to the Figma `get_screenshot` (prefer the node-link). For each UI element in the diff scope, check the per-element parity list in the `code-reviewer` UI / Figma parity gate: typography, color, spacing, imagery, states, structure/responsive, auto-layout intent.
+3. **Fix** obvious deviations before the implementation receipt (font family / size / line-height / color / spacing / image src+size / icon name / state). Bind to the Design contract; load **`design-tokens-binding`** if a value is missing.
+4. **Record** a `## UI self-check vs Figma` block in `implementation.md`:
+
+   ```markdown
+   ## UI self-check vs Figma
+   - Viewports checked: <e.g. 375, 768, 1280>
+   - MCP / app status: <ok | degraded: reason>
+   - Deviations fixed: `path:line` | node id | viewport | what | fix
+   - Remaining gaps / known limits: <… or none>
+   ```
+
+   If the app was not runnable or MCP was down, still emit the block with the limitation and what you could not check — the reviewer will gate.
+
+This is the developer-side counterpart to the `code-reviewer` UI / Figma parity gate; together they close the fidelity loop (extract contract → bind → self-check → review-block on unbound).
+
 ## Anti-hallucination (Next / React / RTK)
 
 - When editing `app/**/*.{ts,tsx}`, load / follow rule `react-next-anti-hallucination`.

package/presets/opencode/next/agents/mockup-reviewer.md

@@ -56,9 +56,35 @@ MCP unavailable or OAuth fail → verdict `BLOCKED_MCP`. Do not invent DS claims
 
 Follow the requestable `mockup-review` checklist (DS components, tokens, quality, coverage, viewports). Do not duplicate that checklist here.
 
+## Node-link input: child→component decomposition (AC-2, mandatory)
+
+When the Figma URL (in prompt, `brief.md`, or `decomposition.md`) contains a node id (`?node-id=…` or `…/node/…`):
+
+1. **Inspect the node subtree** via Figma MCP `get_metadata` for the exact node (not the whole file). Depth ≤3 named-frame levels; ≤12 child rows in the map.
+2. **Classify each child node** as one of: library component instance (check `search_design_system` / library metadata), custom frame, text/icon/asset, container, layout-only, unknown. Skip pure decorative leaves unless they constrain the child component.
+3. **Map each child node → target component** using repo conventions:
+   - existing `app/src/ui/**` component → name it (e.g. `RiskProfilePage/components/ProfileHealthCard`);
+   - attached library component (e.g. `@sds/*`) → name the library symbol and the local wrapper;
+   - no analog → mark `new: <ProposedName>` and the parent component it belongs to.
+4. **Emit the map** in the report under `## Node decomposition (AC-2)` as a table (node id, node name, type, target component / action). Add a short prose summary of grouping / boundaries.
+5. **Extract the Design contract** (mandatory for node-link input) and emit it as a separate `## Design contract` section, **above** the Node decomposition table — the developer reads it first:
+   - **Figma variables** (one `get_variable_defs` call per file): list the variables used by the subtree (color, spacing, radius, effect). Map each to the repo equivalent: `@sds/tokens-colors` / `@sds/brand-colors` / `@sds/tokens` / project token module (e.g. `var(--text-primary, …)`).
+   - **Text styles**: list the Figma text style names used (e.g. `Body/M`, `Heading/L`). Map to the repo typography component / token (`@sds/tokens-typography`, `Text variant="…"`, Linaria `var(--font-…, …)`).
+   - **Components / assets**: list library component instances (`@sds/*` symbol name), image fills (asset URL / `get_design_context` recommendation), and icons (`@sds/icon` symbol name).
+   - Call this once per file; do not dump the whole variable set — only what the subtree uses.
+6. **Extend the AC-2 table** with a concise `Bindings` column (or a per-row note) capturing the text style, fill / spacing tokens, and asset source for that node. Keep the table scannable; put the long form in the Design contract section.
+7. **Verdict rule.** Missing map **or** missing Design contract on a node-link input → verdict `FAIL` (mandatory pre-implementation step) unless MCP returned `BLOCKED_MCP`. Refusal to produce the map / contract on a node-link task is not an option — narrow the node with the user first (do not silently fall back to whole-file review).
+
+The map and the Design contract are the implementation contract the developer reads before coding; the DS/tokens/quality/coverage/viewport dimensions still apply on top.
+
 ## Output
 
-Write `.ai.local/team/tasks/<slug>/mockup-review.md` using the report headings in the `mockup-review` rule.
+Write `.ai.local/team/tasks/<slug>/mockup-review.md` using the report headings in the `mockup-review` rule. When the input is a node-link, the report **must** additionally include:
+
+- `## Design contract` (above Node decomposition) — Figma variables, text styles, components/assets used by the subtree, with the repo mapping (`@sds/tokens-*` / DS components / project token module). This is the binding table the developer uses for typography, color, spacing, and imagery.
+- `## Node decomposition (AC-2)` — the child→component map (table) plus a short prose summary, with a `Bindings` column / per-row note for the Figma design bindings.
+
+Both sections are the developer’s pre-implementation contract; do not omit either on a node-link input.
 
 ## Verdicts and receipts
 

package/presets/opencode/next/rules/code-review-mr.md

@@ -51,3 +51,13 @@ On-demand rule for review flows. **Procedure and output format:** skill `code-re
 - Security: `security-next.mdc`
 - Tests: `tests-unit.mdc`, `playwright-agents.mdc`, `tests-e2e-structure.mdc`
 - Lint gate before final report: `post-change-lint.mdc`
+
+### UI / Figma parity (web)
+
+When the diff touches UI / layout / styling (paths under `app/src/ui/**`, global layout/CSS/tokens) AND a Figma mockup is referenced in `brief.md` / `decomposition.md` (URL, fileKey, or node id) **or** `mockup-review.md` is present:
+
+- The `code-reviewer` agent must perform a **detailed, pixel-accurate** comparison of the implementation against the mockup, **across every viewport the project uses** (the `mockup-review` AC-8 / Stack notes set — web buckets ~375 / ~768 / ~1280 small/medium/large — and the Storybook viewport toolbar in this repo). Figma frames via Figma MCP `get_screenshot`; the running app via Playwright MCP / Chrome DevTools MCP at the matching width.
+- The comparison is a **per-element parity check** (typography / color / spacing / imagery / states / structure / auto-layout intent) per the `code-reviewer` UI / Figma parity gate. Bind to the `mockup-review.md` `## Design contract` and the **`design-tokens-binding.mdc`** discipline (`@sds/tokens-*` / DS components, no raw `#…` / `px` where a token exists).
+- Findings: `path:line` + Figma node id + viewport + severity. Emit a `## Figma parity (UI)` section in `review.md`.
+- **Storybook visual baselines are not a substitute.** Approving a UI MR on Storybook baselines alone is not acceptable when a Figma reference exists.
+- Missing or `unable_to_compare` parity section on a UI-touching MR with a Figma reference → `REQUEST_CHANGES`. Unbound raw values where a token exists (typography / color / spacing / imagery) → `blocker` / `important`. The full gate lives in the `code-reviewer` agent prompt; this rule cross-references it.

package/presets/opencode/next/rules/design-tokens-binding.md

@@ -0,0 +1,35 @@
+# Design-token binding (Figma → repo)
+
+The implementation must mirror the Figma mockup token-for-token. Raw design values where a token exists are a finding. This rule is the web-stack discipline; the reporter (`mockup-reviewer`) emits the bindings, the implementer (`feature-developer`) binds, the reviewer (`code-reviewer`) blocks on unbound raw values.
+
+## Typography
+
+- Bind to the Figma **text style** used by the node — extract via Figma MCP `get_design_context` / `get_variable_defs` and the node metadata. Do not invent `font-size: 14px; line-height: 20px;` when a Figma text style exists.
+- Repo mapping: font family, size, line-height, weight, letter-spacing → `@sds/tokens-typography` (or the project token module). In Linaria / styled: `font: var(--font-body-m, …)` / equivalent token.
+- Prefer a typography variant / DS text component that already binds the token (e.g. `Text variant="body-m"`) over a styled wrapper with raw values.
+
+## Color
+
+- Bind to the Figma **fill / stroke variable** (`get_variable_defs`). Do not write raw `#…` or `rgb(…)`.
+- Repo mapping: `@sds/tokens-colors`, `@sds/brand-colors`, or the project token module (`color: var(--text-primary, …)`).
+- A raw value is allowed only with an inline `// token-pending: <Figma-variable-name>` comment and a follow-up to bind it. The reviewer treats unbound raw values as a finding.
+
+## Spacing / radius / shadow
+
+- Bind to Figma **spacing / radius / effect variables** or the repo spacing scale. Do not write raw `padding: 16px; gap: 12px;` if a token exists.
+- Repo mapping: spacing tokens from `@sds/tokens` / the project scale; Linaria `css\`…\`` uses `var(--space-…, …)`.
+- **Auto-layout intent:** respect Figma auto-layout (direction, gap, padding, alignment). Switching to absolute positioning for a region that is the only responsive evidence is a finding. `display: flex` with the same gap/padding is the safe mirror; do not reflow to a different layout without a reason in the brief.
+
+## Imagery & icons
+
+- **Images:** use the Figma asset source from `get_design_context` / the node’s image fill. Repo: `next/image` (or repo convention) with `src`, `width`, `height` derived from Figma. Do not use a placeholder, do not invent a URL, do not change aspect ratio.
+- **Icons:** use the `@sds/icon` (or project DS) symbol name from the Figma component instance / metadata. Do not invent icon names. The Figma node’s component name (e.g. `Icon / chevron-right`) maps to the DS symbol.
+- `alt` text from the Figma node name when meaningful; otherwise from the design context copy.
+
+## Self-check before handoff
+
+For UI WPs with a Figma reference: render the page at each project viewport (Playwright MCP / Chrome DevTools MCP) and compare to the Figma `get_screenshot`. Fix obvious typography / color / spacing / imagery deviations before the implementation receipt. Record a short **UI self-check vs Figma** block in `implementation.md` (viewports checked, deviations fixed, remaining gaps, MCP / app status). If the app is not runnable or MCP is down, note the limitation — the reviewer will gate.
+
+## Reviewer contract
+
+The `code-reviewer` UI / Figma parity gate enforces this. A UI-touching MR with a Figma reference and unbound raw values where tokens exist → `blocker` (user-visible) or `important` (latent). Missing self-check on a UI WP with a Figma reference → `important`.

package/presets/opencode/next/rules/feature-delivery-workflow.md

@@ -56,6 +56,23 @@ When the prompt or `brief.md` contains a `figma.com` URL, **mockup review** (`mo
 
 Before writing a new file in a layer, open **1–2 analog files** in the same layer and mirror: export shape, name prefixes (`T` / `I` where the repo uses them), file suffixes (`.apiMethods.ts`, `.endpoints.ts`, `.data.ts`, `.hooks.ts`, `styles.ts`), mapper / selector / thunk naming, and barrel shape. Record the analogs in the handoff. Where this preset's examples differ from the repo, **the repo wins**.
 
+## Figma node-link — child→component decomposition (mandatory pre-implementation)
+
+When the prompt or `brief.md` contains a Figma URL with a node id (`?node-id=…`), `mockup-reviewer` must walk the node subtree via Figma MCP and emit **two sections** in `mockup-review.md`:
+
+- `## Design contract` — Figma variables, text styles, components/assets used by the subtree, with the repo mapping (`@sds/tokens-colors` / `@sds/brand-colors` / `@sds/tokens-typography` / `@sds/tokens` / DS components / `next/image` with Figma-derived `src/width/height`). This is the binding table the developer uses for typography, color, spacing, and imagery.
+- `## Node decomposition (AC-2)` — the child→component map (with a `Bindings` column for the Figma design bindings).
+
+`feature-developer` must **not** start UI implementation until both sections are present, and must load requestable `design-tokens-binding.mdc` to bind every value to a Figma variable / text style / repo token (raw `#…` / `px` are a finding). The full procedure and verdict rule live in the `mockup-reviewer` agent prompt and the `mockup-review` Stack notes.
+
+## UI MR — Figma parity gate (mandatory in code review)
+
+When the MR touches UI / layout / styling (`app/src/ui/**`, global layout/CSS/tokens) and a Figma reference exists in `brief.md` / `decomposition.md` or `mockup-review.md` is present, `code-reviewer` must 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). The comparison is a per-element parity check (typography / color / spacing / imagery / states / structure / auto-layout intent) bound to the `## Design contract` and the `design-tokens-binding.mdc` discipline. Findings go in `## Figma parity (UI)` 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`. The full gate lives in the `code-reviewer` agent prompt and the `code-review-mr` Stack notes.
+
+## UI self-check vs Figma (mandatory in implementation)
+
+For UI WPs with a Figma reference, `feature-developer` performs a **self-check vs Figma** at each project viewport (Playwright MCP / Chrome DevTools MCP) before the implementation receipt, fixes obvious typography / color / spacing / imagery / state deviations, and records a `## UI self-check vs Figma` block in `implementation.md`. This is the developer-side counterpart to the parity gate and closes the fidelity loop (extract contract → bind → self-check → review-block).
+
 Typical feature with backend data and shared state. Layer details — `architecture-boundaries.mdc`, `next-app-core.mdc`.
 
 ## Checklist (work order)

package/presets/opencode/next/rules/mockup-review.md

@@ -109,3 +109,12 @@ PASS | PASS_WITH_NOTES | FAIL | BLOCKED_MCP
 ## Stack notes
 
 Illustrative web buckets (not enforced pixels): ~375 / ~768 / ~1280 mapped to small / medium / large.
+
+### Node-link input (AC-2) — child→component decomposition + Design contract (mandatory)
+
+When the Figma URL contains a node id (`?node-id=…`), `mockup-reviewer` must:
+
+1. Walk the node subtree via Figma MCP `get_metadata` and emit a **Node→component map** (each child node id/name/type → target `app/src/ui/**` component, attached library component (e.g. `@sds/*`), or `new: <ProposedName>`). The map goes in `mockup-review.md` under `## Node decomposition (AC-2)` as a table plus a short prose summary, with a `Bindings` column / per-row note for the Figma design bindings.
+2. Extract the **Design contract** (above the Node decomposition table): Figma variables used by the subtree (color, spacing, radius, effect — one `get_variable_defs` call per file), text styles used, and components / assets (library instances, image fills via `get_design_context`, icons). Each item mapped to the repo equivalent: `@sds/tokens-colors` / `@sds/brand-colors` / `@sds/tokens-typography` / `@sds/tokens` / DS component (`@sds/icon` symbol name, `Text variant="…"`) / `next/image` with Figma-derived `src/width/height`.
+
+Both sections are the **pre-implementation contract** the developer reads before coding; the DS/tokens/quality/coverage/viewport dimensions still apply on top. Verdict: missing map **or** missing Design contract on a node-link input → `FAIL` (unless `BLOCKED_MCP`). The developer (`feature-developer`) must not start UI work until both sections are present, and must bind implementation to the Design contract (see `design-tokens-binding.mdc`).