claude-code-arcane 2.10.0 → 2.11.0

package/CHANGELOG.md

@@ -1,3 +1,20 @@
+# [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)
 
 

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.
 
@@ -190,11 +190,11 @@ Older names still install and update: `backend-ts`, `frontend`, `mobile`, `flutt
 
 | Profile | Stack | Skills | Agents |
 |---------|-------|--------|--------|
-| `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 |
+| `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
 
@@ -228,7 +228,7 @@ Older names still install and update: `backend-ts`, `frontend`, `mobile`, `flutt
 
 | Profile | Adds | Skills | Agents |
 |---------|------|--------|--------|
-| `infra` | Terraform, observability, secrets, rollback, K8s | 24 | devops |
+| `infra` | Terraform, observability, secrets, rollback, K8s | 26 | devops |
 | `database` | Indexing, migrations, seeding, replicas, optimization | 8 | — |
 | `security` | Audits, OWASP, secrets, backups | 10 | — |
 | `testing` | Contract, performance, regression, flakiness | 11 | quality |
@@ -461,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

@@ -3205,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(

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 | |
 
 ---
 

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
 

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.10.0",
+  "version": "2.11.0",
   "description": "Skills, agents, hooks and rules for Claude Code — installable via npx claude-code-arcane",
   "type": "module",
   "bin": {

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,6 +27,8 @@ skills:
   - audit-log
   - slo-sli
   - ci-cd-setup
+  - 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

@@ -30,6 +30,8 @@ skills:
   - websocket-realtime-rooms
   - search-setup
   - ci-cd-setup
+  - worktree-isolation
+  - worktree-isolation-setup
 
 rules:
   universal:

package/profiles/backend-typescript.yaml

@@ -28,6 +28,8 @@ skills:
   - websocket-realtime-rooms
   - search-setup
   - ci-cd-setup
+  - worktree-isolation
+  - worktree-isolation-setup
 
 rules:
   universal:

package/profiles/blender.yaml

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

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

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

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.

package/rules/blender-pipeline.md

@@ -1,7 +1,6 @@
 # Blender Pipeline
 
-Reglas para trabajar assets en Blender con destino a un engine o a la web. Aplican a cualquier
-operacion que toque un `.blend` o exporte desde uno.
+Reglas que tienen que estar presentes antes de operar Blender, por MCP o headless, aunque todavia no se haya tocado un `.blend`. Ejes, topologia, materiales, animacion y Git estan en `.claude/rules/blender-files.md`, que se carga al tocar un `.blend` o un archivo exportado.
 
 ## El MCP es opcional, el headless no
 
@@ -32,64 +31,3 @@ barrera**. Consecuencias que no son negociables:
 3. No apuntarlo a una maquina con material sensible ni a credenciales.
 4. Un script que borra (`bpy.data.*.remove`, `object.delete`) se muestra al usuario **antes** de
    correrlo, siempre, incluso si lo pidio.
-
-## 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.

package/rules/gamedev/narrative.md

@@ -12,4 +12,4 @@ paths:
 - Mysteries must have documented "true answers" even if players never learn them
 - Faction motivations, relationships, and power structures must be internally logical
 - All narrative text must be localization-ready: no idioms that don't translate, named placeholders for variables
-- No line of dialogue should exceed 120 characters for dialogue box constraints
+- No line of dialogue should exceed 200 characters for dialogue box constraints

package/rules/meshy-assets.md

@@ -1,6 +1,6 @@
 # Meshy Assets
 
-Reglas para produccion de assets 3D con Meshy. Aplican a cualquier operacion que toque `assets/3d/`.
+Reglas que tienen que estar presentes antes de cualquier llamada a Meshy, aunque no se toque ningun archivo: cada llamada gasta creditos. Estructura en disco, ledger, ejes, rigging y Git estan en `.claude/rules/meshy-files.md`, que se carga al tocar `assets/3d/`.
 
 ## Creditos — cada llamada cuesta plata real
 
@@ -29,83 +29,14 @@ Reglas para produccion de assets 3D con Meshy. Aplican a cualquier operacion que
 
 Ante cualquier duda sobre si una operacion gasta, correr `meshy_check_balance` antes y despues y reportar el delta real.
 
-## Master unico, derivados baratos
+## Antes de gastar
 
-El GLB refined es la fuente de verdad y es **inmutable**. Ningun target se genera desde el prompt: todos salen del master.
+- Ningun target se genera desde el prompt: todos salen del master con `meshy_convert` (1).
+- Nunca usar `remesh` (5) cuando `convert` (1) alcanza, ni para LODs de web: `gltf-transform` los hace gratis.
+- `meshy_rig` (5) es solo para humanoides: con otro modelo se gastan los creditos y no sirve.
+- Si existe un art bible en el proyecto, el prompt de generacion se deriva de ahi, no se inventa.
+- `meshy_analyze_printability` (gratis) **siempre** antes de `meshy_repair_printability` (10). Print (20 white / 40 multicolor): doble confirmacion.
 
-| Target | Como | Creditos |
-|---|---|---|
-| Unity y UE5 | `meshy_convert` -> `fbx` (un solo archivo sirve para los dos) | 1 |
-| Blender | `meshy_convert` -> `blend` | 1 |
-| Impresion | `meshy_convert` -> `stl` (`3mf` si es multicolor) | 1 |
-| Web / three.js | `npx gltf-transform optimize --simplify` | **0** |
+## Secretos
 
-- Nunca usar `remesh` (5) cuando `convert` (1) alcanza. `remesh` es para cambiar topologia de verdad, no para cambiar de formato.
-- Nunca usar `remesh` para LODs de web: `gltf-transform` hace decimation, meshopt y KTX2 en local y gratis.
-
-## Estructura en disco
-
-```
-assets/3d/<slug>/
-  meshy.json           # ledger, ver abajo
-  master.glb           # refined, inmutable
-  thumb.png
-  targets/
-    web.glb            # <=15k tris, texturas 1024, KTX2 + draco
-    game.fbx           # Unity + UE5
-    edit.blend
-    print.stl
-```
-
-Slugs en kebab-case, sin fechas ni task_ids en el path.
-
-## Ledger: `meshy.json`
-
-Obligatorio por asset. Sin esto cada sesion nueva arranca ciega y se paga dos veces el mismo modelo.
-
-```json
-{
-  "slug": "rune-pedestal",
-  "prompt": "...",
-  "ai_model": "meshy-5",
-  "tasks": [
-    { "id": "...", "op": "text_to_3d_preview", "credits": 5, "at": "2026-08-18T14:02:00Z" },
-    { "id": "...", "op": "text_to_3d_refine", "credits": 25, "at": "2026-08-18T14:11:00Z" }
-  ],
-  "credits_total": 30,
-  "derived": ["targets/web.glb", "targets/game.fbx"]
-}
-```
-
-Actualizar `meshy.json` **en el mismo turno** en que se genera. No dejarlo para despues.
-
-## Ejes y escala
-
-Verificar una vez, anotar en el ledger, no volver a pensarlo.
-
-| Destino | Convencion |
-|---|---|
-| GLB | Y-up, metros |
-| Unity | Y-up, 1 unidad = 1 m |
-| UE5 | Z-up, 1 unidad = 1 cm (rotacion + factor 100) |
-| Blender | Z-up, metros |
-
-## Impresion 3D
-
-Correr `meshy_analyze_printability` (gratis) **siempre** antes de `meshy_repair_printability` (10). `meshy_resize` a milimetros reales antes de exportar STL. Las operaciones de print (20 white / 40 multicolor) son las mas caras del catalogo: doble confirmacion.
-
-## Rigging
-
-`meshy_rig` es solo humanoides. El esqueleto que devuelve **no** es el mannequin de UE5: el retargeting es manual. En UE5 los static meshes van a Nanite y no necesitan decimation; los skeletal meshes si necesitan LODs propios.
-
-## Git y secretos
-
-- `*.glb *.fbx *.blend *.stl *.3mf` por **Git LFS**.
-- `meshy.json` y `thumb.png` van como archivos normales — son chicos y son lo que hace grepeable el catalogo.
-- `MESHY_API_KEY` (formato `msy_...`) va en `.env`, **nunca** en el repo ni en un SKILL.md.
-
-## Integracion con el resto del stack
-
-`asset-spec` define que asset hace falta -> Meshy lo genera -> `asset-audit` valida el resultado. Meshy no reemplaza a ninguno de los dos.
-
-Si existe un art bible en el proyecto, el prompt de generacion se deriva de ahi, no se inventa.
+`MESHY_API_KEY` (formato `msy_...`) va en `.env`, **nunca** en el repo ni en un SKILL.md.

package/rules/meshy-files.md

@@ -0,0 +1,83 @@
+---
+paths:
+  - "assets/3d/**"
+---
+
+# Meshy Files
+
+Como se guardan los assets de Meshy. Los creditos y las reglas de gasto estan en `.claude/rules/meshy-assets.md`, que se carga siempre.
+
+## Master unico, derivados baratos
+
+El GLB refined es la fuente de verdad y es **inmutable**. Ningun target se genera desde el prompt: todos salen del master.
+
+| Target | Como | Creditos |
+|---|---|---|
+| Unity y UE5 | `meshy_convert` -> `fbx` (un solo archivo sirve para los dos) | 1 |
+| Blender | `meshy_convert` -> `blend` | 1 |
+| Impresion | `meshy_convert` -> `stl` (`3mf` si es multicolor) | 1 |
+| Web / three.js | `npx gltf-transform optimize --simplify` | **0** |
+
+## Estructura en disco
+
+```
+assets/3d/<slug>/
+  meshy.json           # ledger, ver abajo
+  master.glb           # refined, inmutable
+  thumb.png
+  targets/
+    web.glb            # <=15k tris, texturas 1024, KTX2 + draco
+    game.fbx           # Unity + UE5
+    edit.blend
+    print.stl
+```
+
+Slugs en kebab-case, sin fechas ni task_ids en el path.
+
+## Ledger: `meshy.json`
+
+Obligatorio por asset. Sin esto cada sesion nueva arranca ciega y se paga dos veces el mismo modelo.
+
+```json
+{
+  "slug": "rune-pedestal",
+  "prompt": "...",
+  "ai_model": "meshy-5",
+  "tasks": [
+    { "id": "...", "op": "text_to_3d_preview", "credits": 5, "at": "2026-08-18T14:02:00Z" },
+    { "id": "...", "op": "text_to_3d_refine", "credits": 25, "at": "2026-08-18T14:11:00Z" }
+  ],
+  "credits_total": 30,
+  "derived": ["targets/web.glb", "targets/game.fbx"]
+}
+```
+
+Actualizar `meshy.json` **en el mismo turno** en que se genera. No dejarlo para despues.
+
+## Ejes y escala
+
+Verificar una vez, anotar en el ledger, no volver a pensarlo.
+
+| Destino | Convencion |
+|---|---|
+| GLB | Y-up, metros |
+| Unity | Y-up, 1 unidad = 1 m |
+| UE5 | Z-up, 1 unidad = 1 cm (rotacion + factor 100) |
+| Blender | Z-up, metros |
+
+## Impresion 3D
+
+`meshy_resize` a milimetros reales antes de exportar STL.
+
+## Rigging
+
+El esqueleto que devuelve `meshy_rig` **no** es el mannequin de UE5: el retargeting es manual. En UE5 los static meshes van a Nanite y no necesitan decimation; los skeletal meshes si necesitan LODs propios.
+
+## Git
+
+- `*.glb *.fbx *.blend *.stl *.3mf` por **Git LFS**.
+- `meshy.json` y `thumb.png` van como archivos normales — son chicos y son lo que hace grepeable el catalogo.
+
+## Integracion con el resto del stack
+
+`asset-spec` define que asset hace falta -> Meshy lo genera -> `asset-audit` valida el resultado. Meshy no reemplaza a ninguno de los dos.

package/skills/agent-protocol/SKILL.md

@@ -90,7 +90,7 @@ All C-suite output follows ONE format. See `references/communication-standard.md
 
 1. **Bottom line first.** The founder's time is the scarcest resource.
 2. **Results and decisions only.** No process narration.
-3. **Max 5 bullets per section.** Longer = reference doc.
+3. **About 5 bullets per section, ranked by impact.** Keep what changes the decision; the rest goes to a reference doc. Never drop a critical finding to fit the number: show it, and point to the doc for detail.
 4. **Actions have owners and deadlines.** "We should consider" is banned.
 5. **Decisions framed as options** with trade-offs and recommendation.
 6. **Risks are concrete.** "If X happens, Y breaks, costing $Z."

package/skills/agent-protocol/references/communication-standard.md

@@ -16,7 +16,7 @@ WHAT
 • [Finding 1 — most critical]
 • [Finding 2]
 • [Finding 3]
-(Max 5 bullets. If more needed → reference doc.)
+(About 5, ranked by impact. More only if critical; detail → reference doc.)
 
 WHY THIS MATTERS
 [1-2 sentences. Business impact. Not theory — consequence.]
@@ -106,7 +106,7 @@ ACTION ITEMS
 1. **Bottom line first.** Always. The founder's time is the scarcest resource.
 2. **Results and decisions only.** No process narration ("First I analyzed..."). No thinking out loud.
 3. **What + Why + How.** Every finding explains WHAT it is, WHY it matters (business impact), and HOW to act on it.
-4. **Max 5 bullets per section.** Longer = reference doc.
+4. **About 5 bullets per section, ranked by impact.** Keep what changes the decision; the rest goes to a reference doc. Never drop a critical finding to fit the number: show it, and point to the doc for detail.
 5. **Actions have owners and deadlines.** "We should consider" is banned. Who does what by when.
 6. **Decisions framed as options.** Not "what do you think?" — "Option A or B, here's the trade-off, here's my recommendation."
 7. **The founder decides.** Roles recommend. The founder approves, modifies, or rejects. Every output respects this hierarchy.

package/skills/ai-security/SKILL.md

@@ -72,6 +72,10 @@ Injection score (0.0-1.0) measures proportion of matched signatures. Score above
 
 Full ATLAS technique coverage and guardrail patterns: `references/atlas-coverage.md`
 
+### Step 5: Verdict
+
+**Verdict:** **FAIL** if any finding is Critical or High; **CONCERNS** if only Medium or Low findings remain; **PASS** if nothing actionable turned up. A prompt-injection score above 0.5 counts as High.
+
 ---
 
 ## Tool Reference

package/skills/audit-dev/SKILL.md

@@ -30,7 +30,7 @@ Identificar lenguajes/frameworks/package manager. Leer configs raíz. Mapear car
 
 ## Phase 3 — Producir reporte
 
-Guardar como `AUDIT.md` en raíz. Secciones: fecha/stack/estado general, resumen ejecutivo (3-5 oraciones), scorecard (tabla dimensión/estado OK-WARN-CRIT/nota), hallazgos críticos, hallazgos importantes, observaciones, lo que está bien, plan de acción recomendado, detalles por dimensión con evidencia (paths, líneas).
+Guardar como `AUDIT.md` en raíz. Secciones: fecha/stack/estado general (**SALUDABLE** si todas las dimensiones del scorecard están en OK, **NECESITA ATENCIÓN** si alguna quedó en WARN, **CRÍTICO** si alguna quedó en CRIT), resumen ejecutivo (3-5 oraciones), scorecard (tabla dimensión/estado OK-WARN-CRIT/nota), hallazgos críticos, hallazgos importantes, observaciones, lo que está bien, plan de acción recomendado, detalles por dimensión con evidencia (paths, líneas).
 
 ## Rules
 

package/skills/blender-animation/SKILL.md

@@ -164,4 +164,4 @@ influencias maximas por vertice, que se bakeo, y decision de root motion por cli
 
 ---
 
-> → Bake de constraints, frame rate y ejes estan en `.claude/rules/blender-pipeline.md`.
+> → Bake de constraints, frame rate y ejes estan en `.claude/rules/blender-files.md`.

package/skills/blender-export/SKILL.md

@@ -140,4 +140,4 @@ verdict.
 
 ---
 
-> → Formatos, ejes, escala y reglas de Git LFS estan en `.claude/rules/blender-pipeline.md`.
+> → Formatos, ejes, escala y reglas de Git LFS estan en `.claude/rules/blender-files.md`.

package/skills/blender-materials/SKILL.md

@@ -162,4 +162,4 @@ que se bakeo, y convencion de normal map elegida.
 ---
 
 > → Color space, convenciones de normal map y presupuesto de materiales estan en
-> `.claude/rules/blender-pipeline.md`.
+> `.claude/rules/blender-files.md`.