claude-code-arcane 2.9.9 → 2.10.0

package/CHANGELOG.md

@@ -1,3 +1,15 @@
+# [2.10.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.9.9...v2.10.0) (2026-10-10)
+
+
+### Bug Fixes
+
+* **profiles:** keep bridge files under the old names for pre-rename CLIs ([921c351](https://github.com/SebastianLuser/claude-code-arcane/commit/921c35119ea3b4bf5a25bbdabe369bc922e71a3f))
+
+
+### Features
+
+* **profiles:** name stack profiles by platform and technology ([ce89d4a](https://github.com/SebastianLuser/claude-code-arcane/commit/ce89d4a25b1f6ba28d6efe7e84a27343b1e734f5))
+
 ## [2.9.9](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.9.8...v2.9.9) (2026-10-10)
 
 

package/README.md

@@ -20,7 +20,7 @@ A configuration harness installable via `npx`. Pick a **profile** that matches y
 cd ~/projects/my-app
 
 # Install a profile (no clone needed)
-npx claude-code-arcane install backend-ts+agile
+npx claude-code-arcane install backend-typescript+agile
 
 # Open Claude Code
 claude
@@ -38,7 +38,7 @@ explicitly first:
 
 ```bash
 npm install -g claude-code-arcane
-arcane install backend-ts+agile      # same as the npx line above
+arcane install backend-typescript+agile      # same as the npx line above
 ```
 
 ---
@@ -50,8 +50,8 @@ arcane install backend-ts+agile      # same as the npx line above
 Each profile is a YAML file that bundles skills, agents, rules, and permissions:
 
 ```yaml
-# profiles/backend-ts.yaml
-name: backend-ts
+# profiles/backend-typescript.yaml
+name: backend-typescript
 category: backend
 skills: [api-design, auth-strategy, jwt-strategy, ...]
 rules:
@@ -66,7 +66,7 @@ permissions:
 All profiles are equal — there is no "base vs addon" distinction. Combine as many as you need:
 
 ```bash
-npx claude-code-arcane install backend-ts+agile+testing
+npx claude-code-arcane install backend-typescript+agile+testing
 ```
 
 The installer merges all profiles, deduplicates skills, and installs only what's needed.
@@ -104,7 +104,7 @@ my-project/.claude/
 ### Install a profile
 
 ```bash
-npx claude-code-arcane install backend-ts+agile     # Install profile combination
+npx claude-code-arcane install backend-typescript+agile     # Install profile combination
 npx claude-code-arcane install                       # Show available profiles (interactive)
 npx claude-code-arcane install unity-dev --dry-run   # Preview without installing
 ```
@@ -184,12 +184,14 @@ Once installed, manage the installation from within a Claude Code session:
 
 All profiles combine freely with `+` — there is no required "base". Grouped by category:
 
+Older names still install and update: `backend-ts`, `frontend`, `mobile`, `flutter`, `ios-native` and `android-native` resolve to `backend-typescript`, `frontend-react-vite`, `mobile-react-native`, `mobile-flutter`, `mobile-ios-swift` and `mobile-android-kotlin`.
+
 ### Backend
 
 | Profile | Stack | Skills | Agents |
 |---------|-------|--------|--------|
-| `backend-ts` | Backend TypeScript — Fastify, Prisma, Zod, API design | 33 | engineering |
-| `backend-go` | Backend Go — Clean Arch, DB, auth, API, CI | 19 | engineering |
+| `backend-typescript` | Backend TypeScript — Fastify, Prisma, Zod, API design | 25 | engineering |
+| `backend-go` | Backend Go — Clean Arch, DB, auth, API, CI | 24 | engineering |
 | `backend-dotnet` | Backend .NET — ASP.NET Core, Vertical Slice/Clean, EF Core, JWT | 25 | engineering |
 | `backend-nestjs` | Backend NestJS — feature modules, DI, Prisma, JWT, microservices | 25 | engineering |
 | `backend-nextjs` | Next.js full-stack — App Router, RSC, Server Actions, SEO, AI SDK | 22 | engineering |
@@ -198,48 +200,48 @@ All profiles combine freely with `+` — there is no required "base". Grouped by
 
 | Profile | Stack | Skills | Agents |
 |---------|-------|--------|--------|
-| `frontend` | React + Vite + TypeScript | 14 | engineering |
-| `design` | Figma, UX review, design system, handoff | 6 | product |
+| `frontend-react-vite` | React + Vite + TypeScript | 17 | engineering |
+| `design` | Figma, UX review, design system, handoff | 10 | product |
 
 ### Mobile
 
 | Profile | Stack | Skills | Agents |
 |---------|-------|--------|--------|
-| `mobile` | React Native + Expo + TypeScript | 12 | engineering |
-| `flutter` | Flutter + Dart cross-platform | 8 | engineering |
-| `android-native` | Kotlin + Jetpack Compose + Material Design 3 | 8 | engineering |
-| `ios-native` | Swift + UIKit/SwiftUI + Apple HIG | 8 | engineering |
+| `mobile-react-native` | React Native + Expo + TypeScript | 17 | engineering |
+| `mobile-flutter` | Flutter + Dart cross-platform | 15 | engineering |
+| `mobile-android-kotlin` | Kotlin + Jetpack Compose + Material Design 3 | 14 | engineering |
+| `mobile-ios-swift` | Swift + UIKit/SwiftUI + Apple HIG | 14 | engineering |
 
 ### Gamedev
 
 | Profile | Stack | Skills | Agents |
 |---------|-------|--------|--------|
-| `unity-dev` | Unity programmer — C#, architecture, performance, builds | 25 | game |
-| `unity-design` | Game designer — GDDs, balance, art bible, playtesting | 17 | game |
+| `unity-dev` | Unity programmer — C#, architecture, performance, builds | 21 | game |
+| `unity-design` | Game designer — GDDs, balance, art bible, playtesting | 18 | game |
 | `meshy` | 3D asset production with Meshy AI — credit-gated generation, single master + cheap derivatives, printability | 5 | — |
 | `blender` | Blender for game assets — tri budget and topology, materials with bake and color space, baked animation, validated export | 6 | — |
-| `unreal-dev` | Unreal Engine 5 programmer — C++, Blueprints, GAS, replication, rendering, packaging | 49 | game |
-| `visual-novel` | Visual novel developer — Ren'Py, narrative, branching | 17 | visualnovel, game |
+| `unreal-dev` | Unreal Engine 5 programmer — C++, Blueprints, GAS, replication, rendering, packaging | 50 | game |
+| `visual-novel` | Visual novel developer — Ren'Py, narrative, branching | 18 | visualnovel, game |
 | `audio` | Game audio — direction, composition, sound design, middleware, VO, QA | 13 | audio |
 
 ### Platform & Quality
 
 | Profile | Adds | Skills | Agents |
 |---------|------|--------|--------|
-| `infra` | Terraform, observability, secrets, rollback, K8s | 17 | devops |
+| `infra` | Terraform, observability, secrets, rollback, K8s | 24 | devops |
 | `database` | Indexing, migrations, seeding, replicas, optimization | 8 | — |
-| `security` | Audits, OWASP, secrets, backups | 5 | — |
+| `security` | Audits, OWASP, secrets, backups | 10 | — |
 | `testing` | Contract, performance, regression, flakiness | 11 | quality |
-| `ai` | LLM cost optimization, RAG, ML, data engineering | 7 | ai |
+| `ai` | LLM cost optimization, RAG, ML, data engineering, agent and MCP design | 10 | ai |
 
 ### Project Management
 
 | Profile | Adds | Skills | Agents |
 |---------|------|--------|--------|
-| `agile` | Sprints, standups, retros, estimates | 10 | management, product |
-| `jira` | Jira via REST API — issues, sprints, boards | 3 | — |
-| `clickup` | ClickUp via MCP — tasks, docs, time tracking | 3 | — |
-| `integrations` | GitHub Projects, Slack, Postman | 3 | integrations |
+| `agile` | Sprints, standups, retros, estimates | 39 | management, product |
+| `jira` | Jira via REST API — issues, sprints, boards | 1 | — |
+| `clickup` | ClickUp via MCP — tasks, docs, time tracking | 1 | — |
+| `integrations` | GitHub Projects, Slack, Postman, Stripe, email templates, Microsoft 365, Snowflake, stack evaluation | 8 | integrations |
 
 ### Business
 
@@ -249,7 +251,7 @@ All profiles combine freely with `+` — there is no required "base". Grouped by
 | `clevel` | C-suite advisors, board prep, strategic ops | 28 | clevel |
 | `finance` | Investment analysis, financial modeling, SaaS metrics | 3 | business |
 | `marketing` | Content, growth, SEO/CRO, strategy, analytics | 44 | marketing |
-| `ecommerce` | Commerce end-to-end agnóstico de lenguaje — data model, checkout, inventario, órdenes, pagos, promociones, shipping/tax, listings, analytics, feeds, storefront, suscripciones | 12 | ecommerce |
+| `ecommerce` | Commerce end-to-end agnóstico de lenguaje — data model, checkout, inventario, órdenes, pagos, promociones, shipping/tax, listings, analytics, feeds, storefront, suscripciones | 21 | ecommerce |
 | `regulatory` | ISO 13485, GDPR, FDA, SOC 2, ISMS, QMS, MDR | 13 | regulatory |
 
 ### Personal
@@ -264,7 +266,7 @@ All profiles combine freely with `+` — there is no required "base". Grouped by
 
 | Profile | Adds | Skills | Agents |
 |---------|------|--------|--------|
-| `docs` | PDF, PPTX, XLSX, DOCX, architecture decisions | 8 | — |
+| `docs` | PDF, PPTX, XLSX, DOCX, architecture decisions | 5 | — |
 | `self-improving` | Agent self-improvement and skill extraction | 2 | — |
 | `statusline` | Claude Code status bar (branch, division, session info) | 0 | — |
 
@@ -323,28 +325,28 @@ npx claude-code-arcane install unity-dev+unity-design+agile+clickup
 npx claude-code-arcane install backend-go+infra+agile+jira
 
 # Full-stack monorepo
-npx claude-code-arcane install backend-ts+frontend+testing+database
+npx claude-code-arcane install backend-typescript+frontend-react-vite+testing+database
 
 # Mobile app with CI/CD
-npx claude-code-arcane install mobile+agile+clickup+testing
+npx claude-code-arcane install mobile-react-native+agile+clickup+testing
 
 # Secure backend with docs
-npx claude-code-arcane install backend-ts+security+docs+database
+npx claude-code-arcane install backend-typescript+security+docs+database
 
 # AI/ML project with data pipelines
 npx claude-code-arcane install backend-go+ai+infra
 
 # SaaS with full marketing stack
-npx claude-code-arcane install backend-ts+marketing+business+finance
+npx claude-code-arcane install backend-typescript+marketing+business+finance
 
 # Regulated medical device
-npx claude-code-arcane install backend-ts+regulatory+security+testing
+npx claude-code-arcane install backend-typescript+regulatory+security+testing
 
 # Founder advisory setup
 npx claude-code-arcane install clevel+business+finance+marketing
 
 # With status bar
-npx claude-code-arcane install backend-ts+agile+statusline
+npx claude-code-arcane install backend-typescript+agile+statusline
 ```
 
 ---
@@ -353,7 +355,7 @@ npx claude-code-arcane install backend-ts+agile+statusline
 
 ```bash
 # Start with a profile
-npx claude-code-arcane install backend-ts
+npx claude-code-arcane install backend-typescript
 
 # Later, add testing and security
 npx claude-code-arcane add +testing +security
@@ -372,7 +374,7 @@ npx claude-code-arcane status
 
 # Start over
 npx claude-code-arcane clean --force
-npx claude-code-arcane install backend-ts+agile
+npx claude-code-arcane install backend-typescript+agile
 ```
 
 ---
@@ -385,7 +387,7 @@ Work on multiple features in parallel using git worktrees, each with its own Arc
 
 ```bash
 # Create worktree + install Arcane in one step
-npx claude-code-arcane worktree feat/new-api --profile backend-ts+agile
+npx claude-code-arcane worktree feat/new-api --profile backend-typescript+agile
 
 # Inherits profile from current installation
 npx claude-code-arcane worktree feat/new-api
@@ -410,7 +412,7 @@ When you run `npx claude-code-arcane install` inside a git worktree, Arcane auto
 
 ```bash
 # Manual: share from a specific installation
-npx claude-code-arcane install backend-ts --share-from /path/to/main/worktree
+npx claude-code-arcane install backend-typescript --share-from /path/to/main/worktree
 
 # Disable sharing
 npx claude-code-arcane worktree feat/api --no-share
@@ -433,7 +435,7 @@ npx claude-code-arcane worktree feat/api --no-share
 ```bash
 npx claude-code-arcane status
 # === Arcane Status ===
-#   Profiles:  backend-ts + agile
+#   Profiles:  backend-typescript + agile
 #   Worktree:  yes (main: /path/to/main/checkout)
 #   Shared:    hooks, docs (symlinked)
 #   ...

package/dist/cli.js

@@ -19,6 +19,7 @@ function parseProfile(filePath) {
   const perms = raw.permissions ?? {};
   return {
     name: String(raw.name ?? path.basename(filePath, ".yaml")),
+    ...raw.renamed_to ? { renamed_to: String(raw.renamed_to) } : {},
     description: String(raw.description ?? ""),
     category: String(raw.category ?? "other"),
     skills: raw.skills ?? [],
@@ -58,9 +59,32 @@ function groupByCategory(profiles) {
   }
   return groups.filter((g) => g.profiles.length > 0);
 }
+var PROFILE_RENAMES = {
+  "backend-ts": "backend-typescript",
+  frontend: "frontend-react-vite",
+  mobile: "mobile-react-native",
+  flutter: "mobile-flutter",
+  "ios-native": "mobile-ios-swift",
+  "android-native": "mobile-android-kotlin"
+};
+function canonicalProfileName(name) {
+  return PROFILE_RENAMES[name] ?? name;
+}
+function sameProfile(a, b) {
+  return canonicalProfileName(a) === canonicalProfileName(b);
+}
+function resolveProfile(profilesDir, name) {
+  const canonical = canonicalProfileName(name);
+  const oldNames = Object.keys(PROFILE_RENAMES).filter((o) => PROFILE_RENAMES[o] === canonical);
+  for (const candidate of [canonical, name, ...oldNames]) {
+    const file = path.join(profilesDir, `${candidate}.yaml`);
+    if (fs.existsSync(file)) return { name: candidate, file };
+  }
+  return null;
+}
 function listProfiles(profilesDir) {
   if (!fs.existsSync(profilesDir)) return [];
-  return fs.readdirSync(profilesDir).filter((f) => f.endsWith(".yaml") && f !== "core.yaml").map((f) => parseProfile(path.join(profilesDir, f))).sort((a, b) => a.name.localeCompare(b.name));
+  return fs.readdirSync(profilesDir).filter((f) => f.endsWith(".yaml") && f !== "core.yaml").map((f) => parseProfile(path.join(profilesDir, f))).filter((p3) => !p3.renamed_to).sort((a, b) => a.name.localeCompare(b.name));
 }
 function mergeProfiles(profilesDir, profileNames) {
   const namesToLoad = ["core", ...profileNames];
@@ -80,13 +104,17 @@ function mergeProfiles(profilesDir, profileNames) {
   const hooks = [];
   const outputStyles = [];
   for (const name of namesToLoad) {
-    const filePath = path.join(profilesDir, `${name}.yaml`);
-    if (!fs.existsSync(filePath)) {
+    const resolved = resolveProfile(profilesDir, name);
+    if (!resolved) {
       console.warn(`  WARN: Profile '${name}.yaml' not found, skipping`);
       continue;
     }
-    const profile = parseProfile(filePath);
-    loaded.push(name);
+    if (resolved.name !== name && resolved.name === canonicalProfileName(name)) {
+      console.warn(`  NOTE: Profile '${name}' is now '${resolved.name}'`);
+    }
+    if (loaded.includes(resolved.name)) continue;
+    const profile = parseProfile(resolved.file);
+    loaded.push(resolved.name);
     for (const s of profile.skills) {
       if (!seenSkills.has(s)) {
         seenSkills.add(s);
@@ -178,7 +206,7 @@ function detectStack(dir) {
   }
   const isFlutter = hasFile(dir, "pubspec.yaml");
   if (isFlutter) {
-    out.push({ profile: "flutter", reason: "pubspec.yaml" });
+    out.push({ profile: "mobile-flutter", reason: "pubspec.yaml" });
   }
   if (hasFile(dir, "go.mod")) {
     out.push({ profile: "backend-go", reason: "go.mod" });
@@ -192,13 +220,13 @@ function detectStack(dir) {
       out.push({ profile: "backend-nextjs", reason: "package.json: next" });
     } else if (deps["react-native"] || deps["expo"]) {
       isReactNative = true;
-      out.push({ profile: "mobile", reason: "package.json: react-native/expo" });
+      out.push({ profile: "mobile-react-native", reason: "package.json: react-native/expo" });
     } else if (deps["react"] || deps["vue"] || deps["svelte"]) {
-      out.push({ profile: "frontend", reason: "package.json: react/vue/svelte" });
+      out.push({ profile: "frontend-react-vite", reason: "package.json: react/vue/svelte" });
     } else if (deps["fastify"] || deps["express"] || deps["koa"] || deps["hono"]) {
-      out.push({ profile: "backend-ts", reason: "package.json: server framework" });
+      out.push({ profile: "backend-typescript", reason: "package.json: server framework" });
     } else if (deps["typescript"]) {
-      out.push({ profile: "backend-ts", reason: "package.json: typescript" });
+      out.push({ profile: "backend-typescript", reason: "package.json: typescript" });
     }
   }
   if (!isUnity) {
@@ -209,11 +237,11 @@ function detectStack(dir) {
   }
   if (!isFlutter && !isReactNative) {
     if ((hasFile(dir, "settings.gradle") || hasFile(dir, "settings.gradle.kts")) && hasFile(dir, "app")) {
-      out.push({ profile: "android-native", reason: "settings.gradle + app/" });
+      out.push({ profile: "mobile-android-kotlin", reason: "settings.gradle + app/" });
     }
     const ios = topLevelMatch(dir, ".xcodeproj") ?? topLevelMatch(dir, ".xcworkspace") ?? (hasFile(dir, "Podfile") ? "Podfile" : void 0);
     if (ios) {
-      out.push({ profile: "ios-native", reason: ios });
+      out.push({ profile: "mobile-ios-swift", reason: ios });
     }
   }
   return out;
@@ -259,7 +287,7 @@ async function runInstallWizard(profiles, detections) {
   if (names.length === 0) {
     p.outro(
       chalk.dim(
-        "Nothing selected. Run again, or install directly: npx claude-code-arcane install backend-ts+testing"
+        "Nothing selected. Run again, or install directly: npx claude-code-arcane install backend-typescript+testing"
       )
     );
     return null;
@@ -1747,7 +1775,7 @@ async function installCommand(profileExpr, opts) {
         console.log();
       }
       console.log(
-        chalk2.dim("  Usage: npx claude-code-arcane install backend-ts+agile+testing\n")
+        chalk2.dim("  Usage: npx claude-code-arcane install backend-typescript+agile+testing\n")
       );
       return;
     }
@@ -1859,14 +1887,15 @@ async function addCommand(items = []) {
     process.exit(1);
   }
   if (items.length === 0) {
+    const installedProfiles = manifest.profiles.map(canonicalProfileName);
     if (!(process.stdin.isTTY && process.stdout.isTTY)) {
-      printCatalog(root, manifest.profiles, manifest.installed_skills);
+      printCatalog(root, installedProfiles, manifest.installed_skills);
       return;
     }
     const selected = await runAddWizard({
       profiles: listProfiles(path14.join(root, "profiles")),
       skills: listSkills(path14.join(root, "skills")),
-      installedProfiles: manifest.profiles,
+      installedProfiles,
       installedSkills: manifest.installed_skills
     });
     if (!selected) return;
@@ -1881,13 +1910,14 @@ async function addCommand(items = []) {
   let statuslineAdded = false;
   for (const item of items) {
     if (item.startsWith("+")) {
-      const profileName = item.slice(1);
-      const profilePath = path14.join(root, "profiles", `${profileName}.yaml`);
-      if (!fs12.existsSync(profilePath)) {
-        console.error(chalk3.red(`  Profile '${profileName}' not found`));
+      const requested = item.slice(1);
+      const resolved = resolveProfile(path14.join(root, "profiles"), requested);
+      if (!resolved) {
+        console.error(chalk3.red(`  Profile '${requested}' not found`));
         continue;
       }
-      const profile = parseProfile(profilePath);
+      const profileName = resolved.name;
+      const profile = parseProfile(resolved.file);
       for (const skill of profile.skills) {
         const result = addSkill(root, target, skill, manifest.installed_skills);
         if (result === "added") added.push(skill);
@@ -1935,7 +1965,7 @@ async function addCommand(items = []) {
       if (profile.permissions.allow.length > 0 || profile.permissions.deny.length > 0) {
         mergePermissions(claudeDir, profile.permissions);
       }
-      if (!manifest.profiles.includes(profileName)) {
+      if (!manifest.profiles.some((p3) => sameProfile(p3, profileName))) {
         manifest.profiles.push(profileName);
         manifest.profile_command = manifest.profiles.filter((p3) => p3 !== "core").join("+");
       }
@@ -2175,30 +2205,31 @@ function removeProfile(root, target, profileName, manifest) {
     );
     return { removed: false, skills: [], agents: [] };
   }
-  if (!manifest.profiles.includes(profileName)) {
+  const installedName = manifest.profiles.find((p3) => sameProfile(p3, profileName));
+  if (!installedName) {
     console.warn(
       chalk4.yellow(`  WARNING: Profile '${profileName}' is not installed.`)
     );
     return { removed: false, skills: [], agents: [] };
   }
-  const profilePath = path15.join(root, "profiles", `${profileName}.yaml`);
-  if (!fs13.existsSync(profilePath)) {
+  const resolved = resolveProfile(path15.join(root, "profiles"), installedName);
+  if (!resolved) {
     console.warn(
-      chalk4.yellow(`  WARNING: Profile '${profileName}.yaml' not found.`)
+      chalk4.yellow(`  WARNING: Profile '${installedName}.yaml' not found.`)
     );
     return { removed: false, skills: [], agents: [] };
   }
-  const profile = parseProfile(profilePath);
+  const profile = parseProfile(resolved.file);
   const remainingProfiles = manifest.profiles.filter(
-    (p3) => p3 !== profileName
+    (p3) => p3 !== installedName
   );
   const sharedSkills = /* @__PURE__ */ new Set();
   const sharedAgents = /* @__PURE__ */ new Set();
   const sharedRules = /* @__PURE__ */ new Set();
   for (const rp of remainingProfiles) {
-    const rpPath = path15.join(root, "profiles", `${rp}.yaml`);
-    if (!fs13.existsSync(rpPath)) continue;
-    const rpDef = parseProfile(rpPath);
+    const rpResolved = resolveProfile(path15.join(root, "profiles"), rp);
+    if (!rpResolved) continue;
+    const rpDef = parseProfile(rpResolved.file);
     rpDef.skills.forEach((s) => sharedSkills.add(s));
     rpDef.agents.forEach((a) => sharedAgents.add(a));
     rpDef.rules.universal.forEach((r) => sharedRules.add(r));
@@ -3059,7 +3090,7 @@ async function worktreeCommand(branch, opts) {
   if (!profileExpr) {
     console.error(
       chalk9.red(
-        "No profile specified and no existing installation to inherit from.\nUse --profile to specify one: npx claude-code-arcane worktree feat/api --profile backend-ts+agile"
+        "No profile specified and no existing installation to inherit from.\nUse --profile to specify one: npx claude-code-arcane worktree feat/api --profile backend-typescript+agile"
       )
     );
     process.exit(1);
@@ -3488,7 +3519,7 @@ program.name("arcane").description(
   "Claude Code Arcane \u2014 Skills, agents, hooks and rules for Claude Code"
 ).version(getPackageVersion());
 program.command("install [profile]").description(
-  "Install profiles (e.g., backend-ts+agile). Without args, opens an interactive picker."
+  "Install profiles (e.g., backend-typescript+agile). Without args, opens an interactive picker."
 ).option("-t, --target <dir>", "Target project directory", process.cwd()).option("-n, --dry-run", "Show what would be installed without changing files").option("-f, --force", "Overwrite without backup prompt").option(
   "-s, --share-from <dir>",
   "Share hooks/docs from an existing Arcane installation (e.g., main worktree)"

package/docs/USER-GUIDE.md

@@ -37,7 +37,7 @@ Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/e
 No installation needed — Arcane runs via `npx`:
 
 ```bash
-npx claude-code-arcane install backend-ts+agile
+npx claude-code-arcane install backend-typescript+agile
 ```
 
 That's it. `npx` downloads and runs the latest version automatically.
@@ -49,7 +49,7 @@ That's it. `npx` downloads and runs the latest version automatically.
 cd ~/projects/my-app
 
 # 2. Install a profile
-npx claude-code-arcane install backend-ts+agile
+npx claude-code-arcane install backend-typescript+agile
 
 # 3. Open Claude Code
 claude
@@ -69,10 +69,10 @@ Your project now has skills, agents, hooks, rules, and permissions tailored for
 npx claude-code-arcane install
 
 # Install a specific profile
-npx claude-code-arcane install backend-ts
+npx claude-code-arcane install backend-typescript
 
 # Combine profiles with +
-npx claude-code-arcane install backend-ts+agile+testing
+npx claude-code-arcane install backend-typescript+agile+testing
 
 # Install to a specific directory (default: current dir)
 npx claude-code-arcane install unity-dev --target ~/projects/my-game
@@ -178,7 +178,7 @@ Removes `.claude/` and `.claude.bak/` from the current directory. Requires `--fo
 
 ```bash
 # Create worktree + install Arcane in one step
-npx claude-code-arcane worktree feat/new-api --profile backend-ts+agile
+npx claude-code-arcane worktree feat/new-api --profile backend-typescript+agile
 
 # Inherits profile from current installation
 npx claude-code-arcane worktree feat/new-api
@@ -219,9 +219,9 @@ All profiles are equal — pick any combination that fits your work. They are gr
 
 | Category | Profiles |
 |----------|----------|
-| **Backend** | `backend-ts`, `backend-go`, `backend-dotnet`, `backend-nestjs`, `backend-nextjs` |
-| **Frontend & Design** | `frontend`, `design` |
-| **Mobile** | `mobile`, `flutter`, `android-native`, `ios-native` |
+| **Backend** | `backend-typescript`, `backend-go`, `backend-dotnet`, `backend-nestjs`, `backend-nextjs` |
+| **Frontend & Design** | `frontend-react-vite`, `design` |
+| **Mobile** | `mobile-react-native`, `mobile-flutter`, `mobile-android-kotlin`, `mobile-ios-swift` |
 | **Gamedev** | `unity-dev`, `unity-design`, `unreal-dev`, `visual-novel`, `audio`, `meshy`, `blender` |
 | **Platform & Quality** | `infra`, `database`, `security`, `testing`, `ai` |
 | **Project Management** | `agile`, `jira`, `clickup`, `integrations` |
@@ -229,6 +229,8 @@ All profiles are equal — pick any combination that fits your work. They are gr
 | **Personal** | `second-brain`, `job-hunt`, `freelance` |
 | **Utilities** | `docs`, `self-improving`, `statusline` |
 
+Older names still install and update: `backend-ts`, `frontend`, `mobile`, `flutter`, `ios-native` and `android-native` resolve to `backend-typescript`, `frontend-react-vite`, `mobile-react-native`, `mobile-flutter`, `mobile-ios-swift` and `mobile-android-kotlin`.
+
 ### Core (always included)
 
 Every installation automatically loads `core.yaml` first:
@@ -255,7 +257,7 @@ npx claude-code-arcane install <profile>[+<profile>][+<profile>...]
 
 1. **Always explicit** — there is no "full" or "all" profile. You choose what you need.
 2. **Core is automatic** — the 21 universal skills and all hooks are always included.
-3. **All profiles combine freely** — `unity-dev+unity-design`, `backend-go+frontend`, or `backend-ts+agile+testing`; there is no required "base".
+3. **All profiles combine freely** — `unity-dev+unity-design`, `backend-go+frontend-react-vite`, or `backend-typescript+agile+testing`; there is no required "base".
 4. **Deduplication is automatic** — overlapping skills across profiles are installed once.
 5. **Replace, not merge** — installing a new profile replaces the previous one entirely (with backup).
 
@@ -269,7 +271,7 @@ After the initial install, you can incrementally add or remove skills and profil
 
 ```bash
 # Start with a profile
-npx claude-code-arcane install backend-ts
+npx claude-code-arcane install backend-typescript
 
 # Later, add testing and security
 npx claude-code-arcane add +testing +security
@@ -292,7 +294,7 @@ npx claude-code-arcane remove docker-setup
 
 # Start over completely
 npx claude-code-arcane clean --force
-npx claude-code-arcane install backend-ts+agile
+npx claude-code-arcane install backend-typescript+agile
 ```
 
 ---
@@ -305,7 +307,7 @@ Work on multiple features in parallel using git worktrees, each with its own Arc
 
 ```bash
 # Create worktree + install Arcane in one step
-npx claude-code-arcane worktree feat/new-api --profile backend-ts+agile
+npx claude-code-arcane worktree feat/new-api --profile backend-typescript+agile
 
 # Inherits profile from current installation
 npx claude-code-arcane worktree feat/new-api
@@ -368,25 +370,25 @@ npx claude-code-arcane install unity-dev+unity-design+agile+clickup
 npx claude-code-arcane install backend-go+infra+agile+jira
 
 # Full-stack monorepo
-npx claude-code-arcane install backend-ts+frontend+testing+database
+npx claude-code-arcane install backend-typescript+frontend-react-vite+testing+database
 
 # Mobile app with CI/CD
-npx claude-code-arcane install mobile+agile+clickup+testing
+npx claude-code-arcane install mobile-react-native+agile+clickup+testing
 
 # Secure backend with docs
-npx claude-code-arcane install backend-ts+security+docs+database
+npx claude-code-arcane install backend-typescript+security+docs+database
 
 # AI/ML project with data pipelines
 npx claude-code-arcane install backend-go+ai+infra
 
 # SaaS with full marketing stack
-npx claude-code-arcane install backend-ts+marketing+business+finance
+npx claude-code-arcane install backend-typescript+marketing+business+finance
 
 # Regulated medical device
-npx claude-code-arcane install backend-ts+regulatory+security+testing
+npx claude-code-arcane install backend-typescript+regulatory+security+testing
 
 # With status bar
-npx claude-code-arcane install backend-ts+agile+statusline
+npx claude-code-arcane install backend-typescript+agile+statusline
 ```
 
 ---
@@ -450,8 +452,8 @@ Every installation creates `.claude/arcane-manifest.json`:
 {
   "arcane_version": "1.0.0",
   "cli": "npm",
-  "profile_command": "backend-ts+agile",
-  "profiles": ["core", "backend-ts", "agile"],
+  "profile_command": "backend-typescript+agile",
+  "profiles": ["core", "backend-typescript", "agile"],
   "installed_at": "2026-05-25T15:30:00Z",
   "total_skills": 56,
   "total_rules": 6,
@@ -523,7 +525,7 @@ mv ~/projects/my-game/.claude.bak ~/projects/my-game/.claude
 
 ### Can I combine multiple stack profiles?
 
-Yes. `backend-go+frontend` gives you both Go backend and React frontend skills. Duplicate skills are automatically deduplicated.
+Yes. `backend-go+frontend-react-vite` gives you both Go backend and React frontend skills. Duplicate skills are automatically deduplicated.
 
 ### Does the profile persist between Claude Code sessions?
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-arcane",
-  "version": "2.9.9",
+  "version": "2.10.0",
   "description": "Skills, agents, hooks and rules for Claude Code — installable via npx claude-code-arcane",
   "type": "module",
   "bin": {

package/profiles/ai.yaml

@@ -10,6 +10,9 @@ skills:
   - senior-data-scientist
   - senior-ml-engineer
   - senior-prompt-engineer
+  - agent-designer
+  - agent-workflow-designer
+  - mcp-server-builder
 
 rules:
   universal:

package/profiles/android-native.yaml

@@ -1,4 +1,6 @@
+# Bridge for CLIs released before this profile was renamed: they look it up as 'android-native'. Keep identical to mobile-android-kotlin.yaml.
 name: android-native
+renamed_to: mobile-android-kotlin
 description: "Android native — Kotlin + Jetpack Compose + Material Design 3"
 category: mobile
 

package/profiles/backend-go.yaml

@@ -27,14 +27,6 @@ skills:
   - audit-log
   - slo-sli
   - ci-cd-setup
-  - agent-designer
-  - agent-workflow-designer
-  - email-template-builder
-  - mcp-server-builder
-  - ms365-tenant-manager
-  - snowflake-development
-  - stripe-integration-expert
-  - tech-stack-evaluator
 
 rules:
   universal:

package/profiles/backend-ts.yaml

@@ -1,4 +1,6 @@
+# Bridge for CLIs released before this profile was renamed: they look it up as 'backend-ts'. Keep identical to backend-typescript.yaml.
 name: backend-ts
+renamed_to: backend-typescript
 description: "Backend TypeScript — Fastify, Prisma, Zod, API design, CI"
 category: backend
 
@@ -28,14 +30,6 @@ skills:
   - websocket-realtime-rooms
   - search-setup
   - ci-cd-setup
-  - agent-designer
-  - agent-workflow-designer
-  - email-template-builder
-  - mcp-server-builder
-  - ms365-tenant-manager
-  - snowflake-development
-  - stripe-integration-expert
-  - tech-stack-evaluator
 
 rules:
   universal:

package/profiles/backend-typescript.yaml

@@ -0,0 +1,51 @@
+name: backend-typescript
+description: "Backend TypeScript — Fastify, Prisma, Zod, API design, CI"
+category: backend
+
+skills:
+  - testing
+  - deps-audit
+  - env-sync
+  - observability
+  - scaffold-fastify-ts
+  - database
+  - api-design
+  - api-docs
+  - api-versioning
+  - auth-strategy
+  - jwt-strategy
+  - mfa-setup
+  - oauth-setup
+  - rbac-abac
+  - performance
+  - async-ops
+  - audit-log
+  - monorepo-setup
+  - data-migrations
+  - caching-strategy
+  - webhooks
+  - rate-limiting
+  - websocket-realtime-rooms
+  - search-setup
+  - ci-cd-setup
+
+rules:
+  universal:
+    - backend-code
+    - api-code
+    - migration-code
+  gamedev:
+    []
+
+agents:
+  - engineering
+
+permissions:
+  allow:
+    - "Bash(npm *)"
+    - "Bash(yarn *)"
+    - "Bash(pnpm *)"
+    - "Bash(docker ps*)"
+    - "Bash(docker images*)"
+  deny:
+    []

package/profiles/flutter.yaml

@@ -1,4 +1,6 @@
+# Bridge for CLIs released before this profile was renamed: they look it up as 'flutter'. Keep identical to mobile-flutter.yaml.
 name: flutter
+renamed_to: mobile-flutter
 description: "Flutter + Dart cross-platform development"
 category: mobile
 

package/profiles/frontend-react-vite.yaml

@@ -0,0 +1,39 @@
+name: frontend-react-vite
+description: "Frontend React + Vite + TypeScript"
+category: frontend
+
+skills:
+  - testing
+  - i18n-setup
+  - deps-audit
+  - env-sync
+  - observability
+  - release
+  - onboard
+  - scaffold-react-vite
+  - state-management
+  - form-validation
+  - accessibility
+  - web-security
+  - ci-cd-setup
+  - cdn-setup
+  - file-uploads
+  - frontend-dev
+  - csp-headers
+
+rules:
+  universal:
+    - frontend-code
+  gamedev:
+    []
+
+agents:
+  - engineering
+
+permissions:
+  allow:
+    - "Bash(npm *)"
+    - "Bash(yarn *)"
+    - "Bash(pnpm *)"
+  deny:
+    []

package/profiles/frontend.yaml

@@ -1,4 +1,6 @@
+# Bridge for CLIs released before this profile was renamed: they look it up as 'frontend'. Keep identical to frontend-react-vite.yaml.
 name: frontend
+renamed_to: frontend-react-vite
 description: "Frontend React + Vite + TypeScript"
 category: frontend
 

package/profiles/integrations.yaml

@@ -1,11 +1,16 @@
 name: integrations
-description: "Integraciones externas — GitHub Projects, Slack, Postman"
+description: "Integraciones externas — GitHub Projects, Slack, Postman, Stripe, email templates, Microsoft 365, Snowflake, evaluación de stack"
 category: management
 
 skills:
   - gh-projects
   - slack
   - postman
+  - stripe-integration-expert
+  - email-template-builder
+  - ms365-tenant-manager
+  - snowflake-development
+  - tech-stack-evaluator
 
 rules:
   universal:

package/profiles/ios-native.yaml

@@ -1,4 +1,6 @@
+# Bridge for CLIs released before this profile was renamed: they look it up as 'ios-native'. Keep identical to mobile-ios-swift.yaml.
 name: ios-native
+renamed_to: mobile-ios-swift
 description: "iOS native — Swift + UIKit/SwiftUI + Apple HIG"
 category: mobile
 

package/profiles/mobile-android-kotlin.yaml

@@ -0,0 +1,36 @@
+name: mobile-android-kotlin
+description: "Android native — Kotlin + Jetpack Compose + Material Design 3"
+category: mobile
+
+skills:
+  - testing
+  - deps-audit
+  - env-sync
+  - observability
+  - release
+  - onboard
+  - perf-profile
+  - android-native-dev
+  - state-management
+  - form-validation
+  - accessibility
+  - auth-strategy
+  - ci-cd-setup
+  - deploy-check
+
+rules:
+  universal:
+    []
+  gamedev:
+    []
+
+agents:
+  - engineering
+
+permissions:
+  allow:
+    - "Bash(./gradlew *)"
+    - "Bash(gradle *)"
+    - "Bash(adb *)"
+  deny:
+    []

package/profiles/mobile-flutter.yaml

@@ -0,0 +1,37 @@
+name: mobile-flutter
+description: "Flutter + Dart cross-platform development"
+category: mobile
+
+skills:
+  - testing
+  - i18n-setup
+  - deps-audit
+  - env-sync
+  - observability
+  - release
+  - onboard
+  - perf-profile
+  - flutter-dev
+  - state-management
+  - form-validation
+  - accessibility
+  - auth-strategy
+  - ci-cd-setup
+  - deploy-check
+
+rules:
+  universal:
+    - frontend-code
+  gamedev:
+    []
+
+agents:
+  - engineering
+
+permissions:
+  allow:
+    - "Bash(flutter *)"
+    - "Bash(dart *)"
+    - "Bash(pub *)"
+  deny:
+    []

package/profiles/mobile-ios-swift.yaml

@@ -0,0 +1,37 @@
+name: mobile-ios-swift
+description: "iOS native — Swift + UIKit/SwiftUI + Apple HIG"
+category: mobile
+
+skills:
+  - testing
+  - deps-audit
+  - env-sync
+  - observability
+  - release
+  - onboard
+  - perf-profile
+  - ios-application-dev
+  - state-management
+  - form-validation
+  - accessibility
+  - auth-strategy
+  - ci-cd-setup
+  - deploy-check
+
+rules:
+  universal:
+    []
+  gamedev:
+    []
+
+agents:
+  - engineering
+
+permissions:
+  allow:
+    - "Bash(xcodebuild *)"
+    - "Bash(swift *)"
+    - "Bash(pod *)"
+    - "Bash(xcrun *)"
+  deny:
+    []

package/profiles/mobile-react-native.yaml

@@ -0,0 +1,39 @@
+name: mobile-react-native
+description: "Mobile React Native + Expo + TypeScript"
+category: mobile
+
+skills:
+  - testing
+  - i18n-setup
+  - deps-audit
+  - env-sync
+  - observability
+  - release
+  - onboard
+  - perf-profile
+  - scaffold-react-native
+  - react-native-dev
+  - state-management
+  - form-validation
+  - accessibility
+  - auth-strategy
+  - file-uploads
+  - ci-cd-setup
+  - deploy-check
+
+rules:
+  universal:
+    - frontend-code
+  gamedev:
+    []
+
+agents:
+  - engineering
+
+permissions:
+  allow:
+    - "Bash(npm *)"
+    - "Bash(yarn *)"
+    - "Bash(pnpm *)"
+  deny:
+    []

package/profiles/mobile.yaml

@@ -1,4 +1,6 @@
+# Bridge for CLIs released before this profile was renamed: they look it up as 'mobile'. Keep identical to mobile-react-native.yaml.
 name: mobile
+renamed_to: mobile-react-native
 description: "Mobile React Native + Expo + TypeScript"
 category: mobile
 

package/skills/arcane-add/SKILL.md

@@ -27,7 +27,7 @@ Mismo criterio que el picker de `arcane install`: mostrar solo lo que **no** est
 elegir. No listar los 400 skills.
 
 1. Read `.claude/arcane-manifest.json` (`profiles`, `installed_skills`)
-2. List `profiles/*.yaml` from the source, skip `core.yaml` and the ones already in `profiles`
+2. List `profiles/*.yaml` from the source, skip `core.yaml`, the ones already in `profiles`, and bridge files (those with a `renamed_to` field: an old name kept for older CLIs). An installed old name counts as its `renamed_to` profile
 3. Print the remaining profiles grouped by their `category` field, in the order of
    `CATEGORY_ORDER` (Backend, Frontend & Design, Mobile, Gamedev, Platform & Quality,
    Project Management, Business, Personal, Utilities), each with its description

package/skills/arcane-list/SKILL.md

@@ -15,7 +15,7 @@ List all profiles and skills available in the Arcane source repo, so you can see
 1. Read `.claude/arcane-manifest.json` to find the `source` path (Arcane repo location)
 2. If no manifest, ask the user for the Arcane repo path
 3. From the source repo, list:
-   - **Profiles** from `profiles/*.yaml`, grouped by their `category` field (backend, frontend, mobile, gamedev, platform, management, business, personal, utilities)
+   - **Profiles** from `profiles/*.yaml`, skipping bridge files (those with a `renamed_to` field), grouped by their `category` field (backend, frontend, mobile, gamedev, platform, management, business, personal, utilities)
    - **All skills** in `skills/` directory, grouped by category from SKILL.md frontmatter
 4. Mark skills that are already installed in the current project with `[installed]`
 5. Close with a one-line summary (`COMPLETE — N profiles, M skills, K installed`)
@@ -25,8 +25,8 @@ List all profiles and skills available in the Arcane source repo, so you can see
 ```
 === Available Profiles ===
 Backend:
-  backend-ts     Backend TypeScript — Fastify, Prisma, Zod
-  backend-go     Backend Go — scaffold, DB, auth, API design
+  backend-typescript  Backend TypeScript — Fastify, Prisma, Zod
+  backend-go          Backend Go — scaffold, DB, auth, API design
   ...
 
 Project Management:

package/skills/arcane-status/SKILL.md

@@ -27,7 +27,7 @@ Show what profiles, skills, rules, and agents are installed in the current proje
 
 ```
 === Arcane Status ===
-Profiles:  backend-ts + agile + testing
+Profiles:  backend-typescript + agile + testing
 Installed: 2026-05-01T12:00:00Z
 Source:    /path/to/Claude-Code-Arcane
 

package/skills/freelance-kickoff/SKILL.md

@@ -77,7 +77,7 @@ Después **rutear al trabajo técnico**, que ya existe en el repo:
 | Si el proyecto es | Seguí con |
 |---|---|
 | Historias y tickets | `/create-stories`, `/create-epics` |
-| Backend, frontend, mobile | El perfil técnico que corresponda (`+backend-ts`, `+frontend`, ...) |
+| Backend, frontend, mobile | El perfil técnico que corresponda (`+backend-typescript`, `+frontend-react-vite`, ...) |
 | Algo sin especificar del lado del cliente | `/product-discovery` antes de codear |
 | Documentar lo que ya existe | `/reverse-document` |