@bonesofspring/ai-rules 0.2.24 → 0.2.26

package/presets/claude/go/skills/write-adr/SKILL.md

@@ -15,7 +15,7 @@ On-demand skill for durable architecture decisions. Stack-agnostic sections —
 
 ## Template
 
-Create (or append) a short markdown ADR in the repo’s agreed location (e.g. `docs/adr/`, `.cursor/team/`, wiki). Suggested filename: `NNNN-short-title.md`.
+Create (or append) a short markdown ADR in the repo’s agreed location (e.g. `docs/adr/`, `.ai.local/team/`, wiki). Suggested filename: `NNNN-short-title.md`.
 
 ```markdown
 # ADR NNNN: <Title>
@@ -37,5 +37,5 @@ Related PRs, issues, rules, prior ADRs, diagrams.
 
 - Prefer one decision per ADR.
 - Keep Context factual; Decision imperative and short.
-- Link living gotchas to `team/conventions.md` when the decision becomes a recurring local pattern.
+- Link living gotchas to `.ai.local/conventions.md` when the decision becomes a recurring local pattern.
 - Do not put ADR bodies only in root `AGENTS.md` (overwrite on init).

package/presets/claude/go/team/README.md

@@ -1,54 +1,77 @@
-# Agent team artifacts (go)
+# Agent team artifacts
 
-Artifact directory for the agent-team pipeline for Go backends (hexagonal / ports & adapters).
+Shared `/task` runtime for Cursor, Claude, Mavis, and OpenCode. Seeded at **`.ai.local/team/`**. Overlay must not load this tree as rules.
+
+`init` refreshes README + fixtures. It never overwrites `tasks/<slug>/`. `clean <tool>` never deletes `.ai.local/`.
 
 ## Layout
 
 ```
-.claude/team/
-  active-task.json
-  fixtures/
+.ai.local/team/
+  README.md
+  active-task.json           # current slug pointer (runtime)
+  fixtures/                  # pipeline profile examples
   tasks/<slug>/
-    pipeline.json
-    status.json
-    brief.md
-    decomposition.md
-    .memlog.md
-    …
+    pipeline.json            # router-owned plan
+    status.json              # hook-owned lifecycle
+    metrics.json             # hook-owned append-only ledger
+    artifact-manifest.json   # producer receipts
+    brief.md, decomposition.md, implementation.md, review.md, …
+    .memlog.md               # optional agent notes (hook does not parse)
 ```
 
-## Fixtures
-
-| Fixture | Notes |
-|---------|-------|
-| `feature-full.json` | Full profile; QA scope `e2e-only` = **adapter/integration tests** (not UI e2e); Playwright/XCUITest stems in `skipped` |
-| `feature-light.json` | developer → build-verifier (`go test` / `go vet` / golangci-lint) |
-| `bugfix-standard.json` | debugger → developer (skipIf) → verifier → reviewer |
-
-**Never** schedule Playwright/XCUITest-only steps for this preset. Use `integration-test-*` (or QA with `e2e-only` = integration) for adapter-level coverage.
-
+Bootstrap a slug by **writing** `pipeline.json` (editor Write tool). Do not `mkdir -p` from a sandboxed Shell. The hook owns `status.json` / `metrics.json`; agents must not patch lifecycle fields.
+
+## pipeline.json
+
+```json
+{
+  "slug": "order-history-date-filter",
+  "intent": "feature",
+  "specMode": "consume",
+  "summary": "Add date filter to Order History",
+  "steps": [
+    { "agent": "task-analyst", "label": "Clarify and decompose" },
+    { "agent": "feature-developer", "label": "Implement + unit tests", "scope": "unit-in-dev" },
+    { "agent": "build-verifier", "label": "Validation gate" },
+    { "agent": "code-reviewer", "label": "Code review" }
+  ],
+  "humanGates": ["after:task-analyst"],
+  "autoChain": true,
+  "skipped": []
+}
+```
 
-## specMode, applyReadiness, memlog
+| Field | Notes |
+|-------|--------|
+| `agent` | kebab-case, or an array when `parallel: true` |
+| `scope` | e.g. `unit-in-dev`, `e2e-only` |
+| `skipIf` | `debugger.fixed` \| `ci-investigator.resolved` |
+| `model` | optional `cheap` \| `standard` \| `strong` |
+| `specMode` | `consume` \| `generate` \| `none` — `brief.md` `## Spec mode` wins |
 
-- **`specMode`:** `consume` | `generate` | `none` — primary in `brief.md` `## Spec mode`; optional top-level `pipeline.json` `specMode`. `none` skips INDEX/author mode (spike/research).
-- **`applyReadiness`:** YAML frontmatter on developer `implementation.md`; JSON-shaped `{ "state": "blocked"|"ready"|"all_done", "contextFiles": [] }` on the analyst receipt (analyst may emit `blocked` pre-gate). See `agent-artifact-contracts`.
-- **Memlog:** `.cursor/team/tasks/<slug>/.memlog.md` (Claude: `.claude/team/tasks/<slug>/.memlog.md`) — append-only, agent-written; `/task-continue` may read. Hook does not parse it. Example: `fixtures/memlog.example.md`.
+## status.json
 
-## Artifact manifest and receipts
+Prefer `phase: executing`. States: `in_progress`, `completed`, `awaiting_approval` (`/task-continue`), `changes_requested`, `validation_failed`.
 
-Each slug stores one context index at `.claude/team/tasks/<slug>/artifact-manifest.json`. Schema v1 is defined by shared core `agent-team/agent-artifact-contracts.md`: every entry declares its producer, status, authoritative paths, acceptance-criteria IDs, decomposition task IDs, timestamps, and a terminal completion receipt.
+## Commands
 
-Producer/consumer rules:
+```bash
+/task <description>
+/task-continue <slug>
+/technical-retro <slug>
+```
 
-- Read the manifest first and use only the authoritative inputs needed by the current step; fall back to `brief.md`, `decomposition.md`, and `pipeline.json` when it is missing or stale, and report that gap.
-- Producers upsert only their stable entry IDs, preserve foreign entries, and finish with `completed`, `blocked`, `changes_requested`, or `validation_failed` receipt evidence.
-- The router owns `pipeline.json` and its routing entry; analyst, developer, verifier, and reviewer own their named outputs and receipts. Consumers do not edit another producer's receipt.
-- Agents do not mutate `status.json` or `metrics.json`. The orchestration runtime/hook is their single writer. Parallel receipt merges are serialized by the parent/orchestrator.
+After a human gate, close wait via the **installed** hook (do not hand-edit `pipelineIndex`):
 
-## Local metrics ledger
+```bash
+printf '%s\n' '{"status":"completed","action":"end_human_gate","activateNext":true}' | bash .claude/hooks/chain-team-phases.sh
+```
 
-`metrics.json` is an append-only schema-v1 event ledger for one task run. It contains only allowlisted IDs, task dimensions, timestamps, outcomes, and attribution confidence—never prompts, secrets, file paths, or contents. The orchestration runtime writes `task_started` / `attempt_started`; the hook records host-clock completion and human-gate edges under a per-task lock with temp-and-rename.
+Same JSON on Claude, Mavis, or OpenCode: `bash .<tool>/hooks/chain-team-phases.sh`.
 
-`status.json.activeAttempts` is a transient timing bridge keyed by `attemptId`; `lastCompletedAttempt` is diagnostic; `parallelOutcomes` holds per-agent outcomes for the current parallel join until the step advances. For parallel stops, the hook must use a stable payload identity or the sole active attempt. Otherwise an explicit `.metrics-receipts.json` receipt is fallback data marked `source: agent`, `attributionConfidence: fallback`; it must never guess from `currentAgent`.
+## Contracts
 
-Aggregate with `node packages/ai-rules/scripts/aggregate-agent-task-metrics.mjs --team-root .claude/team`. It reports role/agent count, completed count, total/average duration, distinct completed run IDs, separate human-gate wait, and incomplete artifacts.
+- Manifest schema: shared core `agent-team/agent-artifact-contracts.md`. Read it first; producers upsert only their IDs.
+- Metrics: append-only allowlisted events — `agent-team/agent-task-metrics.md`. Aggregate: `node packages/ai-rules/scripts/aggregate-agent-task-metrics.mjs --team-root .ai.local/team`.
+- Commit `.ai.local/team/` templates (and slugs if you want them in clones).

package/presets/claude/ios-swift/CLAUDE.md

@@ -35,4 +35,4 @@ See @rules/README.md for mapping and loading strategy.
 npx @bonesofspring/ai-rules init claude --preset ios-swift
 ```
 
-Copies `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `skills/**`, `hooks/**`, `team/**`, `MCP.md` into `.claude/`, plus `mcp.json` → **`.mcp.json`** and `REPO_AGENTS.md` → root **`AGENTS.md`**. Skill: `write-adr` (on-demand).
+Copies `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `skills/**`, `hooks/**`, `MCP.md` into `.claude/`; seeds `.ai.local/team/` from `team/` (slugs preserved), plus `mcp.json` → **`.mcp.json`** and `REPO_AGENTS.md` → root **`AGENTS.md`**. Skill: `write-adr` (on-demand).

package/presets/claude/ios-swift/README.md

@@ -1,43 +1,9 @@
-# Preset `ios-swift` (Claude Code)
+# iOS Swift preset (Claude Code)
 
-Rules and agent-team surface for Swift / SwiftUI / XCTest / XCUITest.
-
-Layout: topic folders under `rules/` + agents/skills/commands/hooks/team (like next Claude).
-
-| In the preset | Where `ai-rules init claude --preset ios-swift` copies |
-|-----------|---------------------------------------------------------|
-| `CLAUDE.md` | `.claude/CLAUDE.md` |
-| `rules/**` | `.claude/rules/**` |
-| `commands/**` | `.claude/commands/**` |
-| `skills/**` | `.claude/skills/**` (**7**, incl. `xcuitest-e2e`) |
-| `agents/**` | `.claude/agents/**` (**22**, XCUITest trio + `codebase-analyzer`) |
-| `hooks/**` | `.claude/hooks/**` (scripts + README; **no** `hooks.json`) |
-| `team/**` | `.claude/team/**` |
-| `mcp.json` | **`.mcp.json`** at repo root (Context7 + Figma) |
-| `MCP.md` | `.claude/MCP.md` |
+Twin of `presets/cursor/ios-swift/`. XCUITest trio; no `hooks.json`.
 
 ```bash
 npx @bonesofspring/ai-rules init claude --preset ios-swift
 ```
 
-## Preset taxonomy & contributing
-
-- **Layers:** Core → Stack → Platform — [`../../_shared/README.md`](../../_shared/README.md)
-- **Contribution guide:** [`../../docs/PRESET-CONTRIBUTION.md`](../../docs/PRESET-CONTRIBUTION.md)
-- **Cursor SoT:** `presets/cursor/ios-swift/` — derived twin; same PR as Cursor
-- **Mapping + core table:** [`rules/README.md`](./rules/README.md)
-
-## Session-start (= Cursor alwaysApply)
-
-Exactly **3** files without `paths:`: `stack/ios-app-core.md`, `architecture/boundaries.md`, `tooling-and-review/code-quality.md`. Body budget ≤140 lines total.
-
-## Parity with Cursor
-
-- **SoT:** `presets/cursor/ios-swift/`
-- Change Cursor → update Claude twin **same PR**
-- Mapping: [`rules/README.md`](./rules/README.md)
-- **`BUGBOT.md`:** Cursor-only (no twin); review in Claude — skill `code-review` + `tooling-and-review/code-review.md`
-
-## Cross-tool root AGENTS
-
-`REPO_AGENTS.md` → project-root `AGENTS.md` on init. Living conventions: `team/conventions.md`. Skill `write-adr` on-demand.
+`team/` seeds **`.ai.local/team/`**. MCP → **`.mcp.json`**. Catalog: [`rules/README.md`](./rules/README.md).

package/presets/claude/ios-swift/REPO_AGENTS.md

@@ -1,19 +1,34 @@
 # iOS Swift — 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 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 ios-swift
-npx @bonesofspring/ai-rules init claude --preset ios-swift
+npx @bonesofspring/ai-rules init multi --preset ios-swift
 ```
 
-`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 ios-swift`. `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/ios-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/ios-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)
 
@@ -38,9 +53,20 @@ After code edits: invoke **`post-change-build`** (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).
+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/ios-swift/agents/README.md

@@ -13,7 +13,7 @@ Role subagents for the Claude Code team pipeline (iOS / Swift / SwiftUI).
 
 When copying next pipeline templates: put Playwright stems in `skipped` with reason "iOS uses XCUITest" and schedule xcuitest trio instead.
 
-## Roster (23)
+## Roster (24)
 
 | Agent | Production code |
 |-------|-----------------|
@@ -29,7 +29,7 @@ When copying next pipeline templates: put Playwright stems in `skipped` with rea
 
 ## Team writes
 
-Team agents may write under `.claude/team/**`. Production restrictions live in the prompt body.
+Team agents may write under `.ai.local/team/**`. Production restrictions live in the prompt body.
 
 ## Model matrix (frontmatter `model`)
 

package/presets/claude/ios-swift/agents/accessibility-reviewer.md

@@ -9,8 +9,8 @@ You are an accessibility reviewer for an **iOS SwiftUI / UIKit** 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 Views / UI under `Features/**/Presentation/**` (and DesignSystem if touched).
 4. `ui-and-accessibility/swiftui.md` and project a11y conventions.
 
@@ -32,7 +32,7 @@ Load requestable rule `mcp-usage` when verifying third-party library APIs (Conte
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/a11y-review.md`:
+Write `.ai.local/team/tasks/<slug>/a11y-review.md`:
 
 ```markdown
 # Accessibility review: <slug>

package/presets/claude/ios-swift/agents/api-contract-reviewer.md

@@ -9,7 +9,7 @@ You are an API contract reviewer for a layered **iOS** Feature module (Domain /
 
 ## 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: DTO models, mappers, API clients/services, mocks/fixtures under Data (and Domain entities).
 
@@ -27,7 +27,7 @@ Apply `api-and-data/networking.md`, `architecture/boundaries.md`, `architecture/
 
 ## 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>

package/presets/claude/ios-swift/agents/build-verifier.md

@@ -11,8 +11,8 @@ You **validate** iOS implementation quality — do not edit production code or t
 
 ## 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 (Swift targets or preset paths).
 
 ## App / Feature validation (default)
@@ -66,7 +66,7 @@ When validating **ios-swift preset** changes (or `scope: preset-structure-valida
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/validation-report.md`:
+Write `.ai.local/team/tasks/<slug>/validation-report.md`:
 
 ```markdown
 # Validation: <slug>
@@ -93,7 +93,7 @@ Write the owned validation receipt (`completed` or `validation_failed`). Do not
 
 ## 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/ios-swift/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. `.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: same scheme, configuration, and destination CI uses (`tooling-and-review/xcode-tooling.md`).
 
 ## Process
@@ -22,7 +22,7 @@ Use the **`ci-investigation` skill** for the investigation loop.
 3. Reproduce locally when feasible (`xcodebuild build` / `xcodebuild 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 `.claude/team/tasks/<slug>/ci-report.md`:
+6. Document in `.ai.local/team/tasks/<slug>/ci-report.md`:
 
 ```markdown
 # CI report: <slug>

package/presets/claude/ios-swift/agents/code-reviewer.md

@@ -5,14 +5,14 @@ readonly: false
 model: fast
 ---
 
-You are a senior iOS / Swift / SwiftUI code reviewer. You may write only review artifacts under `.claude/team/**` and terminal receipts; do not modify production code.
+You are a senior iOS / Swift / SwiftUI 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`).
-4. `.claude/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 `tooling-and-review/code-review.md` checklist. Also weigh `architecture/boundaries.md`, `stack/swift-conventions.md`, `ui-and-accessibility/swiftui.md`, `api-and-data/networking.md`, `testing/unit.md`, `testing/ui.md`.
 
@@ -38,7 +38,7 @@ You **issue** reviews. Implementers acting on your findings must verify each ite
 
 ## Review artifact
 
-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>
@@ -74,7 +74,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/ios-swift/agents/debugger.md

@@ -9,8 +9,8 @@ You are an expert debugger for an **iOS Swift/SwiftUI** app. 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, crash logs, failing XCTest/XCUITest output, or reproduction steps from the user.
 
 ## Process
@@ -19,7 +19,7 @@ You are an expert debugger for an **iOS Swift/SwiftUI** app. Use the **`debug-in
 2. Prefer **runtime evidence** before coding: Xcode console, lldb, Instruments (Time Profiler / Allocations when relevant), XCTest/XCUITest logs, `os_log` / Logger 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 `xcodebuild test`).
-5. Document root cause in `.claude/team/tasks/<slug>/debug-report.md`:
+5. Document root cause in `.ai.local/team/tasks/<slug>/debug-report.md`:
 
 ```markdown
 # Debug report: <slug>

package/presets/claude/ios-swift/agents/feature-developer.md

@@ -9,7 +9,7 @@ You are a senior iOS developer (SwiftUI-first, SPM as in repo) with strict layer
 
 ## Before coding
 
-1. Read `.claude/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`** + `architecture/feature-delivery.md` + `architecture/reference-features.md`.
 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 `.claude/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 `.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/ios-swift/agents/migration-specialist.md

@@ -9,13 +9,13 @@ You are a migration specialist for an **iOS Swift** codebase with Feature-module
 
 ## 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: Xcode version, iOS deployment target, SPM/`Package.resolved`, project.yml/xcodeproj conventions.
 3. `architecture/boundaries.md`, `architecture/feature-delivery.md`, `tooling-and-review/xcode-tooling.md`, `api-and-data/networking.md` / `api-and-data/persistence.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>

package/presets/claude/ios-swift/agents/mockup-reviewer.md

@@ -6,11 +6,11 @@ model: opus
 
 You are a Figma mockup reviewer for an iOS SwiftUI / UIKit 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/ios-swift/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/ios-swift/agents/performance-auditor.md

@@ -9,7 +9,7 @@ You are an iOS performance auditor for a Swift/SwiftUI 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 Features/screens to audit.
 3. `stack/ios-app-core.md`, `ui-and-accessibility/swiftui.md`, `ui-and-accessibility/viewmodels.md`, networking/persistence patterns as relevant.
 
@@ -28,7 +28,7 @@ Prefer evidence from Instruments (Time Profiler, Allocations, SwiftUI) when user
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/perf-report.md`:
+Write `.ai.local/team/tasks/<slug>/perf-report.md`:
 
 ```markdown
 # Performance audit: <slug>

package/presets/claude/ios-swift/agents/qa-tester.md

@@ -9,8 +9,8 @@ You are a QA engineer for an **iOS Swift/SwiftUI** app with XCTest (or Swift Tes
 
 ## Inputs
 
-1. `.claude/team/tasks/<slug>/brief.md` — acceptance criteria drive test scenarios.
-2. `.claude/team/tasks/<slug>/decomposition.md` — test-related tasks (unit, UI).
+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, UI).
 3. Reviewer notes if `changes_requested` was resolved.
 4. Existing `*Tests` / `*UITests` targets and screen objects in the repo.
 

package/presets/claude/ios-swift/agents/security-reviewer.md

@@ -9,8 +9,8 @@ You are an iOS security reviewer for a Swift/SwiftUI 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, Keychain, tokens, networking, Info.plist ATS, deep links, logging, payments/PII.
 
 Apply `tooling-and-review/security-ios.md` and relevant parts of `api-and-data/networking.md` / `tooling-and-review/code-review.md`.
@@ -28,7 +28,7 @@ Apply `tooling-and-review/security-ios.md` and relevant parts of `api-and-data/n
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/security-review.md`:
+Write `.ai.local/team/tasks/<slug>/security-review.md`:
 
 ```markdown
 # Security review: <slug>

package/presets/claude/ios-swift/agents/solution-architect.md

@@ -5,7 +5,7 @@ readonly: false
 model: opus
 ---
 
-You are a solution architect for **iOS Feature modules** (Presentation / Domain / Data). Write `architecture.md` under `.claude/team/tasks/<slug>/`. No production code.
+You are a solution architect for **iOS Feature modules** (Presentation / Domain / Data). Write `architecture.md` under `.ai.local/team/tasks/<slug>/`. No production code.
 
 ## Design rules