@bonesofspring/ai-rules 0.2.24 → 0.2.26

package/presets/cursor/nuxt/agents/task-analyst.md

@@ -7,7 +7,7 @@ model: fast
 
 You are a senior business/technical analyst for a Nuxt 3 frontend team.
 
-Your job is to reach **Definition of Ready (DoR)** before any implementation starts. You may write only `.cursor/team/**` artifacts. You do **not** write production code or modify application source files.
+Your job is to reach **Definition of Ready (DoR)** before any implementation starts. You may write only `.ai.local/team/**` artifacts. You do **not** write production code or modify application source files.
 
 ## Classify first
 
@@ -40,7 +40,7 @@ Before writing artifacts, confirm:
 
 ## Artifacts (required output)
 
-Create or update files under `.cursor/team/tasks/<slug>/`:
+Create or update files under `.ai.local/team/tasks/<slug>/`:
 
 ### `brief.md`
 
@@ -88,7 +88,7 @@ Create or update files under `.cursor/team/tasks/<slug>/`:
 
 The orchestration runtime/hook owns `status.json`; the analyst does not create or mutate lifecycle fields.
 
-Also write `.cursor/team/active-task.json`:
+Also write `.ai.local/team/active-task.json`:
 
 ```json
 { "slug": "<slug>" }
@@ -123,7 +123,7 @@ Do not invoke the developer or any implementation subagent.
 
 **`none`:** skip INDEX row requirement and author mode; do not invent a dummy INDEX.
 
-**Research-before-spec (opt-in):** load skill **`spec-discovery`** only when the user/AC asks research before authoring (not default consume `/task`). Run a **subset** of methods; **`claim-ledger` is mandatory** whenever the skill loads. Append chronological notes to `.cursor/team/tasks/<slug>/.memlog.md` (append-only; do not mutate `status.json`).
+**Research-before-spec (opt-in):** load skill **`spec-discovery`** only when the user/AC asks research before authoring (not default consume `/task`). Run a **subset** of methods; **`claim-ledger` is mandatory** whenever the skill loads. Append chronological notes to `.ai.local/team/tasks/<slug>/.memlog.md` (append-only; do not mutate `status.json`).
 
 **applyReadiness (author blocked):** if specs are drafted but the human gate has not passed, or a required named spec is missing, emit `applyReadiness: { "state": "blocked", "contextFiles": ["…"] }` on the analysis receipt. Do not invoke feature-developer.
 
@@ -149,7 +149,7 @@ Load requestable skill **`ux-design`** and rule **`ux-design`** when:
 
 **Order:** write `ux-design.md` **before** author mode / skill `spec-authoring` when both apply. You remain the only INDEX writer.
 
-Write `.cursor/team/tasks/<slug>/ux-design.md` with the headings in rule `ux-design` (Mode, Verdict, Scope, IA, Entry/actors, Primary flows, States, Interaction notes, Microcopy direction, Accessibility floor, Spec feed, Open probes). Modes: `synthesize` | `review`.
+Write `.ai.local/team/tasks/<slug>/ux-design.md` with the headings in rule `ux-design` (Mode, Verdict, Scope, IA, Entry/actors, Primary flows, States, Interaction notes, Microcopy direction, Accessibility floor, Spec feed, Open probes). Modes: `synthesize` | `review`.
 
 **Required vs advisory:** required-signal + missing named primary flows **or** empty/error/loading matrix → DoR not met (`open_questions` / blocked analysis). Isolated missing microcopy never blocks. Advisory `INCOMPLETE` → notes only. Do **not** copy the mockup FAIL-only hook.
 
@@ -167,7 +167,7 @@ If the prompt/brief has a tracker URL (Linear/Jira/Notion/…) and that MCP is r
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume `pipeline.json`, the manifest routing entry, user-approved decisions, and any authoritative architecture/approval entries.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume `pipeline.json`, the manifest routing entry, user-approved decisions, and any authoritative architecture/approval entries.
 - **Owned outputs:** `brief.md` and `decomposition.md` (plus `ux-design.md` when produced); upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `analysis`) 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/nuxt/agents/task-router.md

@@ -10,7 +10,7 @@ You are a task router for a Nuxt 3 frontend agent team. You **do not** implement
 ## Inputs
 
 - User task description (from `/task` or orchestrator).
-- Optional: existing files under `.cursor/team/tasks/<slug>/`.
+- Optional: existing files under `.ai.local/team/tasks/<slug>/`.
 - Pipeline JSON schema, examples, step fields — **`agents/README.md`**.
 
 ## Intent detection
@@ -73,7 +73,7 @@ SoT: `agent-team/task-classification` (shared-core marker above; do not invent a
 | `docs-only` | tech-writer (skip analyst if brief exists) |
 | `ci-fix` | ci-investigator → build-verifier (`skipIf: ci-investigator.resolved`) |
 
-Fixtures: `.cursor/team/fixtures/` (feature-full, feature-light, bugfix-standard).
+Fixtures: `.ai.local/team/fixtures/` (feature-full, feature-light, bugfix-standard).
 
 ## Routing decision rubric
 
@@ -143,7 +143,7 @@ Cursor mapping when orchestrator invokes Task: `cheap` → pass `model: "fast"`
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/pipeline.json` and initialize the routing entry in `artifact-manifest.json`; set `.cursor/team/active-task.json`. The orchestration runtime creates and owns `status.json`.
+Write `.ai.local/team/tasks/<slug>/pipeline.json` and initialize the routing entry in `artifact-manifest.json`; set `.ai.local/team/active-task.json`. The orchestration runtime creates and owns `status.json`.
 
 ## Handoff to orchestrator
 
@@ -179,7 +179,7 @@ Return the routing receipt to the orchestrator. The orchestration runtime/hook e
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume the user request and any existing authoritative task/decision entries.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume the user request and any existing authoritative task/decision entries.
 - **Owned outputs:** `pipeline.json` and the routing manifest entry; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `routing`) 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/nuxt/agents/tech-writer.md

@@ -9,13 +9,13 @@ You are a technical writer for a Nuxt 3 frontend team.
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/brief.md`, `decomposition.md`, `architecture.md`, `migration-plan.md`, `review.md` as available.
+1. `.ai.local/team/tasks/<slug>/brief.md`, `decomposition.md`, `architecture.md`, `migration-plan.md`, `review.md` as available.
 2. Git diff summary or list of changed modules.
 3. User-specified doc target (e.g. `docs/`, feature README, ADR).
 
 ## Deliverable
 
-Write `.cursor/team/tasks/<slug>/documentation.md` and/or update paths agreed in the task:
+Write `.ai.local/team/tasks/<slug>/documentation.md` and/or update paths agreed in the task:
 
 ```markdown
 # Documentation: <slug>
@@ -54,7 +54,7 @@ Post-delivery: when behavior or public docs changed and `docs/specs/` is in play
 
 ## 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.
+- **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:** `documentation.md` (and any explicitly requested docs paths); upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `documentation`) 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/nuxt/agents/unit-test-generator.md

@@ -9,8 +9,8 @@ You generate unit tests from project test plans.
 
 ## Inputs
 
-- `.cursor/team/tasks/<slug>/unit-test-plan.md`
-- `.cursor/team/tasks/<slug>/brief.md` for AC alignment
+- `.ai.local/team/tasks/<slug>/unit-test-plan.md`
+- `.ai.local/team/tasks/<slug>/brief.md` for AC alignment
 - Existing specs and test utilities in the target module area
 
 ## Rules
@@ -28,7 +28,7 @@ Run affected unit tests from repository root when feasible. Report files changed
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `unit-test-plan.md`, brief/decomposition when present, and target modules.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for `unit-test-plan.md`, brief/decomposition when present, and target modules.
 - **Owned outputs:** generated/updated `*.spec.ts` / `*.spec.ts` paths; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `unit-test-generator`) 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/nuxt/agents/unit-test-healer.md

@@ -10,7 +10,7 @@ You debug and fix failing unit tests.
 ## Inputs
 
 - Failing test output and command.
-- Matching `*.spec.ts` / `*.spec.ts` and `.cursor/team/tasks/<slug>/unit-test-plan.md` if present.
+- Matching `*.spec.ts` / `*.spec.ts` and `.ai.local/team/tasks/<slug>/unit-test-plan.md` if present.
 - Recent diff that may have caused the failure.
 
 Use **`unit-testing` skill**, **`debug-investigation` skill**, and **`tests-unit.mdc`**.
@@ -29,7 +29,7 @@ Report root cause, files changed, validation result, and remaining risk.
 
 ## Artifact contract
 
-- **Authoritative inputs:** read `.cursor/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for failing test evidence, `unit-test-plan.md` when present, and recent diff.
+- **Authoritative inputs:** read `.ai.local/team/tasks/<slug>/artifact-manifest.json` first; consume handoff `artifactInputIds` when supplied, otherwise consume the manifest entries for failing test evidence, `unit-test-plan.md` when present, and recent diff.
 - **Owned outputs:** healed `*.spec.ts` / `*.spec.ts` paths (and minimal production fixes only when evidenced); upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `unit-test-healer`) 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/nuxt/agents/unit-test-planner.md

@@ -11,7 +11,7 @@ Use the **`unit-testing` skill** and **`tests-unit.mdc`**.
 
 ## Inputs
 
-1. `.cursor/team/tasks/<slug>/brief.md` and `decomposition.md`.
+1. `.ai.local/team/tasks/<slug>/brief.md` and `decomposition.md`.
 2. Changed or target modules under `**`.
 3. Existing `*.spec.ts` / `*.spec.ts` in the same areas.
 
@@ -24,7 +24,7 @@ Use the **`unit-testing` skill** and **`tests-unit.mdc`**.
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/unit-test-plan.md`:
+Write `.ai.local/team/tasks/<slug>/unit-test-plan.md`:
 
 ```markdown
 # Unit test plan: <slug>
@@ -49,7 +49,7 @@ Test titles in the plan must follow Russian capitalization rules from `tests-uni
 
 ## 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 target modules under `**`.
+- **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 target modules under `**`.
 - **Owned outputs:** `unit-test-plan.md`; upsert only the manifest entry assigned by handoff (`artifactOutputId`; fallback `unit-test-planner`) 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/nuxt/ai-local/conventions.md

@@ -0,0 +1,21 @@
+# Living conventions
+
+Consumer-owned store for post-init gotchas, patterns, and decisions. **Not** always-on. Fill after `ai-rules init`. Root `AGENTS.md` only points here.
+
+## Gotchas
+
+<!-- e.g. fragile flows, “never do X in this repo” -->
+
+-
+
+## Patterns
+
+<!-- local patterns beyond reference-features table -->
+
+-
+
+## Decisions
+
+<!-- short pointers to ADRs / product choices that affect code -->
+
+-

package/presets/cursor/nuxt/commands/README.md

@@ -40,10 +40,10 @@ Slash commands are copied to `.cursor/commands/` on `ai-rules init cursor --pres
 
 ## Related files
 
-- Subagents: `../agents/` (**22** roles, including `task-router.md`, `codebase-analyzer.md`)
+- Subagents: `../agents/` (**24** roles, including `task-router.md`, `codebase-analyzer.md`)
 - Orchestrator: `../rules/agent-team-orchestrator.mdc`
 - Skills: `../skills/` (`feature-delivery`, `code-review`, `debug-investigation`, `ci-investigation`, `unit-testing`, `playwright-e2e`, `technical-retro`)
-- Artifacts: `../team/README.md` (`pipeline.json`, `status.json`)
+- Artifacts: `.ai.local/team/README.md` (`pipeline.json`, `status.json`)
 - Hooks: `../hooks.json`, `../hooks/chain-team-phases.sh`
 
 Create and edit commands via `/commands` in Cursor or directly in this preset folder.

package/presets/cursor/nuxt/commands/spec-start.md

@@ -11,8 +11,8 @@ Routes intent **`spec-gen`** (or bootstrap) → **task-analyst** in **author mod
 
 1. Extract description from arguments after `/spec-start` (domain, page/feature ids, sources).
 2. Generate a **slug** (kebab-case, ≤48 chars), e.g. `spec-<domain>-<id>`.
-3. Ensure `.cursor/team/tasks/<slug>/` exists (Write artifacts; not Shell mkdir).
-4. Write `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
+3. Ensure `.ai.local/team/tasks/<slug>/` exists (Write artifacts; not Shell mkdir).
+4. Write `.ai.local/team/active-task.json` → `{ "slug": "<slug>" }`.
 5. Write minimal `pipeline.json`: task-analyst → (optional stop) → feature-developer only if user asked implement-after. **No separate spec-author agent.**
 6. Invoke **task-analyst** with: author mode; load **`product-specs`** + **`product-specs-authoring`** + skill **`spec-authoring`**; Bootstrap if `docs/specs/` absent, else Generate. Optional: if arguments/AC ask research-before-spec, also load skill **`spec-discovery`** (not default).
 7. Wait for analyst. **Do not** invoke feature-developer until human gate passes.

package/presets/cursor/nuxt/commands/task-continue.md

@@ -13,7 +13,7 @@ Continue the pipeline from `pipeline.json`.
 
 ## Preconditions
 
-1. Read `.cursor/team/tasks/<slug>/pipeline.json` and `status.json`.
+1. Read `.ai.local/team/tasks/<slug>/pipeline.json` and `status.json`.
 2. Continue if:
    - `awaitingHumanGate: true` or `state: awaiting_approval`, **or**
    - `state: changes_requested` (after review), **or**
@@ -21,7 +21,7 @@ Continue the pipeline from `pipeline.json`.
 
 ## Algorithm
 
-1. Write `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
+1. Write `.ai.local/team/active-task.json` → `{ "slug": "<slug>" }`.
 2. **Human gate resume** (`awaitingHumanGate` / `awaiting_approval`):
    1. **Do not** manually increment `pipelineIndex` or invent `currentAgent` first.
    2. Close the gate + activate the next attempt via the **installed** hook (single authority for ledger + status):

package/presets/cursor/nuxt/commands/task.md

@@ -27,7 +27,7 @@ Examples:
 
 ## Algorithm
 
-1. **Slug** — kebab-case from the description (≤48 characters). Create `.cursor/team/tasks/<slug>/` via **Write** (e.g. placeholder `pipeline.json` or empty marker) — runtime/hook owns `status.json` — **not** via Shell `mkdir` (sandbox → `Operation not permitted`).
+1. **Slug** — kebab-case from the description (≤48 characters). Create `.ai.local/team/tasks/<slug>/` via **Write** (e.g. placeholder `pipeline.json` or empty marker) — runtime/hook owns `status.json` — **not** via Shell `mkdir` (sandbox → `Operation not permitted`).
 2. **Router** — invoke subagent **task-router** with the task description and slug path.
 3. **Plan** — show the user the table from `pipeline.json`: intent, steps, skipped, humanGates.
 4. **Intent retro** — if `intent === "retro"`, run `/technical-retro` and **stop**.

package/presets/cursor/nuxt/commands/technical-retro.md

@@ -26,10 +26,10 @@ Ask when missing:
 
 Read from the repository:
 
-- `.cursor/team/tasks/<slug>/pipeline.json`
-- `.cursor/team/tasks/<slug>/brief.md`
-- `.cursor/team/tasks/<slug>/decomposition.md`
-- `.cursor/team/tasks/<slug>/status.json`
+- `.ai.local/team/tasks/<slug>/pipeline.json`
+- `.ai.local/team/tasks/<slug>/brief.md`
+- `.ai.local/team/tasks/<slug>/decomposition.md`
+- `.ai.local/team/tasks/<slug>/status.json`
 - Git diff / `git status` for changed files
 
 Do not invent facts that are not in artifacts, the diff, or the user message.

package/presets/cursor/nuxt/hooks/README.md

@@ -2,7 +2,7 @@
 
 | File | Purpose |
 |------|---------|
-| `chain-team-phases.sh` | Continues pipeline after subagent completes; supports `skipIf`, parallel steps, `validation_failed`, `retryAfterFix` |
+| `chain-team-phases.sh` | Continues `/task` after a subagent stop. Reads/writes `.ai.local/team/` (`skipIf`, parallel, `validation_failed`, human gates). Agents must not patch `status.json` / `metrics.json`. |
 | `guard-shell-command.sh` | Blocks/asks on destructive git commands and package-manager mismatches (`failClosed: true`) |
 
 `hooks.json`: `loop_limit: 15` for long pipelines (build-verifier + parallel reviewers + e2e).

package/presets/cursor/nuxt/hooks/chain-team-phases.sh

@@ -10,7 +10,7 @@ INPUT="$input" node <<'NODE'
 const fs = require('fs');
 const path = require('path');
 
-const TEAM_ROOT = path.join(process.cwd(), '.cursor', 'team');
+const TEAM_ROOT = path.join(process.cwd(), '.ai.local', 'team');
 
 const inputRaw = process.env.INPUT || '';
 let hookInput;
@@ -318,7 +318,7 @@ function findNextExecutableStep(steps, startIdx, dir) {
 
 const AGENT_HANDOFF = {
   'task-analyst': (s) =>
-    `Invoke task-analyst for slug "${s}". Write brief.md and decomposition.md under .cursor/team/tasks/${s}/. ` +
+    `Invoke task-analyst for slug "${s}". Write brief.md and decomposition.md under .ai.local/team/tasks/${s}/. ` +
     `Upsert the analysis receipt in artifact-manifest.json; do not mutate status.json lifecycle fields. Do not use legacy phase analysis.`,
   debugger: (s) =>
     `Invoke debugger subagent for slug "${s}". Investigate root cause; write debug-report.md with fixApplied: true/false. ` +
@@ -655,9 +655,10 @@ function nearestPrecedingStepIndex(agent, fromIndex, fallback) {
 }
 function scheduleRetry(agent, retryAfterFix, predecessor, explicitStepIndex = null) {
   const currentIndex = typeof status.pipelineIndex === 'number' ? status.pipelineIndex : 0;
-  const stepIndex = Number.isInteger(explicitStepIndex)
-    ? explicitStepIndex
-    : nearestPrecedingStepIndex(agent, currentIndex, currentIndex);
+  const explicitOk = Number.isInteger(explicitStepIndex) && getStepAgents(steps[explicitStepIndex]).includes(agent);
+  const stepIndex = explicitOk ? explicitStepIndex : nearestPrecedingStepIndex(agent, currentIndex, -1);
+  // Refuse to activate an agent the pipeline never planned; callers fall back to a human gate.
+  if (stepIndex < 0) return -1;
   const predecessorAttemptId = predecessor?.attemptId || status.lastCompletedAttempt?.attemptId || null;
   appendMetric({ type: 'retry_scheduled', at: now, attemptId: predecessorAttemptId, nextAgent: agent, retryAfterFix: retryAfterFix || null, source: 'hook', attributionConfidence: predecessor ? predecessor.confidence : 'unknown' });
   activateAttempts(steps[stepIndex] || { agent }, stepIndex);
@@ -716,6 +717,18 @@ if (currentStep?.parallel && stepAgents.length > 1) {
         }
       : finishedAttempt;
     const developerIndex = scheduleRetry('feature-developer', retryReviewer, predecessor);
+    if (developerIndex < 0) {
+      beginHumanGate();
+      writeStatus({
+        awaitingHumanGate: true,
+        state: 'awaiting_approval',
+        currentAgent: retryReviewer,
+        parallelCompleted: [],
+        parallelOutcomes: {},
+      });
+      out(`${retryReviewer} requested changes for slug "${slug}" but this pipeline has no feature-developer step. Read the review artifact. Resume only via /task-continue.`);
+      process.exit(0);
+    }
     writeStatus({
       pipelineIndex: developerIndex,
       currentAgent: 'feature-developer',
@@ -758,6 +771,12 @@ if (status.state === 'changes_requested') {
   }
   const retryAfterFixStepIndex = typeof status.pipelineIndex === 'number' ? status.pipelineIndex : 0;
   const developerIndex = scheduleRetry('feature-developer', reviewer, finishedAttempt);
+  if (developerIndex < 0) {
+    beginHumanGate();
+    writeStatus({ awaitingHumanGate: true, state: 'awaiting_approval', currentAgent: reviewer });
+    out(`${reviewer} requested changes for slug "${slug}" but this pipeline has no feature-developer step. Read the review artifact. Resume only via /task-continue.`);
+    process.exit(0);
+  }
   writeStatus({
     pipelineIndex: developerIndex,
     currentAgent: 'feature-developer',
@@ -773,6 +792,12 @@ if (status.state === 'changes_requested') {
 if (status.state === 'validation_failed' && status.currentAgent === 'build-verifier') {
   const retryAfterFixStepIndex = typeof status.pipelineIndex === 'number' ? status.pipelineIndex : 0;
   const developerIndex = scheduleRetry('feature-developer', 'build-verifier', finishedAttempt);
+  if (developerIndex < 0) {
+    beginHumanGate();
+    writeStatus({ awaitingHumanGate: true, state: 'awaiting_approval', currentAgent: 'build-verifier' });
+    out(`Validation failed for slug "${slug}" but this pipeline has no feature-developer step. Read validation-report.md. Resume only via /task-continue.`);
+    process.exit(0);
+  }
   writeStatus({
     pipelineIndex: developerIndex,
     currentAgent: 'feature-developer',
@@ -788,9 +813,13 @@ if (status.state === 'validation_failed' && status.currentAgent === 'build-verif
 if (status.state === 'completed' && status.retryAfterFix) {
   const retry = status.retryAfterFix;
   const retryIndex = scheduleRetry(retry, null, finishedAttempt, status.retryAfterFixStepIndex);
-  writeStatus({ pipelineIndex: retryIndex, currentAgent: retry, state: 'in_progress', retryAfterFix: null, retryAfterFixStepIndex: null });
-  out(handoffForAgent(retry, steps[retryIndex]?.scope, steps[retryIndex]));
-  process.exit(0);
+  if (retryIndex >= 0) {
+    writeStatus({ pipelineIndex: retryIndex, currentAgent: retry, state: 'in_progress', retryAfterFix: null, retryAfterFixStepIndex: null });
+    out(handoffForAgent(retry, steps[retryIndex]?.scope, steps[retryIndex]));
+    process.exit(0);
+  }
+  // The reviewer to re-run is no longer in steps[]; drop the marker and advance normally.
+  writeStatus({ retryAfterFix: null, retryAfterFixStepIndex: null });
 }
 
 if (!currentStep) {

package/presets/cursor/nuxt/rules/README.md

@@ -13,7 +13,7 @@ Special Cursor Rule format:
 
 ### Starting a new task
 
-- **Agent team (recommended):** `/task <description>` — the router picks roles and order; after a human gate — `/task-continue <slug>`. See **`agent-team-orchestrator.mdc`** and `.cursor/team/README.md`.
+- **Agent team (recommended):** `/task <description>` — the router picks roles and order; after a human gate — `/task-continue <slug>`. See **`agent-team-orchestrator.mdc`** and `.ai.local/team/README.md`.
 
 - **End-to-end layer checklist (for developer):** **`feature-delivery-workflow.mdc`**.
 

package/presets/cursor/nuxt/rules/agent-team-orchestrator.mdc

@@ -7,7 +7,7 @@ alwaysApply: false
 
 # Agent team orchestrator
 
-Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.cursor/team/tasks/<slug>/`.
+Parent agent = **manager**. Router plans; specialists execute. Artifacts: `.ai.local/team/tasks/<slug>/`.
 
 Work request without `/task` — see **`agent-team-intake.mdc`** (when to suggest the router instead of coding directly).
 
@@ -50,9 +50,9 @@ Work request without `/task` — see **`agent-team-intake.mdc`** (when to sugges
 | `tech-writer` | docs / team | docs-only, feature/migration docs |
 | `openspec-author` | `openspec/**` only | openspec-change (`/opsx:propose`, `/opsx:apply`, `/opsx:archive`, openspec refresh) |
 
-**Cursor frontmatter:** all team pipeline agents use `readonly: false` so they can write `.cursor/team/**`. Production/app restrictions live in the agent prompt body — do **not** set `readonly: true` (Cursor blocks *all* file writes, including team artifacts).
+**Cursor frontmatter:** all team pipeline agents use `readonly: false` so they can write `.ai.local/team/**`. Production/app restrictions live in the agent prompt body — do **not** set `readonly: true` (Cursor blocks *all* file writes, including team artifacts).
 
-Full prompts: `.cursor/agents/*.md`. Artifact conventions: `.cursor/team/README.md`; schema SoT: **agent-artifact-contracts**.
+Full prompts: `.cursor/agents/*.md`. Artifact conventions: `.ai.local/team/README.md`; schema SoT: **agent-artifact-contracts**.
 
 **Behavioral UX:** `task-analyst` loads requestable skill `ux-design` for standalone intent `ux-design` and embedded required-signal / advisory UI AC. No `ux-designer` agent in v1.
 
@@ -92,7 +92,7 @@ Use the local `metrics.json` ledger described by **agent-task-metrics**: the orc
 
 ## Artifact context index and receipts
 
-Each slug has one `artifact-manifest.json`: `.cursor/team/tasks/<slug>/` or `.claude/team/tasks/<slug>/`. Schema SoT: **agent-artifact-contracts**.
+Each slug has one `artifact-manifest.json` at `.ai.local/team/tasks/<slug>/`. Schema SoT: **agent-artifact-contracts**.
 
 - Read the manifest before broad prior-artifact discovery. Each step receives authoritative input entry IDs, owns named output entry IDs, and finishes with one terminal receipt linked to AC/task IDs.
 - Markdown remains detailed evidence; the manifest records producer, status, authoritative paths, timestamps, outcome, and evidence paths.
@@ -158,7 +158,7 @@ On each `subagentStop`, the hook reconciles `status.state` from the completing p
 
 ## Team artifact I/O (Cursor Shell sandbox)
 
-- Create/update `.cursor/team/tasks/<slug>/**` with the **Write** tool (parents are created automatically). Do **not** bootstrap slug dirs with Shell `mkdir -p` — default sandbox returns `Operation not permitted` (worse on macOS Desktop/Documents with TCC `com.apple.macl`).
+- Create/update `.ai.local/team/tasks/<slug>/**` with the **Write** tool (parents are created automatically). Do **not** bootstrap slug dirs with Shell `mkdir -p` — default sandbox returns `Operation not permitted` (worse on macOS Desktop/Documents with TCC `com.apple.macl`).
 - If Shell must touch team paths and fails with EPERM, retry with `required_permissions: ["all"]`. Prefer Write for artifacts.
 - Prefer repo under `~/Projects` / `WebstormProjects` over `~/Desktop` when using agent team heavily.
 

package/presets/cursor/nuxt/rules/ai-local-overlay.mdc

@@ -12,7 +12,7 @@ This rule is mandatory. **You MUST** obey it on every turn, without exception.
 
 1. **Probe** — before answering, run `ls -la .ai.local` from the repository root.
 2. **Walk** — if `.ai.local/` exists at multiple levels (monorepo), read every level from root to leaf. **Deeper wins** in practice: more specific rules appear later in the assembled context and take precedence.
-3. **Apply** — treat every `.ai.local/rules/*.md` and `.ai.local/conventions.md` as a higher-priority rule for this repo. The block below ("Authoring `.ai.local/rules/*.md`") defines the conventions.
+3. **Apply** — treat every `.ai.local/rules/*.md` and `.ai.local/conventions.md` as a higher-priority rule for this repo. Do **not** load `.ai.local/team/**` as rules (shared pipeline artifacts). The block below ("Authoring `.ai.local/rules/*.md`") defines the conventions.
 4. **Conflict** — if a local rule conflicts with a preset rule, **the local rule wins**. If a local rule body contains `override: kill <preset-rule-name>`, drop that preset rule from your context window entirely.
 5. **Acknowledge** — when answering a user question, briefly state which `.ai.local/` rules apply to the current task (one line is enough). Format: `Using .ai.local: <rule-name>(, <rule-name>)*`. If no `.ai.local/` exists, do NOT mention this rule.
 
@@ -39,5 +39,5 @@ Keep files ≤ 120 lines. Match the style of preset rules (short sections, bulle
 ## Pointers
 
 - Authoring guide: `docs/LOCAL-OVERLAY.md` in the `@bonesofspring/ai-rules` package.
-- Living gotchas alternative: `.cursor/team/conventions.md`.
+- Living gotchas: `.ai.local/conventions.md`. Pipeline artifacts: `.ai.local/team/` (do not load as rules).
 - Root `AGENTS.md` reinforces this rule with a `MANDATORY` section.

package/presets/cursor/nuxt/rules/preset-layering.mdc

@@ -3,7 +3,7 @@ description: Preset authoring: Core → Stack → Platform layering. Use when ed
 globs:
   - packages/ai-rules/presets/**/*
   - .cursor/rules/**/*
-  - .cursor/team/tasks/**/*
+  - .ai.local/team/tasks/**/*
 alwaysApply: false
 ---
 

package/presets/cursor/nuxt/rules/preset-no-cross-stack-leakage.mdc

@@ -3,7 +3,7 @@ description: Preset authoring: forbid cross-stack agent/path leakage in hooks an
 globs:
   - packages/ai-rules/presets/**/*
   - .cursor/rules/**/*
-  - .cursor/team/tasks/**/*
+  - .ai.local/team/tasks/**/*
 alwaysApply: false
 ---
 

package/presets/cursor/nuxt/rules/preset-pr-checklist.mdc

@@ -3,7 +3,7 @@ description: Preset authoring: PR checklist for twin sync, budget, leakage, READ
 globs:
   - packages/ai-rules/presets/**/*
   - .cursor/rules/**/*
-  - .cursor/team/tasks/**/*
+  - .ai.local/team/tasks/**/*
 alwaysApply: false
 ---
 
@@ -18,8 +18,8 @@ Checklist for PRs that touch `packages/ai-rules/presets/**` (and dogfood `.curso
 - [ ] **SoT:** edits in `packages/…` (not only root `.cursor/`)
 - [ ] **Core:** if `_shared/core/**` changed — all `<!-- shared-core: … -->` consumers updated (or documented intentional fork)
 - [ ] **Twin:** Cursor change → Claude twin **same PR** (**FAIL** if missing on next, nuxt, svelte, ios-swift, android-kotlin, go, java, mcp-ts, php-hexagonal, and php-laravel — see `preset-twin-sync`)
-- [ ] **Mavis derive:** mapped `cursor/<stack>/` change → `mavis/<stack>/` + `adapter-map.json` **same PR** when the stack is in `releasedStacks` (run `generate-mavis-next.mjs` + `check-mavis-adapter-map.mjs` for `next`; see `preset-twin-sync` § Mavis derivation)
-- [ ] **OpenCode derive:** mapped `cursor/<stack>/` change → `opencode/<stack>/` + `adapter-map.json` **same PR** when the stack is in `releasedStacks` (run `generate-opencode-next.mjs` + `check-opencode-adapter-map.mjs` for `next`; see `preset-twin-sync` § OpenCode derivation)
+- [ ] **Mavis derive:** mapped `cursor/<stack>/` change → `mavis/<stack>/` + `adapter-map.json` **same PR** when the stack is in `releasedStacks` (run `generate-mavis.mjs --stack <stack>` + `check-mavis-adapter-map.mjs`; see `preset-twin-sync` § Mavis derivation)
+- [ ] **OpenCode derive:** mapped `cursor/<stack>/` change → `opencode/<stack>/` + `adapter-map.json` **same PR** when the stack is in `releasedStacks` (run `generate-opencode.mjs --stack <stack>` + `check-opencode-adapter-map.mjs`; see `preset-twin-sync` § OpenCode derivation)
 - [ ] **Mapping:** `claude/<stack>/rules/README.md` mapping table is current
 - [ ] **Token budget:** Cursor `alwaysApply` ≤ 4 (4th slot reserved for `ai-local-overlay`); Claude session-start exactly 3; meta rules not always-on
 - [ ] **Local overlay coverage:** every installable stack ships `ai-local-overlay.mdc` (Cursor) and `ai-local-overlay.md` (Claude) with `MANDATORY` + acknowledgement format + `docs/LOCAL-OVERLAY.md` pointer; Claude twin listed in `claude/<stack>/rules/README.md` mapping table. Run `packages/ai-rules/scripts/check-local-overlay.sh`.

package/presets/cursor/nuxt/rules/preset-token-budget.mdc

@@ -3,7 +3,7 @@ description: Preset authoring: ≤3 always-on / session-start; meta rules never
 globs:
   - packages/ai-rules/presets/**/*
   - .cursor/rules/**/*
-  - .cursor/team/tasks/**/*
+  - .ai.local/team/tasks/**/*
 alwaysApply: false
 ---
 

package/presets/cursor/nuxt/rules/preset-twin-sync.mdc

@@ -3,7 +3,7 @@ description: Preset authoring: Cursor SoT → Claude twin same PR. Use when edit
 globs:
   - packages/ai-rules/presets/**/*
   - .cursor/rules/**/*
-  - .cursor/team/tasks/**/*
+  - .ai.local/team/tasks/**/*
 alwaysApply: false
 ---
 
@@ -32,7 +32,16 @@ Cursor `.mdc` — **SoT per stack**. Claude topic `.md` — derived twin.
 
 | Stack | Cursor SoT | Mavis derive | Manifest |
 |-------|------------|--------------|----------|
-| `next` | `presets/cursor/next/**` | `presets/mavis/next/**` via `generate-mavis-next.mjs` | **Required** `adapter-map.json` |
+| `next` | `presets/cursor/next/**` | `presets/mavis/next/**` via `generate-mavis.mjs --stack next` | **Required** `adapter-map.json` |
+| `nuxt` | `presets/cursor/nuxt/**` | `presets/mavis/nuxt/**` via `generate-mavis.mjs --stack nuxt` | **Required** `adapter-map.json` |
+| `svelte` | `presets/cursor/svelte/**` | `presets/mavis/svelte/**` via `generate-mavis.mjs --stack svelte` | **Required** `adapter-map.json` |
+| `ios-swift` | `presets/cursor/ios-swift/**` | `presets/mavis/ios-swift/**` via `generate-mavis.mjs --stack ios-swift` | **Required** `adapter-map.json` |
+| `android-kotlin` | `presets/cursor/android-kotlin/**` | `presets/mavis/android-kotlin/**` via `generate-mavis.mjs --stack android-kotlin` | **Required** `adapter-map.json` |
+| `go` | `presets/cursor/go/**` | `presets/mavis/go/**` via `generate-mavis.mjs --stack go` | **Required** `adapter-map.json` |
+| `java` | `presets/cursor/java/**` | `presets/mavis/java/**` via `generate-mavis.mjs --stack java` | **Required** `adapter-map.json` |
+| `mcp-ts` | `presets/cursor/mcp-ts/**` | `presets/mavis/mcp-ts/**` via `generate-mavis.mjs --stack mcp-ts` | **Required** `adapter-map.json` |
+| `php-hexagonal` | `presets/cursor/php-hexagonal/**` | `presets/mavis/php-hexagonal/**` via `generate-mavis.mjs --stack php-hexagonal` | **Required** `adapter-map.json` |
+| `php-laravel` | `presets/cursor/php-laravel/**` | `presets/mavis/php-laravel/**` via `generate-mavis.mjs --stack php-laravel` | **Required** `adapter-map.json` |
 
 Mavis is a **third platform adapter**, not a Claude-style topic twin:
 
@@ -40,13 +49,22 @@ Mavis is a **third platform adapter**, not a Claude-style topic twin:
 _shared/core  →  cursor/<stack>  →  mavis/<stack>
 ```
 
-Regenerate with `node packages/ai-rules/scripts/generate-mavis-next.mjs`; validate with `node packages/ai-rules/scripts/check-mavis-adapter-map.mjs`.
+Regenerate with `node packages/ai-rules/scripts/generate-mavis.mjs --stack <stack>`; validate with `node packages/ai-rules/scripts/check-mavis-adapter-map.mjs`.
 
 ## OpenCode derivation (not a Claude twin)
 
 | Stack | Cursor SoT | OpenCode derive | Manifest |
 |-------|------------|-----------------|----------|
-| `next` | `presets/cursor/next/**` | `presets/opencode/next/**` via `generate-opencode-next.mjs` | **Required** `adapter-map.json` |
+| `next` | `presets/cursor/next/**` | `presets/opencode/next/**` via `generate-opencode.mjs --stack next` | **Required** `adapter-map.json` |
+| `nuxt` | `presets/cursor/nuxt/**` | `presets/opencode/nuxt/**` via `generate-opencode.mjs --stack nuxt` | **Required** `adapter-map.json` |
+| `svelte` | `presets/cursor/svelte/**` | `presets/opencode/svelte/**` via `generate-opencode.mjs --stack svelte` | **Required** `adapter-map.json` |
+| `ios-swift` | `presets/cursor/ios-swift/**` | `presets/opencode/ios-swift/**` via `generate-opencode.mjs --stack ios-swift` | **Required** `adapter-map.json` |
+| `android-kotlin` | `presets/cursor/android-kotlin/**` | `presets/opencode/android-kotlin/**` via `generate-opencode.mjs --stack android-kotlin` | **Required** `adapter-map.json` |
+| `go` | `presets/cursor/go/**` | `presets/opencode/go/**` via `generate-opencode.mjs --stack go` | **Required** `adapter-map.json` |
+| `java` | `presets/cursor/java/**` | `presets/opencode/java/**` via `generate-opencode.mjs --stack java` | **Required** `adapter-map.json` |
+| `mcp-ts` | `presets/cursor/mcp-ts/**` | `presets/opencode/mcp-ts/**` via `generate-opencode.mjs --stack mcp-ts` | **Required** `adapter-map.json` |
+| `php-hexagonal` | `presets/cursor/php-hexagonal/**` | `presets/opencode/php-hexagonal/**` via `generate-opencode.mjs --stack php-hexagonal` | **Required** `adapter-map.json` |
+| `php-laravel` | `presets/cursor/php-laravel/**` | `presets/opencode/php-laravel/**` via `generate-opencode.mjs --stack php-laravel` | **Required** `adapter-map.json` |
 
 OpenCode is a **fourth platform adapter** with a **native** install root (`.opencode/`), not a Claude-style topic twin and not an owned overlay like `.mavis/`:
 
@@ -54,7 +72,7 @@ OpenCode is a **fourth platform adapter** with a **native** install root (`.open
 _shared/core  →  cursor/<stack>  →  opencode/<stack>
 ```
 
-Regenerate with `node packages/ai-rules/scripts/generate-opencode-next.mjs`; validate with `node packages/ai-rules/scripts/check-opencode-adapter-map.mjs`. Do not derive OpenCode sources from Claude.
+Regenerate with `node packages/ai-rules/scripts/generate-opencode.mjs --stack <stack>`; validate with `node packages/ai-rules/scripts/check-opencode-adapter-map.mjs`. Do not derive OpenCode sources from Claude.
 
 ## Same-PR checklist
 
@@ -62,8 +80,8 @@ Regenerate with `node packages/ai-rules/scripts/generate-opencode-next.mjs`; val
 2. Update Claude twin: body + `paths:` (from Cursor `globs:` / requestable triggers); drop `alwaysApply`.
 3. Update mapping table row if stem/path changed.
 4. If body embeds core (`<!-- shared-core: … -->`), sync core consumers across stacks when core changed.
-5. When mapped `cursor/<stack>/` sources change, regenerate `mavis/<stack>/` and refresh `adapter-map.json` `sourceRevision` in the **same PR** (run `generate-mavis-next.mjs` + `check-mavis-adapter-map.mjs` for `next`).
-6. When mapped `cursor/<stack>/` sources change, regenerate `opencode/<stack>/` and refresh `adapter-map.json` `sourceRevision` in the **same PR** (run `generate-opencode-next.mjs` + `check-opencode-adapter-map.mjs` for `next`).
+5. When mapped `cursor/<stack>/` sources change, regenerate `mavis/<stack>/` and refresh `adapter-map.json` `sourceRevision` in the **same PR** (run `generate-mavis.mjs --stack <stack>` + `check-mavis-adapter-map.mjs`).
+6. When mapped `cursor/<stack>/` sources change, regenerate `opencode/<stack>/` and refresh `adapter-map.json` `sourceRevision` in the **same PR** (run `generate-opencode.mjs --stack <stack>` + `check-opencode-adapter-map.mjs`).
 
 ## Twin depth
 
@@ -84,7 +102,7 @@ Regenerate with `node packages/ai-rules/scripts/generate-opencode-next.mjs`; val
 - **php-hexagonal:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts; mapping table required).
 - **php-laravel:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-hexagonal; mapping table required).
 - **android-kotlin:** missing Claude twin for a changed Cursor rule → **FAIL** (same as next / ios-swift / go / java / mcp-ts / php-*; mapping table required).
-- **mavis/next:** `cursor/next` mapped source changed without mavis regeneration / `adapter-map.json` `sourceRevision` drift → **FAIL** (`check-mavis-adapter-map.mjs`).
-- **opencode/next:** `cursor/next` mapped source changed without opencode regeneration / `adapter-map.json` `sourceRevision` drift → **FAIL** (`check-opencode-adapter-map.mjs`).
+- **mavis/<stack>:** `cursor/<stack>` mapped source changed without mavis regeneration / `adapter-map.json` `sourceRevision` drift → **FAIL** (`check-mavis-adapter-map.mjs`).
+- **opencode/<stack>:** `cursor/<stack>` mapped source changed without opencode regeneration / `adapter-map.json` `sourceRevision` drift → **FAIL** (`check-opencode-adapter-map.mjs`).
 
 Dogfood: sync packages → root `.cursor/` after Cursor SoT changes (not the reverse). Use `packages/ai-rules/scripts/sync-dogfood-cursor.sh`.

package/presets/cursor/nuxt/rules/reference-features.mdc

@@ -40,7 +40,7 @@ Replace **TBD** with real paths after team agreement (or on `ai-rules init` in t
 
 ## Living conventions
 
-Post-init gotchas / patterns / decisions: **`.cursor/team/conventions.md`** (and the twin tool path if both Cursor and Claude are installed). Consumer-owned; not always-on. See root `AGENTS.md` § Living conventions.
+Post-init gotchas / patterns / decisions: **`.ai.local/conventions.md`** (shared across tools; `.ai.local/team/**` is pipeline artifacts, not rules). Consumer-owned; not always-on. See root `AGENTS.md` § Living conventions.
 
 ## Related rules