@bonesofspring/ai-rules 0.2.28 → 0.2.29

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": "d4543a561129f18289d5c83d94038bbf7a973c57bb498f9b58c2ed37ceca3a07",
   "entries": [
     {
       "source": "AGENTS.md",

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

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

@@ -22,7 +22,7 @@
     ".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": "a0153f5b3a97dc9222e7465577a2dbc03a4b03526663a1ec55e27f4c2ac51979",
+    ".claude/CLAUDE.md": "2adbeb71dbadbaefeb4f7576e6ce5db395f7bfd566b665532e156265f9457293",
     ".claude/MCP.md": "a40a7f9cd8a11a031a5fb3f2e4ccdb6cb2186461600146765d3255990e6133d0",
     ".claude/agents/README.md": "98fd8018a96eb924977217f81eb9cf966e88dee151b60af2c7c94ae2a8b32730",
     ".claude/agents/accessibility-reviewer.md": "795072716b23b0ce3b95703bbaf4de963f24308088046c6656066e0b34c792e1",
@@ -54,14 +54,14 @@
     ".claude/commands/task-continue.md": "8c2bec3c204c25910e8fc349c571778275905380e90d8bd02c0092c83ecfe6f6",
     ".claude/commands/task.md": "4db4b9245e7d5d0d56fb06d86196502aa8fa6487c747c2c103d09da27b02941e",
     ".claude/commands/technical-retro.md": "6195206cc687645fadcbe011306f6c62f1d082508c9182d880e5e4485d17214c",
-    ".claude/hooks/README.md": "2d76085d8319a9c6cf579800fba52288bd43e29d2434df31a28d34d2a4a6a61d",
-    ".claude/hooks/chain-team-phases.sh": "ab0f689747f3f79b6cbb598c0d2b8cba8a694322f9902d7d853be6862565f5fc",
-    ".claude/hooks/examples/README.md": "e287392fe719476053a1998d35fe08924be58f065e9d2bfdab7727a050ba7efe",
+    ".claude/hooks/README.md": "dc22793bce005fa1b29960f44fb9162de47095a501ce639239ae7210b7cb9003",
+    ".claude/hooks/chain-team-phases.sh": "e6790f4512bba38a17ba7f13ec9c1dc1a00db423e9ece24bf6c359107039a585",
+    ".claude/hooks/examples/README.md": "c5bdc1398bdaad95a15051d75c9f896f5c4991d66641982e675db648e9591813",
     ".claude/hooks/examples/format-edited.example.sh": "fd4df1d6c2a5673f963febd4f3f21ec8c42899645bdc53144d713c66b2affc76",
     ".claude/hooks/examples/secret-guard.example.sh": "51cbc95c3a1b64dfc5b19901932b4e3a047ade9332451282f254bf5f8d45a58f",
     ".claude/hooks/examples/test-on-save.example.sh": "ae185e383811e2f8f89ae5f631993705c06fc8cf7216cf8f0862a5b55c64ca2a",
-    ".claude/hooks/guard-shell-command.sh": "d1eae59b78aac8155668528ceb87abaf54624466a60f7d2df8716c25aad3fe96",
-    ".claude/rules/README.md": "f047c1fb6cd7ffbeee5cd8e7dd958db41a404c275c50a16e1b02ce6b5754caf4",
+    ".claude/hooks/guard-shell-command.sh": "31e1451148c17aedbcc2e9f372e50f079624f2624fb93505ba74850543749c75",
+    ".claude/rules/README.md": "8fb263352c7c2325fafb0ff2b6f7a328e47ac974cc730a14e5764aedea349e02",
     ".claude/rules/anti-hallucination/react-next-anti-hallucination.md": "021d22a4178aad43b8ba8b332cc677dbe8130a0cf673407acbb34d47c5367d32",
     ".claude/rules/api-and-data/README.md": "1caace24921f00d60a58bea551988abd15c32f13a2711ae799ce1e689b838de2",
     ".claude/rules/api-and-data/api-services.md": "30b50d49c4281c4e0f9169d453c285f7dfc828d9991520e0c204101b5b634cb9",
@@ -91,7 +91,7 @@
     ".claude/rules/tooling-and-review/README.md": "27a956fa7fa68c58cd17a9b598580b06cb2241aadef29e3b647a31ab418d99ec",
     ".claude/rules/tooling-and-review/agent-team-intake.md": "e05a5879d587a9c4774e9e36cfcadca5664eedaabe02051745fb6c87a6143e42",
     ".claude/rules/tooling-and-review/agent-team-orchestrator.md": "810afc6e3d3a97b652af215bbc03433727b87c063d79613e3588e1d955d192d6",
-    ".claude/rules/tooling-and-review/ai-local-overlay.md": "2b8373351357a6df002e714302c130c6e79dd90c5a9cc852e45271f09b7d2726",
+    ".claude/rules/tooling-and-review/ai-local-overlay.md": "bb96bf00cf76c58d5db4e6c12622164b0d700d8330e9805c0aa7c1542bffbde4",
     ".claude/rules/tooling-and-review/anti-sycophancy-discipline.md": "6d359631dde6dbe6588397aa1108752cfdad9764d90d6d9da31606a463b72226",
     ".claude/rules/tooling-and-review/code-quality.md": "fc764e9fbf7101475fc709a4610d09758a3a959f2fe82d3d1a487f2c8556c1b4",
     ".claude/rules/tooling-and-review/code-review-mr.md": "30b31277be1f6df878712d79cb54bc157edb97640e3bc7e77c0121273821ab03",
@@ -102,7 +102,7 @@
     ".claude/rules/tooling-and-review/post-change-lint.md": "ea16a0311ef354c101efc697e738d852742f74f60f49f421b776ccf0e19ad53c",
     ".claude/rules/tooling-and-review/preset-layering.md": "006b9ea97f55d039debc16847ac9b0bfae6b26b56f44e812081ddd65760289ca",
     ".claude/rules/tooling-and-review/preset-no-cross-stack-leakage.md": "01e045b7f6f5a472581804499ec97dc4296264da90e3a6e3a25807501a300dad",
-    ".claude/rules/tooling-and-review/preset-pr-checklist.md": "d89e936da90b0f5a8ee23292a5f78946dc10fb53ae55f9aad20d6674d378fa40",
+    ".claude/rules/tooling-and-review/preset-pr-checklist.md": "769addcfbde87d6681291ee038ff57842e03a4634dbc90f2562fb95efd5fc625",
     ".claude/rules/tooling-and-review/preset-token-budget.md": "bc22059a066d3ba21d8813f5e50d5cc9eef3a28860372d122d31b50977438e18",
     ".claude/rules/tooling-and-review/preset-twin-sync.md": "bdd98171bc8218fdd84834aa8051e8c899f87bb1063f9a5fd539af1154cb618f",
     ".claude/rules/tooling-and-review/security-next.md": "3e5c733925a0040928a9fbb7d841e69a471a03c5cb02d2fa986b81d29d7e31ca",
@@ -113,7 +113,7 @@
     ".claude/rules/ui-and-accessibility/no-props-spread.md": "60aa9ca9c94db981bcceb05a090734e540644febfa88f4e40089f5d16a8a5d7f",
     ".claude/rules/ui-and-accessibility/react-a11y-coding.md": "8709f43c13f7071b2cd645c29b171de218551c3895479901efa1a817585b245d",
     ".claude/rules/ui-and-accessibility/react-ui.md": "06233a81f4eb4d6686f5a5ced351ddde43aed2cf753d6a6be072e6507b71572f",
-    ".claude/settings.json": "0380e1d6160f208f95edfcee0f8a8251a20dbc24e33a702ff87334533ea8f3a1",
+    ".claude/settings.json": "930a46deffc5aee8161328b29ca7122d32a8434415988462f3be6578fcf5036f",
     ".claude/skills/README.md": "1aeac616a5270d0ce6be132a3dff3e0bbca1371191503f0ecf3eeeeea5b4e9f3",
     ".claude/skills/ci-investigation/SKILL.md": "b13ed9de0716671b7d192dc2ba7fec139466a933b52f25c075623dcdef38b399",
     ".claude/skills/code-review/SKILL.md": "068f995e00e4baa4baf02098cef865fd837f3dad33a5c063b778aa84b0878b02",
@@ -129,7 +129,7 @@
     ".claude/skills/ux-design/SKILL.md": "74b70875ba3d41ffb8401c42bc8c9e442e73b36c6a6b0d8d9d2aae0a6017479c",
     ".claude/skills/write-adr/SKILL.md": "607d70eff78d6a7b67b783237721fdc42eaa5170cb6175882e7e2a4adf132242",
     ".mcp.json": "f68a14db68a491a982975a3e6cc985057072a68eebdcedf33d8ac2a4a3b284ca",
-    "AGENTS.md": "2d3c64960ee9adb11d850ce5da390d3c9571d1e9a02f1fd7114f5ea68d00c6ff",
+    "AGENTS.md": "dbfbbb0fb243c67bed8c02dd2ba45dfc92163ebed8914d7dee6e8d359638ec08",
     "docs/specs/INDEX.md": "cab59f2093e6aaa376246a56d53e4268cb59070a6b10e87a94895192c35f422d",
     "docs/specs/_templates/feature.md": "83c47b90334c555fb5144749837e2ddfe1cae5bb89031f885ba98671075d59e7",
     "docs/specs/_templates/page.md": "a668c584e28edd52afaf3f9f8f898a75e43cb82fa12822c7a016033441e12e54"