@bonesofspring/ai-rules 0.2.3 → 0.2.4

package/CHANGELOG.md

@@ -9,12 +9,14 @@
 
 ### Added
 
+- **MCP configs in presets** (`next` + `ios-swift`, Cursor + Claude): `mcp.json` + `MCP.md`. Cursor → `.cursor/mcp.json`; Claude → project-root `.mcp.json`. **next:** Context7, Playwright, Chrome DevTools, Figma (remote). **ios-swift:** Context7 + Figma. CLI `init`/`clean` manage these paths.
 - **Cursor + Claude `ios-swift` — full agent-team parity with `next`:** **21** agents (Playwright trio → `xcuitest-test-{planner,generator,healer}`), **7** skills (`xcuitest-e2e`), **5** slash commands, `hooks.json` + iOS-adapted `chain-team-phases.sh` (Cursor) / hook scripts + README (Claude), `team/fixtures/` ×3, `AGENTS.md` (Cursor) / thin `CLAUDE.md` (≤35 lines).
 - **ios-swift rules:** agent-team intake/orchestrator, `xcode-tooling`, `reference-features`, domain rules (`navigation-coordinators`, `persistence-data`, `security-ios`, `module-public-api`), `technical-retro` alias; **21** rule topics (+ README). CLI init copies agents, hooks, skills, team, `AGENTS.md`.
 - **ios-swift retro follow-ups:** `build-verifier` preset checks (chain ≠ next; ban Playwright/`lint:js` handoffs); enriched 16 priority agent prompts + 6 skills; dogfood checklist (5 scenarios) in `AGENTS.md` / `reference-features`; Cursor-only **`BUGBOT.md`** (iOS review priorities).
 
 ### Changed
 
+- **Agent team slug bootstrap:** `/task` and `/feature-start` (Cursor + Claude, `next` + `ios-swift`) create `.cursor|claude/team/tasks/<slug>/` via **Write**, not Shell `mkdir` — avoids Cursor sandbox `Operation not permitted` (esp. macOS Desktop/Documents). Orchestrator + `team/README` + `task-router` document the rule.
 - **Token model (ios-swift + next):** both presets use **3** alwaysApply / session-start rules (~77 / ~59 body lines). Post-change verification is **requestable** — ios: `post-change-build`; next: `post-change-lint`. Orchestrator, intake, code-review, feature-delivery, tooling rules load on-demand (`paths:` / description).
 - Claude `next`: `agent-team-orchestrator` and `code-review-mr` use `paths:` (on-demand) — session-start matches the 3-rule budget above.
 - Cursor `next` agents: all pipeline agents set **`readonly: false`** so they can write `.cursor/team/**`. Production/app restrictions remain in prompt bodies (Cursor `readonly: true` blocks all file writes, including team artifacts).

package/README.md

@@ -1,6 +1,6 @@
 # @bonesofspring/ai-rules
 
-Presets for Cursor and Claude Code: rules, commands, plus optional `agents`, `hooks`, `skills`, and team artifacts when the preset includes them. For Claude: `CLAUDE.md`. Install from npm into a project so you don’t have to copy files out of the repo by hand.
+Presets for Cursor and Claude Code: rules, commands, plus optional `agents`, `hooks`, `skills`, team artifacts, and MCP configs when the preset includes them. For Claude: `CLAUDE.md`. Install from npm into a project so you don’t have to copy files out of the repo by hand.
 
 Node 18+.
 
@@ -30,8 +30,8 @@ If `.cursor` does not appear, check the command output for errors and confirm yo
 
 - `rules/`, `commands/`
 - optional dirs when present: `agents/`, `hooks/`, `skills/`, `team/`
-- Cursor root files: `hooks.json`, `BUGBOT.md`, `AGENTS.md`
-- Claude root file: `CLAUDE.md`
+- Cursor root files: `hooks.json`, `BUGBOT.md`, `AGENTS.md`, `MCP.md`, `mcp.json`
+- Claude: `CLAUDE.md`, `MCP.md` under `.claude/`; project `.mcp.json` at repo root
 
 Any other files you added under `.cursor/` or `.claude/` (notes, local overrides, IDE state) are **left intact**. Older releases that deleted the whole tool directory are no longer the behavior.
 
@@ -45,6 +45,7 @@ Where things go on `init`:
 | hooks | `.cursor/hooks`, `.cursor/hooks.json` | `.claude/hooks` |
 | skills | `.cursor/skills` | `.claude/skills` |
 | team artifacts template | `.cursor/team` | `.claude/team` |
+| MCP | `mcp.json` → `.cursor/mcp.json`, `MCP.md` → `.cursor/` | `mcp.json` → **`.mcp.json`** (project root), `MCP.md` → `.claude/` |
 | other | `BUGBOT.md`, `AGENTS.md` → `.cursor/` | `CLAUDE.md` → `.claude/CLAUDE.md` |
 
 The package ships presets including **`next`** (Next.js stack) and **`ios-swift`** (iOS apps on Swift / SwiftUI). Other preset names: see `presets/` in the [repo](https://github.com/bonesofspring/ai-rules). Name is a single path segment, no `/` or `..`.

package/bin/cli.js

@@ -17,7 +17,10 @@ const PRESETS = {
     relBase: ['presets', 'cursor'],
     optionalCursorDirs: ['agents', 'hooks', 'skills', 'team'],
     hooksJsonSrc: 'hooks.json',
-    toolRootFiles: ['BUGBOT.md', 'AGENTS.md'],
+    /** Project MCP → `.cursor/mcp.json` */
+    mcpJsonSrc: 'mcp.json',
+    mcpJsonDest: '.cursor/mcp.json',
+    toolRootFiles: ['BUGBOT.md', 'AGENTS.md', 'MCP.md'],
   },
   claude: {
     rulesDir: '.claude/rules',
@@ -25,6 +28,10 @@ const PRESETS = {
     relBase: ['presets', 'claude'],
     optionalClaudeDirs: ['skills', 'agents', 'hooks', 'team'],
     claudeMdSrc: 'CLAUDE.md',
+    /** Project MCP lives at repo root (Claude Code project scope), not under `.claude/`. */
+    mcpJsonSrc: 'mcp.json',
+    mcpJsonDest: '.mcp.json',
+    toolRootFiles: ['MCP.md'],
   },
 };
 
@@ -50,8 +57,8 @@ Options:
 
 Notes:
   init merges into the target directory; same-named files are overwritten.
-  Cursor init copies rules, commands, agents, hooks, skills, team, hooks.json, BUGBOT.md, AGENTS.md.
-  Claude init copies rules, commands, skills, agents, hooks, team, and CLAUDE.md when present.
+  Cursor init copies rules, commands, agents, hooks, skills, team, hooks.json, BUGBOT.md, AGENTS.md, MCP.md, mcp.json → .cursor/mcp.json.
+  Claude init copies rules, commands, skills, agents, hooks, team, CLAUDE.md, MCP.md, and mcp.json → .mcp.json (project root).
   Command forms: "init cursor --preset next", "init cursor next", "--preset next init cursor", "cursor init --preset next".
 
 Examples:
@@ -238,6 +245,9 @@ function presetHasAnySource(base, cfg) {
   if (cfg.hooksJsonSrc && fs.existsSync(path.join(base, cfg.hooksJsonSrc))) {
     return true;
   }
+  if (cfg.mcpJsonSrc && fs.existsSync(path.join(base, cfg.mcpJsonSrc))) {
+    return true;
+  }
   for (const name of cfg.toolRootFiles || []) {
     if (fs.existsSync(path.join(base, name))) {
       return true;
@@ -355,6 +365,17 @@ function cmdInit(tool, preset, cwdOption) {
       }
     }
 
+    if (cfg.mcpJsonSrc && cfg.mcpJsonDest) {
+      const mcpFrom = path.join(base, cfg.mcpJsonSrc);
+      if (fs.existsSync(mcpFrom)) {
+        const mcpDestAbs = path.join(cwd, cfg.mcpJsonDest);
+        fs.mkdirSync(path.dirname(mcpDestAbs), { recursive: true });
+        fs.copyFileSync(mcpFrom, mcpDestAbs);
+        console.log(`Copied ${cfg.mcpJsonSrc} → ${cfg.mcpJsonDest}`);
+        copiedSteps++;
+      }
+    }
+
     for (const name of cfg.toolRootFiles || []) {
       const from = path.join(base, name);
       if (fs.existsSync(from)) {
@@ -411,6 +432,11 @@ function cmdClean(tool, cwdOption) {
     removedParts.push(`${toolRoot}/hooks.json`);
   }
 
+  if (cfg.mcpJsonDest) {
+    removeFileIfExists(path.join(cwd, cfg.mcpJsonDest));
+    removedParts.push(cfg.mcpJsonDest);
+  }
+
   for (const name of cfg.toolRootFiles || []) {
     removeFileIfExists(path.join(cwd, toolRoot, name));
     removedParts.push(`${toolRoot}/${name}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bonesofspring/ai-rules",
-  "version": "0.2.3",
+  "version": "0.2.4",
   "description": "Presets of Cursor and Claude rules/commands for Revy Ross personal use",
   "license": "MIT",
   "author": "Revy Ross",

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

@@ -32,4 +32,4 @@ See @rules/README.md for mapping and loading strategy.
 npx @bonesofspring/ai-rules init claude --preset ios-swift
 ```
 
-Копирует `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `skills/**`, `hooks/**`, `team/**`.
+Копирует `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `skills/**`, `hooks/**`, `team/**`, `MCP.md` в `.claude/`, плюс `mcp.json` → **`.mcp.json`** в корне.

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

@@ -0,0 +1,14 @@
+# MCP (preset `ios-swift`, Claude Code)
+
+Копируется в **корень проекта** как `.mcp.json` при `ai-rules init claude --preset ios-swift`.
+
+## Servers
+
+| Name | Package | Зачем |
+|------|---------|--------|
+| `context7` | `@upstash/context7-mcp` | Актуальная документация Swift / SwiftUI / Apple frameworks |
+| `figma` | remote `https://mcp.figma.com/mcp` | Design context → SwiftUI; OAuth при первом подключении |
+
+Playwright / Chrome DevTools не входят в ios-пресет.
+
+Секреты не коммитим. Опционально: `CONTEXT7_API_KEY`. Figma — OAuth. Approve project MCP через `/mcp`.

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

@@ -13,6 +13,8 @@
 | `agents/**` | `.claude/agents/**` (**21**, XCUITest trio) |
 | `hooks/**` | `.claude/hooks/**` (scripts + README; **нет** `hooks.json`) |
 | `team/**` | `.claude/team/**` |
+| `mcp.json` | **`.mcp.json`** в корне (Context7 + Figma) |
+| `MCP.md` | `.claude/MCP.md` |
 
 ```bash
 npx @bonesofspring/ai-rules init claude --preset ios-swift

package/presets/claude/ios-swift/agents/task-router.md

@@ -55,7 +55,7 @@ Fixtures: `.claude/team/fixtures/` (feature-full, feature-light, bugfix-standard
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/pipeline.json` and initial `status.json`; set `.claude/team/active-task.json`.
+Write `.claude/team/tasks/<slug>/pipeline.json` and initial `status.json` (write files; do not Shell-`mkdir` alone); set `.claude/team/active-task.json`.
 
 ## Handoff
 

package/presets/claude/ios-swift/commands/feature-start.md

@@ -11,7 +11,7 @@ description: Legacy analyst-only feature intake. Prefer /task for new work becau
 
 1. Извлеки описание задачи из аргументов команды (всё после `/feature-start`).
 2. Сгенерируй **slug** (kebab-case, до 48 символов) из заголовка задачи.
-3. Создай каталог `.claude/team/tasks/<slug>/` если его ещё нет.
+3. Создай `.claude/team/tasks/<slug>/` если его ещё нет — через запись файла (Write / Edit), не через Shell `mkdir`.
 4. Запиши `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
 5. Вызови subagent **task-analyst** с полным описанием задачи и путём к артефактам.
 6. Дождись завершения аналитика. **Не вызывай developer** на этом этапе.

package/presets/claude/ios-swift/commands/task.md

@@ -25,7 +25,7 @@ description: Route a natural-language task through the agent-team pipeline: task
 
 ## Алгоритм
 
-1. **Slug** — kebab-case из описания (≤48 символов). Создай `.claude/team/tasks/<slug>/`.
+1. **Slug** — kebab-case из описания (≤48 символов). Создай `.claude/team/tasks/<slug>/` через запись файла (Write / Edit) — **не** полагайся на Shell `mkdir` как единственный способ создать каталог.
 2. **Router** — вызови subagent **task-router** с описанием задачи и путём к slug.
 3. **План** — покажи пользователю таблицу из `pipeline.json`: intent, steps, skipped, humanGates.
 4. **Intent retro** — если `intent === "retro"`, выполни `/technical-retro` и **остановись**.

package/presets/claude/ios-swift/mcp.json

@@ -0,0 +1,12 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "figma": {
+      "type": "http",
+      "url": "https://mcp.figma.com/mcp"
+    }
+  }
+}

package/presets/claude/ios-swift/rules/tooling-and-review/agent-team-orchestrator.md

@@ -38,7 +38,7 @@ Full prompts: `.claude/agents/*.md`. Artifacts: `.claude/team/README.md`.
 2. Read `pipeline.json` before every subagent invocation.
 3. One role per invocation — except parallel steps.
 4. **Never** skip `humanGates` without continue/approval.
-5. Persist handoffs under `.claude/team/tasks/<slug>/`.
+5. Persist handoffs under `.claude/team/tasks/<slug>/` by writing files (not Shell-only `mkdir`).
 6. On `validation_failed`: developer → build-verifier.
 7. When complete, suggest `/technical-retro <slug>`.
 

package/presets/claude/next/CLAUDE.md

@@ -32,4 +32,4 @@ See @rules/README.md for the full catalog and loading strategy.
 npx @bonesofspring/ai-rules init claude --preset next
 ```
 
-Копирует `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `hooks/**`, `team/**` и др. в `.claude/` целевого репозитория.
+Копирует `CLAUDE.md`, `rules/**`, `commands/**`, `agents/**`, `hooks/**`, `team/**`, `MCP.md` в `.claude/`, плюс `mcp.json` → **`.mcp.json`** в корне проекта.

package/presets/claude/next/MCP.md

@@ -0,0 +1,16 @@
+# MCP (preset `next`, Claude Code)
+
+Копируется в **корень проекта** как `.mcp.json` при `ai-rules init claude --preset next` (не в `.claude/` — так устроен project scope Claude Code).
+
+## Servers
+
+| Name | Package | Зачем |
+|------|---------|--------|
+| `context7` | `@upstash/context7-mcp` | Актуальная документация Next/React/TS |
+| `playwright-test` | `@playwright/mcp` | Browser MCP; имя сервера совпадает с `mcp__playwright-test__*` в agents |
+| `chrome-devtools` | `chrome-devtools-mcp` | Live DOM/network/performance |
+| `figma` | remote `https://mcp.figma.com/mcp` | Design context → код; OAuth при первом подключении |
+
+Секреты не коммитим. Опционально: `CONTEXT7_API_KEY`. Figma — OAuth (токен в файл не пишем). После clone/init Claude Code попросит approve project MCP (`/mcp`).
+
+Для полного Playwright Test Agents loop (`planner_*` / `generator_*` / `test_*`) дополнительно: `npx playwright init-agents --loop=claude` в приложении с `@playwright/test`.

package/presets/claude/next/README.md

@@ -11,6 +11,8 @@
 | `agents/**` | `.claude/agents/**` (если папка есть) |
 | `hooks/**` | `.claude/hooks/**` (если папка есть) |
 | `team/**` | `.claude/team/**` (шаблон артефактов agent team) |
+| `mcp.json` | **`.mcp.json`** в корне проекта (Claude project MCP) |
+| `MCP.md` | `.claude/MCP.md` |
 
 Файлы правил — обычный Markdown с опциональным YAML frontmatter (`paths:` для скоупа по путям), не формат `.mdc` Cursor.
 

package/presets/claude/next/agents/task-router.md

@@ -81,7 +81,7 @@ Fixtures: `.claude/team/fixtures/` (feature-full, feature-light, bugfix-standard
 
 ## Output
 
-Write `.claude/team/tasks/<slug>/pipeline.json` and initial `status.json`; set `.claude/team/active-task.json` → `{ "slug": "<slug>" }`. Minimal template — см. **`agents/README.md`**.
+Write `.claude/team/tasks/<slug>/pipeline.json` and initial `status.json` (write files; do not Shell-`mkdir` alone); set `.claude/team/active-task.json` → `{ "slug": "<slug>" }`. Minimal template — см. **`agents/README.md`**.
 
 ## Handoff to orchestrator
 

package/presets/claude/next/commands/feature-start.md

@@ -11,7 +11,7 @@ description: Legacy analyst-only feature intake. Prefer /task for new work becau
 
 1. Извлеки описание задачи из аргументов команды (всё после `/feature-start`).
 2. Сгенерируй **slug** (kebab-case, до 48 символов) из заголовка задачи.
-3. Создай каталог `.claude/team/tasks/<slug>/` если его ещё нет.
+3. Создай `.claude/team/tasks/<slug>/` если его ещё нет — через запись файла (Write / Edit), не через Shell `mkdir`.
 4. Запиши `.claude/team/active-task.json` → `{ "slug": "<slug>" }`.
 5. Вызови subagent **task-analyst** с полным описанием задачи и путём к артефактам.
 6. Дождись завершения аналитика. **Не вызывай developer** на этом этапе.

package/presets/claude/next/commands/task.md

@@ -25,7 +25,7 @@ description: Route a natural-language task through the agent-team pipeline: task
 
 ## Алгоритм
 
-1. **Slug** — kebab-case из описания (≤48 символов). Создай `.claude/team/tasks/<slug>/`.
+1. **Slug** — kebab-case из описания (≤48 символов). Создай `.claude/team/tasks/<slug>/` через запись файла (Write / Edit) — **не** полагайся на Shell `mkdir` как единственный способ создать каталог.
 2. **Router** — вызови subagent **task-router** с описанием задачи и путём к slug.
 3. **План** — покажи пользователю таблицу из `pipeline.json`: intent, steps, skipped, humanGates.
 4. **Intent retro** — если `intent === "retro"`, выполни `/technical-retro` и **остановись**.

package/presets/claude/next/hooks/chain-team-phases.sh

@@ -157,10 +157,10 @@ const AGENT_HANDOFF = {
     `Follow testing/playwright-agents.md and the playwright-e2e skill. Update status.json when done.`,
   'playwright-test-generator': (s) =>
     `Invoke playwright-test-generator for slug "${s}". Generate/update *.spec.ts from matching *.cases.md. ` +
-    `Use user-playwright MCP when available. Follow testing/playwright-agents.md and the playwright-e2e skill. Update status.json when done.`,
+    `Use playwright MCP when available. Follow testing/playwright-agents.md and the playwright-e2e skill. Update status.json when done.`,
   'playwright-test-healer': (s) =>
     `Invoke playwright-test-healer for slug "${s}". Fix failing/flaky e2e while preserving cases.md assertions. ` +
-    `Use user-playwright MCP when available. Follow testing/playwright-agents.md and debug-investigation. Update status.json when done.`,
+    `Use playwright MCP when available. Follow testing/playwright-agents.md and debug-investigation. Update status.json when done.`,
   'tech-writer': (s) =>
     `Invoke tech-writer for slug "${s}". Write documentation.md from task artifacts. Update status.json when done.`,
 };

package/presets/claude/next/mcp.json

@@ -0,0 +1,20 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "playwright-test": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    },
+    "figma": {
+      "type": "http",
+      "url": "https://mcp.figma.com/mcp"
+    }
+  }
+}

package/presets/claude/next/rules/tooling-and-review/agent-team-orchestrator.md

@@ -109,12 +109,16 @@ flowchart TD
 2. Read `pipeline.json` before every subagent invocation.
 3. One role per subagent call — **except** parallel steps.
 4. **Never** skip `humanGates` without `/task-continue` or explicit user approval.
-5. Persist handoffs including `validation-report.md`.
+5. Persist handoffs including `validation-report.md` (write files; do not rely on Shell `mkdir` alone).
 6. On `changes_requested`: hook sets `retryAfterFix` → developer → same reviewer.
 7. On `validation_failed`: hook sets `retryAfterFix: build-verifier` → developer → build-verifier.
 8. When all steps complete, suggest `/technical-retro <slug>`.
 9. If `autoChain: false`, manual step only.
 
+## Team artifact I/O
+
+Create `.claude/team/tasks/<slug>/**` by writing files (Write/Edit). Avoid Shell-only `mkdir` as the bootstrap step.
+
 ## Invoking agents
 
 Use the available Claude Code subagent mechanism. Pass: slug, artifact paths, step `scope` if set.

package/presets/cursor/ios-swift/AGENTS.md

@@ -44,4 +44,4 @@ Intent detection, profiles (`full` / `standard` / `light`), and default steps
 npx @bonesofspring/ai-rules init cursor --preset ios-swift
 ```
 
-Копирует rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md`.
+Копирует rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md`, `MCP.md`, `mcp.json` → `.cursor/mcp.json`.

package/presets/cursor/ios-swift/MCP.md

@@ -0,0 +1,16 @@
+# MCP (preset `ios-swift`, Cursor)
+
+Копируется в `.cursor/mcp.json` при `ai-rules init cursor --preset ios-swift`.
+
+## Servers
+
+| Name | Package | Зачем |
+|------|---------|--------|
+| `context7` | `@upstash/context7-mcp` | Актуальная документация Swift / SwiftUI / Apple frameworks |
+| `figma` | remote `https://mcp.figma.com/mcp` | Design context → SwiftUI; OAuth в Cursor |
+
+Playwright / Chrome DevTools **не** входят в ios-пресет (browser e2e запрещены agent team).
+
+Секреты в файл не кладём. Опционально: `CONTEXT7_API_KEY` в окружении. Figma — OAuth (токен не коммитим).
+
+После init: Settings → MCP → включить серверы. `init` перезаписывает одноимённый `mcp.json`.

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

@@ -20,6 +20,7 @@ npx @bonesofspring/ai-rules init cursor --preset ios-swift
 | `commands/**` | task, task-continue, feature-start/continue, technical-retro |
 | `hooks.json` + `hooks/**` | guard-shell + chain-team-phases |
 | `team/**` | fixtures + README |
+| `mcp.json` + `MCP.md` | Context7 + Figma MCP → `.cursor/mcp.json` |
 
 ## alwaysApply (≤3)
 

package/presets/cursor/ios-swift/agents/task-router.md

@@ -55,7 +55,7 @@ Fixtures: `.cursor/team/fixtures/` (feature-full, feature-light, bugfix-standard
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/pipeline.json` and initial `status.json`; set `.cursor/team/active-task.json`.
+Write `.cursor/team/tasks/<slug>/pipeline.json` and initial `status.json` via the **Write** tool (creates parents; do not Shell-`mkdir`); set `.cursor/team/active-task.json`.
 
 ## Handoff
 

package/presets/cursor/ios-swift/commands/feature-start.md

@@ -13,7 +13,7 @@ description: Legacy analyst-only feature intake. Prefer /task for new work becau
 
 1. Извлеки описание задачи из аргументов команды (всё после `/feature-start`).
 2. Сгенерируй **slug** (kebab-case, до 48 символов) из заголовка задачи.
-3. Создай каталог `.cursor/team/tasks/<slug>/` если его ещё нет.
+3. Создай `.cursor/team/tasks/<slug>/` если его ещё нет — через **Write** артефакта (не Shell `mkdir`).
 4. Запиши `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
 5. Опционально: минимальный `pipeline.json` с фиксированными steps (analyst → developer → reviewer → qa-tester).
 6. Вызови subagent **task-analyst** (Task tool) с полным описанием задачи и путём к артефактам.

package/presets/cursor/ios-swift/commands/task.md

@@ -25,7 +25,7 @@ description: Route a natural-language task through the agent-team pipeline: task
 
 ## Алгоритм
 
-1. **Slug** — kebab-case из описания (≤48 символов). Создай `.cursor/team/tasks/<slug>/`.
+1. **Slug** — kebab-case из описания (≤48 символов). Создай `.cursor/team/tasks/<slug>/` через **Write** (например сразу `status.json` или пустой placeholder) — **не** через Shell `mkdir` (песочница → `Operation not permitted`).
 2. **Router** — вызови subagent **task-router** с описанием задачи и путём к slug.
 3. **План** — покажи пользователю таблицу из `pipeline.json`: intent, steps, skipped, humanGates.
 4. **Intent retro** — если `intent === "retro"`, выполни `/technical-retro` и **остановись**.

package/presets/cursor/ios-swift/mcp.json

@@ -0,0 +1,11 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "figma": {
+      "url": "https://mcp.figma.com/mcp"
+    }
+  }
+}

package/presets/cursor/ios-swift/rules/agent-team-orchestrator.mdc

@@ -67,12 +67,17 @@ Full prompts: `.cursor/agents/*.md`. Artifacts: `.cursor/team/README.md`.
 2. Read `pipeline.json` before every subagent invocation.
 3. One role per Task call — except parallel steps.
 4. **Never** skip `humanGates` without `/task-continue` or explicit approval.
-5. Persist handoffs to disk under `.cursor/team/tasks/<slug>/`.
+5. Persist handoffs to disk under `.cursor/team/tasks/<slug>/` via **Write** (not Shell `mkdir`).
 6. On `changes_requested`: developer → same reviewer.
 7. On `validation_failed`: developer → build-verifier.
 8. When all steps complete, suggest `/technical-retro <slug>`.
 9. If `autoChain: false`, do not rely on hook.
 
+## Team artifact I/O (Cursor Shell sandbox)
+
+- Create/update `.cursor/team/tasks/<slug>/**` with the **Write** tool. Do **not** bootstrap slug dirs with Shell `mkdir -p` — sandbox → `Operation not permitted` (esp. macOS Desktop/Documents + TCC).
+- If Shell must touch team paths and fails with EPERM, retry with `required_permissions: ["all"]`.
+
 ## Skip pipeline when
 
 - Pure questions; typo / one-file trivial fix; user «без pipeline»; single-line docs-only.

package/presets/cursor/ios-swift/team/README.md

@@ -25,3 +25,7 @@
 | `bugfix-standard.json` | debugger → developer (skipIf) → verifier → reviewer |
 
 **Never** schedule Playwright-only steps without skip rationale. Use `xcuitest-test-*` for UI-test-only intents.
+
+## Creating task dirs
+
+Bootstrap `tasks/<slug>/` by **writing** artifacts (Write tool), not Shell `mkdir`. Cursor sandbox → `Operation not permitted` otherwise (worse on Desktop/Documents).

package/presets/cursor/next/AGENTS.md

@@ -33,4 +33,4 @@ Intent detection, profiles (`full` / `standard` / `light`), and default steps
 npx @bonesofspring/ai-rules init cursor --preset next
 ```
 
-Копирует rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md`.
+Копирует rules, commands, agents, hooks, skills, team, `hooks.json`, `BUGBOT.md`, `AGENTS.md`, `MCP.md`, `mcp.json` → `.cursor/mcp.json`.

package/presets/cursor/next/MCP.md

@@ -0,0 +1,16 @@
+# MCP (preset `next`, Cursor)
+
+Копируется в `.cursor/mcp.json` при `ai-rules init cursor --preset next`.
+
+## Servers
+
+| Name | Package | Зачем |
+|------|---------|--------|
+| `context7` | `@upstash/context7-mcp` | Актуальная документация Next/React/TS и библиотек (меньше устаревших API в ответах агента) |
+| `playwright` | `@playwright/mcp` | Browser automation для e2e агентов (`playwright-test-*`) и проверки селекторов |
+| `chrome-devtools` | `chrome-devtools-mcp` | Live DOM/network/performance при отладке UI |
+| `figma` | remote `https://mcp.figma.com/mcp` | Design context → код (макеты, токены, Code Connect); OAuth в Cursor |
+
+Секреты в файл не кладём. Опционально: `CONTEXT7_API_KEY` в окружении — выше rate limits у Context7. Figma — OAuth при первом подключении (токен в конфиг не пишем).
+
+После init: Settings → MCP → включить серверы (или перезапустить Cursor). Локально можно дополнять/переопределять; `init` перезаписывает одноимённый `mcp.json`.

package/presets/cursor/next/agents/playwright-test-generator.md

@@ -19,7 +19,7 @@ You generate Playwright tests from project test plans.
 2. Write specs under `app/__tests__/e2e/**`, next to the plan.
 3. Match `test.describe` and `test(...)` names to the plan sections and scenario names.
 4. Prefer existing page objects and helpers over direct selector-heavy tests.
-5. **Use `user-playwright` MCP** when available (`browser_navigate`, `browser_snapshot`, generator tools) to verify selectors before finalizing specs.
+5. **Use `playwright` MCP** when available (`browser_navigate`, `browser_snapshot`, generator tools; may appear as `user-playwright` if installed globally) to verify selectors before finalizing specs.
 6. Do not weaken or skip assertions from the plan without documenting a blocker.
 
 ## Completion

package/presets/cursor/next/agents/playwright-test-healer.md

@@ -18,7 +18,7 @@ You debug and fix failing Playwright e2e tests.
 1. Follow **`playwright-agents.mdc`**, **`tests-e2e-structure.mdc`**, and the **`debug-investigation`** and **`playwright-e2e`** skills.
 2. Treat `*.cases.md` as the behavior contract.
 3. Fix locators, waits, setup, mocks, or page-object flows without weakening business assertions.
-4. **Use `user-playwright` MCP** when available to reproduce failures and verify fixes.
+4. **Use `playwright` MCP** when available (or `user-playwright` if installed globally) to reproduce failures and verify fixes.
 5. Prefer targeted fixes in the affected spec/page object over broad test infrastructure changes.
 6. Re-run the affected spec when feasible.
 

package/presets/cursor/next/agents/task-router.md

@@ -82,7 +82,7 @@ Fixtures: `.cursor/team/fixtures/` (feature-full, feature-light, bugfix-standard
 
 ## Output
 
-Write `.cursor/team/tasks/<slug>/pipeline.json` and initial `status.json`; set `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`. Minimal template — см. **`agents/README.md`**.
+Write `.cursor/team/tasks/<slug>/pipeline.json` and initial `status.json` via the **Write** tool (creates parents; do not Shell-`mkdir`); set `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`. Minimal template — см. **`agents/README.md`**.
 
 ## Handoff to orchestrator
 

package/presets/cursor/next/commands/feature-start.md

@@ -13,7 +13,7 @@ description: Legacy analyst-only feature intake. Prefer /task for new work becau
 
 1. Извлеки описание задачи из аргументов команды (всё после `/feature-start`).
 2. Сгенерируй **slug** (kebab-case, до 48 символов) из заголовка задачи.
-3. Создай каталог `.cursor/team/tasks/<slug>/` если его ещё нет.
+3. Создай `.cursor/team/tasks/<slug>/` если его ещё нет — через **Write** артефакта (не Shell `mkdir`).
 4. Запиши `.cursor/team/active-task.json` → `{ "slug": "<slug>" }`.
 5. Опционально: минимальный `pipeline.json` с фиксированными steps (analyst → developer → reviewer → qa-tester).
 6. Вызови subagent **task-analyst** (Task tool) с полным описанием задачи и путём к артефактам.

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

@@ -25,7 +25,7 @@ description: Route a natural-language task through the agent-team pipeline: task
 
 ## Алгоритм
 
-1. **Slug** — kebab-case из описания (≤48 символов). Создай `.cursor/team/tasks/<slug>/`.
+1. **Slug** — kebab-case из описания (≤48 символов). Создай `.cursor/team/tasks/<slug>/` через **Write** (например сразу `status.json` или пустой placeholder) — **не** через Shell `mkdir` (песочница → `Operation not permitted`).
 2. **Router** — вызови subagent **task-router** с описанием задачи и путём к slug.
 3. **План** — покажи пользователю таблицу из `pipeline.json`: intent, steps, skipped, humanGates.
 4. **Intent retro** — если `intent === "retro"`, выполни `/technical-retro` и **остановись**.

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

@@ -157,10 +157,10 @@ const AGENT_HANDOFF = {
     `Follow playwright-agents.mdc and the playwright-e2e skill. Update status.json when done.`,
   'playwright-test-generator': (s) =>
     `Invoke playwright-test-generator for slug "${s}". Generate/update *.spec.ts from matching *.cases.md. ` +
-    `Use user-playwright MCP when available. Follow playwright-agents.mdc and the playwright-e2e skill. Update status.json when done.`,
+    `Use playwright MCP when available. Follow playwright-agents.mdc and the playwright-e2e skill. Update status.json when done.`,
   'playwright-test-healer': (s) =>
     `Invoke playwright-test-healer for slug "${s}". Fix failing/flaky e2e while preserving cases.md assertions. ` +
-    `Use user-playwright MCP when available. Follow playwright-agents.mdc and debug-investigation. Update status.json when done.`,
+    `Use playwright MCP when available. Follow playwright-agents.mdc and debug-investigation. Update status.json when done.`,
   'tech-writer': (s) =>
     `Invoke tech-writer for slug "${s}". Write documentation.md from task artifacts. Update status.json when done.`,
 };

package/presets/cursor/next/mcp.json

@@ -0,0 +1,19 @@
+{
+  "mcpServers": {
+    "context7": {
+      "command": "npx",
+      "args": ["-y", "@upstash/context7-mcp"]
+    },
+    "playwright": {
+      "command": "npx",
+      "args": ["-y", "@playwright/mcp@latest"]
+    },
+    "chrome-devtools": {
+      "command": "npx",
+      "args": ["-y", "chrome-devtools-mcp@latest"]
+    },
+    "figma": {
+      "url": "https://mcp.figma.com/mcp"
+    }
+  }
+}

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

@@ -115,6 +115,12 @@ flowchart TD
 8. When all steps complete, suggest `/technical-retro <slug>`.
 9. If `autoChain: false` in pipeline, do not rely on hook — manual step only.
 
+## 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`).
+- 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.
+
 ## Invoking agents
 
 Use Task tool or `/agent-name`. Pass: slug, artifact paths, step `scope` if set.

package/presets/cursor/next/team/README.md

@@ -100,6 +100,10 @@ Prefer **`executing`** for pipeline mode. Legacy: `analysis`, `development`, `re
 
 Legacy: `/feature-start`, `/feature-continue`.
 
+## Creating task dirs
+
+Bootstrap `<slug>/` by **writing** `pipeline.json` / `status.json` (Write tool). Do **not** use Shell `mkdir -p` — Cursor’s default sandbox returns `Operation not permitted` (especially for repos on macOS Desktop/Documents).
+
 ## Git
 
 Commit task artifacts if you want them to survive `ai-rules clean cursor`. Or copy finished tasks to `docs/agent-workflow/tasks/<slug>/`.