claude-code-arcane 2.9.9 → 2.11.0

package/CHANGELOG.md

@@ -1,3 +1,32 @@
+# [2.11.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.10.0...v2.11.0) (2026-10-11)
+
+
+### Bug Fixes
+
+* **global:** refuse to rewrite a malformed settings.json ([fa1a15b](https://github.com/SebastianLuser/claude-code-arcane/commit/fa1a15be969fe56fd865319df30b4e3bd985285e))
+* **rules:** align the narrative dialogue limit with the VN rule at 200 ([3cc5f60](https://github.com/SebastianLuser/claude-code-arcane/commit/3cc5f60b0836c6a817018ca8af3b9ebf981499dc))
+* **skill-test:** drop the ask-before-write static check ([28e504f](https://github.com/SebastianLuser/claude-code-arcane/commit/28e504f29ab2114d8f27f732d3fd148ccd3dc2be))
+* **skills:** complete the skill catalog and the frontmatter it relies on ([5665fdf](https://github.com/SebastianLuser/claude-code-arcane/commit/5665fdfd60766ce663c26060d8f042d873f12ac1))
+* **skills:** make the five-bullet limit a guide that never drops a critical finding ([466bf55](https://github.com/SebastianLuser/claude-code-arcane/commit/466bf554d862d55350c0d1cfb86caea4520779e6))
+* **worktree:** ship the isolation skills with the profiles that run Docker ([f0a1589](https://github.com/SebastianLuser/claude-code-arcane/commit/f0a15894c6c064088c1fe55150f7145e04f5848a))
+
+
+### Features
+
+* **skills:** give the ten evaluator skills that lacked one a verdict ([26e9682](https://github.com/SebastianLuser/claude-code-arcane/commit/26e968235dbaf4babd7c93aa15c348639f7e6b8d))
+
+# [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

@@ -1,6 +1,6 @@
 # Claude Code Arcane
 
-> **437 skills, 115 agents, 17 hooks and 31 rules for Claude Code — selective deploy by profile.**
+> **437 skills, 115 agents, 17 hooks and 33 rules for Claude Code — selective deploy by profile.**
 
 A configuration harness installable via `npx`. Pick a **profile** that matches your stack and only the relevant tools get installed into your project's `.claude/` directory.
 
@@ -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,62 +184,64 @@ 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-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 |
+| `backend-typescript` | Backend TypeScript — Fastify, Prisma, Zod, API design | 27 | engineering |
+| `backend-go` | Backend Go — Clean Arch, DB, auth, API, CI | 26 | engineering |
+| `backend-dotnet` | Backend .NET — ASP.NET Core, Vertical Slice/Clean, EF Core, JWT | 27 | engineering |
+| `backend-nestjs` | Backend NestJS — feature modules, DI, Prisma, JWT, microservices | 27 | engineering |
+| `backend-nextjs` | Next.js full-stack — App Router, RSC, Server Actions, SEO, AI SDK | 24 | engineering |
 
 ### Frontend & Design
 
 | 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 | 26 | 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)
 #   ...
@@ -459,7 +461,7 @@ claude-code-arcane/
 ├── profiles/                  # 38 profiles (YAML)
 ├── agents/                    # 17 dirs, 109 agents (Markdown)
 ├── hooks/                     # 17 lifecycle hooks (Bash)
-├── rules/                     # 31 rules (Markdown)
+├── rules/                     # 33 rules (Markdown)
 ├── templates/                 # Gamedev templates
 ├── docs/                      # Documentation
 └── skills-selftest/           # QA framework

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);
@@ -3174,12 +3205,27 @@ async function globalCommand(opts) {
     showStatus();
     return;
   }
+  if (!settingsParseable()) {
+    console.error(
+      chalk10.red(`  Refusing to modify malformed ${SETTINGS_PATH}. Fix it and re-run.`)
+    );
+    process.exit(1);
+  }
   if (opts.remove) {
     removeGlobal();
     return;
   }
   installGlobal();
 }
+function settingsParseable() {
+  if (!fs17.existsSync(SETTINGS_PATH)) return true;
+  try {
+    JSON.parse(fs17.readFileSync(SETTINGS_PATH, "utf-8"));
+    return true;
+  } catch {
+    return false;
+  }
+}
 function showStatus() {
   console.log(chalk10.bold("\n=== Arcane Global Status ===\n"));
   const hasScripts = fs17.existsSync(
@@ -3488,7 +3534,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/SKILLS-CATALOG.md

@@ -2,7 +2,7 @@
 
 Los 437 skills disponibles para proyectos consumidores, organizados por division.
 
-La tabla cubre 395: hay 42 skills instalables que todavia no estan catalogados aca. Un test de CI (`src/__tests__/doc-counts.test.ts`) verifica que estos numeros coincidan con el filesystem y que el header de cada seccion coincida con sus filas.
+La tabla cubre 397: hay 40 skills instalables que todavia no estan catalogados aca. Un test de CI (`src/__tests__/doc-counts.test.ts`) verifica que estos numeros coincidan con el filesystem y que el header de cada seccion coincida con sus filas.
 
 ## Como ejecutar un skill
 
@@ -376,7 +376,7 @@ Instalables con el perfil `unreal-dev`. Procedencia y licencias en `ATTRIBUTION.
 
 ---
 
-## DevOps (6 skills)
+## DevOps (8 skills)
 
 | Skill | Descripcion | Uso |
 |-------|-------------|-----|
@@ -386,6 +386,8 @@ Instalables con el perfil `unreal-dev`. Procedencia y licencias en `ATTRIBUTION.
 | `/helm-chart-builder` | Build production-grade Helm charts: scaffolding, values design, template patterns, dependency management, and security hardening | `[scaffold\|lint\|test]` |
 | `/incident-commander` | Manage technology incidents end-to-end: severity classification, timeline reconstruction, stakeholder communication, and RCA | `[classify\|timeline\|communicate]` |
 | `/incident-response` | Classify and triage security incidents through the full NIST SP 800-61 lifecycle: SEV1-4 scoring and forensic evidence collection | `[classify\|triage\|forensics]` |
+| `/worktree-isolation` | Regenera o muestra los puertos de Docker de este worktree para que varios worktrees corran en paralelo sin chocar | `[apply\|status]` |
+| `/worktree-isolation-setup` | Prepara el repo una vez: parametriza puertos y container_name del docker-compose, `.gitignore`, CLAUDE.md y el hook global | |
 
 ---