claude-code-arcane 2.9.9 → 2.11.0

package/docs/USER-GUIDE.md

@@ -2,7 +2,7 @@
 
 ## What is Arcane?
 
-Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **437 skills**, **115 agents**, **17 hooks**, and **31 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
+Arcane is a configuration harness for [Claude Code](https://docs.anthropic.com/en/docs/claude-code). It provides a curated library of **437 skills**, **115 agents**, **17 hooks**, and **33 rules** that you selectively deploy into any project. Instead of shipping everything to every project (wasting tokens and degrading performance), you pick a **profile** that matches your stack and only the relevant tools get installed.
 
 ## Table of Contents
 
@@ -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/docs/templates/skill-test-spec.md

@@ -15,7 +15,6 @@ Verified automatically by `/skill-test static` — no fixture needed.
 - [ ] Has required frontmatter fields: `name`, `description`, `argument-hint`, `user-invocable`, `allowed-tools`
 - [ ] Has ≥2 phase headings (## Phase N or numbered ## sections)
 - [ ] Contains verdict keywords: [list the ones expected, e.g., PASS, FAIL, CONCERNS]
-- [ ] Contains "May I write" collaborative protocol language (if skill writes files)
 - [ ] Has a next-step handoff at the end
 
 ---

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-arcane",
-  "version": "2.9.9",
+  "version": "2.11.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-dotnet.yaml

@@ -32,6 +32,8 @@ skills:
   - performance
   - async-ops
   - ci-cd-setup
+  - worktree-isolation
+  - worktree-isolation-setup
 
 rules:
   universal:

package/profiles/backend-go.yaml

@@ -27,14 +27,8 @@ 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
+  - worktree-isolation
+  - worktree-isolation-setup
 
 rules:
   universal:

package/profiles/backend-nestjs.yaml

@@ -32,6 +32,8 @@ skills:
   - performance
   - async-ops
   - ci-cd-setup
+  - worktree-isolation
+  - worktree-isolation-setup
 
 rules:
   universal:

package/profiles/backend-nextjs.yaml

@@ -30,6 +30,8 @@ skills:
   - observability
   - ci-cd-setup
   - cdn-setup
+  - worktree-isolation
+  - worktree-isolation-setup
 
 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,8 @@ 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
+  - worktree-isolation
+  - worktree-isolation-setup
 
 rules:
   universal:

package/profiles/backend-typescript.yaml

@@ -0,0 +1,53 @@
+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
+  - worktree-isolation
+  - worktree-isolation-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/blender.yaml

@@ -17,6 +17,7 @@ skills:
 rules:
   universal:
     - blender-pipeline
+    - blender-files
   gamedev:
     []
 

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/infra.yaml

@@ -27,6 +27,8 @@ skills:
   - incident-commander
   - incident-response
   - git-worktree-manager
+  - worktree-isolation
+  - worktree-isolation-setup
 
 rules:
   universal:

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/meshy.yaml

@@ -15,6 +15,7 @@ skills:
 rules:
   universal:
     - meshy-assets
+    - meshy-files
   gamedev:
     []
 

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/rules/blender-files.md

@@ -0,0 +1,72 @@
+---
+paths:
+  - "**/*.blend"
+  - "**/*.fbx"
+  - "**/*.glb"
+  - "**/*.gltf"
+---
+
+# Blender Files
+
+Como tiene que salir un asset de Blender hacia un engine o la web. Como operar Blender sin romper nada esta en `.claude/rules/blender-pipeline.md`, que se carga siempre.
+
+## Ejes, escala y unidades
+
+Verificar una vez por proyecto, anotarlo, no volver a pensarlo.
+
+| Destino | Convencion | Al exportar desde Blender |
+|---|---|---|
+| Blender | Z-up, right-handed, 1 unidad = 1 m | — |
+| glTF / GLB | Y-up, metros | El exporter convierte solo (`+Y up`) |
+| Unity | Y-up, left-handed, 1 unidad = 1 m | glTF sale derecho; en FBX revisar el eje |
+| UE5 | Z-up, left-handed, 1 unidad = 1 cm | Factor 100 |
+
+Reglas duras:
+
+- **Aplicar escala antes de exportar** (`Object → Apply → Scale`). Un objeto que sale con `scale`
+  distinto de 1 arrastra el problema al engine y rompe la fisica y el skinning.
+- Origen al piso para props y personajes; al centro para objetos que rotan sobre si mismos.
+- Un nodo con escala `100` o `0.01` en el archivo exportado es una conversion de unidades sin
+  aplicar, no una decision de diseno. Se corrige, no se documenta.
+
+## Topologia
+
+- **Quads en todo lo que deforma.** Tris solo en geometria estatica. N-gons en nada que deforme.
+- Edge loops en articulaciones, poles de 5 aristas o menos.
+- Presupuesto de triangulos declarado **antes** de modelar, no medido despues.
+- Un LOD generado con Decimate es un borrador. Para heroes va retopo a mano.
+
+## Materiales y texturas
+
+- **Principled BSDF y nada mas** en lo que se exporta. Los nodos procedurales no sobreviven a
+  glTF ni a FBX: si el look depende de ellos, hay que bakearlo a textura.
+- Color space: Base Color en sRGB; Normal, Roughness, Metallic y AO en **Non-Color**. Es el bug
+  mas comun y el mas silencioso.
+- Normal maps: Blender, glTF y Unity usan OpenGL (+Y). **UE5 usa DirectX (-Y)**: hay que invertir
+  el canal verde o marcarlo en el import.
+- Resoluciones potencia de dos. Texel density consistente entre assets del mismo set.
+- Cantidad de materiales = draw calls. Atlas antes de sumar materiales.
+
+## Animacion
+
+- **Los constraints no se exportan, los keyframes si.** Todo rig con IK, drivers o constraints se
+  bakea (`nla.bake` con visual keying) antes de exportar.
+- Frame rate del `.blend` igual al del engine. Un mismatch se ve como animacion lenta o acelerada,
+  no como error.
+- Huesos con sufijo `.L` / `.R` para que la simetria funcione.
+- Root motion: hueso raiz en el origen. Decidir in-place vs root motion **antes** de animar.
+
+## Git
+
+- `*.blend *.fbx *.glb *.gltf` por **Git LFS**. Verificar `git lfs version` antes de agregar las
+  entradas: peor que no tenerlas es tenerlas sin LFS instalado.
+- `*.blend1` y `*.blend2` (backups de Blender) van al `.gitignore`, nunca al repo.
+- Las texturas fuente (`.psd`, `.kra`, `.exr` de bake) por LFS; los `.png` finales tambien.
+
+## Integracion con el resto del stack
+
+`asset-spec` define que asset hace falta → Meshy o modelado a mano lo produce → **Blender lo
+limpia y lo exporta** → `asset-audit` valida el resultado en el proyecto.
+
+Blender es el paso del medio, no el principio ni el final. Si el asset vino de `meshy-derive`, el
+`.blend` que bajo es el punto de entrada; no se regenera desde Meshy para arreglar topologia.