claude-code-arcane 2.9.8 → 2.10.0

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+# [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)
+
+
+### Bug Fixes
+
+* **content:** remove stale facts and dated prompting found by a prompt audit ([f6d0cf0](https://github.com/SebastianLuser/claude-code-arcane/commit/f6d0cf0abef40682a5ea7b5546c740787267c2bb))
+* **rules:** install the LLM rule with backend-go as llm-code ([8fbac31](https://github.com/SebastianLuser/claude-code-arcane/commit/8fbac317376dd0243878db501ce996df705e3478))
+* **skills:** price current Claude models in the cost estimators ([352e062](https://github.com/SebastianLuser/claude-code-arcane/commit/352e0623123de5833e6734fa785e71c06c004429))
+* **skills:** reach playwright-pro and self-improving-agent sub-skills through their parent ([4cc9dff](https://github.com/SebastianLuser/claude-code-arcane/commit/4cc9dffe71c406d1e12ccdb041587b3607a301b2))
+* **skills:** read the engine from the project in the last four skills ([120c8eb](https://github.com/SebastianLuser/claude-code-arcane/commit/120c8eb0ddee200acea6e2f29b0f04e3118b6b5a))
+* **skills:** route the remaining skills to skills and files that exist ([eb2eea0](https://github.com/SebastianLuser/claude-code-arcane/commit/eb2eea0eed4e1ba8964a1944548cb9ae9b386a4e))
+* **skills:** stop pricing and advising prompts from 2023 in the prompt tools ([429247d](https://github.com/SebastianLuser/claude-code-arcane/commit/429247db70689e3df86fc1bfdf7b78cab3e10195))
+* **update:** keep .claude/docs/ current like the other installed content ([f753c03](https://github.com/SebastianLuser/claude-code-arcane/commit/f753c030b73c89d5f3d035f0460954ba8d8c69a4))
+
 ## [2.9.8](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.9.7...v2.9.8) (2026-09-09)
 
 

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/agents/business/business-ops-lead.md

@@ -32,20 +32,7 @@ Sos el **Business Operations Lead**. Tu rol: que el motor comercial funcione —
 
 ## Customer Health Score
 
-```
-Health Score = weighted average of:
-  Product Usage (30%):    DAU/MAU, feature adoption, depth
-  Support (20%):          Ticket volume, CSAT, escalations
-  Engagement (20%):       NPS, exec sponsor active, QBR attendance
-  Financial (15%):        Payment on time, expansion signals
-  Relationship (15%):     Champion changes, stakeholder map
-  
-Tiers:
-  90-100: Healthy (green)  → Expansion candidate
-  70-89:  Monitor (yellow) → Proactive outreach
-  50-69:  At Risk (orange) → Success plan
-  <50:    Critical (red)   → Executive intervention
-```
+Calculate it with `health_score_calculator.py` from the `customer-success-manager` skill: its dimensions, weights and segment thresholds are the ones in use. Do not compute it by hand.
 
 ## Protocolo
 

package/agents/game/gameplay-programmer.md

@@ -69,10 +69,9 @@ arrive. Decide, act, and make your reasoning auditable in the report.
 ### Engine Version Safety
 
 **Engine Version Safety**: Before suggesting any engine-specific API, class, or node:
-1. Check `docs/engine-reference/[engine]/VERSION.md` for the project's pinned engine version
-2. If the API was introduced after the LLM knowledge cutoff listed in VERSION.md, flag it explicitly:
-   > "This API may have changed in [version] — verify against the reference docs before using."
-3. Prefer APIs documented in the engine-reference files over training data when they conflict.
+1. Read the engine version from the project: `ProjectSettings/ProjectVersion.txt` (Unity) or `EngineAssociation` in the `.uproject` (Unreal)
+2. If the API may have changed in that version, flag it explicitly:
+   > "This API may have changed in [version] — verify against the engine docs before using."
 
 **ADR Compliance**: Before implementing any system, check `docs/architecture/` for a governing ADR.
 If an ADR exists for this system:

package/agents/game/technical-artist.md

@@ -68,10 +68,9 @@ arrive. Decide, act, and make your reasoning auditable in the report.
 ### Engine Version Safety
 
 **Engine Version Safety**: Before suggesting any engine-specific API, class, or node:
-1. Check `docs/engine-reference/[engine]/VERSION.md` for the project's pinned engine version
-2. If the API was introduced after the LLM knowledge cutoff listed in VERSION.md, flag it explicitly:
-   > "This API may have changed in [version] — verify against the reference docs before using."
-3. Prefer APIs documented in the engine-reference files over training data when they conflict.
+1. Read the engine version from the project: `ProjectSettings/ProjectVersion.txt` (Unity) or `EngineAssociation` in the `.uproject` (Unreal)
+2. If the API may have changed in that version, flag it explicitly:
+   > "This API may have changed in [version] — verify against the engine docs before using."
 
 ### Performance Budgets
 

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;
@@ -751,7 +779,8 @@ function computeContentHashes(claudeDir) {
     skills: {},
     rules: {},
     agents: {},
-    hooks: {}
+    hooks: {},
+    docs: {}
   };
   const skillsDir = path7.join(claudeDir, "skills");
   if (fs6.existsSync(skillsDir)) {
@@ -790,6 +819,8 @@ function computeContentHashes(claudeDir) {
       }
     }
   }
+  const docsDir = path7.join(claudeDir, "docs");
+  if (fs6.existsSync(docsDir)) hashes.docs = hashDirectory(docsDir);
   return hashes;
 }
 function computeSourceHashes(packageRoot, skills, rules, agents) {
@@ -797,7 +828,8 @@ function computeSourceHashes(packageRoot, skills, rules, agents) {
     skills: {},
     rules: {},
     agents: {},
-    hooks: {}
+    hooks: {},
+    docs: {}
   };
   for (const skill of skills) {
     const skillDir = path7.join(packageRoot, "skills", skill);
@@ -836,6 +868,8 @@ function computeSourceHashes(packageRoot, skills, rules, agents) {
       }
     }
   }
+  const docsDir = path7.join(packageRoot, "docs");
+  if (fs6.existsSync(docsDir)) hashes.docs = hashDirectory(docsDir);
   return hashes;
 }
 
@@ -1741,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;
     }
@@ -1853,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;
@@ -1875,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);
@@ -1929,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("+");
       }
@@ -2169,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));
@@ -2547,6 +2584,10 @@ Update available: ${chalk7.red(installedVersion)} -> ${chalk7.green(currentVersi
   const sourceHashes = computeSourceHashes(root, merged.skills, allRules, merged.agents);
   const claudeDir = path17.join(target, ".claude");
   const installedHashes = computeContentHashes(claudeDir);
+  if (isSymlink(path17.join(claudeDir, "docs"))) {
+    sourceHashes.docs = {};
+    installedHashes.docs = {};
+  }
   const unhashed = earlySync;
   const items = computeUpdatePlan(
     manifest.content_hashes ?? null,
@@ -2649,10 +2690,21 @@ function printGeneralSummary(results, isDryRun) {
 ${prefix}Done. ${results.length} installation${results.length === 1 ? "" : "s"} processed:`));
   console.log(`  ${chalk7.green(updated)} ${isDryRun ? "would change" : "updated"}, ${chalk7.dim(unchanged + " unchanged")}`);
 }
+var RETIRED_DOCS = /* @__PURE__ */ new Set([
+  "RELEASE-SETUP.md",
+  "trusted-publishing-setup.md",
+  "presentations/arcane-overview.pptx",
+  "presentations/arcane-overview-12.pptx",
+  "presentations/build_arcane_deck.py",
+  "presentations/build_arcane_deck_12.py"
+]);
 function makeOwnershipCheck(manifest) {
   const hashes = manifest.content_hashes;
   if (hashes) {
-    return (type, name) => name in (hashes[type] ?? {});
+    return (type, name) => {
+      if (type === "docs" && !hashes.docs) return RETIRED_DOCS.has(name);
+      return name in (hashes[type] ?? {});
+    };
   }
   const skills = new Set(manifest.installed_skills ?? []);
   const rules = new Set(
@@ -2671,6 +2723,8 @@ function makeOwnershipCheck(manifest) {
         return agents.has(name);
       case "hooks":
         return true;
+      case "docs":
+        return RETIRED_DOCS.has(name);
     }
   };
 }
@@ -2689,7 +2743,8 @@ function hashesToRecord(fresh, previous, items, force) {
     skills: { ...fresh.skills },
     rules: { ...fresh.rules },
     agents: { ...fresh.agents },
-    hooks: { ...fresh.hooks }
+    hooks: { ...fresh.hooks },
+    docs: { ...fresh.docs }
   };
   for (const item of items) {
     const bucket = `${item.type}s`;
@@ -2706,8 +2761,8 @@ function hashesToRecord(fresh, previous, items, force) {
 }
 function computeUpdatePlan(manifestHashes, installedHashes, sourceHashes, owned, exemptAgentDivisions = /* @__PURE__ */ new Set()) {
   const items = [];
-  for (const contentType of ["skills", "rules", "agents", "hooks"]) {
-    const itemType = contentType === "skills" ? "skill" : contentType === "rules" ? "rule" : contentType === "agents" ? "agent" : "hook";
+  for (const contentType of ["skills", "rules", "agents", "hooks", "docs"]) {
+    const itemType = contentType === "skills" ? "skill" : contentType === "rules" ? "rule" : contentType === "agents" ? "agent" : contentType === "hooks" ? "hook" : "doc";
     const manifest = manifestHashes?.[contentType] ?? {};
     const installed = installedHashes[contentType];
     const source = sourceHashes[contentType];
@@ -2942,6 +2997,8 @@ function getSourcePath(item, root) {
       return path17.join(root, "agents", item.name);
     case "hook":
       return path17.join(root, "hooks", item.name);
+    case "doc":
+      return path17.join(root, "docs", item.name);
     default:
       return null;
   }
@@ -2956,6 +3013,15 @@ function getInstalledPath(item, claudeDir) {
       return path17.join(claudeDir, "agents", item.name);
     case "hook":
       return path17.join(claudeDir, "hooks", item.name);
+    case "doc":
+      return path17.join(claudeDir, "docs", item.name);
+  }
+}
+function isSymlink(p3) {
+  try {
+    return fs15.lstatSync(p3).isSymbolicLink();
+  } catch {
+    return false;
   }
 }
 
@@ -3024,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);
@@ -3453,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)"