@bonesofspring/ai-rules 0.2.31 → 0.2.32

package/presets/mavis/svelte/rules/code-review-mr.md

@@ -45,9 +45,9 @@ On-demand rule for review flows. **Procedure and output format:** skill `code-re
 
 ### Checklist references
 
-- Architecture layers: `architecture-boundaries.mdc`, `svelte-app-core.mdc`; network: `http-client.mdc`
-- Imports: `public-imports.mdc`, `layer-barrel-exports.mdc`
-- UI: `svelte-ui.mdc`
-- Security: `security-sveltekit.mdc`
-- Tests: `tests-unit.mdc`, `playwright-agents.mdc`, `tests-e2e-structure.mdc`
-- Lint gate before final report: `post-change-lint.mdc`
+- Architecture layers: `architecture-boundaries.md`, `svelte-app-core.md`; network: `http-client.md`
+- Imports: `public-imports.md`, `layer-barrel-exports.md`
+- UI: `svelte-ui.md`
+- Security: `security-sveltekit.md`
+- Tests: `tests-unit.md`, `playwright-agents.md`, `tests-e2e-structure.md`
+- Lint gate before final report: `post-change-lint.md`

package/presets/mavis/svelte/rules/feature-delivery-workflow.md

@@ -52,7 +52,7 @@ Filled in the stack adapter: concrete globs/paths and `.mdc` / topic `.md` names
 
 When the prompt or `brief.md` contains a `figma.com` URL, **mockup review** (`mockup-reviewer` / skill `mockup-review`) must complete — or the user must continue past FAIL/`BLOCKED_MCP` via `/task-continue` — **before UI implementation**. Non-UI tasks no-op this gate. When required-signal and **no** `figma.com`, **`ux-design.md`** (on the analysis manifest entry) must exist and not be `INCOMPLETE` before UI work — else **blocked**, hand back to `task-analyst`. Parallel to the mockup gate.
 
-Typical feature with backend data and shared state. Layer details — `architecture-boundaries.mdc`, `svelte-app-core.mdc`.
+Typical feature with backend data and shared state. Layer details — `architecture-boundaries.md`, `svelte-app-core.md`.
 
 Canonical paths: `src/routes/**`, `src/lib/{components,stores,api,clients,types}/**`, `tests/e2e/**`. Aliases: `$lib` preferred; `@/` if configured. State: `store-svelte` (runes primary; legacy stores secondary).
 

package/presets/mavis/svelte/rules/reference-features.md

@@ -77,6 +77,6 @@ Post-init gotchas / patterns / decisions: **`.ai.local/conventions.md`** (shared
 
 ## Related rules
 
-- `code-quality-and-refactoring.mdc` — repeat patterns; no deep-import.
-- `feature-delivery-workflow.mdc` — layer order.
+- `code-quality-and-refactoring.md` — repeat patterns; no deep-import.
+- `feature-delivery-workflow.md` — layer order.
 - skill `feature-delivery` — end-to-end scenario.

package/presets/mavis/svelte/rules/tests-e2e-structure.md

@@ -84,5 +84,5 @@ Bad (no capital after period; or wrong locale for configured ESLint):
 - `PREFIX-XXX` example: `OrderHistory` → `OH`, `BillingReport` → `BR`.
 - Russian example: `test('OH-001 Отображается список заказов', async ({ page }) => { ... })` <!-- i18n-keep: E5 --> (Order list is displayed).
 - Page object example filename: `OrderHistoryPage.ts`.
-- Cross-reference: See also **`playwright-agents.mdc`**.
+- Cross-reference: See also **`playwright-agents.md`**.
 - `## Stack notes` content is stripped by `scripts/check-shared-core-drift.sh` before byte-comparing this file against `_shared/core/testing/testing-principles.md`; keep prose above (core content) verbatim against the core file.

package/presets/opencode/android-kotlin/adapter-map.json

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

package/presets/opencode/android-kotlin/rules/agent-team-orchestrator.md

@@ -109,8 +109,7 @@ Each slug has one `artifact-manifest.json` at `.ai.local/team/tasks/<slug>/`. Th
 
 - Read the manifest before broad prior-artifact discovery. Each step receives authoritative input entry IDs, owns named output entry IDs, and finishes with one terminal receipt linked to AC/task IDs.
 - Markdown remains detailed evidence; the manifest points to authoritative paths and records producer, status, timestamps, outcome, and evidence paths.
-- 
-                  Agents upsert only the items in `manifest.artifacts[]` they own and preserve foreign items. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges.
+- Agents upsert only the items they own in `manifest.artifacts[]` and preserve all foreign items in that array. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges. The top-level array key is `artifacts` — not `entries`; see `agent-artifact-contracts.md` for the schema callout.
 - The orchestration runtime/hook is the single writer for `status.json` lifecycle fields and `metrics.json`. Agents read status for eligibility but never rewrite unrelated state, gate, retry, attempt, timestamp, or metrics fields.
 - Missing/stale manifests are reported as a handoff gap; fall back to `brief.md`, `decomposition.md`, and `pipeline.json` rather than inventing authority.
 

package/presets/opencode/android-kotlin/rules/code-review-mr.md

@@ -48,7 +48,7 @@ On-demand rule for review flows (not always-on).
   - Rely on the local repository: branch, `git diff`, open files.
 
 - **What the agent must check**
-  - **Architecture and layers** (`architecture-boundaries.mdc`, `android-app-core.mdc`):
+  - **Architecture and layers** (`architecture-boundaries.md`, `android-app-core.md`):
     - View does not call APIs and does not know DTOs.
     - ViewModel does not depend on Data implementations directly.
     - Domain does not import Jetpack Compose/Android View system.
@@ -57,21 +57,21 @@ On-demand rule for review flows (not always-on).
     - DI via protocols; composition / holders in `applications/` + feature DI.
     - No deep-import between features.
     - Files in the correct layers (`presentation`, `domain`, `data`, design-system / `api`/`impl`).
-  - **Kotlin and concurrency** (`kotlin-conventions.mdc`):
+  - **Kotlin and concurrency** (`kotlin-conventions.md`):
     - `main-safe / viewModelScope` on UI; no unjustified `!!`s.
     - Typed errors; structured concurrency / cancellation where needed.
-  - **UI** (`compose-ui.mdc`):
+  - **UI** (`compose-ui.md`):
     - Thin Views; Design System tokens; semantics / content descriptions for testable elements.
-  - **Networking and data** (`networking-data.mdc`):
+  - **Networking and data** (`networking-data.md`):
     - DTOs separated from domain; mappers cover edge cases.
   - **Tests**:
-    - Non-trivial logic — unit (`tests-unit.mdc`); user flows — UI (`tests-ui.mdc`).
+    - Non-trivial logic — unit (`tests-unit.md`); user flows — UI (`tests-ui.md`).
     - State which tests to add or update.
 
 - **Depth and format**
   - Focus on the **MR diff**, not the whole project.
   - Overview first (MR goal, risks), then concrete comments with file and a fix suggestion matching repo patterns.
-  - No “big refactors” without a request (`code-quality-and-refactoring.mdc`).
+  - No “big refactors” without a request (`code-quality-and-refactoring.md`).
 
 - **Constraints**
   - Do not invent CI/MR hosting metadata without local data.

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

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

package/presets/opencode/go/rules/agent-team-orchestrator.md

@@ -109,8 +109,7 @@ Each slug has one `artifact-manifest.json` at `.ai.local/team/tasks/<slug>/`. Th
 
 - Read the manifest before broad prior-artifact discovery. Each step receives authoritative input entry IDs, owns named output entry IDs, and finishes with one terminal receipt linked to AC/task IDs.
 - Markdown remains detailed evidence; the manifest points to authoritative paths and records producer, status, timestamps, outcome, and evidence paths.
-- 
-                  Agents upsert only the items in `manifest.artifacts[]` they own and preserve foreign items. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges.
+- Agents upsert only the items they own in `manifest.artifacts[]` and preserve all foreign items in that array. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges. The top-level array key is `artifacts` — not `entries`; see `agent-artifact-contracts.md` for the schema callout.
 - The orchestration runtime/hook is the single writer for `status.json` lifecycle fields and `metrics.json`. Agents read status for eligibility but never rewrite unrelated state, gate, retry, attempt, timestamp, or metrics fields.
 - Missing/stale manifests are reported as a handoff gap; fall back to `brief.md`, `decomposition.md`, and `pipeline.json` rather than inventing authority.
 

package/presets/opencode/go/rules/code-quality-and-refactoring.md

@@ -51,5 +51,5 @@ Style enforcement (formatter / linter / post-change gate) lives in the **stack t
 - Public API between packages: exported types/funcs in `pkg/` or explicit ports — avoid deep imports of another feature's `internal`.
 - Prefer wrapping errors with `%w`; check with `errors.Is` / `errors.As`.
 - Interfaces belong at **ports** (consumer side), not on every struct.
-- Post-change gate: **`post-change-test.mdc`** + **`go-tooling.mdc`** (not yarn lint / xcodebuild).
+- Post-change gate: **`post-change-test.md`** + **`go-tooling.md`** (not yarn lint / xcodebuild).
 - Style: **gofmt** / **goimports** + **golangci-lint** when configured — authoritative style gate; do not duplicate linter rules in prose.

package/presets/opencode/ios-swift/adapter-map.json

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

package/presets/opencode/ios-swift/rules/agent-team-orchestrator.md

@@ -109,8 +109,7 @@ Each slug has one `artifact-manifest.json` at `.ai.local/team/tasks/<slug>/`. Th
 
 - Read the manifest before broad prior-artifact discovery. Each step receives authoritative input entry IDs, owns named output entry IDs, and finishes with one terminal receipt linked to AC/task IDs.
 - Markdown remains detailed evidence; the manifest points to authoritative paths and records producer, status, timestamps, outcome, and evidence paths.
-- 
-                  Agents upsert only the items in `manifest.artifacts[]` they own and preserve foreign items. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges.
+- Agents upsert only the items they own in `manifest.artifacts[]` and preserve all foreign items in that array. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges. The top-level array key is `artifacts` — not `entries`; see `agent-artifact-contracts.md` for the schema callout.
 - The orchestration runtime/hook is the single writer for `status.json` lifecycle fields and `metrics.json`. Agents read status for eligibility but never rewrite unrelated state, gate, retry, attempt, timestamp, or metrics fields.
 - Missing/stale manifests are reported as a handoff gap; fall back to `brief.md`, `decomposition.md`, and `pipeline.json` rather than inventing authority.
 

package/presets/opencode/ios-swift/rules/code-quality-and-refactoring.md

@@ -50,5 +50,5 @@ Style enforcement (formatter / linter / post-change gate) lives in the **stack t
 - Before adding a new UI control, check DesignSystem and existing components.
 - Public API: protocols and facades between features.
 - Acceptable examples: shared mapper/validation; replace force unwrap; split an overloaded ViewModel into use cases; design tokens instead of magic numbers/colors; remove a direct View→Data dependency in favor of a protocol.
-- Post-change gate: **`post-change-build.mdc`** + `xcode-tooling.mdc` (not yarn lint).
+- Post-change gate: **`post-change-build.md`** + `xcode-tooling.md` (not yarn lint).
 - Style: **SwiftLint** (+ SwiftFormat when configured) — authoritative style gate; do not duplicate linter rules in prose.

package/presets/opencode/ios-swift/rules/code-review-mr.md

@@ -48,7 +48,7 @@ On-demand rule for review flows (not always-on).
   - Rely on the local repository: branch, `git diff`, open files.
 
 - **What the agent must check**
-  - **Architecture and layers** (`architecture-boundaries.mdc`, `ios-app-core.mdc`):
+  - **Architecture and layers** (`architecture-boundaries.md`, `ios-app-core.md`):
     - View does not call APIs and does not know DTOs.
     - ViewModel does not depend on Data implementations directly.
     - Domain does not import SwiftUI/UIKit.
@@ -57,21 +57,21 @@ On-demand rule for review flows (not always-on).
     - DI via protocols; composition root in App.
     - No deep-import between features.
     - Files in the correct layers (`Presentation`, `Domain`, `Data`, `DesignSystem`).
-  - **Swift and concurrency** (`swift-conventions.mdc`):
+  - **Swift and concurrency** (`swift-conventions.md`):
     - `@MainActor` on UI; no unjustified force unwraps.
     - Typed errors; correct Task cancellation where needed.
-  - **UI** (`swiftui-ui.mdc`):
+  - **UI** (`swiftui-ui.md`):
     - Thin Views; Design System tokens; accessibility identifiers for testable elements.
-  - **Networking and data** (`networking-services.mdc`):
+  - **Networking and data** (`networking-services.md`):
     - DTOs separated from domain; mappers cover edge cases.
   - **Tests**:
-    - Non-trivial logic — unit (`tests-unit.mdc`); user flows — UI (`tests-ui.mdc`).
+    - Non-trivial logic — unit (`tests-unit.md`); user flows — UI (`tests-ui.md`).
     - State which tests to add or update.
 
 - **Depth and format**
   - Focus on the **MR diff**, not the whole project.
   - Overview first (MR goal, risks), then concrete comments with file and a fix suggestion matching repo patterns.
-  - No “big refactors” without a request (`code-quality-and-refactoring.mdc`).
+  - No “big refactors” without a request (`code-quality-and-refactoring.md`).
 
 - **Constraints**
   - Do not invent CI/MR hosting metadata without local data.

package/presets/opencode/ios-swift/rules/feature-delivery-workflow.md

@@ -52,16 +52,16 @@ Filled in the stack adapter: concrete globs/paths and `.mdc` / topic `.md` names
 
 When the prompt or `brief.md` contains a `figma.com` URL, **mockup review** (`mockup-reviewer` / skill `mockup-review`) must complete — or the user must continue past FAIL/`BLOCKED_MCP` via `/task-continue` — **before UI implementation**. Non-UI tasks no-op this gate. When required-signal and **no** `figma.com`, **`ux-design.md`** (on the analysis manifest entry) must exist and not be `INCOMPLETE` before UI work — else **blocked**, hand back to `task-analyst`. Parallel to the mockup gate.
 
-Typical feature with data and UI. Layer details — `architecture-boundaries.mdc`, `ios-app-core.mdc`.
+Typical feature with data and UI. Layer details — `architecture-boundaries.md`, `ios-app-core.md`.
 
 ## Checklist (work order)
 
 1. **Domain** — entities, value types, repository / use case protocols (`Features/**/Domain/**`).
-2. **Data** — DTOs (`Codable`), Domain ↔ DTO mappers, repository implementations, API client (`networking-services.mdc`).
-3. **ViewModel** — state, use case / protocol calls; DI from App; no DTOs or URLs (`state-and-viewmodels.mdc`).
-4. **View / navigation** — thin SwiftUI Views, Design System; navigation as in the repo (`swiftui-ui.mdc`).
-5. **Tests** — unit for mappers / use cases / VM (`tests-unit.mdc`); UI flows — XCUITest (`tests-ui.mdc`).
-6. **Completion** — **invoke** `post-change-build.mdc` (+ `xcode-tooling.mdc` for schemes/commands): build touched targets + lint/format per repo config. When the current WP spans **more than one** layer or module, `implementation.md` includes a **Code Map** (3–8 annotated paths) and **Suggested Review Order** (`concern | path:line | ≤15 word note`). Omit both for a single-file or single-layer WP.
+2. **Data** — DTOs (`Codable`), Domain ↔ DTO mappers, repository implementations, API client (`networking-services.md`).
+3. **ViewModel** — state, use case / protocol calls; DI from App; no DTOs or URLs (`state-and-viewmodels.md`).
+4. **View / navigation** — thin SwiftUI Views, Design System; navigation as in the repo (`swiftui-ui.md`).
+5. **Tests** — unit for mappers / use cases / VM (`tests-unit.md`); UI flows — XCUITest (`tests-ui.md`).
+6. **Completion** — **invoke** `post-change-build.md` (+ `xcode-tooling.md` for schemes/commands): build touched targets + lint/format per repo config. When the current WP spans **more than one** layer or module, `implementation.md` includes a **Code Map** (3–8 annotated paths) and **Suggested Review Order** (`concern | path:line | ≤15 word note`). Omit both for a single-file or single-layer WP.
 
 ## Data flow (orientation)
 
@@ -99,14 +99,14 @@ flowchart LR
 
 | Zone | Rules |
 |------|---------|
-| `Features/**/Domain/**`, `Core/Domain/**` | `architecture-boundaries.mdc`, `ios-app-core.mdc` |
-| `Features/**/Data/**`, `**/Network*/**` | `networking-services.mdc`, `architecture-boundaries.mdc` |
-| `*ViewModel*.swift`, Presentation state | `state-and-viewmodels.mdc` |
-| `Presentation/**`, `DesignSystem/**` | `swiftui-ui.mdc`, `architecture-boundaries.mdc` |
-| `**/*.swift` (style) | `swift-conventions.mdc` |
-| `*Tests/**` | `tests-unit.mdc` |
-| `*UITests/**` | `tests-ui.mdc` |
-| After Swift edits | `post-change-build.mdc` |
+| `Features/**/Domain/**`, `Core/Domain/**` | `architecture-boundaries.md`, `ios-app-core.md` |
+| `Features/**/Data/**`, `**/Network*/**` | `networking-services.md`, `architecture-boundaries.md` |
+| `*ViewModel*.swift`, Presentation state | `state-and-viewmodels.md` |
+| `Presentation/**`, `DesignSystem/**` | `swiftui-ui.md`, `architecture-boundaries.md` |
+| `**/*.swift` (style) | `swift-conventions.md` |
+| `*Tests/**` | `tests-unit.md` |
+| `*UITests/**` | `tests-ui.md` |
+| After Swift edits | `post-change-build.md` |
 
 When adding or extending a feature, **walk the checklist** and the table rules for touched zones.
 

package/presets/opencode/ios-swift/rules/reference-features.md

@@ -81,7 +81,7 @@ Run after preset init (manual smoke for agents):
 2. ViewModel bug — debugger → fix → unit test.
 3. DTO↔domain mapper — unit-test-planner/generator.
 4. UI flow — `xcuitest-test-planner` → generator (accessibilityIdentifier).
-5. Auth/Keychain touch — security-reviewer + `security-ios.mdc`.
+5. Auth/Keychain touch — security-reviewer + `security-ios.md`.
 
 ## Living conventions
 
@@ -89,6 +89,6 @@ Post-init gotchas / patterns / decisions: **`.ai.local/conventions.md`** (shared
 
 ## Related rules
 
-- `code-quality-and-refactoring.mdc` — repeat patterns.
-- `feature-delivery-workflow.mdc` — layer order.
+- `code-quality-and-refactoring.md` — repeat patterns.
+- `feature-delivery-workflow.md` — layer order.
 - skill `feature-delivery` — end-to-end scenario.

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

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

package/presets/opencode/java/rules/agent-team-orchestrator.md

@@ -109,8 +109,7 @@ Each slug has one `artifact-manifest.json` at `.ai.local/team/tasks/<slug>/`. Th
 
 - Read the manifest before broad prior-artifact discovery. Each step receives authoritative input entry IDs, owns named output entry IDs, and finishes with one terminal receipt linked to AC/task IDs.
 - Markdown remains detailed evidence; the manifest points to authoritative paths and records producer, status, timestamps, outcome, and evidence paths.
-- 
-                  Agents upsert only the items in `manifest.artifacts[]` they own and preserve foreign items. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges.
+- Agents upsert only the items they own in `manifest.artifacts[]` and preserve all foreign items in that array. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges. The top-level array key is `artifacts` — not `entries`; see `agent-artifact-contracts.md` for the schema callout.
 - The orchestration runtime/hook is the single writer for `status.json` lifecycle fields and `metrics.json`. Agents read status for eligibility but never rewrite unrelated state, gate, retry, attempt, timestamp, or metrics fields.
 - Missing/stale manifests are reported as a handoff gap; fall back to `brief.md`, `decomposition.md`, and `pipeline.json` rather than inventing authority.
 

package/presets/opencode/java/rules/code-quality-and-refactoring.md

@@ -51,5 +51,5 @@ Style enforcement (formatter / linter / post-change gate) lives in the **stack t
 - Public API between packages: exported types in module API or explicit ports — avoid deep imports of another feature's internals.
 - Prefer checked/unchecked exceptions with clear translation at adapter edges; do not leak persistence exceptions upward.
 - Interfaces belong at **ports** (consumer side), not on every class; prefer composition over inheritance.
-- Post-change gate: **`post-change-test.mdc`** + **`java-tooling.mdc`** (not yarn lint / xcodebuild / Playwright).
+- Post-change gate: **`post-change-test.md`** + **`java-tooling.md`** (not yarn lint / xcodebuild / Playwright).
 - Style/static analysis: use **repository/CI** formatter and checks — do not invent a parallel Checkstyle/SpotBugs bible in rules.

package/presets/opencode/mcp-ts/adapter-map.json

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

package/presets/opencode/mcp-ts/rules/agent-team-orchestrator.md

@@ -109,8 +109,7 @@ Each slug has one `artifact-manifest.json` at `.ai.local/team/tasks/<slug>/`. Th
 
 - Read the manifest before broad prior-artifact discovery. Each step receives authoritative input entry IDs, owns named output entry IDs, and finishes with one terminal receipt linked to AC/task IDs.
 - Markdown remains detailed evidence; the manifest points to authoritative paths and records producer, status, timestamps, outcome, and evidence paths.
-- 
-                  Agents upsert only the items in `manifest.artifacts[]` they own and preserve foreign items. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges.
+- Agents upsert only the items they own in `manifest.artifacts[]` and preserve all foreign items in that array. Parallel agents use distinct IDs; the parent/orchestrator serializes manifest merges. The top-level array key is `artifacts` — not `entries`; see `agent-artifact-contracts.md` for the schema callout.
 - The orchestration runtime/hook is the single writer for `status.json` lifecycle fields and `metrics.json`. Agents read status for eligibility but never rewrite unrelated state, gate, retry, attempt, timestamp, or metrics fields.
 - Missing/stale manifests are reported as a handoff gap; fall back to `brief.md`, `decomposition.md`, and `pipeline.json` rather than inventing authority.
 

package/presets/opencode/next/REPO_AGENTS.md

@@ -43,6 +43,8 @@ Working directory for app scripts: **`app/`**. Detect the package manager from l
 
 After code edits: invoke **`post-change-lint`** (requestable). Full gate: agent `build-verifier`.
 
+Repositories with more than one package (e.g. `app/` + `storybook/`) run each package's own scripts from its own directory; do not conflate runners.
+
 ## Security basics
 
 - Do not commit secrets (`.env`, tokens, credentials).
@@ -65,10 +67,18 @@ Skills: `.cursor/skills/`, `.claude/skills/`, `.mavis/skills/`, or `.opencode/sk
 
 Gotchas, local patterns, and team decisions: **`.ai.local/conventions.md`** (fill after init; `init` does not overwrite it).
 
+## Seed library (`.ai.local/rules-library/`)
+
+`init` seeds **staged-inactive** rule templates here (Cursor `.mdc` sources analog: `presets/cursor/next/ai-local/rules-library/**`). They are **not** active until moved into `.ai.local/rules/`. When a seed matches the task scope, apply it and tell the owner to move it. Typical seeds: `router-pages` (Pages Router override), `no-react-fc`, `component-child-decomposition`, `single-source-copy-constants`, `commit-hygiene`, `pre-pr-checklist`, `api-contract-source`, `agent-pipeline-gates`, `task-levels`, `analytics-events`, `feature-flags-experiments`, `pwa-service-worker`, `qa-test-cases`, `forms-validation`, and the `storybook-*` set.
+
+## Managed vs preserved
+
+`init` owns `.cursor/**`, `.claude/**`, `.mavis/**`, `.opencode/**`, root `AGENTS.md`, and the tool MCP config; it **overwrites/merges** them. Durable project config and authoritative specs belong **outside** those trees: `.ai.local/**`, `.ai/context/**`, `docs/specs/**`, `openspec/**`, repo-root `.mcp.json`. After a re-init, re-check any consumer-owned block added to a managed file.
+
 ## Local overlay (`.ai.local/`) — MANDATORY
 
 A `.ai.local/` directory MAY exist at the repo root or at any nesting depth in monorepos. **All agents MUST read and apply it on every turn.** Rules there override preset rules; in conflicts, the local rule wins. `override: kill <preset-rule-name>` drops the named preset rule from the agent's context entirely.
 
-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`.
+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`. Staged seeds live in `.ai.local/rules-library/**`; a matching seed must be moved into `.ai.local/rules/` to activate.
 
 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.