claude-code-arcane 2.9.7 → 2.9.9

package/CHANGELOG.md

@@ -1,3 +1,24 @@
+## [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)
+
+
+### Bug Fixes
+
+* **statusline:** point the global install at the script it owns ([1a8aada](https://github.com/SebastianLuser/claude-code-arcane/commit/1a8aada612e7f2bad2d60450306c0d51887f6b65))
+
 ## [2.9.7](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.9.6...v2.9.7) (2026-09-08)
 
 

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

@@ -397,6 +397,14 @@ import os from "os";
 function arcaneHome() {
   return process.env.ARCANE_HOME ?? path3.join(os.homedir(), ".arcane");
 }
+var RELATIVE_STATUSLINE_COMMAND = "bash .claude/statusline.sh";
+function statuslineCommand(target) {
+  if (path3.resolve(target) !== path3.resolve(os.homedir())) {
+    return RELATIVE_STATUSLINE_COMMAND;
+  }
+  const script = path3.join(target, ".claude", "statusline.sh").replace(/\\/g, "/");
+  return `bash "${script}"`;
+}
 function getPackageRoot() {
   const thisFile = fileURLToPath(import.meta.url);
   return path3.resolve(path3.dirname(thisFile), "..");
@@ -743,7 +751,8 @@ function computeContentHashes(claudeDir) {
     skills: {},
     rules: {},
     agents: {},
-    hooks: {}
+    hooks: {},
+    docs: {}
   };
   const skillsDir = path7.join(claudeDir, "skills");
   if (fs6.existsSync(skillsDir)) {
@@ -782,6 +791,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) {
@@ -789,7 +800,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);
@@ -828,6 +840,8 @@ function computeSourceHashes(packageRoot, skills, rules, agents) {
       }
     }
   }
+  const docsDir = path7.join(packageRoot, "docs");
+  if (fs6.existsSync(docsDir)) hashes.docs = hashDirectory(docsDir);
   return hashes;
 }
 
@@ -1243,7 +1257,7 @@ var Installer = class {
     if (this.hasStatusline) {
       settings.statusLine = {
         type: "command",
-        command: "bash .claude/statusline.sh"
+        command: statuslineCommand(this.target)
       };
     }
     const activeStyle = this.merged.output_styles[0];
@@ -1926,7 +1940,7 @@ async function addCommand(items = []) {
         manifest.profile_command = manifest.profiles.filter((p3) => p3 !== "core").join("+");
       }
       if (statuslineAdded) {
-        addStatuslineToSettings(claudeDir);
+        addStatuslineToSettings(target, claudeDir);
       }
     } else {
       const result = addSkill(root, target, item, manifest.installed_skills);
@@ -2046,14 +2060,14 @@ function mergePermissions(claudeDir, newPerms) {
   settings.permissions = perms;
   writeJsonSync(settingsPath, settings);
 }
-function addStatuslineToSettings(claudeDir) {
+function addStatuslineToSettings(target, claudeDir) {
   const settingsPath = path14.join(claudeDir, "settings.json");
   if (!fs12.existsSync(settingsPath)) return;
   const settings = readJsonSync(settingsPath);
   if (settings.statusLine) return;
   settings.statusLine = {
     type: "command",
-    command: "bash .claude/statusline.sh"
+    command: statuslineCommand(target)
   };
   writeJsonSync(settingsPath, settings);
 }
@@ -2539,6 +2553,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,
@@ -2641,10 +2659,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(
@@ -2663,6 +2692,8 @@ function makeOwnershipCheck(manifest) {
         return agents.has(name);
       case "hooks":
         return true;
+      case "docs":
+        return RETIRED_DOCS.has(name);
     }
   };
 }
@@ -2681,7 +2712,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`;
@@ -2698,8 +2730,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];
@@ -2867,22 +2899,29 @@ function syncUnhashedFiles(root, claudeDir, merged, dryRun) {
     fs15.mkdirSync(path17.dirname(t.dst), { recursive: true });
     fs15.copyFileSync(t.src, t.dst);
   }
-  const activeStyle = merged.output_styles[0];
-  if (activeStyle) {
-    const settingsPath = path17.join(claudeDir, "settings.json");
-    if (fs15.existsSync(settingsPath)) {
-      try {
-        const settings = JSON.parse(fs15.readFileSync(settingsPath, "utf-8"));
-        if (settings.outputStyle !== activeStyle) {
-          changed.push(`settings.json (outputStyle: ${activeStyle})`);
-          if (!dryRun) {
-            settings.outputStyle = activeStyle;
-            fs15.writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}
+  const settingsPath = path17.join(claudeDir, "settings.json");
+  if (fs15.existsSync(settingsPath)) {
+    try {
+      const settings = JSON.parse(fs15.readFileSync(settingsPath, "utf-8"));
+      let dirty = false;
+      const activeStyle = merged.output_styles[0];
+      if (activeStyle && settings.outputStyle !== activeStyle) {
+        changed.push(`settings.json (outputStyle: ${activeStyle})`);
+        settings.outputStyle = activeStyle;
+        dirty = true;
+      }
+      const wanted = statuslineCommand(path17.dirname(claudeDir));
+      const current = settings.statusLine;
+      if (wanted !== RELATIVE_STATUSLINE_COMMAND && current && current.command !== wanted) {
+        changed.push("settings.json (statusLine path)");
+        settings.statusLine = { ...current, command: wanted };
+        dirty = true;
+      }
+      if (dirty && !dryRun) {
+        fs15.writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}
 `, "utf-8");
-          }
-        }
-      } catch {
       }
+    } catch {
     }
   }
   return changed;
@@ -2927,6 +2966,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;
   }
@@ -2941,6 +2982,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;
   }
 }
 

package/docs/USER-GUIDE.md

@@ -414,7 +414,7 @@ La lista `agents:` de un profile acepta dos formas:
 
 ```yaml
 agents:
-  - game                        # la división entera: 30 agentes
+  - game                        # la división entera: 32 agentes
   - quality/security-architect  # solo ese agente
 ```
 

package/docs/coordination-rules.md

@@ -49,7 +49,7 @@ Cuando un agente es invocado como "gate" (approval gate), debe empezar la respue
 
 Luego el rationale. El token en la primera línea permite que el skill orquestador lo parsee.
 
-**Escalation:** Cuando múltiples gates corren en paralelo, aplica el verdict más estricto — un REJECT override cualquier APPROVE. Ver `director-gates.md` para gates definidos.
+**Escalation:** Cuando múltiples gates corren en paralelo, aplica el verdict más estricto — un REJECT override cualquier APPROVE.
 
 ## Regla #6 — Cross-Division Collaboration
 

package/docs/directory-structure.md

@@ -1,31 +1,40 @@
 # Estructura de Directorios
 
+Hay dos layouts distintos y conviene no mezclarlos:
+
+- **El repo** (`claude-code-arcane/`): la fuente. Acá se edita el contenido y el instalador.
+- **Un proyecto instalado** (`<proyecto>/.claude/`): lo que `npx claude-code-arcane install <profile>` copia. Solo llega lo que algún profile lista.
+
+## El repo
+
 ```
-Claude-Code-Arcane/
-├── CLAUDE.md                          # Configuración maestra
-├── README.md                          # Documentación del repo
-├── pyproject.toml                     # Python package config
+claude-code-arcane/
+├── CLAUDE.md                          # Guía para trabajar en este repo
+├── README.md                          # Documentación pública
+├── CHANGELOG.md                       # Generado por semantic-release, no se edita a mano
+├── ATTRIBUTION.md                     # Origen del contenido adaptado de terceros
 ├── LICENSE
-├── .gitignore
+├── package.json                       # CLI npm: build (tsup), test (vitest), test:skills (Python)
+├── tsconfig.json
+├── vitest.config.ts                   # Aísla ARCANE_SOURCE y ARCANE_HOME para la suite
+├── .releaserc.json                    # semantic-release
+│
+├── src/                               # Instalador TypeScript (único código con build y typecheck)
+│   ├── cli.ts                         # Entry point: arcane install/add/remove/update/...
+│   ├── commands/                      # Un archivo por subcomando
+│   ├── installer.ts                   # Copia contenido a .claude/ y genera settings.json
+│   ├── profiles.ts                    # Parser y merge de profiles/*.yaml
+│   ├── agent-entries.ts               # Entradas de agentes: división entera o agente suelto
+│   ├── content-source.ts, cache.ts    # Fuente del contenido: bundled / github / cache
+│   ├── manifest.ts, content-hash.ts   # arcane-manifest.json y hashes para update
+│   ├── registry.ts                    # ~/.arcane/installations.json
+│   ├── worktree.ts                    # Instalación en git worktrees
+│   ├── wizard.ts, detect.ts           # Wizard interactivo y auto-detección de stack
+│   └── __tests__/                     # Suite vitest, incluidos los invariantes de docs
 │
-├── arcane/                            # Python CLI (installer, profiles parser)
-│   ├── cli.py                         # Entry point: arcane install/list/clean
-│   ├── installer.py                   # Profile installer logic
-│   └── profiles.py                    # Profile parser & merger
+├── profiles/                          # Profiles declarativos (.yaml); core.yaml siempre se carga
 │
-├── profiles/                          # 27 profile definitions (.profile)
-│   ├── core.profile                   # Always included (21 skills, hooks, rules)
-│   ├── backend-go.profile             # Base: Go backend
-│   ├── backend-ts.profile             # Base: TypeScript backend
-│   ├── frontend.profile               # Base: React frontend
-│   ├── unity-dev.profile              # Base: Unity programmer
-│   ├── ai.profile                     # Add-on: AI/ML
-│   ├── clevel.profile                 # Add-on: C-suite advisory
-│   ├── business.profile               # Add-on: Business ops
-│   ├── marketing.profile              # Add-on: Marketing
-│   ├── finance.profile                # Add-on: Finance
-│   ├── regulatory.profile             # Add-on: Regulatory & compliance
-│   └── ...                            # agile, testing, infra, security, etc.
+├── skills/                            # Un directorio por skill: SKILL.md + references/ + scripts/
 │
 ├── agents/                            # 115 agent definitions (root level)
 │   ├── ai/                            # 4 agents
@@ -46,116 +55,78 @@ Claude-Code-Arcane/
 │   ├── regulatory/                    # 3 agents
 │   └── visualnovel/                   # 6 agents
 │
-├── .claude/                           # Claude Code configuration
-│   ├── settings.json                  # Hooks, permissions, safety
-│   ├── settings.local.json            # User-specific overrides (gitignored)
-│   ├── statusline.sh                  # Status line bash script
-│   ├── setup-skill-junctions.bat      # Windows: create skill junctions
-│   ├── remove-skill-junctions.bat     # Windows: remove skill junctions
-│   │
-│   ├── skills-agile/                  # 35 agile/PM skills
-│   ├── skills-ai/                     # 7 AI/ML skills
-│   ├── skills-arcane/                 # 7 Arcane self-management skills
-│   ├── skills-backend/                # 45 backend skills
-│   ├── skills-business/               # 4 business skills
-│   ├── skills-clevel-advisors/        # 10 C-suite advisor skills
-│   ├── skills-clevel-operations/      # 18 C-suite operations skills
-│   ├── skills-design/                 # 9 design skills
-│   ├── skills-devops/                 # 17 DevOps/infra skills
-│   ├── skills-docs/                   # 13 documentation skills
-│   ├── skills-finance/                # 3 finance skills
-│   ├── skills-frontend/               # 9 frontend skills
-│   ├── skills-gamedev/                # 19 gamedev skills + _rules/ + _templates/
-│   ├── skills-git/                    # 21 git workflow skills
-│   ├── skills-integrations/           # 3 integration skills
-│   ├── skills-marketing-content/      # 8 content marketing skills
-│   ├── skills-marketing-growth/       # 10 growth marketing skills
-│   ├── skills-marketing-seo/          # 11 SEO/CRO skills
-│   ├── skills-marketing-strategy/     # 15 marketing strategy skills
-│   ├── skills-mobile/                 # 5 mobile skills
-│   ├── skills-regulatory/             # 13 regulatory/compliance skills
-│   ├── skills-release/                # 5 release skills
-│   ├── skills-security/               # 9 security skills
-│   ├── skills-testing/                # 13 testing skills
-│   │
-│   ├── hooks/                         # 14 lifecycle hooks
-│   │   ├── session-start.sh
-│   │   ├── session-stop.sh
-│   │   ├── detect-division.sh
-│   │   ├── detect-gaps.sh
-│   │   ├── validate-commit.sh
-│   │   ├── validate-push.sh
-│   │   ├── validate-secrets.sh
-│   │   ├── validate-assets.sh
-│   │   ├── validate-skill-change.sh
-│   │   ├── notify.sh
-│   │   ├── pre-compact.sh
-│   │   ├── post-compact.sh
-│   │   ├── log-agent.sh
-│   │   └── log-agent-stop.sh
-│   │
-│   ├── rules/                         # 9 path-scoped rules
-│   │   ├── backend-code.md
-│   │   ├── frontend-code.md
-│   │   ├── api-code.md
-│   │   ├── migration-code.md
-│   │   ├── infra-code.md
-│   │   ├── ai-code.md
-│   │   ├── data-files.md
-│   │   ├── test-standards.md
-│   │   └── prototype-code.md
-│   │
-│   └── docs/                          # Internal documentation
-│       ├── division-structure.md
-│       ├── agent-hierarchy.md
-│       ├── directory-structure.md      # This file
-│       ├── coding-standards.md
-│       ├── technical-preferences.md
-│       ├── coordination-rules.md
-│       ├── context-management.md
-│       ├── workflow-catalog.yaml
-│       ├── stack-registry.md
-│       └── templates/
+├── rules/                             # Rules universales (rules.universal en los profiles)
+│   └── gamedev/                       # Rules de gamedev (rules.gamedev en los profiles)
 │
-├── docs/                              # Public documentation
-│   ├── SKILLS-CATALOG.md              # Complete skill catalog
-│   └── USER-GUIDE.md                  # User guide
+├── hooks/                             # Scripts bash de lifecycle; statusline.sh incluido
+├── output-styles/                     # Output styles (arcane.md)
+├── templates/
+│   └── gamedev/                       # Plantillas de GDD y docs de juego
+├── docs/                              # Documentación; se copia entera a .claude/docs/
+│   ├── templates/                     # Plantillas de ADR, PRD, RFC, test plan, etc.
+│   ├── gates/                         # Gates de fase (software y gamedev)
+│   └── gamedev/, software/            # coding-standards por dominio
 │
-├── tools/                             # Migration & wrapper scripts
-│   ├── arcane.sh                      # Legacy bash installer
-│   ├── arcane.bat                     # Windows wrapper
-│   └── migrate-*.sh                   # Migration tools
-│
-├── skills-selftest/                   # QA framework for skills/agents
+├── skills-selftest/                   # QA de skills y agentes (no se instala)
 │   ├── CLAUDE.md
-│   ├── catalog.yaml                   # Registry: 305 skills + 94 agents
-│   ├── quality-rubric.md
-│   ├── skills/[category]/             # Behavioral specs per skill
-│   ├── agents/[tier]/                 # Behavioral specs per agent
-│   ├── templates/
-│   └── results/                       # Test outputs (gitignored)
+│   ├── catalog.yaml                   # Registro de skills y agentes con su spec
+│   ├── quality-rubric.md              # Métricas por categoría
+│   ├── skills/<categoria>/            # Specs de comportamiento por skill
+│   ├── agents/<tier>/                 # Specs de comportamiento por agente
+│   └── templates/                     # Plantillas para specs nuevos
 │
-└── production/                        # Runtime state
-    └── session-state/
+├── tests/                             # Specs Python de los scripts de skills (npm run test:skills)
+├── maintainers/                       # Cómo publicar Arcane (release, npm). No se instala ni se publica
+├── scripts/                           # Utilidades de mantenimiento del repo
+├── .github/workflows/                 # ci.yml (vitest, typecheck, specs Python) y release.yml (semantic-release)
+└── .claude/                           # La instalación de Arcane que usa este mismo repo
 ```
 
-## Rules Split Policy
+## Un proyecto instalado
 
-- **`.claude/rules/`** — reglas universales que aplican a cualquier stack software (backend APIs, frontends web/mobile, DBs, infra, LLM apps). Usan paths genéricos (`src/api/**`, `src/components/**`, `migrations/**`).
-- **`.claude/skills-gamedev/_rules/`** — reglas exclusivas de gamedev (frame budgets, shaders, NPC AI, GDDs, lore). Usan paths gamedev (`src/gameplay/**`, `assets/shaders/**`, `design/gdd/**`, `design/narrative/**`).
+```
+<proyecto>/
+├── .claude/
+│   ├── settings.json                  # Generado: permisos, hooks y statusline
+│   ├── arcane-manifest.json           # Profiles instalados y content_hashes de cada archivo
+│   ├── skills/<skill>/                # Los skills de los profiles elegidos, con sus references/ y scripts/
+│   │   └── _templates/                # templates/gamedev/, solo si algún profile trae rules de gamedev
+│   ├── agents/<division>/             # Divisiones enteras o agentes sueltos, según el profile
+│   ├── rules/                         # Universales y de gamedev juntas, en un solo nivel
+│   ├── hooks/                         # Todos los hooks de hooks/ salvo statusline.sh
+│   ├── statusline.sh                  # Solo con el profile statusline
+│   ├── output-styles/                 # Solo si algún profile declara output_styles
+│   ├── docs/                          # Copia de docs/; arcane update la mantiene al día
+│   └── .arcane-trash/                 # Lo que arcane update saca; nunca se borra con rm
+├── .claude.bak/                       # Backup de .claude/ antes de instalar
+└── production/session-state/          # Estado de sesión que escriben los hooks
+```
 
-Cuando un proyecto es dual (ej. web + game), ambos sets de rules aplican por sus paths scoped.
+Fuera del proyecto, `~/.arcane/` guarda el registro de instalaciones (`installations.json`) y el contenido descargado de GitHub (`cache/<version>/`). `ARCANE_HOME` lo desvía.
 
-## Hook Events Wiring
+En un git worktree, `hooks/` y `docs/` son symlinks al worktree principal; `skills/`, `agents/` y `rules/` se copian para que puedan divergir por rama.
 
-Ver `settings.json`. Los eventos wireados:
+## Rules: dos carpetas en el repo, una en el proyecto
+
+- **`rules/`**: reglas para cualquier stack de software (backend, frontend, APIs, DBs, infra, apps LLM). Paths genéricos como `src/api/**` o `src/components/**`.
+- **`rules/gamedev/`**: reglas exclusivas de gamedev (frame budgets, shaders, IA de NPCs, GDDs, lore). Paths como `src/gameplay/**`, `assets/shaders/**` o `design/gdd/**`.
+
+El installer copia las dos al mismo `.claude/rules/`, sin subcarpeta. Por eso un nombre no puede repetirse entre las dos carpetas: el segundo archivo pisaría al primero. La rule de apps LLM se llama `llm-code.md` justamente para no chocar con `gamedev/ai-code.md`, que es la de IA de NPCs.
+
+Cuando un proyecto es dual (por ejemplo web + juego), las dos familias aplican cada una por sus paths.
+
+## Hooks: cómo se cablean
+
+Los eventos los define `src/installer.ts` al generar `settings.json`, no los profiles. Todo proyecto instalado recibe estos:
 
 | Evento | Hooks |
 |--------|-------|
-| SessionStart | session-start.sh → detect-division.sh → detect-gaps.sh |
-| PreToolUse (Bash) | validate-commit.sh, validate-push.sh, validate-secrets.sh |
-| PostToolUse (Write/Edit) | validate-assets.sh, validate-skill-change.sh |
-| Notification | notify.sh |
-| PreCompact / PostCompact | pre-compact.sh / post-compact.sh |
-| Stop | session-stop.sh |
-| SubagentStart / SubagentStop | log-agent.sh / log-agent-stop.sh |
+| SessionStart | `session-start.sh` → `detect-division.sh` → `detect-unreal.sh` → `detect-gaps.sh` → `check-update.sh` |
+| PreToolUse (`Bash`) | `validate-commit.sh`, `validate-push.sh`, `validate-secrets.sh` |
+| PostToolUse (`Write\|Edit`) | `validate-assets.sh`, `validate-skill-change.sh` |
+| Notification | `notify.sh` |
+| PreCompact / PostCompact | `pre-compact.sh` / `post-compact.sh` |
+| Stop | `session-stop.sh` |
+| SubagentStart / SubagentStop | `log-agent.sh` / `log-agent-stop.sh` |
+
+La statusline (`statusline.sh`) se configura aparte, solo con el profile `statusline`.

package/package.json

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

package/profiles/backend-go.yaml

@@ -41,6 +41,7 @@ rules:
     - backend-code
     - api-code
     - migration-code
+    - llm-code
   gamedev:
     []
 

package/profiles/core.yaml

@@ -57,7 +57,6 @@ hooks:
   - session-stop.sh
   - log-agent.sh
   - log-agent-stop.sh
-  - statusline.sh
 
 permissions:
   allow:

package/rules/gamedev/engine-code.md

@@ -13,7 +13,7 @@ paths:
 - Changes to public interfaces require a deprecation period and migration guide
 - Use RAII / deterministic cleanup for all resources
 - All engine systems must support graceful degradation
-- Before writing engine API code, consult `docs/engine-reference/` for the current engine version and verify APIs against the reference docs
+- Before writing engine API code, read the project's engine version (`ProjectSettings/ProjectVersion.txt` or the `.uproject`) and verify APIs against that version's docs
 
 ## Examples
 

package/rules/gamedev/shader-code.md

@@ -13,7 +13,6 @@ visual quality, performance, and cross-platform compatibility.
   - `SG_Env_Water` (Unity Shader Graph)
   - `M_Env_Water` (Unreal Material)
 - Use descriptive names that indicate the material purpose
-- Prefix with shader type: `spatial_`, `canvas_`, `particles_`, `post_`
 
 ## Code Quality
 - All uniforms/parameters must have descriptive names and appropriate hints
@@ -32,7 +31,7 @@ visual quality, performance, and cross-platform compatibility.
 ## Cross-Platform
 - Test shaders on minimum spec target hardware
 - Provide fallback/simplified versions for lower quality tiers
-- Document which render pipeline the shader targets (Forward/Deferred, URP/HDRP, Forward+/Mobile/Compatibility)
+- Document which render pipeline the shader targets (Forward/Deferred, URP/HDRP)
 - Do not mix shaders from different render pipelines in the same directory
 
 ## Variant Management

package/rules/gamedev/vn-code.md

@@ -1,6 +1,7 @@
 ---
-name: vn-code
-description: "Coding rules for Ren'Py visual novel development"
+paths:
+  - "game/**"
+  - "**/*.rpy"
 ---
 
 # Visual Novel Code Rules

package/rules/implementation-workflow.md

@@ -1,6 +1,6 @@
 # Implementation Workflow Rule
 
-Before starting any non-trivial implementation task, you MUST present the user with work mode options using AskUserQuestion. This is mandatory — do not skip it and jump to coding.
+Before starting a non-trivial implementation task, present the user with work mode options using AskUserQuestion, so they choose how much planning the task gets before any code is written.
 
 ## When to trigger