@bonesofspring/ai-rules 0.2.25 → 0.2.27

package/presets/claude/svelte/team/fixtures/metrics-scenarios/tasks/validation-failed/metrics.json

@@ -0,0 +1,124 @@
+{
+  "schemaVersion": 1,
+  "task": {
+    "runId": "validation-failed-run",
+    "slug": "validation-failed",
+    "preset": "ai-rules",
+    "stack": "svelte",
+    "platform": "cursor",
+    "intent": "feature",
+    "profile": "full"
+  },
+  "events": [
+    {
+      "eventId": "validation-failed-run:task",
+      "type": "task_started",
+      "at": "2026-07-31T15:00:00.000Z",
+      "source": "router",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T15:00:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-1",
+      "stepIndex": 2,
+      "stepLabel": null,
+      "agent": "build-verifier",
+      "role": "validation",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:1:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T15:02:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-1",
+      "outcome": "validation_failed",
+      "durationMs": 120000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:retry:1",
+      "type": "retry_scheduled",
+      "at": "2026-07-31T15:02:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-1",
+      "nextAgent": "feature-developer",
+      "retryAfterFix": "build-verifier",
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:1:feature-developer:1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T15:02:00.000Z",
+      "attemptId": "validation-failed-run:step-1:feature-developer:attempt-1",
+      "stepIndex": 1,
+      "stepLabel": null,
+      "agent": "feature-developer",
+      "role": "implementation",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:1:feature-developer:1:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T15:05:00.000Z",
+      "attemptId": "validation-failed-run:step-1:feature-developer:attempt-1",
+      "outcome": "completed",
+      "durationMs": 180000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:retry:2",
+      "type": "retry_scheduled",
+      "at": "2026-07-31T15:05:00.000Z",
+      "attemptId": "validation-failed-run:step-1:feature-developer:attempt-1",
+      "nextAgent": "build-verifier",
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:2:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T15:05:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-2",
+      "stepIndex": 2,
+      "stepLabel": null,
+      "agent": "build-verifier",
+      "role": "validation",
+      "attempt": 2,
+      "parallelGroupId": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:2:build-verifier:2:finish",
+      "type": "attempt_finished",
+      "at": "2026-07-31T15:06:00.000Z",
+      "attemptId": "validation-failed-run:step-2:build-verifier:attempt-2",
+      "outcome": "completed",
+      "durationMs": 60000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "validation-failed-run:done",
+      "type": "task_completed",
+      "at": "2026-07-31T15:06:00.000Z",
+      "outcome": "completed",
+      "source": "hook",
+      "attributionConfidence": "high"
+    }
+  ]
+}

package/presets/claude/svelte/team/fixtures/metrics.example.json

@@ -0,0 +1,54 @@
+{
+  "schemaVersion": 1,
+  "task": {
+    "runId": "example-run-1",
+    "slug": "example-feature-full",
+    "preset": "ai-rules",
+    "stack": "svelte",
+    "platform": "cursor",
+    "intent": "feature",
+    "profile": "full"
+  },
+  "events": [
+    {
+      "eventId": "example-run-1:task_started",
+      "type": "task_started",
+      "at": "2026-07-31T14:00:00.000Z",
+      "source": "router",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "example-run-1:attempt-1:start",
+      "type": "attempt_started",
+      "at": "2026-07-31T14:00:00.000Z",
+      "attemptId": "example-run-1:step-0:task-analyst:attempt-1",
+      "stepIndex": 0,
+      "stepLabel": "Clarify and decompose",
+      "agent": "task-analyst",
+      "role": "planning",
+      "attempt": 1,
+      "parallelGroupId": null,
+      "source": "router",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "example-run-1:attempt-1:end",
+      "type": "attempt_finished",
+      "at": "2026-07-31T14:02:00.000Z",
+      "attemptId": "example-run-1:step-0:task-analyst:attempt-1",
+      "outcome": "completed",
+      "durationMs": 120000,
+      "retryAfterFix": null,
+      "source": "hook",
+      "attributionConfidence": "high"
+    },
+    {
+      "eventId": "example-run-1:task_completed",
+      "type": "task_completed",
+      "at": "2026-07-31T14:02:00.000Z",
+      "outcome": "completed",
+      "source": "hook",
+      "attributionConfidence": "high"
+    }
+  ]
+}

package/presets/cursor/android-kotlin/AGENTS.md

@@ -47,4 +47,4 @@ Intent detection, profiles (`full` / `standard` / `light`), and default steps
 npx @bonesofspring/ai-rules init cursor --preset android-kotlin
 ```
 
-Copies rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md` → `.cursor/AGENTS.md`, `MCP.md`, `mcp.json` → `.cursor/mcp.json`, plus `REPO_AGENTS.md` → root `AGENTS.md`. Skill: `write-adr` (on-demand).
+Copies rules, commands, agents, hooks, skills, `hooks.json`, `BUGBOT.md`, `AGENTS.md` → `.cursor/AGENTS.md`, `MCP.md`, `mcp.json` → `.cursor/mcp.json`, plus `REPO_AGENTS.md` → root `AGENTS.md`. Seeds `.ai.local/team/`. Skill: `write-adr` (on-demand).

package/presets/cursor/android-kotlin/README.md

@@ -1,35 +1,9 @@
-# Preset: android-kotlin (Cursor)
+# Android Kotlin preset (Cursor)
 
-Installable Android/Kotlin multimodule preset: Clean Architecture, Jetpack Compose MVI, Dagger feature holders (no Hilt by default), Gradle convention plugins, instrumentation UI-test agents.
+Multimodule Kotlin / Compose MVI / Gradle. Map module paths in `.ai.local/conventions.md`.
 
 ```bash
 npx @bonesofspring/ai-rules init cursor --preset android-kotlin
 ```
 
-Copies rules, agents, skills, commands, hooks, team, `MCP.md`, `mcp.json` → `.cursor/mcp.json`, plus `REPO_AGENTS.md` → root `AGENTS.md`.
-
-## Layout placeholders
-
-Generic multimodule layout encoded in rules (map your repo in `team/conventions.md` after install):
-
-`applications/`, `core/`, `features/<name>/{api,impl}/`, `build-logic/`, `gradle/libs.versions.toml`
-
-## Agent surface
-
-- UI tests: `instrumentation-test-{planner,generator,healer}` + skill `instrumentation-ui-e2e`
-- Gates: `post-change-build` + `gradle-tooling` + `build-verifier`
-- Claude twin: `presets/claude/android-kotlin/` (same PR policy)
-
-See `rules/README.md` and `agents/README.md`.
-
-## Install troubleshooting
-
-- **Gradle wrapper:** run from the Gradle root where `./gradlew` (or a wrapper script documented in the repo README/CI) lives; agents load `gradle-tooling.mdc` for discovery — do not assume a single hard-coded script name.
-- **Modules:** use `./gradlew projects` (or CI task names) to resolve affected `:module` paths before compile/test gates.
-- **Variants / flavors:** product flavors and build types differ per repo; note the CI variant (e.g. `debug` vs `release`) in `team/conventions.md` and pass `-P` / `--variant` flags only as documented locally.
-- **Multimodule:** scope `./gradlew :feature:impl:compileDebugKotlin` (example pattern) to changed modules; full gate — agent `build-verifier`.
-
-## Preset taxonomy
-
-- Contribution: [`../../docs/PRESET-CONTRIBUTION.md`](../../docs/PRESET-CONTRIBUTION.md)
-- Core→stack mapping: [`rules/README.md`](./rules/README.md)
+`team/` seeds **`.ai.local/team/`**. UI tests: `instrumentation-test-*` + skill `instrumentation-ui-e2e`. Gates: `post-change-build`, `gradle-tooling`, `build-verifier`. Twin: `presets/claude/android-kotlin/`. Catalog: [`rules/README.md`](./rules/README.md).

package/presets/cursor/android-kotlin/REPO_AGENTS.md

@@ -1,19 +1,34 @@
 # Android Kotlin — agent instructions
 
-Cross-tool repo-root guide for the **android-kotlin** multimodule preset. Tool-specific maps stay under `.cursor/AGENTS.md` and `.claude/CLAUDE.md`.
+Cross-tool repo-root guide. Tool-specific maps stay under `.cursor/AGENTS.md`, `.claude/CLAUDE.md`, `.mavis/AGENTS.md`, and `.opencode/AGENTS.md`.
 
 ## Cross-tool setup
 
-- Treat this file as the **shared** entry for any agent (Cursor, Claude Code, or other).
-- Tool maps live in `.cursor/AGENTS.md` / `.claude/CLAUDE.md` when that tool is installed.
+- Treat this file as the **shared** entry for any agent (Cursor, Claude Code, Mavis, OpenCode, or other).
+- All four platforms ship **the same** root file. `init` overwrites it; content does not depend on which tool ran last.
+- Tool maps (agent-team tables, slash commands) live in `.cursor/AGENTS.md` / `.claude/CLAUDE.md` / `.mavis/AGENTS.md` / `.opencode/AGENTS.md` — use them when that tool is installed.
 - Install:
 
 ```bash
-npx @bonesofspring/ai-rules init cursor --preset android-kotlin
-npx @bonesofspring/ai-rules init claude --preset android-kotlin
+npx @bonesofspring/ai-rules init multi --preset android-kotlin
 ```
 
-`init` overwrites this file from the preset (`REPO_AGENTS.md` → `AGENTS.md`). Living gotchas and local type names belong in `team/conventions.md`, not here.
+Per-tool: `init cursor|claude|mavis|opencode --preset android-kotlin`. `init` overwrites this file from the preset (`REPO_AGENTS.md` → `AGENTS.md`). `clean` of one tool leaves this file if another tool install remains. Living gotchas belong in `.ai.local/conventions.md`, not here.
+
+## Presence-based load
+
+When the tree exists, read the tool map, then the essential rules. Do not preload the full catalog.
+
+- If `.cursor/` exists: read `.cursor/AGENTS.md`.
+- If `.claude/` exists: read `.claude/CLAUDE.md`.
+- If `.mavis/` exists: read `.mavis/AGENTS.md`, then `.mavis/rules/android-app-core.md`, `.mavis/rules/architecture-boundaries.md`, `.mavis/rules/code-quality-and-refactoring.md`, `.mavis/rules/ai-local-overlay.md`.
+- If `.opencode/` exists: read `.opencode/AGENTS.md`, then `.opencode/rules/android-app-core.md`, `.opencode/rules/architecture-boundaries.md`, `.opencode/rules/code-quality-and-refactoring.md`, `.opencode/rules/ai-local-overlay.md`.
+
+Mavis has no native rule discovery without those root paths. OpenCode has no `alwaysApply` engine — the four `.opencode/rules/*.md` files above are the always-on set.
+
+## Pipelines are shared
+
+`/task` slug, `status.json`, and `metrics.json` live under `.ai.local/team/tasks/<slug>/`. Cursor, Claude, Mavis, and OpenCode share this folder (including `init multi`).
 
 ## Commands (test / lint / build)
 
@@ -40,9 +55,20 @@ After code edits: invoke **`post-change-build`** (requestable) + **`gradle-tooli
 |------|-----|
 | Cursor | `.cursor/AGENTS.md` (optional if Cursor not installed) |
 | Claude Code | `.claude/CLAUDE.md` (optional if Claude not installed) |
+| Mavis | `.mavis/AGENTS.md` (optional if Mavis not installed) |
+| OpenCode | `.opencode/AGENTS.md` (optional if OpenCode not installed) |
 
-Rules: `.cursor/rules/` or `.claude/rules/`. Skills: `.cursor/skills/` or `.claude/skills/`. UI tests: `instrumentation-test-*` (never Playwright/XCUITest as required handoffs).
+Rules: `.cursor/rules/`, `.claude/rules/`, `.mavis/rules/`, or `.opencode/rules/`.
+Skills: `.cursor/skills/`, `.claude/skills/`, `.mavis/skills/`, or `.opencode/skills/`.
 
 ## Living conventions
 
-Local type names (ViewModel base, DI holders, design-system package), flavors, and wrapper quirks: **`.cursor/team/conventions.md`** and/or **`.claude/team/conventions.md`** (fill after init).
+Gotchas, local patterns, and team decisions: **`.ai.local/conventions.md`** (fill after init; `init` does not overwrite it).
+
+## 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`.
+
+Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package. The `ai-local-overlay` rule (always-on for Cursor, on-demand for Claude) is the mechanism; this `MANDATORY` section is the reinforcement.

package/presets/cursor/android-kotlin/agents/README.md

@@ -1,6 +1,6 @@
 # Agents (android-kotlin)
 
-Full agent-team roster (~22). Production-write policy matches ios-swift mobile depth with Gradle + instrumentation.
+Full agent-team roster (~24). Production-write policy matches ios-swift mobile depth with Gradle + instrumentation.
 
 ## Rename map (from next / ios-swift / java)
 

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

@@ -9,8 +9,8 @@ You are an accessibility reviewer for an **Android Kotlin / Jetpack Compose** (a
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/brief.md` — acceptance criteria and UI scope.
-2. `.cursor/team/tasks/<slug>/decomposition.md` — UI-related tasks.
+1. `.ai.local/team/tasks/<slug>/brief.md` — acceptance criteria and UI scope.
+2. `.ai.local/team/tasks/<slug>/decomposition.md` — UI-related tasks.
 3. Git diff for changed Views / UI under `features/**/Presentation/**` (and design-system if touched).
 4. `compose-ui.mdc` and project a11y conventions.
 
@@ -26,7 +26,7 @@ You are an accessibility reviewer for an **Android Kotlin / Jetpack Compose** (a
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/a11y-review.md`:
+Write `.ai.local/team/tasks/<slug>/a11y-review.md`:
 
 ```markdown
 # Accessibility review: <slug>
@@ -56,7 +56,7 @@ Load requestable rule `mcp-usage` when verifying third-party library APIs (Conte
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, implementation or UI diff scope, and prior review artifacts when present.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, implementation or UI diff scope, and prior review artifacts when present.
 - **Owned outputs:** `a11y-review.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `a11y-review`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `changes_requested`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

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

@@ -9,7 +9,7 @@ You are an API contract reviewer for a layered **Android Kotlin** Feature module
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/brief.md`, `decomposition.md`, `architecture.md` if present.
+1. `.ai.local/team/tasks/<slug>/brief.md`, `decomposition.md`, `architecture.md` if present.
 2. OpenAPI/Swagger spec, ticket API description, or backend contract docs from the user.
 3. Changed files: DTO models, mappers, API clients/services, mocks/fixtures under Data (and Domain entities).
 
@@ -27,7 +27,7 @@ Apply `networking-data.mdc`, `architecture-boundaries.mdc`, `module-public-api.m
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/api-contract-review.md`:
+Write `.ai.local/team/tasks/<slug>/api-contract-review.md`:
 
 ```markdown
 # API contract review: <slug>
@@ -59,7 +59,7 @@ Write the owned terminal receipt described under **Artifact contract**.
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
 - **Owned outputs:** `api-contract-review.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `api-contract-review`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `changes_requested`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

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

@@ -11,8 +11,8 @@ You **validate** Android/Kotlin implementation quality — do not edit productio
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/brief.md` and `decomposition.md`.
-2. `.cursor/team/tasks/<slug>/pipeline.json` — step context and `scope`.
+1. `.ai.local/team/tasks/<slug>/brief.md` and `decomposition.md`.
+2. `.ai.local/team/tasks/<slug>/pipeline.json` — step context and `scope`.
 3. Git diff / changed files (Kotlin/Android modules or preset paths).
 
 ## App / feature validation (default)
@@ -37,7 +37,7 @@ When validating **android-kotlin preset** changes (or `scope: preset-structure-v
 
 ### FAIL (android-kotlin packaging)
 
-1. **Token budget:** Cursor `alwaysApply: true` count ≤ **3**; Claude rules without `paths:` === **3** (**exclude `**/README.md`**). Meta `preset-*` rules must **not** be always-on.
+1. **Token budget:** Cursor `alwaysApply: true` count 3–5; Claude rules without `paths:` 3–5 (**exclude `**/README.md`**). Meta `preset-*` rules must **not** be always-on.
 2. **Chain fork:** `hooks/chain-team-phases.sh` byte-≠ every other stack (Cursor + Claude).
 3. **Forbidden handoff strings** in android-kotlin `chain-team-phases.sh` (Cursor + Claude): `playwright-test-`, `playwright-agents`, `playwright-e2e`, `user-playwright`, `app/__tests__/e2e`, `xcuitest-test-`, positive `xcodebuild` / `SwiftLint` as required handoffs, positive yarn `lint:js` / `lint:css`.
 4. **Required handoff stems:** `AGENT_HANDOFF` includes `instrumentation-test-planner` (or generator/healer); `build-verifier` prose mentions `gradle-tooling` and/or `post-change-build`.
@@ -45,7 +45,7 @@ When validating **android-kotlin preset** changes (or `scope: preset-structure-v
 6. **Twin presence (hard):** Cursor rule → Claude twin + mapping row — **FAIL** if missing.
 7. **Mapping / README:** `claude/android-kotlin/rules/README.md` mapping table present.
 8. **shared-core consumers:** if `_shared/core/**` changed, matching embeds updated (or intentional fork documented).
-9. **Session-start body budget:** sum of the 3 always-on / session-start bodies ≤ **140** lines.
+9. **Session-start body budget:** sum of the intended always-on / session-start bodies ≤ **200** lines.
 10. **Embed drift:** `packages/ai-rules/scripts/check-shared-core-drift.sh` with `AI_RULES_DRIFT_FAIL=1`.
 11. **Root AGENTS template:** ship `REPO_AGENTS.md` → **FAIL** if missing.
 12. **Hooks cookbook:** `hooks.json` must **not** reference `hooks/examples/`.
@@ -65,7 +65,7 @@ When validating **android-kotlin preset** changes (or `scope: preset-structure-v
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/validation-report.md` with verdict, commands, failures, changed files.
+Write `.ai.local/team/tasks/<slug>/validation-report.md` with verdict, commands, failures, changed files.
 
 ## On completion
 
@@ -75,7 +75,7 @@ Write the owned validation receipt (`completed` or `validation_failed`). Do not
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied.
 - **Owned outputs:** `validation-report.md`; upsert only the assigned manifest entry; preserve foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs; emit `completed` or `validation_failed`.
 - **Shared state:** never mutate `status.json` or `metrics.json`.

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

@@ -12,7 +12,7 @@ Use the **`ci-investigation` skill** for the investigation loop.
 ## Inputs
 
 1. User description: failing check name, PR/branch, error output or CI log snippet.
-2. `.cursor/team/tasks/<slug>/pipeline.json` and `brief.md` if present.
+2. `.ai.local/team/tasks/<slug>/pipeline.json` and `brief.md` if present.
 3. Local reproduction: same scheme, configuration, and destination CI uses (`gradle-tooling.mdc`).
 
 ## Process
@@ -22,7 +22,7 @@ Use the **`ci-investigation` skill** for the investigation loop.
 3. Reproduce locally when feasible (`./gradlew build` / `./gradlew test` / lint scripts as in repo CI).
 4. Inspect changed files in the git diff related to the failure.
 5. Apply **minimal** fix — do not refactor unrelated code.
-6. Document in `.cursor/team/tasks/<slug>/ci-report.md`:
+6. Document in `.ai.local/team/tasks/<slug>/ci-report.md`:
 
 ```markdown
 # CI report: <slug>
@@ -70,7 +70,7 @@ If a Sentry/Datadog (or similar) MCP is ready and the task is a production error
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
 - **Owned outputs:** `ci-report.md` plus any minimal CI fix paths; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `ci-report`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `blocked`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

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

@@ -5,14 +5,14 @@ readonly: false
 model: fast
 ---
 
-You are a senior Android / Kotlin / Jetpack Compose code reviewer. You may write only review artifacts under `.cursor/team/**` and terminal receipts; do not modify production code.
+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
 
-1. `.cursor/team/tasks/<slug>/brief.md` — verify implementation matches acceptance criteria.
-2. `.cursor/team/tasks/<slug>/decomposition.md` — check coverage of planned tasks.
+1. `.ai.local/team/tasks/<slug>/brief.md` — verify implementation matches acceptance criteria.
+2. `.ai.local/team/tasks/<slug>/decomposition.md` — check coverage of planned tasks.
 3. Git diff for changed files (`git diff`, `git status`).
-4. `.cursor/team/tasks/<slug>/validation-report.md` if `build-verifier` already ran.
+4. `.ai.local/team/tasks/<slug>/validation-report.md` if `build-verifier` already ran.
 
 Apply the **`code-review` skill** and `code-review-mr.mdc` checklist. Also weigh `architecture-boundaries.mdc`, `kotlin-conventions.mdc`, `compose-ui.mdc`, `networking-data.mdc`, `tests-unit.mdc`, `tests-ui.mdc`.
 
@@ -38,7 +38,7 @@ You **issue** reviews. Implementers acting on your findings must verify each ite
 
 ## Review artifact
 
-Write `.cursor/team/tasks/<slug>/review.md` with this format:
+Write `.ai.local/team/tasks/<slug>/review.md` with this format:
 
 ```markdown
 # Code review: <slug>
@@ -74,7 +74,7 @@ Do not mix this output with retrospective facilitation — keep review and retro
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, implementation, validation evidence, and the scoped git diff.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, implementation, validation evidence, and the scoped git diff.
 - **Owned outputs:** `review.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `review`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `changes_requested`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

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

@@ -9,8 +9,8 @@ You are an expert debugger for an **Android Kotlin/Jetpack Compose** app. Use th
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/brief.md` if present; else the user task description.
-2. `.cursor/team/tasks/<slug>/pipeline.json` for context.
+1. `.ai.local/team/tasks/<slug>/brief.md` if present; else the user task description.
+2. `.ai.local/team/tasks/<slug>/pipeline.json` for context.
 3. Error messages, stack traces, crash logs, failing JUnit/Android instrumentation output, or reproduction steps from the user.
 
 ## Process
@@ -19,7 +19,7 @@ You are an expert debugger for an **Android Kotlin/Jetpack Compose** app. Use th
 2. Prefer **runtime evidence** before coding: Android Studio / AGP console, lldb, Android Studio Profiler (CPU / Memory when relevant), JUnit/Android instrumentation logs, Logcat / Timber output.
 3. Inspect relevant Feature layers (Presentation / Domain / Data) via Read/Grep — do not guess.
 4. Form hypothesis; falsify with the smallest check (targeted unit test, breakpoint path, or narrow `./gradlew test`).
-5. Document root cause in `.cursor/team/tasks/<slug>/debug-report.md`:
+5. Document root cause in `.ai.local/team/tasks/<slug>/debug-report.md`:
 
 ```markdown
 # Debug report: <slug>
@@ -72,7 +72,7 @@ If a Sentry/Datadog (or similar) MCP is ready and the task is a production error
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
 - **Owned outputs:** `debug-report.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `debug`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `blocked`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

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

@@ -9,7 +9,7 @@ You are a senior Android developer (Jetpack Compose-first, Gradle modules as in
 
 ## Before coding
 
-1. Read `.cursor/team/tasks/<slug>/brief.md`, `decomposition.md`, prior artifacts.
+1. Read `.ai.local/team/tasks/<slug>/brief.md`, `decomposition.md`, prior artifacts.
 2. `status.json` must allow work (`in_progress` / `approved` / `retryAfterFix`).
 3. Follow skill **`feature-delivery`** + `feature-delivery-workflow.mdc` + `reference-features.mdc`.
 4. **Verify carry-over at HEAD before applying** (refactor intent only). When the brief comes from a prior review's carry-over findings list, for each item run `git show HEAD:<path>` or `grep` to confirm the finding still applies at the current HEAD; if the file already contains the fix (carry-over was closed in a prior uncommitted batch), mark it as **NO-OP at HEAD** in `implementation.md` and skip the edit; if the file is unchanged, apply the fix and cite file:line. Target ≤2 NO-OP items per refactor pipeline.
@@ -92,7 +92,7 @@ applyReadiness:
 
 **Code Map + Suggested Review Order:** when this WP spans **>1 layer or module**, add to `implementation.md` a Code Map (3–8 annotated paths) and Suggested Review Order lines `concern | path:line | ≤15 words`. Omit for single-file / single-layer WPs.
 
-**Memlog:** append implementation decisions to `.cursor/team/tasks/<slug>/.memlog.md` (append-only).
+**Memlog:** append implementation decisions to `.ai.local/team/tasks/<slug>/.memlog.md` (append-only).
 
 
 
@@ -103,7 +103,7 @@ Load requestable rule `mcp-usage` when verifying third-party library APIs (Conte
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, current scope, and applicable prior findings.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, current scope, and applicable prior findings.
 - **Owned outputs:** `implementation.md` plus changed implementation/test paths; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `implementation`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `blocked`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

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

@@ -9,13 +9,13 @@ You are a migration specialist for an **Android Kotlin** codebase with Feature-m
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/brief.md` and `decomposition.md`.
+1. `.ai.local/team/tasks/<slug>/brief.md` and `decomposition.md`.
 2. Current stack: Android Studio / AGP version, Android deployment target, Gradle modules / `gradle/libs.versions.toml` / `build-logic/` conventions.
 3. `architecture-boundaries.mdc`, `feature-delivery-workflow.mdc`, `gradle-tooling.mdc`, `networking-data.mdc` / `persistence-data.mdc` when relevant.
 
 ## Deliverable
 
-Write `.cursor/team/tasks/<slug>/migration-plan.md`:
+Write `.ai.local/team/tasks/<slug>/migration-plan.md`:
 
 ```markdown
 # Migration plan: <slug>
@@ -68,7 +68,7 @@ Load requestable rule `mcp-usage` when verifying third-party library APIs (Conte
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `brief.md`, `decomposition.md`, and other authoritative prior artifacts for this step.
 - **Owned outputs:** `migration-plan.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `migration-plan`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `blocked`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

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

@@ -7,11 +7,11 @@ model: claude-opus-4-8[effort=high]
 
 You are a Figma mockup reviewer for an Android Kotlin / Jetpack Compose frontend.
 
-You write **only** `.cursor/team/tasks/<slug>/mockup-review.md` (and the owned manifest receipt). Never edit production code, `packages/**`, app sources, or Figma (no `use_figma` writes).
+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).
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/artifact-manifest.json`.
+1. `.ai.local/team/tasks/<slug>/artifact-manifest.json`.
 2. Prompt Figma URL(s); `brief.md` / `decomposition.md` when present.
 3. Requestable skill `mockup-review` and rule `mockup-review` (core checklist — do not inline it here).
 4. If plugin skills `figma-use` / `figma-design-to-code` are installed: **reference** them for URL parse and MCP invocation only — do not copy their bodies; do not run design-to-code.
@@ -36,7 +36,7 @@ Follow the requestable `mockup-review` checklist (DS components, tokens, quality
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/mockup-review.md` using the report headings in the `mockup-review` rule.
+Write `.ai.local/team/tasks/<slug>/mockup-review.md` using the report headings in the `mockup-review` rule.
 
 ## Verdicts and receipts
 
@@ -52,7 +52,7 @@ Standalone FAIL must **not** set `changes_requested`. Embedded FAIL is a FAIL-on
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for routing + analysis when present (standalone may have only the prompt + URL).
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for routing + analysis when present (standalone may have only the prompt + URL).
 - **Owned outputs:** `mockup-review.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `mockup-review`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed`, `changes_requested`, or `blocked` per the table above. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.

package/presets/cursor/android-kotlin/agents/openspec-author.md

@@ -22,8 +22,8 @@ If `openspec/` is absent in the repo, stop and report `blocked` with the message
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/{brief.md, decomposition.md, architecture.md}` (Claude: `.claude/team/tasks/<slug>/`).
-2. `.cursor/team/tasks/<slug>/artifact-manifest.json` — read first, consume `artifactInputIds`.
+1. `.ai.local/team/tasks/<slug>/{brief.md, decomposition.md, architecture.md}` (Claude: `.ai.local/team/tasks/<slug>/`).
+2. `.ai.local/team/tasks/<slug>/artifact-manifest.json` — read first, consume `artifactInputIds`.
 3. `openspec/config.yaml` — schema, context block, `rules.proposal | specs | design | tasks`. **Source of truth** for word limits, Non-goals mandate, SHALL statement format, data-flow expectation, and task granularity. Never fork.
 4. `openspec/specs/<capability>/spec.md` — surviving applied specs (the "as-is" target).
 5. `openspec/changes/archive/<YYYY-MM-DD>-<change-id>/` — prior decisions (D-1..) and open questions (OQ-1..) reusable across changes.
@@ -122,14 +122,14 @@ If `scope` carries multiple phases (e.g. `openspec:<change-id>:propose+apply`),
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition and available architecture/migration/review artifacts.
-- **Owned outputs:** `openspec/changes/<change-id>/**` (proposal.md, design.md, tasks.md, .openspec.yaml, specs/<capability>/spec.md delta) plus the team slot `openspec-change.md` in `.cursor/team/tasks/<slug>/` when the orchestrator asks for a summary handoff. Preserve all foreign entries; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `openspec-change`).
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition and available architecture/migration/review artifacts.
+- **Owned outputs:** `openspec/changes/<change-id>/**` (proposal.md, design.md, tasks.md, .openspec.yaml, specs/<capability>/spec.md delta) plus the team slot `openspec-change.md` in `.ai.local/team/tasks/<slug>/` when the orchestrator asks for a summary handoff. Preserve all foreign entries; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `openspec-change`).
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths under `openspec/changes/<change-id>/**`, attach `openspec validate <change-id> --type change --strict` exit code + deltas-only summary, and emit `completed` or `blocked`. Bind it to the supplied `attemptId` when present.
 - **Shared state:** never create or mutate `status.json` or `metrics.json`; the orchestration runtime/hook owns lifecycle, gates, retries, attempts, and timestamps.
 
 ## Output
 
-When invoked directly (no pipeline), write the spec handoff at `.cursor/team/tasks/<slug>/openspec-change.md`:
+When invoked directly (no pipeline), write the spec handoff at `.ai.local/team/tasks/<slug>/openspec-change.md`:
 
 ```markdown
 # OpenSpec change: <change-id>