@bonesofspring/ai-rules 0.2.27 → 0.2.28

package/presets/opencode/next/agents/tech-writer.md

@@ -11,6 +11,23 @@ permission:
 
 Write team artifacts under `.ai.local/team/**` and scoped files (`docs/**`). Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/next-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a technical writer for a Next.js frontend team.
 
 ## Inputs

package/presets/opencode/next/agents/unit-test-generator.md

@@ -6,6 +6,24 @@ permission:
   edit: allow
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/next-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/tests-unit.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You generate unit tests from project test plans.
 
 ## Inputs

package/presets/opencode/next/agents/unit-test-healer.md

@@ -6,6 +6,24 @@ permission:
   edit: allow
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/next-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/tests-unit.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You debug and fix failing unit tests.
 
 ## Inputs

package/presets/opencode/next/agents/unit-test-planner.md

@@ -10,6 +10,24 @@ permission:
 
 Write only team artifacts under `.ai.local/team/**`. Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/next-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/tests-unit.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a unit test planner for a Next.js frontend with Jest/Vitest and Testing Library.
 
 Use the **`unit-testing` skill** and **`tests-unit.md`**.

package/presets/opencode/next/ai-local/rules-library/agent-artifacts-no-local-paths.md

@@ -0,0 +1,38 @@
+glob: always
+
+## Body
+
+# Agent artifacts: no local machine paths
+
+When this rule applies, acknowledge: `Using .ai.local: agent-artifacts-no-local-paths(, …)*`.
+
+Committed agent artifacts leak into git history. Absolute host paths expose the developer machine layout even if the file is deleted in a later MR.
+
+## Forbidden
+
+Do **not** write host-absolute paths, including:
+
+- `/Users/<username>/…` (macOS)
+- `/home/<username>/…` (Linux)
+- `C:\Users\<username>\…` and `C:/Users/<username>/…` (Windows)
+- Any other absolute checkout root.
+
+Do **not** put those strings in `productionTarget.root`, `instructions[]`, summaries, or evidence lists.
+
+## Required instead
+
+- This repo: path from workspace root (`src/…`, `.ai.local/team/tasks/<slug>/pipeline.json`).
+- Task-local artifacts: basename is enough (`pipeline.json`, `brief.md`) when the file lives in the same task directory.
+- Sibling / other repo: **repo name** + repo-relative path. Never the filesystem location of that checkout.
+
+## Gate before finishing a write
+
+After writing or editing a team artifact, scan the file (and any JSON you are about to write) for `/Users/`, `/home/`, `C:\Users`, `C:/Users`. If any match, rewrite to repo-relative **before** considering the step done.
+
+Deleting a leaked file later does **not** remove it from git history — prevention is the only fix.
+
+## Allowed (not this ban)
+
+- Repo-relative paths, `@/` aliases, URL paths (`/api/…`).
+- Public URLs (`https://…`, `figma.com/…`).
+- Ephemeral local logs that are **not** committed.

package/presets/opencode/next/ai-local/rules-library/commit-hygiene.md

@@ -0,0 +1,17 @@
+glob: always
+
+## Body
+
+# Commit hygiene
+
+When committing or preparing a commit, acknowledge: `Using .ai.local: commit-hygiene(, …)*`.
+
+Agents do not run `git commit`/`git push`. This rule constrains the **human commit step** and the agent's end-of-turn commit guidance.
+
+## Rules
+
+- **One area per commit.** Do not mix unrelated feature areas or layers in one commit. A commit that spans more than one area tag (or >~40 files) must be split, or the split must be justified in the message.
+- **Never mix trees.** Do not put `src/**` (or any product path) in the same commit as `**/team/tasks/**`, `openspec/**`, `docs/**`, storybook baselines, or config. Artifact/doc churn and source changes go in separate commits.
+- **Owning slug required.** Every commit touching `src/**` names its task slug or ticket id in the subject/body. "cleanup", "restore", "rename", "fix review comments" are not exemptions.
+- **No debug residue.** Do not commit `= true` debug flags, commented-out blocks, or unused exports.
+- **Spike ≠ ship.** A `spike`/`research` task does not commit `src/**` behaviour.

package/presets/opencode/next/ai-local/rules-library/mcp-required-for-ui-layout.md

@@ -0,0 +1,41 @@
+globs: src/ui/**
+
+## Body
+
+# MCP access gate for UI layout work (strict)
+
+Before **any** markup/layout implementation or refactor under `src/ui/**` (JSX structure, Linaria/styled-components, breakpoints, spacing, alignment, CTA placement, card/panel geometry), the agent MUST verify the **session MCP catalog** — it is the source of truth, not this file, not `opencode.json`, not `.opencode/MCP.md`.
+
+Acknowledge: `Using .ai.local: mcp-required-for-ui-layout(, …)*`.
+
+## Categorical ban — layout implementation without Figma MCP **and** Storybook MCP
+
+Implementing or refactoring UI markup/layout is **FORBIDDEN** unless BOTH servers are fully available and usable **in the current session**:
+
+1. **Figma MCP** — can read the real design node: `get_design_context` / `get_metadata` / `get_screenshot` / `get_variable_defs` for the target frame(s). A static image, exported PNG, or someone's description is **not** full access.
+2. **Storybook MCP** — can read story instructions and run the visual/test gate. With `@storybook/addon-mcp` (served by the running dev server at `/mcp`) the real tools are: `get-storybook-story-instructions`, `stories-preview`, `test-run` (docs: `docs-list` / `docs-show`). Tool names differ per MCP implementation — discover them from the session catalog; do not assume names.
+
+If either server is missing, `error`, `needsAuth`, or `loading`:
+
+- **STOP.** Do not edit layout/markup/styles. Do not "approximate from memory".
+- Report exactly: `Blocked: <figma|storybook> MCP unavailable — layout implementation banned (mcp-required-for-ui-layout).`
+- Ask the operator to configure/authenticate the MCP, or to **explicitly change this rule**. The agent MUST NOT self-waive.
+
+A running Storybook dev server (e.g. `localhost:6006`) reached through a browser MCP (chrome-devtools / Playwright) is **not** a substitute for Storybook MCP tooling.
+
+## Playwright MCP — mandatory warning + confirmation
+
+If Playwright MCP is unavailable during UI work:
+
+- Emit a **visible warning** in the turn output (do not bury it).
+- Do **not** start layout work or its verification until the operator confirms (`yes` / `no`).
+- Rationale: Playwright is the fallback for composed-frame, breakpoint, and interaction checks that Storybook MCP cannot cover.
+
+## Scope
+
+- **Banned:** writing/editing layout, markup, styles, breakpoints, spacing, alignment, CTA placement under `src/ui/**`.
+- **Allowed without the gate:** read-only investigation, comparing an existing implementation against a mockup, writing review artifacts (`mockup-review.md`, `perf-report.md`, …). The ban is on implementation, not on analysis.
+
+## Reference
+
+Project strict rule: `.ai.local/rules/00-strict-rules.md`. Adapt the path for your repo (this seed uses `.ai.local`).

package/presets/opencode/next/ai-local/rules-library/no-test-driven-behavior-change.md

@@ -0,0 +1,14 @@
+globs: src/**/*.{ts,tsx}
+
+## Body
+
+# Tests adapt to the product, not the reverse
+
+When editing `src`, tests, or stories, acknowledge: `Using .ai.local: no-test-driven-behavior-change(, …)*`.
+
+## Rules
+
+- Do not change production behaviour (`src/**`) to make a test, story, or e2e case reachable. Fix the test, the fixture, or the mock instead.
+- If a test reveals a genuine product gap, file it as a task; do not silently ship the behaviour change inside a "test stabilisation" commit.
+- Never rewrite `*.cases.md` / QA prose to match an unintended behaviour change. Prose changes that hide a behaviour change are a `blocker` for `code-reviewer`.
+- Removing a `test`/`snapshot` tag or commenting out `play` to go green is forbidden.

package/presets/opencode/next/ai-local/rules-library/pre-pr-checklist.md

@@ -0,0 +1,16 @@
+glob: always
+
+## Body
+
+# Pre-PR checklist
+
+Before opening a PR / finishing a branch, acknowledge: `Using .ai.local: pre-pr-checklist(, …)*`.
+
+## Checklist
+
+- [ ] Commits split: source / artifacts / docs; one area each; no mixed trees
+- [ ] `git status` clean of temp dumps, `* (1).*` copies, debug flags
+- [ ] Lint + type-check + targeted unit + storybook vitest green
+- [ ] e2e plan executed for user-flow AC; mock-path regexes match ≥1 route
+- [ ] L2/L3 `proposal.md` claims reconcile with the shipped diff
+- [ ] Review artifacts cite the reviewed revision (sha)

package/presets/opencode/next/ai-local/rules-library/router-pages.md

@@ -0,0 +1,23 @@
+override: kill next-app-router
+globs: src/pages/**/*.{ts,tsx},src/ui/**/*.{ts,tsx},next.config.ts
+
+## Body
+
+# Routing — Pages Router (not App Router)
+
+When doing routing / page / navigation work, acknowledge: `Using .ai.local: router-pages(, …)*`.
+
+This rule drops the preset's `next-app-router` rule from context for repos using the **Next.js Pages Router**. Enable by moving this file into `.ai.local/rules/` (it is staged-inactive in `.ai.local/rules-library/` by default).
+
+## Rules
+
+- Route files live in `src/pages/<route>/index.tsx` (or `<route>.tsx`), thin wrappers.
+- Domain UI lives in `src/ui/pages/<Name>Page`; route files do not contain layout/business logic.
+- Navigation: `next/router` (`useRouter`) and `next/link`. **Never** `next/navigation`.
+- `_app.tsx` / `_document.tsx` stay in `src/pages/`.
+
+## Forbidden
+
+- Creating App Router files (`src/app/**`, `page.tsx`, `layout.tsx`, `loading.tsx`, `error.tsx`, `route.ts`).
+- Importing `next/navigation` or App Router server APIs (`cookies()`, `headers()`, `redirect()`).
+- `getServerSideProps` / `getStaticProps` — the app is a client-rendered static export; data goes through the store/`@/api`.

package/presets/opencode/next/ai-local/rules-library/single-source-copy-constants.md

@@ -0,0 +1,16 @@
+globs: src/**/*.{ts,tsx}
+
+## Body
+
+# Single source for copy, constants, enums, routes
+
+When editing `src/**`, acknowledge: `Using .ai.local: single-source-copy-constants(, …)*`.
+
+Copy (button labels, headings, alt text, aria-labels), constants, enums, and route paths live in **one** owner module. Components import from that module — they do not redeclare literals.
+
+## Rules
+
+- User-visible copy: inline unless the same string is used in ≥2 distinct places OR is consumed by tests/stories that need a shared reference. Multi-instance refactors belong to a dedicated task.
+- Numeric / pixel / token aliases: inline directly; do not re-wrap into a named constant when used exactly once in the same file.
+- Counters and derived single-use values: inline (`array.length`, computed expressions).
+- Layout sizes of one component (skeleton `height`/`width`/`maxWidth`, one-off `px`) stay as literals in the JSX prop or in `styles.ts`. Do not hoist them into named constants or a `*.data.ts`, even when the same number is repeated in that component's JSX and its styles.

package/presets/opencode/next/opencode.json

@@ -1,5 +1,24 @@
 {
   "$schema": "https://opencode.ai/config.json",
+  "instructions": [
+    ".opencode/AGENTS.md",
+    ".opencode/rules/next-app-core.md",
+    ".opencode/rules/package-manager.md",
+    ".opencode/rules/code-quality-and-refactoring.md",
+    ".opencode/rules/ai-local-overlay.md"
+  ],
+  "permission": {
+    "bash": {
+      "*": "allow",
+      "git commit *": "deny",
+      "git push *": "deny",
+      "npm *": "ask",
+      "npx *": "ask",
+      "pnpm *": "ask",
+      "bun *": "ask",
+      "npx jest*": "deny"
+    }
+  },
   "mcp": {
     "context7": {
       "type": "local",

package/presets/opencode/next/rules/README.md

@@ -4,8 +4,13 @@ Plain Markdown. OpenCode does **not** auto-load these files. Root `AGENTS.md`
 and `.opencode/AGENTS.md` list four essential paths to Read immediately; the
 rest are lazy-loaded when the task matches.
 
-Do not put this catalog into `opencode.json` `instructions` as the only
-always-on path (V2 may ignore that field).
+Subagent tasks (`Task`/`@name`) start blank and never read these rule files;
+the **authoritative** mechanism is the `## Rules to load (subagent context)`
+block injected into every `.opencode/agents/*.md`. The preset also adds a
+compact `opencode.json` `instructions` list (alwaysOn paths +
+`.opencode/AGENTS.md`) as a hedge for the parent context, with
+`bin/opencode-install.js` filling-if-absent on re-init; do **not** treat
+`instructions` as the only always-on path (V2 may ignore the field).
 
 ## Essential (entry-critical)
 

package/presets/opencode/nuxt/OPENCODE.md

@@ -24,6 +24,19 @@ Root `AGENTS.md` is native always-on. Read it first, then this file.
 
 See `.opencode/rules/README.md` for the full catalog and loading strategy.
 
+## Harness wiring
+
+- `opencode.json` carries a compact `instructions` list (always-on rule
+  paths + `.opencode/AGENTS.md`) and a harness-level `permission.bash`
+  block. On re-init, `mergeOpencodeConfig` unions preset instruction paths
+  into the consumer list and fills missing bash keys. Extra paths and
+  same-key overrides stay.
+- **Subagent rules** are re-declared inside every `.opencode/agents/*.md`
+  via the `## Rules to load (subagent context)` block (always-on + zone
+  rules filtered to stems that exist for this stack). `Task`-launched
+  subagents do not inherit the parent's `instructions`, so this block
+  is the authoritative mechanism.
+
 **Platform docs:** published with the `@bonesofspring/ai-rules` package
 (`docs/OPENCODE.md`, `docs/OPENCODE-COMPATIBILITY.md`) — **not** copied into
 the consumer repo. Source: https://github.com/bonesofspring/ai-rules
@@ -62,4 +75,5 @@ npx @bonesofspring/ai-rules init opencode --preset nuxt
 
 Copies rules, commands, agents, hooks, skills, `OPENCODE.md` →
 `.opencode/AGENTS.md`, `MCP.md`, `opencode.json` → project `opencode.json`
-(`mcp` merge), plus `REPO_AGENTS.md` → root `AGENTS.md`. Seeds `.ai.local/team/`.
+(`mcp` merge, instruction-path union, missing bash keys), plus
+`REPO_AGENTS.md` → root `AGENTS.md`. Seeds `.ai.local/team/`.

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

@@ -330,7 +330,7 @@
       "category": "mcp",
       "disposition": "transform",
       "loadMode": "manual",
-      "reason": "Cursor mcp.json → opencode.json mcp (local/remote types)"
+      "reason": "Cursor mcp.json → opencode.json mcp (local/remote types); emits permission.bash + compact instructions"
     },
     {
       "source": "rules/agent-team-intake.mdc",

package/presets/opencode/nuxt/agents/accessibility-reviewer.md

@@ -10,6 +10,23 @@ permission:
 
 Write only team artifacts under `.ai.local/team/**`. Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are an accessibility reviewer for a Nuxt 3 Vue frontend.
 
 ## Inputs

package/presets/opencode/nuxt/agents/api-contract-reviewer.md

@@ -10,6 +10,25 @@ permission:
 
 Write only team artifacts under `.ai.local/team/**`. Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/api-services.md`
+- `.opencode/rules/http-client.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are an API contract reviewer for a layered Nuxt 3 frontend (`@/types`, `@/api`, store, UI).
 
 ## Inputs

package/presets/opencode/nuxt/agents/build-verifier.md

@@ -10,6 +10,23 @@ permission:
 
 Write only team artifacts under `.ai.local/team/**`. Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a build verification specialist. You **validate** implementation quality before code review — you do not edit production code or tests.
 
 **SSOT for full validation in pipeline:** run complete **`lint:js`**, **`lint:css`**, and **`typecheck`** from repository root even if feature-developer ran scoped checks.

package/presets/opencode/nuxt/agents/ci-investigator.md

@@ -6,6 +6,40 @@ permission:
   edit: allow
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/public-imports.md` — @/types, @/api barrels
+- `.opencode/rules/vue-ui.md`
+- `.opencode/rules/store-pinia.md`
+- `.opencode/rules/vue-nuxt-anti-hallucination.md`
+- `.opencode/rules/no-v-bind-spread.md`
+- `.opencode/rules/no-type-assertion-as-import-export.md`
+- `.opencode/rules/architecture-boundaries-ui.md`
+- `.opencode/rules/css-property-order-stylelint.md`
+- `.opencode/rules/layer-barrel-exports.md`
+- `.opencode/rules/navigation-router-stack.md`
+- `.opencode/rules/navigation-router-ui.md`
+- `.opencode/rules/nuxt-pages-routing.md`
+- `.opencode/rules/vue-a11y-coding.md`
+- `.opencode/rules/types-jsdoc.md`
+- `.opencode/rules/script-setup-conventions.md`
+- `.opencode/rules/api-services.md`
+- `.opencode/rules/http-client.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a CI failure investigator for a Nuxt 3 TypeScript frontend monorepo.
 
 Use the **`ci-investigation` skill** for the investigation loop.

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

@@ -10,6 +10,24 @@ permission:
 
 Write only review artifacts under `.ai.local/team/**`. Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/code-review-mr.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a senior code reviewer. You may write only review artifacts under `.ai.local/team/**` and terminal receipts; do not modify production code.
 
 ## Inputs

package/presets/opencode/nuxt/agents/codebase-analyzer.md

@@ -10,6 +10,23 @@ permission:
 
 Write only team artifacts under `.ai.local/team/**`. Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a specialist at understanding HOW this Nuxt 3 codebase works. Document implementation details with precise `path:line` references.
 
 ## CRITICAL — explain as-is only

package/presets/opencode/nuxt/agents/debugger.md

@@ -6,6 +6,40 @@ permission:
   edit: allow
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/public-imports.md` — @/types, @/api barrels
+- `.opencode/rules/vue-ui.md`
+- `.opencode/rules/store-pinia.md`
+- `.opencode/rules/vue-nuxt-anti-hallucination.md`
+- `.opencode/rules/no-v-bind-spread.md`
+- `.opencode/rules/no-type-assertion-as-import-export.md`
+- `.opencode/rules/architecture-boundaries-ui.md`
+- `.opencode/rules/css-property-order-stylelint.md`
+- `.opencode/rules/layer-barrel-exports.md`
+- `.opencode/rules/navigation-router-stack.md`
+- `.opencode/rules/navigation-router-ui.md`
+- `.opencode/rules/nuxt-pages-routing.md`
+- `.opencode/rules/vue-a11y-coding.md`
+- `.opencode/rules/types-jsdoc.md`
+- `.opencode/rules/script-setup-conventions.md`
+- `.opencode/rules/api-services.md`
+- `.opencode/rules/http-client.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are an expert debugger for a Nuxt 3 TypeScript frontend. Use the **`debug-investigation` skill** for the investigation loop.
 
 ## Inputs

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

@@ -6,6 +6,40 @@ permission:
   edit: allow
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.opencode/rules/public-imports.md` — @/types, @/api barrels
+- `.opencode/rules/vue-ui.md`
+- `.opencode/rules/store-pinia.md`
+- `.opencode/rules/vue-nuxt-anti-hallucination.md`
+- `.opencode/rules/no-v-bind-spread.md`
+- `.opencode/rules/no-type-assertion-as-import-export.md`
+- `.opencode/rules/architecture-boundaries-ui.md`
+- `.opencode/rules/css-property-order-stylelint.md`
+- `.opencode/rules/layer-barrel-exports.md`
+- `.opencode/rules/navigation-router-stack.md`
+- `.opencode/rules/navigation-router-ui.md`
+- `.opencode/rules/nuxt-pages-routing.md`
+- `.opencode/rules/vue-a11y-coding.md`
+- `.opencode/rules/types-jsdoc.md`
+- `.opencode/rules/script-setup-conventions.md`
+- `.opencode/rules/api-services.md`
+- `.opencode/rules/http-client.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a senior frontend developer working in a Nuxt 3 monorepo with strict layer boundaries.
 
 ## Before coding

package/presets/opencode/nuxt/agents/migration-specialist.md

@@ -10,6 +10,23 @@ permission:
 
 Write only team artifacts under `.ai.local/team/**`. Do not edit production code.
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit `opencode.json` `instructions`. Read these rules explicitly before acting:
+
+- `.opencode/rules/nuxt-app-core.md`
+- `.opencode/rules/package-manager.md`
+- `.opencode/rules/code-quality-and-refactoring.md`
+- `.opencode/rules/ai-local-overlay.md`
+- `.opencode/rules/architecture-boundaries.md` — layer boundaries and allowed imports
+- `.opencode/rules/feature-delivery-workflow.md` — layer order, mockup gate, ux-design gate
+- `.opencode/rules/reference-features.md` — analog files first
+- `.opencode/rules/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.opencode/rules/post-change-lint.md` — lint/type-check after code edits
+- `.opencode/rules/mcp-usage.md` — when verifying third-party APIs (Context7)
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You are a migration specialist for a Nuxt 3 frontend with strict layer boundaries.
 
 ## Inputs