@bonesofspring/ai-rules 0.2.24 → 0.2.26

package/presets/claude/nuxt/REPO_AGENTS.md

@@ -1,19 +1,34 @@
 # Nuxt 3 — agent instructions
 
-Cross-tool repo-root guide. 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 (agent-team tables, slash commands) live in `.cursor/AGENTS.md` / `.claude/CLAUDE.md` — use them 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 nuxt
-npx @bonesofspring/ai-rules init claude --preset nuxt
+npx @bonesofspring/ai-rules init multi --preset nuxt
 ```
 
-`init` overwrites this file from the preset (`REPO_AGENTS.md` → `AGENTS.md`). Living gotchas belong in `team/conventions.md`, not here.
+Per-tool: `init cursor|claude|mavis|opencode --preset nuxt`. `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/nuxt-app-core.md`, `.mavis/rules/package-manager.md`, `.mavis/rules/code-quality-and-refactoring.md`, `.mavis/rules/ai-local-overlay.md`.
+- If `.opencode/` exists: read `.opencode/AGENTS.md`, then `.opencode/rules/nuxt-app-core.md`, `.opencode/rules/package-manager.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)
 
@@ -41,9 +56,20 @@ After code edits: invoke **`post-change-lint`** (requestable). Full gate: agent
 |------|-----|
 | 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/`.
+Rules: `.cursor/rules/`, `.claude/rules/`, `.mavis/rules/`, or `.opencode/rules/`.
+Skills: `.cursor/skills/`, `.claude/skills/`, `.mavis/skills/`, or `.opencode/skills/`.
 
 ## Living conventions
 
-Gotchas, local patterns, and team decisions: **`.cursor/team/conventions.md`** and/or **`.claude/team/conventions.md`** (fill after init; not overwritten on every dogfood sync when already present).
+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/claude/nuxt/agents/README.md

@@ -60,7 +60,7 @@ Copied to `.claude/agents/` on `ai-rules init claude --preset nuxt`.
 
 ## Frontmatter `readonly`
 
-All pipeline agents are **`readonly: false`**. They need write access under `.claude/team/**` (`pipeline.json`, `brief.md`, `review.md`, `status.json`, …).
+All pipeline agents are **`readonly: false`**. They need write access under `.ai.local/team/**` (`pipeline.json`, `brief.md`, `review.md`, `status.json`, …).
 
 The “do not touch production / `app/**`” limit is set **in the prompt body**, not via the `readonly` flag. In Claude Code `readonly: true` blocks *any* file edits (including team) — that breaks the pipeline for team agents.
 
@@ -88,120 +88,12 @@ Default SoT — YAML `model` in each agent file. Optional `steps[].model` (`chea
 | `/task <desc>` | Router → dynamic pipeline → first agent |
 | `/task-continue <slug>` | After a human gate |
 
-Rule: `rules/tooling-and-review/agent-team-orchestrator.md`. Plan: `pipeline.json` under `.claude/team/tasks/<slug>/`.
+Rule: `rules/tooling-and-review/agent-team-orchestrator.md`. Plan: `pipeline.json` under `.ai.local/team/tasks/<slug>/`.
 
 ## Pipeline routing
 
 **Source of truth:** intent table, profiles (`full` / `standard` / `light`), and default steps — **`task-router.md`** only. Do not duplicate intent→pipeline tables in entry docs.
 
-## pipeline.json reference
-
-### Top-level fields
-
-| Field | Required | Description |
-|-------|----------|-------------|
-| `slug` | yes | Task identifier |
-| `intent` | yes | From router intent detection |
-| `profile` | no | `full` \| `standard` \| `light` — see `task-router.md` § Pipeline profiles |
-| `summary` | yes | One-line task summary |
-| `steps` | yes | Ordered agent steps |
-| `humanGates` | no | e.g. `["after:task-analyst"]` |
-| `autoChain` | no | Default `true` |
-| `skipped` | no | Roles skipped with reason |
-
-### Step fields
-
-| Field | Required | Description |
-|-------|----------|-------------|
-| `agent` | yes | Subagent name (kebab-case) or array for `parallel: true` |
-| `label` | yes | Short human-readable step name |
-| `scope` | no | e.g. `unit-in-dev`, `e2e-only`, `regression`, `full` |
-| `skipIf` | no | `debugger.fixed` \| `ci-investigator.resolved` |
-| `parallel` | no | When `true` and `agent` is array — invoke all in one turn |
-| `model` | no | `cheap` \| `standard` \| `strong` — pipeline tier override; omit → agent frontmatter |
-
-### Minimal template
-
-```json
-{
-  "slug": "<slug>",
-  "intent": "feature",
-  "summary": "One-line task summary",
-  "steps": [
-    { "agent": "task-analyst", "label": "Clarify and decompose" },
-    { "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
-    { "agent": "build-verifier", "label": "Lint, check, unit smoke" },
-    { "agent": "code-reviewer", "label": "Code review" }
-  ],
-  "humanGates": ["after:task-analyst"],
-  "autoChain": true,
-  "skipped": []
-}
-```
-
-### Example: parallel reviewers + model tiers
-
-```json
-{
-  "intent": "feature",
-  "profile": "full",
-  "steps": [
-    { "agent": "task-analyst", "label": "Clarify" },
-    { "agent": "solution-architect", "label": "Design boundaries", "model": "strong" },
-    { "agent": "feature-developer", "label": "Implement", "scope": "unit-in-dev" },
-    { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" },
-    {
-      "agent": ["accessibility-reviewer", "security-reviewer"],
-      "parallel": true,
-      "label": "A11y and security",
-      "model": "strong"
-    },
-    { "agent": "code-reviewer", "label": "Review", "model": "cheap" }
-  ],
-  "humanGates": ["after:task-analyst"]
-}
-```
-
-### Example: light profile with cheap models
-
-```json
-{
-  "intent": "feature",
-  "profile": "light",
-  "steps": [
-    { "agent": "feature-developer", "label": "Implement", "model": "cheap" },
-    { "agent": "build-verifier", "label": "Validation gate", "model": "cheap" }
-  ],
-  "humanGates": []
-}
-```
-
-### Example: bugfix skipIf
-
-```json
-{
-  "intent": "bugfix",
-  "steps": [
-    { "agent": "debugger", "label": "Root cause" },
-    { "agent": "feature-developer", "label": "Fix if needed", "skipIf": "debugger.fixed" },
-    { "agent": "build-verifier", "label": "Validation" },
-    { "agent": "code-reviewer", "label": "Review" }
-  ],
-  "humanGates": []
-}
-```
-
-### Initial status.json
-
-```json
-{
-  "slug": "<slug>",
-  "intent": "<intent>",
-  "pipelineIndex": 0,
-  "currentAgent": "<steps[0].agent>",
-  "phase": "executing",
-  "state": "in_progress",
-  "awaitingHumanGate": false,
-  "updatedAt": "<ISO8601>"
-}
-```
+## Artifacts
+
+Schema: `.ai.local/team/README.md`. Intents and profiles: `task-router.md` only.

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

@@ -8,8 +8,8 @@ You are an accessibility reviewer for a Nuxt 3 Vue frontend.
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` — acceptance criteria and UI scope.
-2. `.claude/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 UI files under `components/**`.
 4. `rules/ui-and-accessibility/vue-ui.md` and project a11y conventions.
 
@@ -25,7 +25,7 @@ You are an accessibility reviewer for a Nuxt 3 Vue frontend.
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/a11y-review.md`:
+Write `.ai.local/team/tasks/<slug>/a11y-review.md`:
 
 ```markdown
 # Accessibility review: <slug>
@@ -57,7 +57,7 @@ Shipped browser split: Playwright MCP for e2e specs/selectors; Chrome DevTools M
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/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/claude/nuxt/agents/api-contract-reviewer.md

@@ -8,7 +8,7 @@ You are an API contract reviewer for a layered Nuxt 3 frontend (`@/types`, `@/ap
 
 ## Inputs
 
-1. `.claude/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 in `types/**`, `api/**`, mocks, Pinia store actions.
 
@@ -25,7 +25,7 @@ Apply **`rules/architecture/public-imports.md`**, **`rules/api-and-data/api-serv
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/api-contract-review.md`:
+Write `.ai.local/team/tasks/<slug>/api-contract-review.md`:
 
 ```markdown
 # API contract review: <slug>
@@ -53,7 +53,7 @@ For feature-developer before or during implementation.
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, architecture when present, and changed types/API/mocks against the contract docs.
+- **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, architecture when present, and changed types/API/mocks against the contract docs.
 - **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/claude/nuxt/agents/build-verifier.md

@@ -10,8 +10,8 @@ You are a build verification specialist. You **validate** implementation quality
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` and `decomposition.md`.
-2. `.claude/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 under the project root.
 
 ## Commands (from repository root)
@@ -71,7 +71,7 @@ When ios-swift paths are also in the PR, apply ios-swift verifier checks (chain
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/validation-report.md`:
+Write `.ai.local/team/tasks/<slug>/validation-report.md`:
 
 ```markdown
 # Validation: <slug>
@@ -100,7 +100,7 @@ Do not fix code — report only. Do not advance to code-reviewer until PASS.
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, implementation evidence, pipeline scope, and changed files.
+- **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 evidence, pipeline scope, and changed files.
 - **Owned outputs:** `validation-report.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `validation`) and preserve all foreign entries.
 - **Terminal receipt:** cover applicable AC/task IDs, list authoritative evidence paths, and emit `completed` or `validation_failed`. 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/claude/nuxt/agents/ci-investigator.md

@@ -11,7 +11,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. `.claude/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: run the same commands CI uses (`lint:js`, `lint:css`, `typecheck`, unit/e2e targets from repository root).
 
 ## Process
@@ -20,7 +20,7 @@ Use the **`ci-investigation` skill** for the investigation loop.
 2. Reproduce locally when feasible; inspect changed files in the diff.
 3. Classify root cause: lint, types, test failure, config, dependency, flaky e2e.
 4. Apply **minimal** fix — do not refactor unrelated code.
-5. Document in `.claude/team/tasks/<slug>/ci-report.md`:
+5. Document in `.ai.local/team/tasks/<slug>/ci-report.md`:
 
 ```markdown
 # CI report: <slug>
@@ -56,7 +56,7 @@ If a Sentry/Datadog (or similar) MCP is ready and the task is a production error
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition when present, failing check context, and prior validation/debug artifacts.
+- **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 when present, failing check context, and prior validation/debug artifacts.
 - **Owned outputs:** `ci-report.md` plus any minimal fix paths; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `ci`) 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/claude/nuxt/agents/code-reviewer.md

@@ -4,12 +4,12 @@ description: Expert code review specialist. Reviews after feature development us
 model: fast
 ---
 
-You are a senior code reviewer. You may write only review artifacts under `.claude/team/**` and terminal receipts; do not modify production code.
+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
 
-1. `.claude/team/tasks/<slug>/brief.md` — verify implementation matches acceptance criteria.
-2. `.claude/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`).
 
 Apply the **`code-review` skill** and **`rules/tooling-and-review/code-review-mr.md`** checklist.
@@ -26,7 +26,7 @@ You **issue** reviews. Implementers acting on your findings must verify each ite
 
 - If the MR touches `docs/specs/**`, load **`product-specs`** (+ **`product-specs-authoring`** when new/changed specs): **WARN** code/spec drift; **FAIL** broken INDEX `path` link or missing required frontmatter keys/arrays on touched spec files; required body headings missing → **FAIL** on touched files. Do not invent missing product behavior.
 
-Write `.claude/team/tasks/<slug>/review.md` with this format:
+Write `.ai.local/team/tasks/<slug>/review.md` with this format:
 
 ```markdown
 # Code review: <slug>
@@ -62,7 +62,7 @@ Do not mix this output with retrospective facilitation — keep review and retro
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/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/claude/nuxt/agents/debugger.md

@@ -8,8 +8,8 @@ You are an expert debugger for a Nuxt 3 TypeScript frontend. Use the **`debug-in
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` if present; else the user task description.
-2. `.claude/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, failing test output, or reproduction steps from the user.
 
 ## Process
@@ -17,7 +17,7 @@ You are an expert debugger for a Nuxt 3 TypeScript frontend. Use the **`debug-in
 1. Capture error message, stack trace, and reproduction steps.
 2. Inspect relevant code — do not guess.
 3. Form hypothesis; verify with minimal checks.
-4. Document root cause in `.claude/team/tasks/<slug>/debug-report.md`:
+4. Document root cause in `.ai.local/team/tasks/<slug>/debug-report.md`:
 
 ```markdown
 # Debug report: <slug>
@@ -63,7 +63,7 @@ If a Sentry/Datadog (or similar) MCP is ready and the task is a production error
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition when present, failing evidence, and related prior artifacts.
+- **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 when present, failing evidence, and related prior artifacts.
 - **Owned outputs:** `debug-report.md` plus any minimal fix paths; 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/claude/nuxt/agents/feature-developer.md

@@ -8,7 +8,7 @@ You are a senior frontend developer working in a Nuxt 3 monorepo with strict lay
 
 ## Before coding
 
-1. Read `.claude/team/tasks/<slug>/brief.md`, `decomposition.md`, and prior artifacts if present.
+1. Read `.ai.local/team/tasks/<slug>/brief.md`, `decomposition.md`, and prior artifacts if present.
 2. Read `status.json` — proceed if `in_progress`, `approved`, or `retryAfterFix`.
 3. Read `pipeline.json` for step context and scope.
 4. Follow the **`feature-delivery` skill** (layer order, reference features, validation handoff).
@@ -88,7 +88,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 `.claude/team/tasks/<slug>/.memlog.md` (append-only).
+**Memlog:** append implementation decisions to `.ai.local/team/tasks/<slug>/.memlog.md` (append-only).
 
 
 
@@ -101,7 +101,7 @@ Shipped browser split: Playwright MCP for e2e specs/selectors; Chrome DevTools M
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/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/claude/nuxt/agents/migration-specialist.md

@@ -8,13 +8,13 @@ You are a migration specialist for a Nuxt 3 frontend with strict layer boundarie
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` and `decomposition.md`.
+1. `.ai.local/team/tasks/<slug>/brief.md` and `decomposition.md`.
 2. Current stack versions from `package.json`, lockfile, and existing patterns.
 3. `rules/architecture/architecture-boundaries.md`, `rules/architecture/feature-delivery-workflow.md`, `rules/api-and-data/http-client.md` when relevant.
 
 ## Deliverable
 
-Write `.claude/team/tasks/<slug>/migration-plan.md`:
+Write `.ai.local/team/tasks/<slug>/migration-plan.md`:
 
 ```markdown
 # Migration plan: <slug>
@@ -61,7 +61,7 @@ Load requestable rule `mcp-usage` when verifying third-party library APIs (Conte
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition and stack/version context from the repo.
+- **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 stack/version context from the repo.
 - **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/claude/nuxt/agents/mockup-reviewer.md

@@ -6,11 +6,11 @@ model: opus
 
 You are a Figma mockup reviewer for a Nuxt 3 Vue frontend.
 
-You write **only** `.claude/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. `.claude/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.
@@ -35,7 +35,7 @@ Follow the requestable `mockup-review` checklist (DS components, tokens, quality
 
 ## Output
 
-Write `.claude/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
 
@@ -51,7 +51,7 @@ Standalone FAIL must **not** set `changes_requested`. Embedded FAIL is a FAIL-on
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/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/claude/nuxt/agents/openspec-author.md

@@ -21,8 +21,8 @@ If `openspec/` is absent in the repo, stop and report `blocked` with the message
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/{brief.md, decomposition.md, architecture.md}` (Cursor: `.cursor/team/tasks/<slug>/`).
-2. `.claude/team/tasks/<slug>/artifact-manifest.json` — read first, consume `artifactInputIds`.
+1. `.ai.local/team/tasks/<slug>/{brief.md, decomposition.md, architecture.md}` (Cursor: `.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.
@@ -121,14 +121,14 @@ If `scope` carries multiple phases (e.g. `openspec:<change-id>:propose+apply`),
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/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 `.claude/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 `.claude/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>

package/presets/claude/nuxt/agents/performance-auditor.md

@@ -8,7 +8,7 @@ You are a frontend performance auditor for a Nuxt 3 Vue application.
 
 ## Inputs
 
-1. Task description or `.claude/team/tasks/<slug>/brief.md`.
+1. Task description or `.ai.local/team/tasks/<slug>/brief.md`.
 2. Git diff or specified files/routes to audit.
 3. `rules/stack/nuxt-app-core.md`, `rules/ui-and-accessibility/vue-ui.md`, store/API patterns for data-fetching review.
 
@@ -25,7 +25,7 @@ You are a frontend performance auditor for a Nuxt 3 Vue application.
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/perf-report.md`:
+Write `.ai.local/team/tasks/<slug>/perf-report.md`:
 
 ```markdown
 # Performance audit: <slug>
@@ -60,7 +60,7 @@ If Chrome DevTools MCP is ready and the app is running, use it for console/netwo
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief when present and the scoped git diff / routes under audit.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief when present and the scoped git diff / routes under audit.
 - **Owned outputs:** `perf-report.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `perf-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/claude/nuxt/agents/qa-tester.md

@@ -8,8 +8,8 @@ You are a QA engineer for a Nuxt 3 frontend with Jest/Vitest unit tests and Play
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` — acceptance criteria drive test scenarios.
-2. `.claude/team/tasks/<slug>/decomposition.md` — test-related tasks (unit, e2e).
+1. `.ai.local/team/tasks/<slug>/brief.md` — acceptance criteria drive test scenarios.
+2. `.ai.local/team/tasks/<slug>/decomposition.md` — test-related tasks (unit, e2e).
 3. Reviewer notes if `changes_requested` was resolved.
 
 ## Test strategy
@@ -37,7 +37,7 @@ When the task is mostly e2e, prefer invoking the dedicated `playwright-test-plan
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, reviewer notes when present, and prior implementation/validation artifacts.
+- **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, reviewer notes when present, and prior implementation/validation artifacts.
 - **Owned outputs:** changed/added test paths (and any QA notes written under the slug dir); upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `qa-tester`) 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/claude/nuxt/agents/security-reviewer.md

@@ -8,8 +8,8 @@ You are a frontend security reviewer for a Nuxt 3 TypeScript application.
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` and `decomposition.md`.
-2. `.claude/team/tasks/<slug>/review.md` if code-reviewer already ran.
+1. `.ai.local/team/tasks/<slug>/brief.md` and `decomposition.md`.
+2. `.ai.local/team/tasks/<slug>/review.md` if code-reviewer already ran.
 3. Git diff — focus on auth, forms, API integration, env usage, user-generated content.
 
 ## Review scope
@@ -26,7 +26,7 @@ Load `tooling-and-review/security-nuxt.md` for coding-time invariants. Focus on:
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/security-review.md`:
+Write `.ai.local/team/tasks/<slug>/security-review.md`:
 
 ```markdown
 # Security review: <slug>
@@ -50,7 +50,7 @@ PASS | PASS_WITH_NOTES | FAIL
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition, prior `review.md` when present, 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, prior `review.md` when present, and the scoped git diff.
 - **Owned outputs:** `security-review.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `security-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/claude/nuxt/agents/solution-architect.md

@@ -8,13 +8,13 @@ You are a solution architect for a Nuxt 3 frontend with strict layer boundaries
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` and `decomposition.md` (from analyst).
-2. `.claude/team/tasks/<slug>/pipeline.json`.
+1. `.ai.local/team/tasks/<slug>/brief.md` and `decomposition.md` (from analyst).
+2. `.ai.local/team/tasks/<slug>/pipeline.json`.
 3. Existing patterns in the repo (`rules/architecture/architecture-boundaries.md`, `rules/architecture/feature-delivery-workflow.md`).
 
 ## Deliverable
 
-Write `.claude/team/tasks/<slug>/architecture.md`:
+Write `.ai.local/team/tasks/<slug>/architecture.md`:
 
 ```markdown
 # Architecture: <slug>
@@ -60,7 +60,7 @@ Load requestable rule `mcp-usage` when verifying third-party library APIs (Conte
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.claude/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for brief/decomposition and applicable prior analysis artifacts.
+- **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 applicable prior analysis artifacts.
 - **Owned outputs:** `architecture.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `architecture`) 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.