claude-code-arcane 2.10.0 → 2.12.0

package/CHANGELOG.md

@@ -1,3 +1,29 @@
+# [2.12.0](https://github.com/SebastianLuser/claude-code-arcane/compare/v2.11.0...v2.12.0) (2026-10-16)
+
+
+### Features
+
+* **output-style:** shape answers for ADHD readers as well ([66351f7](https://github.com/SebastianLuser/claude-code-arcane/commit/66351f7fb9399eec97c650fb547826c4d7097152))
+* **rules:** add verification, agent-delegation and git-worktrees core rules ([2ffe8ef](https://github.com/SebastianLuser/claude-code-arcane/commit/2ffe8ef0a6b4093f0171ff28a327509b7e30cff0))
+* **rules:** say what counts as evidence in each domain rule ([81cec94](https://github.com/SebastianLuser/claude-code-arcane/commit/81cec94f21ae8cbe44c87e2aaa29d9aa4ba969b3))
+
+# [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 36 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/                     # 36 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 **36 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/output-styles/arcane.md

@@ -1,6 +1,6 @@
 ---
 name: arcane
-description: Respuestas compactas, tablas para comparar, lenguaje literal y estructura legible — pensado para lectura con TEA y dislexia.
+description: Respuestas compactas, tablas para comparar, lenguaje literal y estructura legible — pensado para lectura con TEA, TDAH y dislexia.
 ---
 
 # Arcane
@@ -11,8 +11,8 @@ autorizan entregar menos.
 
 ## Largo
 
-- **La respuesta primero.** Primera línea: qué pasó o qué contestás. El detalle va después,
-  para quien lo quiera.
+- **La respuesta o la acción primero.** Primera línea: qué pasó, qué contestás o, si hay algo
+  para hacer, esa acción (un comando, un archivo, una decisión). El detalle va después.
 - **Sin preámbulo.** No repitas la pregunta, no anuncies lo que vas a hacer, no cierres
   resumiendo lo que acabás de decir.
 - **Un tema por párrafo, tres líneas como máximo.** Si un párrafo crece, partilo o pasalo a
@@ -27,12 +27,19 @@ autorizan entregar menos.
 - **Tabla siempre que compares.** Dos o más cosas con dos o más atributos (opciones,
   versiones, proyectos, trade-offs) van en tabla, no en prosa ni en bullets paralelos. Una
   columna por atributo, una fila por cosa.
-- **Listas para pasos y hallazgos.** Prosa solo para el razonamiento que une las cosas.
+- **Pasos numerados, una acción por paso.** La menor cantidad de pasos que funcione; ningún
+  paso dice "y después" dos veces. Prosa solo para el razonamiento que une las cosas.
+- **Cinco ítems como máximo por lista o tabla visible.** Si hay más, agrupalos en secciones
+  con lo más relevante primero. Es solo presentación: nunca descartes un ítem relevante.
 - **Títulos cuando hay más de un tema.** Que se pueda saltar a la parte que importa sin
   leer todo.
 - **`backticks` en todo identificador** — archivos, comandos, ramas, funciones, flags.
 - **Bold para lo importante**, no italics: es más fácil de decodificar. Nunca MAYÚSCULAS
   para enfatizar, deforman la silueta de la palabra.
+- **Página HTML solo para lo que se entiende mejor dibujado.** Si está instalada
+  `answer-me-with-html`, usala para explicar cómo funciona algo, un flujo o una
+  arquitectura, o cuando el usuario pida "dibujalo". Para comparar o listar, alcanza una
+  tabla en la respuesta.
 
 ## Lenguaje
 
@@ -46,8 +53,48 @@ autorizan entregar menos.
   de prosa condicional que deja al lector adivinando el nivel de confianza.
 - **Decí explícitamente qué esperás del otro.** Si hace falta una decisión, que se vea que
   hace falta y cuáles son las alternativas.
+- **Errores sin dramatismo.** Causa y arreglo: "falla en `auth.spec.ts:42`, falta el
+  header", no "uy, algo salió mal".
 
 ## Números y datos
 
 - **El dato antes que el adjetivo.** "62 commits atrás" en vez de "bastante atrasado".
 - **Unidad y fecha completas.** `2026-09-04`, no "ayer"; `312 KB`, no "poco".
+- **El tamaño en unidades contables.** "3 archivos, 2 pasos, 1 PR", no "rápido" ni "un
+  rato". Nada de estimar minutos.
+
+## Seguimiento
+
+- **Decí el estado en tareas de varios pasos.** "Paso 3 de 5 hecho: X. Sigue: Y." Si hay
+  herramienta de tareas, la lista de tareas reemplaza esa narración.
+- **Que lo terminado se vea.** "El login ya funciona: probá `npm run dev` y entrá a
+  `/login`", no "hice algunos cambios".
+- **Sin desvíos.** Si aparece un segundo tema, cerrá el actual y ofrecé el otro aparte, al
+  final. Una duda que surge en el medio, resolvela vos si podés.
+- **Cerrá con una sola acción concreta** que el usuario pueda hacer en poco tiempo, si
+  queda algo abierto.
+
+## Cuándo se rompen estas reglas
+
+1. **"Explicame".** Se explica completo, con títulos. Sigue sin preámbulo ni cierre.
+2. **Algo destructivo por delante.** Confirmá antes de actuar: la seguridad gana a la
+   brevedad.
+3. **Espiral de debug.** Si los últimos 3 turnos fueron "sigue roto", dejá de tocar código.
+   Nombrá la suposición que puede estar mal y hacé una sola pregunta de diagnóstico.
+4. **Pedido ambiguo.** Una pregunta corta antes que adivinar.
+5. **"¿Qué opciones tengo?"** De 2 a 4 opciones con la recomendada primero: las opciones
+   son la respuesta.
+6. **El trabajo del agente lo hace el agente.** No preguntes "¿querés que lo haga?" por algo
+   que te toca hacer. Las decisiones que son del usuario siguen siendo preguntas.
+
+## Antes de enviar
+
+Borrá:
+
+1. La primera oración, si anuncia lo que vas a hacer.
+2. La última, si pregunta "¿algo más?" o resume lo que pasó.
+3. Los "por cierto".
+4. Las dudas de relleno ("quizás", "podría"). Las que expresan incertidumbre real quedan.
+5. Los modismos.
+
+Prueba final: leyendo solo la primera y la última línea, ¿se sabe qué pasó y qué sigue?

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-code-arcane",
-  "version": "2.10.0",
+  "version": "2.12.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/core.yaml

@@ -33,6 +33,9 @@ rules:
     - test-standards
     - implementation-workflow
     - code-comments
+    - verification
+    - agent-delegation
+    - git-worktrees
   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/agent-delegation.md

@@ -0,0 +1,8 @@
+# Agent Delegation Rule
+
+Applies to the main session and to every subagent it starts.
+
+- **Your final message is the deliverable.** Never end a turn with "waiting for the subagents": a started task is not a finished one.
+- **If you delegate, you collect.** Wait for every result, integrate it, then answer. No fire-and-forget.
+- **One agent by default.** Split work only when it cannot fit one context, or when the second agent needs something the first must not have: different tools or permissions, a clean context (a reviewer that must not see the maker's reasoning), or a different model.
+- **The prompt is all the subagent knows.** It does not see this conversation: pass the goal, the relevant files and the output format you expect.

package/rules/backend-code.md

@@ -33,3 +33,10 @@ paths:
 - Nested business logic in DB queries (computed columns that reimplement rules)
 - Silent retries with no backoff, no max attempts, no circuit breaker
 - Returning raw DB rows as HTTP responses — always go through a DTO / view model
+
+## How to verify
+
+- Run the tests that cover the change.
+- Start the service locally and call the changed endpoint with `curl` (or the project's HTTP client). Show the status code and the body.
+- Call one failure case too (invalid input, missing auth), not only the happy path.
+- Read the server log for those requests: no stack trace, no unexpected warning.

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/dotnet-code.md

@@ -59,6 +59,12 @@ Reglas production-ready para ASP.NET Core (.NET 10), ordenadas por impacto. Cat
 - `Domain` referenciando `Infrastructure` / EF Core (dependencia hacia afuera)
 - Forzar Clean Architecture en un CRUD simple (sobre-ingeniería)
 
+## How to verify
+
+- `dotnet build` with no new warnings, and `dotnet test` for the projects the change touches.
+- Run the API locally and call the changed endpoint with `curl`: show the status code and the body, plus one failure case (invalid input, missing auth).
+- Read the log for those requests: no exception, no unexpected warning.
+
 ---
 
 _Derivado de [github/awesome-copilot](https://github.com/github/awesome-copilot) (dotnet-best-practices), [dotnet/skills](https://github.com/dotnet/skills) y [ardalis/CleanArchitecture](https://github.com/ardalis/CleanArchitecture). Condensado al formato Arcane._

package/rules/frontend-code.md

@@ -33,3 +33,28 @@ paths:
 - Unmanaged re-renders triggered by new object/array literals in parent render
 - DOM manipulation via `document.querySelector` inside a component
 - Inline handlers defined in JSX for components that memoize
+
+## Visual Quality
+
+- Do not ship library defaults as the design: a stock card grid, a centered hero with a gradient blob, the same radius and shadow on every component.
+- Give each screen a hierarchy: one primary action, deliberate emphasis, designed hover, focus and active states.
+- If the app has light and dark themes, both must look designed, not inverted.
+
+## Web Performance
+
+- Images declare `width` and `height`, load `lazy` below the fold, and ship as AVIF or WebP near their rendered size.
+- At most two font families, `font-display: swap`, and preload only the critical weight.
+- Animate only `transform` and `opacity`; use `IntersectionObserver` instead of scroll handlers.
+- Third-party scripts load `async` or `defer`, and only on the pages that need them.
+
+## How to verify
+
+- The build passes and the type check is clean.
+- For a web task done in Plan + Goal or Goal-driven mode, a Playwright check is required before the task counts as done:
+  1. The page loads with no console errors.
+  2. Screenshots at 320, 768, 1024 and 1440 px wide, in both themes if the app has a dark mode.
+  3. Walk the flow you changed: clicks, forms, navigation.
+  4. Keyboard: every control in the flow is reachable with Tab, usable with Enter or Space, and shows a visible focus.
+  5. Keep the screenshots and show them as evidence.
+- If Playwright is not installed, propose installing it once (`npm i -D @playwright/test`, then `npx playwright install chromium`). If the user declines, close the task with "visual result not verified".
+- In React Native or Flutter Playwright does not apply: say what was not verified visually.

package/rules/gamedev/ai-code.md

@@ -1,6 +1,7 @@
 ---
 paths:
   - "src/ai/**"
+  - "Assets/**/Scripts/**/AI/**"
 ---
 
 # AI Code Rules

package/rules/gamedev/audio-code.md

@@ -1,6 +1,7 @@
 ---
 paths:
   - "src/audio/**"
+  - "Assets/**/Scripts/**/Audio/**"
 ---
 
 # Audio Code Rules

package/rules/gamedev/engine-code.md

@@ -1,6 +1,7 @@
 ---
 paths:
   - "src/core/**"
+  - "Assets/**/Scripts/Core/**"
 ---
 
 # Engine Code Rules
@@ -39,3 +40,9 @@ void FixedUpdate()
     nearby.AddRange(FindObjectsOfType<Enemy>());  // VIOLATION: scene scan every frame
 }
 ```
+
+## How to verify
+
+- The project compiles with no new errors: the Unity console, or a batchmode compile (`Unity -batchmode -quit -projectPath . -logFile -`); for Unreal, see `unreal-code`.
+- Run the EditMode and PlayMode tests that cover the change (`-runTests -testPlatform EditMode` or `PlayMode`).
+- You cannot play the game. Name what needs a human playtest (game feel, timing, visuals, input) and list exactly what to try.

package/rules/gamedev/gameplay-code.md

@@ -1,6 +1,8 @@
 ---
 paths:
   - "src/gameplay/**"
+  - "Assets/**/Scripts/Gameplay/**"
+  - "Assets/**/Scripts/Systems/**"
 ---
 
 # Gameplay Code Rules
@@ -28,3 +30,9 @@ float speed = stats.MovementSpeed * Time.deltaTime;
 float damage = 25.0f;   // VIOLATION: hardcoded gameplay value
 float speed = 5.0f;     // VIOLATION: not from config, not using delta
 ```
+
+## How to verify
+
+- The project compiles with no new errors: the Unity console, or a batchmode compile (`Unity -batchmode -quit -projectPath . -logFile -`); for Unreal, see `unreal-code`.
+- Run the EditMode and PlayMode tests that cover the change (`-runTests -testPlatform EditMode` or `PlayMode`).
+- You cannot play the game. Name what needs a human playtest (game feel, timing, visuals, input) and list exactly what to try.

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/gamedev/network-code.md

@@ -1,6 +1,7 @@
 ---
 paths:
   - "src/networking/**"
+  - "Assets/**/Scripts/**/Network*/**"
 ---
 
 # Network Code Rules

package/rules/gamedev/shader-code.md

@@ -1,6 +1,9 @@
 ---
 paths:
   - "assets/shaders/**"
+  - "Assets/**/Shaders/**"
+  - "**/*.shader"
+  - "**/*.hlsl"
 ---
 
 # Shader Code Standards