@bonesofspring/ai-rules 0.2.27 → 0.2.28

package/CHANGELOG.md

@@ -2,6 +2,11 @@
 
 ## Unreleased
 
+### OpenCode re-init picks up preset rules; Claude ships `settings.json`
+
+- `init opencode` merges `opencode.json` by **unioning** preset `instructions` paths and **filling missing** `permission.bash` keys. Consumer extra paths and same-key overrides stay, including on re-init. An empty `instructions` array no longer blocks the preset list.
+- Claude presets now include `presets/claude/<stack>/settings.json` (harness `permissions.deny` / `ask`). `init claude` copies it to `.claude/settings.json` and overwrites that file on re-init.
+
 ### Over-abstraction guardrails + aligned always-on budget
 
 - **Shared core** `quality/code-quality-and-refactoring` gains an **Over-abstraction guardrails** section: no unnecessary constants, no invented one-off utilities (Rule of Three), decompose over conditionals. Propagated to all 10 stacks (Cursor + Claude; Mavis / OpenCode regenerated).

package/bin/cli.js

@@ -73,7 +73,7 @@ Notes:
   on shipped keys are preserved unless the preset defines them. Invalid / non-object JSON is
   copied to a timestamped *.bak.* then replaced with the preset file. JSONC is not supported).
   Cursor init copies rules, commands, agents, hooks, skills, hooks.json, BUGBOT.md, AGENTS.md → .cursor/AGENTS.md, MCP.md, mcp.json → .cursor/mcp.json.
-  Claude init copies rules, commands, skills, agents, hooks, CLAUDE.md, MCP.md, and mcp.json → .mcp.json (project root).
+  Claude init copies rules, commands, skills, agents, hooks, CLAUDE.md, settings.json (harness-level denials), MCP.md, and mcp.json → .mcp.json (project root).
   All init targets seed .ai.local/team/ (shared pipeline artifacts; never overwritten task slugs; not removed by clean)
   and .ai.local/conventions.md (living gotchas; seeded from the preset template only when absent, never overwritten).
   Because .ai.local/team/ is shared, ANY init consolidates every legacy .cursor|.claude|.mavis|.opencode/team/ into it,
@@ -505,7 +505,7 @@ function readInstallManifest(cwd, toolRoot) {
 /** Markers that mean a tool install is still present (directory leftovers do not count). */
 const TOOL_INSTALL_MARKERS = {
   '.cursor': ['.cursor/AGENTS.md', '.cursor/hooks.json', '.cursor/rules'],
-  '.claude': ['.claude/CLAUDE.md', '.claude/rules'],
+  '.claude': ['.claude/CLAUDE.md', '.claude/rules', '.claude/settings.json'],
   '.mavis': ['.mavis/.ai-rules-install.json', '.mavis/AGENTS.md'],
   '.opencode': ['.opencode/.ai-rules-install.json', '.opencode/AGENTS.md'],
 };
@@ -781,6 +781,17 @@ function cmdInit(tool, preset, cwdOption) {
       }
     }
 
+    if (tool === 'claude') {
+      const settingsFrom = path.join(base, 'settings.json');
+      if (fs.existsSync(settingsFrom)) {
+        const destAbs = path.join(toolRootAbs, 'settings.json');
+        fs.copyFileSync(settingsFrom, destAbs);
+        createdPaths.add(destAbs);
+        console.log(`Copied settings.json → ${toolRoot}/settings.json`);
+        copiedSteps++;
+      }
+    }
+
     if (cfg.mcpJsonSrc && cfg.mcpJsonDest) {
       const mcpFrom = path.join(base, cfg.mcpJsonSrc);
       if (fs.existsSync(mcpFrom)) {

package/bin/lib/seed-ai-local-team.js

@@ -255,6 +255,43 @@ function seedConventions(presetTeamSrc, cwd) {
   return true;
 }
 
+/**
+ * Seed `.ai.local/rules-library/` from `presets/<opt>/<stack>/ai-local/rules-library/`.
+ * Opt-in discipline rules the consumer enables by moving a file into
+ * `.ai.local/rules/` (consumer-owned; never overwritten).
+ *
+ * Refuses symlinks anywhere along the source path so `rmSync` and copy
+ * can't escape the install scope.
+ */
+function seedAiLocalRules(presetTeamSrc, cwd) {
+  if (!presetTeamSrc) {
+    return false;
+  }
+  const libraryDir = path.join(path.dirname(presetTeamSrc), 'ai-local', 'rules-library');
+  if (!fs.existsSync(libraryDir) || !fs.statSync(libraryDir).isDirectory()) {
+    return false;
+  }
+  const destDir = path.join(cwd, '.ai.local', 'rules-library');
+  assertSafeDest(cwd, destDir, '.ai.local/rules-library');
+  let copied = 0;
+  let skipped = 0;
+  for (const entry of fs.readdirSync(libraryDir)) {
+    if (!entry.endsWith('.md')) continue;
+    const src = path.join(libraryDir, entry);
+    const dest = path.join(destDir, entry);
+    if (fs.existsSync(dest)) {
+      skipped += 1;
+      continue;
+    }
+    copyFile(src, dest);
+    copied += 1;
+  }
+  if (copied > 0) {
+    console.log(`Seeded .ai.local/rules-library/ (${copied} rules; ${skipped} already present)`);
+  }
+  return copied > 0;
+}
+
 /**
  * Resolve a legacy `.<tool>/team` directory, refusing symlinks and anything whose
  * real path escapes the resolved `cwd`. `rmSync` through a link would delete the
@@ -392,7 +429,7 @@ function migrateLegacyTeams(cwd, dest) {
 
 /**
  * @param {{ cwd: string, presetTeamSrc?: string }} options
- * @returns {{ created: boolean, migrated: boolean, refreshed: boolean, conventionsSeeded: boolean }}
+ * @returns {{ created: boolean, migrated: boolean, refreshed: boolean, conventionsSeeded: boolean, rulesLibrarySeeded: boolean }}
  */
 function seedAiLocalTeam({ cwd, presetTeamSrc }) {
   const dest = destTeamRoot(cwd);
@@ -408,13 +445,14 @@ function seedAiLocalTeam({ cwd, presetTeamSrc }) {
 
   if (!destExisted && !hadLegacy && (!presetTeamSrc || !fs.existsSync(presetTeamSrc))) {
     console.log('Skipped .ai.local/team seed (preset team/ missing)');
-    return { created: false, migrated: false, refreshed: false, conventionsSeeded: false };
+    return { created: false, migrated: false, refreshed: false, conventionsSeeded: false, rulesLibrarySeeded: false };
   }
 
   fs.mkdirSync(dest, { recursive: true });
   const migrated = migrateLegacyTeams(cwd, dest);
   copyTemplates(presetTeamSrc, dest);
   const conventionsSeeded = seedConventions(presetTeamSrc, cwd);
+  const rulesLibrarySeeded = seedAiLocalRules(presetTeamSrc, cwd);
 
   if (migrated) {
     console.log('Migrated legacy .{tool}/team → .ai.local/team');
@@ -422,7 +460,7 @@ function seedAiLocalTeam({ cwd, presetTeamSrc }) {
 
   if (!destExisted && !hadLegacy) {
     console.log('Seeded .ai.local/team/');
-    return { created: true, migrated: false, refreshed: false, conventionsSeeded };
+    return { created: true, migrated: false, refreshed: false, conventionsSeeded, rulesLibrarySeeded };
   }
 
   if (destHasSlugs || destExisted) {
@@ -431,10 +469,10 @@ function seedAiLocalTeam({ cwd, presetTeamSrc }) {
         ? 'Refreshed .ai.local/team templates (tasks preserved)'
         : 'Refreshed .ai.local/team (no consumer task slugs)',
     );
-    return { created: false, migrated, refreshed: true, conventionsSeeded };
+    return { created: false, migrated, refreshed: true, conventionsSeeded, rulesLibrarySeeded };
   }
 
-  return { created: false, migrated, refreshed: false, conventionsSeeded };
+  return { created: false, migrated, refreshed: false, conventionsSeeded, rulesLibrarySeeded };
 }
 
 module.exports = { seedAiLocalTeam, destTeamRoot };

package/bin/opencode-install.js

@@ -190,6 +190,57 @@ function mergeServerEntry(existingEntry, presetEntry) {
   return merged;
 }
 
+function stringList(value) {
+  return Array.isArray(value) ? value.filter((item) => typeof item === 'string') : [];
+}
+
+function mergeInstructionList(existingInstructions, presetInstructions) {
+  const presetList = stringList(presetInstructions);
+  if (existingInstructions == null) {
+    return presetList.length > 0 ? presetList : undefined;
+  }
+  if (!Array.isArray(existingInstructions)) {
+    return existingInstructions;
+  }
+  const merged = [];
+  const seen = new Set();
+  for (const item of existingInstructions) {
+    if (typeof item === 'string') {
+      if (seen.has(item)) continue;
+      seen.add(item);
+    }
+    merged.push(item);
+  }
+  for (const item of presetList) {
+    if (seen.has(item)) continue;
+    seen.add(item);
+    merged.push(item);
+  }
+  return merged;
+}
+
+function mergePermission(existingPermission, presetPermission) {
+  const presetPerm = isPlainObject(presetPermission) ? presetPermission : null;
+  const presetBash = presetPerm && isPlainObject(presetPerm.bash) ? presetPerm.bash : null;
+  if (existingPermission == null) {
+    if (!presetPerm) return undefined;
+    return presetBash ? { ...presetPerm, bash: { ...presetBash } } : { ...presetPerm };
+  }
+  if (!isPlainObject(existingPermission) || !presetBash) {
+    return existingPermission;
+  }
+  const merged = { ...existingPermission };
+  if (merged.bash == null) {
+    merged.bash = { ...presetBash };
+    return merged;
+  }
+  if (!isPlainObject(merged.bash)) {
+    return merged;
+  }
+  merged.bash = { ...presetBash, ...merged.bash };
+  return merged;
+}
+
 function mergeOpencodeConfig(presetObj, existingObj) {
   const preset = isPlainObject(presetObj) ? presetObj : {};
   const existing = isPlainObject(existingObj) ? existingObj : {};
@@ -207,6 +258,13 @@ function mergeOpencodeConfig(presetObj, existingObj) {
     merged.$schema = preset.$schema;
   }
   merged.mcp = mergedMcp;
+  // Re-init re-asserts preset instruction paths and missing bash keys so an
+  // upgrade is picked up. Consumer extras and same-key bash overrides stay.
+  // A non-array `instructions` or non-object `permission` is left untouched.
+  const instructions = mergeInstructionList(merged.instructions, preset.instructions);
+  if (instructions !== undefined) merged.instructions = instructions;
+  const permission = mergePermission(merged.permission, preset.permission);
+  if (permission !== undefined) merged.permission = permission;
   return { merged, extrasKept, existingServersInvalid };
 }
 

package/docs/OPENCODE-COMPATIBILITY.md

@@ -39,7 +39,7 @@ Allowed status values are `confirmed`, `partial`, `unknown`, and `no-equivalent`
 | Slash commands | `confirmed` | opencode.ai/docs/commands | `.opencode/commands/<name>.md` | Native `/task` |
 | Plugin / skill / MCP combo | `confirmed` | skills + mcp docs | MCP inflates context | Gate unused servers in operator config |
 | Native Team lifecycle | `partial` | file pipeline is ai-rules SoT | No native team runtime | Hook owns `status.json` / `metrics.json` |
-| `opencode.json` `instructions` globs | `unknown` | V1 docs load globs; V2 may not resolve | Do not depend on this field | `AGENTS.md` + explicit Read |
+| `opencode.json` `instructions` globs | `unknown` | V1 docs load globs; V2 may not resolve | Compact hedge for parent + per-agent "Rules to load" block is V2-safe | `AGENTS.md` + explicit Read (authoritative for subagents) |
 
 ## What we do not claim
 

package/docs/OPENCODE.md

@@ -23,7 +23,7 @@ What lands:
 | `OPENCODE.md` | `.opencode/AGENTS.md` (OpenCode load map) |
 | `rules/`, `agents/`, `skills/`, `commands/`, `hooks/` | `.opencode/<dir>/` |
 | `team/` | `.ai.local/team/` (shared pipeline artifacts; not `.opencode/team/`) |
-| `opencode.json` | `./opencode.json` (merge `mcp` only) |
+| `opencode.json` | `./opencode.json` (merge `mcp`; union preset `instructions`; fill missing `permission.bash` keys) |
 
 Remove only what this install owns:
 
@@ -31,7 +31,7 @@ Remove only what this install owns:
 npx @bonesofspring/ai-rules clean opencode
 ```
 
-`clean opencode` is **manifest-owned**: unchanged hashes are removed; files you edited stay. Without a valid `.opencode/.ai-rules-install.json`, clean is fail-safe (nothing removed). Extra keys in `opencode.json` (models, permissions, user MCP servers) are preserved.
+`clean opencode` is **manifest-owned**: unchanged hashes are removed; files you edited stay. Without a valid `.opencode/.ai-rules-install.json`, clean is fail-safe (nothing removed). Extra keys in `opencode.json` (models, user MCP servers, extra instruction paths) are preserved. Re-init still unions preset instruction paths and fills bash keys the file does not already set.
 
 The CLI **never** writes `~/.config/opencode/**`.
 
@@ -39,13 +39,23 @@ Quad-install with Cursor, Claude, or Mavis: `init multi --preset next` copies th
 
 ## How to load
 
-OpenCode has **no** `.mdc` `alwaysApply` / `globs` engine. Do **not** rely on `opencode.json` `instructions` as the only always-on path (V2 may ignore it).
+OpenCode has **no** `.mdc` `alwaysApply` / `globs` engine. The preset uses three mechanisms:
+
+| Mechanism | Role | V2-safe? |
+|-----------|------|----------|
+| Root `AGENTS.md` + `.opencode/AGENTS.md` | Always-on core (essential rules + entry maps) for the **parent** | yes |
+| `opencode.json` `instructions` | Compact hedge (`alwaysOn` paths + `.opencode/AGENTS.md`) for the **parent**; re-init unions preset paths into the consumer list | V1 yes, V2 uncertain (kept narrow) |
+| `## Rules to load (subagent context)` block in every `.opencode/agents/*.md` | Authoritative for **subagents** (`Task`/`@name`); alwaysOn + stack zone rules filtered to existing stems | yes |
+
+`bin/opencode-install.js` `mergeOpencodeConfig` on re-init **unions** preset `instructions` paths into the existing list and **fills missing** `permission.bash` keys. Extra consumer paths and same-key bash overrides stay. An empty `instructions: []` receives the preset paths. A non-array `instructions` value is left as-is.
 
 | Kind | How it loads |
 |------|----------------|
-| Essential rules | Root `AGENTS.md` lists four paths — **Read immediately** |
+| Essential rules | Root `AGENTS.md` + `.opencode/AGENTS.md` list four paths — **Read immediately** |
 | Other rules | Lazy `Read` of `.opencode/rules/<stem>.md` when the task matches |
-| Agents | Native `.opencode/agents/*.md` (`@name` / Task). `mode: subagent` |
+| Agents | Native `.opencode/agents/*.md` (`@name` / Task). `mode: subagent`. Each ships the **rules-to-load block** so subagents see the always-on + zone set |
+| MCP | `opencode.json` `mcp` — preset ships context7 / playwright / chrome-devtools / figma; merge keeps extras |
+| Harness enforcement | `opencode.json` `permission.bash` — universal `git commit/push deny` + JS-stack `npm/npx/pnpm/bun ask` + `npx jest* deny` |
 | Skills | Native `.opencode/skills/<name>/SKILL.md` (`skill` tool) |
 | Commands | Native `/task`, `/task-continue`, `/technical-retro`, `/spec-start` |
 | MCP | `opencode.json` → `mcp` |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonesofspring/ai-rules",
-  "version": "0.2.27",
+  "version": "0.2.28",
   "description": "Presets of Cursor, Claude, Mavis, and OpenCode rules/commands for Revy Ross personal use",
   "license": "MIT",
   "author": "Revy Ross",
@@ -31,6 +31,7 @@
   ],
   "scripts": {
     "check:preset-structure": "bash scripts/check-preset-structure.sh",
+    "check:claude-agent-blocks": "node scripts/check-claude-agent-blocks.mjs",
     "check:preset-twin-map": "bash scripts/check-preset-twin-map.sh",
     "check:preset-token-budget": "bash scripts/check-preset-token-budget.sh",
     "check:preset-leakage": "bash scripts/check-preset-leakage.sh",

package/presets/claude/android-kotlin/CLAUDE.md

@@ -36,3 +36,15 @@ npx @bonesofspring/ai-rules init claude --preset android-kotlin
 ```
 
 Copies `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `skills/**`, `hooks/**`, `MCP.md` into `.claude/`; seeds `.ai.local/team/` from `team/` (slugs preserved), plus `mcp.json` → **`.mcp.json`** and `REPO_AGENTS.md` → root **`AGENTS.md`**. Skill: `write-adr` (on-demand).
+
+## Harness wiring
+
+- **Subagent rules** are re-declared inside every `.claude/agents/*.md` via
+  the `## Rules to load (subagent context)` block (always-on + zone rules
+  filtered to stems that exist for this stack, using the nested
+  `.claude/rules/<topic>/<stem>.md` paths). Claude Code subagents inherit
+  no parent context, so this block is the authoritative mechanism.
+- `.claude/settings.json` ships harness-level denials (universal
+  `git commit/push deny`; JS stacks also `npx jest* deny` and `npm/npx/pnpm/bun`
+  ask). Re-init overwrites the file (consumer can edit afterwards); mirror
+  with root `AGENTS.md` if you change the harness.

package/presets/claude/android-kotlin/agents/accessibility-reviewer.md

@@ -5,6 +5,21 @@ readonly: false
 model: inherit
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/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 an **Android Kotlin / Jetpack Compose** (and View system where present) frontend.
 
 ## Inputs

package/presets/claude/android-kotlin/agents/api-contract-reviewer.md

@@ -5,6 +5,22 @@ readonly: false
 model: inherit
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/api-and-data/networking.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 **Android Kotlin** Feature module (`features/<name>/{api,impl}` — Domain / Data / Presentation).
 
 ## Inputs
@@ -67,4 +83,3 @@ Write the owned terminal receipt described under **Artifact contract**.
 If **MISALIGNED**, emit receipt outcome `changes_requested` when blocking implementation.
 
 Do not modify production code.
-

package/presets/claude/android-kotlin/agents/build-verifier.md

@@ -5,6 +5,23 @@ readonly: false
 model: fast
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/tooling-and-review/gradle-tooling.md`
+- `.claude/rules/tooling-and-review/post-change-build.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You **validate** Android/Kotlin implementation quality — do not edit production code or tests.
 
 **SSOT for full validation:** use `tooling-and-review/gradle-tooling.md` + `tooling-and-review/post-change-build.md`. Run compile / configured lint / unit tests at CI parity even if the developer ran scoped checks.

package/presets/claude/android-kotlin/agents/ci-investigator.md

@@ -5,6 +5,31 @@ readonly: false
 model: inherit
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/ui-and-accessibility/compose.md`
+- `.claude/rules/stack/kotlin-conventions.md`
+- `.claude/rules/ui-and-accessibility/viewmodels.md`
+- `.claude/rules/ui-and-accessibility/navigation.md`
+- `.claude/rules/api-and-data/persistence.md`
+- `.claude/rules/architecture/module-public-api.md`
+- `.claude/rules/architecture/di-dagger-feature-holders.md`
+- `.claude/rules/api-and-data/networking.md`
+- `.claude/rules/tooling-and-review/gradle-tooling.md`
+- `.claude/rules/tooling-and-review/post-change-build.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 an **Android Kotlin** project (Android Studio / AGP Cloud, GitHub Actions Android, or similar).
 
 Use the **`ci-investigation` skill** for the investigation loop.

package/presets/claude/android-kotlin/agents/code-reviewer.md

@@ -5,6 +5,22 @@ readonly: false
 model: fast
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/tooling-and-review/code-review.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 Android / Kotlin / Jetpack Compose code reviewer. You may write only review artifacts under `.ai.local/team/**` and terminal receipts; do not modify production code.
 
 ## Inputs

package/presets/claude/android-kotlin/agents/codebase-analyzer.md

@@ -5,6 +5,21 @@ readonly: false
 model: fast
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/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 Android codebase works. Document implementation details with precise `path:line` references.
 
 ## CRITICAL — explain as-is only

package/presets/claude/android-kotlin/agents/debugger.md

@@ -5,6 +5,31 @@ readonly: false
 model: inherit
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/ui-and-accessibility/compose.md`
+- `.claude/rules/stack/kotlin-conventions.md`
+- `.claude/rules/ui-and-accessibility/viewmodels.md`
+- `.claude/rules/ui-and-accessibility/navigation.md`
+- `.claude/rules/api-and-data/persistence.md`
+- `.claude/rules/architecture/module-public-api.md`
+- `.claude/rules/architecture/di-dagger-feature-holders.md`
+- `.claude/rules/api-and-data/networking.md`
+- `.claude/rules/tooling-and-review/gradle-tooling.md`
+- `.claude/rules/tooling-and-review/post-change-build.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 an **Android Kotlin/Jetpack Compose** app. Use the **`debug-investigation` skill** for the investigation loop.
 
 ## Inputs

package/presets/claude/android-kotlin/agents/feature-developer.md

@@ -5,6 +5,31 @@ readonly: false
 model: inherit
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/ui-and-accessibility/compose.md`
+- `.claude/rules/stack/kotlin-conventions.md`
+- `.claude/rules/ui-and-accessibility/viewmodels.md`
+- `.claude/rules/ui-and-accessibility/navigation.md`
+- `.claude/rules/api-and-data/persistence.md`
+- `.claude/rules/architecture/module-public-api.md`
+- `.claude/rules/architecture/di-dagger-feature-holders.md`
+- `.claude/rules/api-and-data/networking.md`
+- `.claude/rules/tooling-and-review/gradle-tooling.md`
+- `.claude/rules/tooling-and-review/post-change-build.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 Android developer (Jetpack Compose-first, Gradle modules as in repo) with strict layer boundaries.
 
 ## Before coding

package/presets/claude/android-kotlin/agents/instrumentation-test-generator.md

@@ -3,6 +3,22 @@ name: instrumentation-test-generator
 description: Instrumentation UI test generator. Generate/update instrumentation tests from plans. Uses skill instrumentation-ui-e2e. Tests only — no production feature code.
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/testing/ui.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You own **Android instrumentation UI tests** (generator).
 
 ## Rules

package/presets/claude/android-kotlin/agents/instrumentation-test-healer.md

@@ -3,6 +3,22 @@ name: instrumentation-test-healer
 description: Instrumentation UI test healer. Fix failing/flaky instrumentation tests while preserving plan assertions. Uses skill instrumentation-ui-e2e. Tests only — no production feature code.
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/testing/ui.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You own **Android instrumentation UI tests** (healer).
 
 ## Rules

package/presets/claude/android-kotlin/agents/instrumentation-test-planner.md

@@ -3,6 +3,22 @@ name: instrumentation-test-planner
 description: Instrumentation UI test planner. Create/update Android instrumentation plans (`androidTest` / `*.cases.md` if used). Uses skill instrumentation-ui-e2e. Tests only — no production feature code.
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/mcp-usage.md` — when verifying third-party APIs (Context7)
+- `.claude/rules/testing/ui.md`
+
+Also read matching `.ai.local/rules/*.md` (local overlay) for the active zone, and the project strict rules if present.
+
 You own **Android instrumentation UI tests** (planner).
 
 ## Rules

package/presets/claude/android-kotlin/agents/migration-specialist.md

@@ -5,6 +5,21 @@ readonly: false
 model: opus
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/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 an **Android Kotlin** codebase with Feature-module layer boundaries.
 
 ## Inputs

package/presets/claude/android-kotlin/agents/mockup-reviewer.md

@@ -4,6 +4,21 @@ description: Figma mockup review specialist. Audits design-system usage, tokens,
 model: opus
 ---
 
+## Rules to load (subagent context)
+
+This subagent does **not** inherit the parent session context or `CLAUDE.md`. Read these rules explicitly before acting:
+
+- `.claude/rules/stack/android-app-core.md`
+- `.claude/rules/architecture/boundaries.md` — layer boundaries and allowed imports
+- `.claude/rules/tooling-and-review/code-quality.md`
+- `.claude/rules/tooling-and-review/ai-local-overlay.md`
+- `.claude/rules/architecture/feature-delivery.md` — layer order, mockup gate, ux-design gate
+- `.claude/rules/architecture/reference-features.md` — analog files first
+- `.claude/rules/tooling-and-review/anti-sycophancy-discipline.md` — procedural anti-sycophancy rules
+- `.claude/rules/tooling-and-review/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 Figma mockup reviewer for an Android Kotlin / Jetpack Compose frontend.
 
 You write **only** `.ai.local/team/tasks/<slug>/mockup-review.md` (and the owned manifest receipt). Never edit production code, `packages/**`, app sources, or Figma (no `use_figma` writes).