@bonesofspring/ai-rules 0.2.1 → 0.2.2

package/README.md

@@ -1,11 +1,9 @@
 # @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 for Claude `CLAUDE.md` and `skills` / `agents` / `hooks` when the preset includes them. Install from npm into a project so you don’t have to copy files out of the repo by hand.
 
 Node 18+.
 
-Contributing and Cursor↔Claude sync checklist: **[CONTRIBUTING.md](./CONTRIBUTING.md)**.
-
 ```bash
 # from the project root
 npx @bonesofspring/ai-rules init cursor --preset next
@@ -15,18 +13,9 @@ npx @bonesofspring/ai-rules clean cursor
 
 Global: `npm i -g @bonesofspring/ai-rules`, then `ai-rules ...`.
 
-`init` merges into the **current working directory** (or `--cwd <dir>`): dirs are created, matching files are **overwritten**. `--preset` defaults to **`next`**. Supported forms:
-
-```bash
-npx @bonesofspring/ai-rules init cursor --preset next
-npx @bonesofspring/ai-rules init cursor next
-npx @bonesofspring/ai-rules init cursor          # preset next by default
-npx @bonesofspring/ai-rules cursor init --preset next
-```
+`init` merges into the current directory: dirs are created, matching files are **overwritten**. `--preset` and the subcommand can be in either order, e.g. `--preset=next init cursor`.
 
-If `.cursor` does not appear, check the command output for errors and confirm you run init from the **target project root** (where the app lives), not from `node_modules`. Success ends with: `Done. .cursor installed at <absolute-path>`.
-
-`clean cursor` / `clean claude` removes what this CLI installs: `rules`, `commands`, optional `agents`, `hooks`, `skills`, `team`, Cursor `hooks.json` / `BUGBOT.md`, and Claude `CLAUDE.md` when present. Other files under `.cursor/` or `.claude/` are left intact.
+`clean cursor` / `clean claude` removes what this CLI installs: for Cursor, the entire `.cursor` directory; for Claude, `.claude/rules`, `.claude/commands`, `skills`, `agents`, `hooks`, and `CLAUDE.md` when present. Anything else under `.claude` is left alone.
 
 Where things go on `init`:
 
@@ -34,13 +23,14 @@ Where things go on `init`:
 |---|--------|--------|
 | rules | `.cursor/rules` | `.claude/rules` |
 | commands | `.cursor/commands` | `.claude/commands` |
-| agents | `.cursor/agents` | `.claude/agents` |
-| hooks | `.cursor/hooks`, `.cursor/hooks.json` | `.claude/hooks` |
-| skills | `.cursor/skills` | `.claude/skills` |
-| team artifacts template | `.cursor/team` | `.claude/team` |
-| other | root `BUGBOT.md` → `.cursor/BUGBOT.md` | root `CLAUDE.md` → `.claude/CLAUDE.md` |
+| other | — | root `CLAUDE.md` → `.claude/CLAUDE.md`; folders `skills`, `agents`, `hooks` → under `.claude/` with the same names |
+
+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 `..`.
 
-The package currently ships the **`next`** preset (Next.js stack and whatever else is bundled there). Other preset names: see `presets/` in the [repo](https://github.com/bonesofspring/ai-rules). Name is a single path segment, no `/` or `..`.
+```bash
+npx @bonesofspring/ai-rules init cursor --preset ios-swift
+npx @bonesofspring/ai-rules init claude --preset ios-swift
+```
 
 Help: `ai-rules --help`.
 

package/bin/cli.js

@@ -5,88 +5,51 @@
 const fs = require('fs');
 const path = require('path');
 
+const packageRoot = path.join(__dirname, '..');
+
 /** Single path segment: letters, digits, dot, underscore, hyphen; no separators or "..". */
 const PRESET_NAME_RE = /^[a-zA-Z0-9][a-zA-Z0-9._-]*$/;
-const DEFAULT_PRESET = 'next';
-const TOOLS = new Set(['cursor', 'claude']);
 
 const PRESETS = {
   cursor: {
     rulesDir: '.cursor/rules',
     commandsDir: '.cursor/commands',
     relBase: ['presets', 'cursor'],
-    optionalCursorDirs: ['agents', 'hooks', 'skills', 'team'],
-    hooksJsonSrc: 'hooks.json',
-    toolRootFiles: ['BUGBOT.md', 'AGENTS.md'],
   },
   claude: {
     rulesDir: '.claude/rules',
     commandsDir: '.claude/commands',
     relBase: ['presets', 'claude'],
-    optionalClaudeDirs: ['skills', 'agents', 'hooks', 'team'],
+    /** Optional dirs under preset root → under `.claude/` (recursive copy). */
+    optionalClaudeDirs: ['skills', 'agents', 'hooks'],
+    /** Copied from preset root to `.claude/CLAUDE.md` when present. */
     claudeMdSrc: 'CLAUDE.md',
-    hooksJsonSrc: 'hooks.json',
-    toolRootFiles: ['BUGBOT.md'],
   },
 };
 
-function getPackageRoot() {
-  try {
-    return path.dirname(require.resolve('@bonesofspring/ai-rules/package.json'));
-  } catch {
-    return path.join(__dirname, '..');
-  }
-}
-
 function printHelp() {
   console.log(`@bonesofspring/ai-rules
 
 Usage:
-  ai-rules init <cursor|claude> [--preset <name>]
-  ai-rules init <cursor|claude> <preset-name>
-  ai-rules clean <cursor|claude> [--cwd <dir>]
-
-Options:
-  --preset <name>   Preset name (default: ${DEFAULT_PRESET})
-  --cwd <dir>       Target project directory (default: current working directory)
+  ai-rules init <cursor|claude> --preset <name>   Copy preset rules and commands into the current directory
+  ai-rules clean <cursor|claude>                 Remove preset target rules and commands directories
 
 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, hooks.json, BUGBOT.md, and CLAUDE.md when present.
-  Command forms: "init cursor --preset next", "init cursor next", "--preset next init cursor", "cursor init --preset next".
+  init merges into existing target folders; same-named files are overwritten.
+  clean cursor removes the entire .cursor directory (if present).
+  Flags may appear before or after the subcommand (e.g. --preset next init cursor).
 
 Examples:
   npx @bonesofspring/ai-rules init cursor --preset next
-  npx @bonesofspring/ai-rules init cursor next
-  npx @bonesofspring/ai-rules init claude
-  npx @bonesofspring/ai-rules clean cursor
+  npx @bonesofspring/ai-rules init claude --preset ios-swift
+  npx @bonesofspring/ai-rules clean claude
 `);
 }
 
 function parseArgs(argv) {
-  const args = { _: [], cwd: undefined, preset: undefined, presetError: undefined };
+  const args = { _: [] };
   for (let i = 0; i < argv.length; i++) {
     const a = argv[i];
-    if (a === '--cwd') {
-      const value = argv[i + 1];
-      if (value === undefined || value.startsWith('-')) {
-        args.cwdError = 'Missing value for --cwd';
-        continue;
-      }
-      args.cwd = value;
-      i++;
-      continue;
-    }
-    if (a.startsWith('--cwd=')) {
-      const value = a.slice('--cwd='.length);
-      if (value === '') {
-        args.cwdError = 'Missing value after --cwd=';
-        continue;
-      }
-      args.cwd = value;
-      continue;
-    }
     if (a === '--preset') {
       const value = argv[i + 1];
       if (value === undefined || value.startsWith('-')) {
@@ -107,53 +70,17 @@ function parseArgs(argv) {
       args.preset = value;
       continue;
     }
-    if (a === '-h' || a === '--help') {
-      args.help = true;
-      continue;
-    }
     args._.push(a);
   }
   return args;
 }
 
-/**
- * Supports: init cursor, cursor init, init cursor next (positional preset).
- */
-function normalizeInitClean(parsed) {
-  const positional = [...parsed._];
-  let command;
-  let tool;
-  let presetFromPositional;
-
-  if (positional.length >= 2 && TOOLS.has(positional[0]) && positional[1] === 'init') {
-    command = 'init';
-    tool = positional[0];
-    presetFromPositional = positional[2];
-  } else if (positional.length >= 2 && positional[0] === 'init' && TOOLS.has(positional[1])) {
-    command = 'init';
-    tool = positional[1];
-    presetFromPositional = positional[2];
-  } else if (positional.length >= 2 && positional[0] === 'clean' && TOOLS.has(positional[1])) {
-    command = 'clean';
-    tool = positional[1];
-  } else if (positional.length >= 1) {
-    command = positional[0];
-    tool = positional[1];
-    if (command === 'init' && positional[2] && PRESET_NAME_RE.test(positional[2])) {
-      presetFromPositional = positional[2];
-    }
-  }
-
-  const preset = parsed.preset || presetFromPositional;
-  return { command, tool, preset };
-}
-
 /**
  * @returns {string | null} Error message or null if valid.
  */
 function validatePresetName(preset) {
   if (preset === undefined || preset === '') {
-    return 'Missing preset name (use --preset <name>, e.g. --preset next)';
+    return 'Missing --preset <name>';
   }
   if (!PRESET_NAME_RE.test(preset) || preset.includes('..')) {
     return (
@@ -164,6 +91,9 @@ function validatePresetName(preset) {
   return null;
 }
 
+/**
+ * Ensures resolved preset dir stays under the tool presets root (defense in depth).
+ */
 function assertPresetDirInsideRoot(presetsRoot, presetBase) {
   const root = path.resolve(presetsRoot);
   const resolved = path.resolve(presetBase);
@@ -187,17 +117,10 @@ function copyDir(src, dest) {
       copyDir(from, to);
     } else {
       fs.copyFileSync(from, to);
-      if (e.name.endsWith('.sh')) {
-        fs.chmodSync(to, 0o755);
-      }
     }
   }
 }
 
-function getOptionalDirs(cfg) {
-  return cfg.optionalCursorDirs || cfg.optionalClaudeDirs || [];
-}
-
 function removeDirIfExists(dir) {
   if (fs.existsSync(dir)) {
     fs.rmSync(dir, { recursive: true, force: true });
@@ -210,157 +133,76 @@ function removeFileIfExists(filePath) {
   }
 }
 
-function listPresetNames(presetsRoot) {
-  if (!fs.existsSync(presetsRoot)) {
-    return [];
-  }
-  return fs
-    .readdirSync(presetsRoot, { withFileTypes: true })
-    .filter((e) => e.isDirectory())
-    .map((e) => e.name)
-    .filter((name) => PRESET_NAME_RE.test(name));
-}
-
 function presetHasAnySource(base, cfg) {
   const rulesSrc = path.join(base, 'rules');
   const commandsSrc = path.join(base, 'commands');
   if (fs.existsSync(rulesSrc) || fs.existsSync(commandsSrc)) {
     return true;
   }
-  for (const name of getOptionalDirs(cfg)) {
-    if (fs.existsSync(path.join(base, name))) {
-      return true;
+  if (cfg.optionalClaudeDirs) {
+    for (const name of cfg.optionalClaudeDirs) {
+      if (fs.existsSync(path.join(base, name))) {
+        return true;
+      }
     }
   }
   if (cfg.claudeMdSrc && fs.existsSync(path.join(base, cfg.claudeMdSrc))) {
     return true;
   }
-  if (cfg.hooksJsonSrc && fs.existsSync(path.join(base, cfg.hooksJsonSrc))) {
-    return true;
-  }
-  for (const name of cfg.toolRootFiles || []) {
-    if (fs.existsSync(path.join(base, name))) {
-      return true;
-    }
-  }
   return false;
 }
 
-function resolveTargetCwd(cwdOption) {
-  const cwd = cwdOption ? path.resolve(cwdOption) : process.cwd();
-  if (!fs.existsSync(cwd)) {
-    console.error(`Target directory does not exist: ${cwd}`);
-    process.exit(1);
-  }
-  if (!fs.statSync(cwd).isDirectory()) {
-    console.error(`Target path is not a directory: ${cwd}`);
+function cmdInit(tool, preset) {
+  const cfg = PRESETS[tool];
+  if (!cfg) {
+    console.error(`Unknown tool: ${tool}. Use cursor or claude.`);
     process.exit(1);
   }
-  return cwd;
-}
-
-function resolvePresetName(tool, preset, packageRoot) {
-  const cfg = PRESETS[tool];
-  const presetsRoot = path.join(packageRoot, ...cfg.relBase);
-  let name = preset || DEFAULT_PRESET;
-
-  const nameErr = validatePresetName(name);
+  const nameErr = validatePresetName(preset);
   if (nameErr) {
     console.error(nameErr);
     process.exit(1);
   }
-
-  let base = path.join(presetsRoot, name);
-  if (!presetHasAnySource(base, cfg)) {
-    const available = listPresetNames(presetsRoot);
-    if (!preset && available.includes(DEFAULT_PRESET)) {
-      name = DEFAULT_PRESET;
-      base = path.join(presetsRoot, name);
-    } else {
-      console.error(`Preset "${name}" for ${tool} not found.`);
-      console.error(`Looked in: ${base}`);
-      console.error(`Package root: ${packageRoot}`);
-      if (available.length > 0) {
-        console.error(`Available presets: ${available.join(', ')}`);
-      } else {
-        console.error(`No presets directory at: ${presetsRoot}`);
-        console.error(
-          'The installed package may be incomplete. Reinstall @bonesofspring/ai-rules or run from the package source.',
-        );
-      }
-      process.exit(1);
-    }
-  }
-
+  const presetsRoot = path.join(packageRoot, ...cfg.relBase);
+  const base = path.join(presetsRoot, preset);
   assertPresetDirInsideRoot(presetsRoot, base);
-  return { name, base, presetsRoot };
-}
-
-function cmdInit(tool, preset, cwdOption) {
-  const cfg = PRESETS[tool];
-  if (!cfg) {
-    console.error(`Unknown tool: ${tool}. Use cursor or claude.`);
-    process.exit(1);
-  }
-
-  const packageRoot = getPackageRoot();
-  const cwd = resolveTargetCwd(cwdOption);
-  const { name: presetName, base } = resolvePresetName(tool, preset, packageRoot);
 
   const rulesSrc = path.join(base, 'rules');
   const commandsSrc = path.join(base, 'commands');
-  const toolRoot = tool === 'cursor' ? '.cursor' : '.claude';
-  const toolRootAbs = path.join(cwd, toolRoot);
-
-  fs.mkdirSync(toolRootAbs, { recursive: true });
+  const cwd = process.cwd();
 
-  let copiedSteps = 0;
+  if (!presetHasAnySource(base, cfg)) {
+    console.error(`Preset "${preset}" for ${tool} not found under ${base}`);
+    process.exit(1);
+  }
 
   try {
     if (tool === 'claude' && cfg.claudeMdSrc) {
       const mdFrom = path.join(base, cfg.claudeMdSrc);
       if (fs.existsSync(mdFrom)) {
-        fs.copyFileSync(mdFrom, path.join(toolRootAbs, 'CLAUDE.md'));
-        console.log(`Copied CLAUDE.md → ${path.join(toolRoot, 'CLAUDE.md')}`);
-        copiedSteps++;
+        const claudeRoot = path.join(cwd, '.claude');
+        fs.mkdirSync(claudeRoot, { recursive: true });
+        fs.copyFileSync(mdFrom, path.join(claudeRoot, 'CLAUDE.md'));
+        console.log('Copied CLAUDE.md → .claude/CLAUDE.md');
       }
     }
 
     if (fs.existsSync(rulesSrc)) {
       copyDir(rulesSrc, path.join(cwd, cfg.rulesDir));
       console.log(`Copied rules → ${cfg.rulesDir}`);
-      copiedSteps++;
     }
     if (fs.existsSync(commandsSrc)) {
       copyDir(commandsSrc, path.join(cwd, cfg.commandsDir));
       console.log(`Copied commands → ${cfg.commandsDir}`);
-      copiedSteps++;
-    }
-
-    for (const name of getOptionalDirs(cfg)) {
-      const src = path.join(base, name);
-      if (fs.existsSync(src)) {
-        copyDir(src, path.join(toolRootAbs, name));
-        console.log(`Copied ${name}/ → ${toolRoot}/${name}/`);
-        copiedSteps++;
-      }
-    }
-
-    if (cfg.hooksJsonSrc) {
-      const hooksFrom = path.join(base, cfg.hooksJsonSrc);
-      if (fs.existsSync(hooksFrom)) {
-        fs.copyFileSync(hooksFrom, path.join(toolRootAbs, 'hooks.json'));
-        console.log(`Copied hooks.json → ${toolRoot}/hooks.json`);
-        copiedSteps++;
-      }
     }
 
-    for (const name of cfg.toolRootFiles || []) {
-      const from = path.join(base, name);
-      if (fs.existsSync(from)) {
-        fs.copyFileSync(from, path.join(toolRootAbs, name));
-        console.log(`Copied ${name} → ${toolRoot}/${name}`);
-        copiedSteps++;
+    if (tool === 'claude' && cfg.optionalClaudeDirs) {
+      for (const name of cfg.optionalClaudeDirs) {
+        const src = path.join(base, name);
+        if (fs.existsSync(src)) {
+          copyDir(src, path.join(cwd, '.claude', name));
+          console.log(`Copied ${name}/ → .claude/${name}/`);
+        }
       }
     }
   } catch (err) {
@@ -368,95 +210,66 @@ function cmdInit(tool, preset, cwdOption) {
     console.error(`init failed: ${msg}`);
     process.exit(1);
   }
-
-  if (copiedSteps === 0) {
-    console.error(`init failed: preset "${presetName}" had no files to copy from ${base}`);
-    process.exit(1);
-  }
-
-  if (!fs.existsSync(toolRootAbs)) {
-    console.error(`init failed: ${toolRootAbs} was not created`);
-    process.exit(1);
-  }
-
-  console.log(`Done. ${toolRoot} installed at ${toolRootAbs} (preset: ${presetName})`);
 }
 
-function cmdClean(tool, cwdOption) {
+function cmdClean(tool) {
   const cfg = PRESETS[tool];
   if (!cfg) {
     console.error(`Unknown tool: ${tool}. Use cursor or claude.`);
     process.exit(1);
   }
-  const cwd = resolveTargetCwd(cwdOption);
-  const toolRoot = tool === 'cursor' ? '.cursor' : '.claude';
-  const removedParts = [cfg.rulesDir, cfg.commandsDir];
-
+  const cwd = process.cwd();
+  if (tool === 'cursor') {
+    removeDirIfExists(path.join(cwd, '.cursor'));
+    console.log('Removed .cursor (if present)');
+    return;
+  }
   removeDirIfExists(path.join(cwd, cfg.rulesDir));
   removeDirIfExists(path.join(cwd, cfg.commandsDir));
-
-  const optionalDirs = getOptionalDirs(cfg);
-  for (const name of optionalDirs) {
-    removeDirIfExists(path.join(cwd, toolRoot, name));
-    removedParts.push(`${toolRoot}/${name}`);
-  }
-
-  if (cfg.claudeMdSrc) {
-    removeFileIfExists(path.join(cwd, toolRoot, 'CLAUDE.md'));
-    removedParts.push(`${toolRoot}/CLAUDE.md`);
-  }
-
-  if (cfg.hooksJsonSrc) {
-    removeFileIfExists(path.join(cwd, toolRoot, 'hooks.json'));
-    removedParts.push(`${toolRoot}/hooks.json`);
-  }
-
-  for (const name of cfg.toolRootFiles || []) {
-    removeFileIfExists(path.join(cwd, toolRoot, name));
-    removedParts.push(`${toolRoot}/${name}`);
-  }
-
-  console.log(`Removed ${removedParts.join(', ')} (if present)`);
+  if (tool === 'claude' && cfg.optionalClaudeDirs) {
+    for (const name of cfg.optionalClaudeDirs) {
+      removeDirIfExists(path.join(cwd, '.claude', name));
+    }
+    removeFileIfExists(path.join(cwd, '.claude', 'CLAUDE.md'));
+  }
+  console.log(
+    `Removed ${cfg.rulesDir} and ${cfg.commandsDir}` +
+      (tool === 'claude' && cfg.optionalClaudeDirs
+        ? `, optional .claude/{${cfg.optionalClaudeDirs.join(',')}}, and .claude/CLAUDE.md`
+        : '') +
+      ' (if present)',
+  );
 }
 
 function main() {
   const argv = process.argv.slice(2);
-  if (argv.length === 0) {
+  if (argv.length === 0 || argv.includes('-h') || argv.includes('--help')) {
     printHelp();
     process.exit(0);
   }
 
   const parsed = parseArgs(argv);
-  if (parsed.help) {
-    printHelp();
-    process.exit(0);
-  }
+  const [command, tool] = parsed._;
 
   if (parsed.presetError) {
     console.error(parsed.presetError);
     process.exit(1);
   }
-  if (parsed.cwdError) {
-    console.error(parsed.cwdError);
-    process.exit(1);
-  }
-
-  const { command, tool, preset } = normalizeInitClean(parsed);
 
   if (command === 'init') {
-    if (!tool || !TOOLS.has(tool)) {
-      console.error('Missing or invalid tool. Use: init cursor|claude [--preset next]');
+    if (!tool) {
+      console.error('Missing <cursor|claude> after init.');
       process.exit(1);
     }
-    cmdInit(tool, preset, parsed.cwd);
+    cmdInit(tool, parsed.preset);
     return;
   }
   if (command === 'clean') {
-    if (!tool || !TOOLS.has(tool)) {
-      console.error('Missing or invalid tool. Use: clean cursor|claude');
+    if (!tool) {
+      console.error('Missing <cursor|claude> after clean.');
       process.exit(1);
     }
-    cmdClean(tool, parsed.cwd);
+    cmdClean(tool);
     return;
   }
 

package/package.json

@@ -1,12 +1,12 @@
 {
   "name": "@bonesofspring/ai-rules",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "Presets of Cursor and Claude rules/commands for Revy Ross personal use",
   "license": "MIT",
   "author": "Revy Ross",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/bonesofspring/ai-rules.git"
+    "url": "https://github.com/bonesofspring/ai-rules.git"
   },
   "keywords": [
     "cursor",
@@ -16,21 +16,12 @@
     "bonesofspring"
   ],
   "bin": {
-    "ai-rules": "bin/cli.js"
-  },
-  "scripts": {
-    "validate": "bash scripts/validate-preset.sh",
-    "validate:init": "bash scripts/validate-preset.sh --init-smoke",
-    "validate:golden": "bash scripts/validate-preset.sh --check-golden"
+    "ai-rules": "./bin/cli.js"
   },
   "files": [
     "README.md",
-    "CHANGELOG.md",
-    "CONTRIBUTING.md",
     "bin",
-    "fragments",
-    "presets",
-    "scripts"
+    "presets"
   ],
   "engines": {
     "node": ">=18"

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

@@ -0,0 +1,27 @@
+# iOS Swift stack — project instructions
+
+Краткая точка входа для Claude Code. Подробные правила — модульные topic `.md` под `rules/` (derived из Cursor SoT).
+
+See @rules/README.md for the full Cursor → Claude mapping and sync checklist.
+
+## Where to look
+
+| Area | Folder |
+|------|--------|
+| Stack / conventions | @rules/stack/ |
+| Architecture / feature delivery | @rules/architecture/ |
+| Networking / data | @rules/api-and-data/ |
+| SwiftUI / ViewModels | @rules/ui-and-accessibility/ |
+| Tests | @rules/testing/ |
+| Quality / review / build | @rules/tooling-and-review/ |
+
+## Conventions
+
+- Одна тема на файл; path scope — frontmatter `paths:` (из Cursor `globs:`).
+- SoT: `presets/cursor/ios-swift/rules/*.mdc`. Change Cursor → update Claude twin same PR.
+- Slash-команды — в `commands/`; skills — когда появятся в пресете.
+
+## Architecture (postcard)
+
+- **Presentation** → **Domain** ← **Data**; DI в `App/`.
+- Views тонкие; ViewModels на `@MainActor`; DTO не покидают Data.

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

@@ -0,0 +1,29 @@
+# Preset `ios-swift` (Claude Code)
+
+Правила для Swift, SwiftUI, слоистой архитектуры и тестов (XCTest, XCUITest).
+
+Структура отличается от пресета Cursor: здесь повторяется типичный **layout проекта Claude Code** под `.claude/`, а не плоский список `.mdc` в `rules/`.
+
+| В пресете | Куда копирует `ai-rules init claude --preset ios-swift` |
+|-----------|---------------------------------------------------------|
+| `CLAUDE.md` | `.claude/CLAUDE.md` (точка входа, грузится в начале сессии) |
+| `rules/**` | `.claude/rules/**` (рекурсивно: подпапки по темам, см. [документацию](https://code.claude.com/docs/en/memory#organize-rules-with-clauderules)) |
+| `commands/**` | `.claude/commands/**` |
+| `skills/**` | `.claude/skills/**` (если папка есть) |
+| `agents/**` | `.claude/agents/**` (если папка есть) |
+| `hooks/**` | `.claude/hooks/**` (если папка есть) |
+
+Файлы правил — обычный Markdown с опциональным YAML frontmatter (`paths:` для скоупа по путям), не формат `.mdc` Cursor.
+
+```bash
+npx @bonesofspring/ai-rules init claude --preset ios-swift
+```
+
+## Parity with Cursor
+
+- **SoT:** `presets/cursor/ios-swift/rules/*.mdc`
+- **Claude twins:** topic `.md` under `rules/**` (bodies derived from Cursor; frontmatter uses `paths:` instead of `globs:` / `alwaysApply`)
+- **Mapping + sync checklist:** [`rules/README.md`](./rules/README.md)
+- **Entry index:** [`CLAUDE.md`](./CLAUDE.md) (thin — no second long-form SoT)
+
+When editing rules: change Cursor first, then update the Claude twin in the same PR.

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

@@ -0,0 +1,3 @@
+# Claude commands (ios-swift preset)
+
+Place command definitions for this preset here. They are copied to `.claude/commands` when you run `ai-rules init claude --preset ios-swift`.