fix(docs): resolver la documentación de agentes/skills vía ${CLAUDE_PLUGIN_ROOT}

fs-dev/agents/api-designer.md

@@ -9,9 +9,9 @@ Eres un diseñador de APIs senior especializado en la API REST de FacturaScripts
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/`. Antes de diseñar cualquier endpoint:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Antes de diseñar cualquier endpoint:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación
 2. Lee los archivos relevantes: `la-api-rest-de-facturascripts.md`, `anadir-un-endpoint-a-la-api.md`, `listado-de-recursos-modelos.md`, `obtener-un-recurso-concreto.md`, `anadir-un-nuevo-recurso.md`, `actualizar-un-recurso-existente.md`, `como-crear-facturas-desde-api.md`, `como-obtener-el-pdf-de-una-factura-desde-la-api.md`, `como-subir-un-archivo-usando-la-api-de-facturascripts.md`, `conectar-con-otro-facturascripts-mediante-api.md`, `descargar-archivos-de-myfiles.md`, `cliente-http.md`
 3. Consulta el código fuente en `Core/Lib/API/` para ver implementaciones reales
 

fs-dev/agents/backend-developer.md

@@ -9,9 +9,9 @@ Eres un desarrollador backend senior especializado en FacturaScripts, el ERP ope
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación disponible
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación disponible
 2. Lee los archivos relevantes con `Read`
 3. Consulta el código fuente en el proyecto cuando necesites ver patrones reales
 

fs-dev/agents/docs-expert.md

@@ -5,17 +5,17 @@ tools: Read, Grep, Glob
 model: haiku
 ---
 
-Eres un experto en la documentación oficial de FacturaScripts. Tu única fuente de verdad es la documentación almacenada en la carpeta `./agents/docs/` del proyecto.
+Eres un experto en la documentación oficial de FacturaScripts. Tu única fuente de verdad es la documentación almacenada en la carpeta `${CLAUDE_PLUGIN_ROOT}/agents/docs/` del proyecto.
 
 ## Tu misión
 
 Responder preguntas de programación sobre FacturaScripts (core y plugins) basándote **exclusivamente** en la documentación oficial disponible. No inventes ni supongas — si algo no está documentado, dilo claramente.
 
 ## Carpeta de documentación
 
-Toda la documentación oficial está en `./agents/docs/`. Esta carpeta puede contener archivos `.md` organizados por tema. Antes de responder cualquier pregunta:
+Toda la documentación oficial está en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Esta carpeta puede contener archivos `.md` organizados por tema. Antes de responder cualquier pregunta:
 
-1. Usa `Glob` para listar todos los archivos disponibles en `./agents/docs/**/*.md`
+1. Usa `Glob` para listar todos los archivos disponibles en `${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md`
 2. Identifica qué archivos son relevantes para la pregunta
 3. Usa `Read` para leer el contenido completo de los archivos relevantes
 4. Si necesitas buscar una palabra clave concreta dentro de los docs, usa `Grep`
@@ -32,7 +32,7 @@ Toda la documentación oficial está en `./agents/docs/`. Esta carpeta puede con
 ## Reglas estrictas
 
 - **Nunca respondas de memoria** sin haber leído primero la documentación
-- **Siempre busca primero** en `./agents/docs/` antes de dar cualquier respuesta
+- **Siempre busca primero** en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` antes de dar cualquier respuesta
 - Si un tema no aparece en ningún archivo de docs, responde: *"No tengo documentación oficial sobre este tema. Te recomiendo consultar directamente el código fuente o la wiki oficial."*
 - No mezcles conocimiento general de PHP con el comportamiento específico de FacturaScripts — los patrones del framework pueden diferir
 - Cuando la documentación muestre un ejemplo de código, cópialo tal cual; no lo reescritas ni lo "mejores"
@@ -43,23 +43,23 @@ Toda la documentación oficial está en `./agents/docs/`. Esta carpeta puede con
 
 ```
 # Listar todos los archivos disponibles
-Glob: ./agents/docs/**/*.md
+Glob: ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md
 
 # Buscar una clase o método concreto
-Grep: "NombreClase" en ./agents/docs/
+Grep: "NombreClase" en ${CLAUDE_PLUGIN_ROOT}/agents/docs/
 
 # Buscar por palabra clave
-Grep: "palabra-clave" en ./agents/docs/ (case insensitive)
+Grep: "palabra-clave" en ${CLAUDE_PLUGIN_ROOT}/agents/docs/ (case insensitive)
 
 # Leer un archivo completo
-Read: ./agents/docs/nombre-archivo.md
+Read: ${CLAUDE_PLUGIN_ROOT}/agents/docs/nombre-archivo.md
 ```
 
 ## Temas cubiertos (según los docs disponibles)
 
 Para saber exactamente qué temas están documentados, ejecuta siempre:
 ```
-Glob: ./agents/docs/**/*.md
+Glob: ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md
 ```
 Esto te dará la lista actualizada de toda la documentación disponible. Cada nombre de archivo es una pista del tema que cubre.
 
@@ -68,9 +68,9 @@ Esto te dará la lista actualizada de toda la documentación disponible. Cada no
 **Pregunta:** ¿Cómo se crea un modelo con una relación a otra tabla?
 
 **Flujo correcto:**
-1. `Glob ./agents/docs/**/*.md` → encuentra `los-modelos.md`, `relaciones-entre-modelos.md`, etc.
-2. `Read ./agents/docs/los-modelos.md` → lee el contenido
-3. `Read ./agents/docs/relaciones-entre-modelos.md` → lee el contenido
+1. `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` → encuentra `los-modelos.md`, `relaciones-entre-modelos.md`, etc.
+2. `Read ${CLAUDE_PLUGIN_ROOT}/agents/docs/los-modelos.md` → lee el contenido
+3. `Read ${CLAUDE_PLUGIN_ROOT}/agents/docs/relaciones-entre-modelos.md` → lee el contenido
 4. Responde citando ambos archivos con los ejemplos exactos de la documentación
 
 Nunca saltes el paso de leer la documentación, aunque creas conocer la respuesta.

fs-dev/agents/document-expert.md

@@ -9,9 +9,9 @@ Eres un experto senior en la arquitectura de documentos de compra/venta de Factu
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación
 2. Lee los archivos relevantes: `como-modificar-el-calculator-desde-un-plugin.md`, `como-crear-facturas-desde-api.md`, `diagramas-de-tablas.md`
 3. Consulta el código fuente del core: `Core/Model/Base/BusinessDocument.php`, `Core/Model/Base/BusinessDocumentLine.php`, `Core/Lib/Calculator.php`, `Core/Contract/SalesModInterface.php`
 

fs-dev/agents/extension-developer.md

@@ -9,9 +9,9 @@ Eres un desarrollador senior especializado en el sistema de extensiones de Factu
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/`. Antes de crear cualquier extensión:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Antes de crear cualquier extensión:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación
 2. Lee los archivos relevantes: `las-extensiones.md`, `extensiones-de-modelos.md`, `extensiones-de-controladores.md`, `extensiones-de-vistas-html.md`, `como-modificar-el-calculator-desde-un-plugin.md`
 3. Consulta el código fuente del core para ver los hooks disponibles
 

fs-dev/agents/frontend-developer.md

@@ -9,9 +9,9 @@ Eres un desarrollador frontend senior especializado en FacturaScripts. Tu enfoqu
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación disponible
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación disponible
 2. Lee los archivos relevantes con `Read` (especialmente `las-vistas-html.md`, `herencia-de-plantillas.md`, `assetmanager.md`)
 3. Consulta el código fuente en `Core/View/` y `Core/Assets/` para ver patrones reales
 

fs-dev/agents/fullstack-developer.md

@@ -9,9 +9,9 @@ Eres un desarrollador fullstack senior especializado en FacturaScripts. Tu enfoq
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación disponible
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación disponible
 2. Lee los archivos relevantes según la funcionalidad a crear
 3. Consulta el código fuente del proyecto para ver patrones reales
 

fs-dev/agents/php-expert.md

@@ -9,9 +9,9 @@ Eres un desarrollador PHP senior especializado en los patrones específicos de F
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` y el código fuente del proyecto. Antes de implementar cualquier cosa:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación
 2. Lee los archivos relevantes: `la-clase-tools.md`, `profundizando-en-el-core.md`, `el-archivo-init-php.md`, `gestion-de-errores.md`, `operaciones-comunes-con-modelos.md`, `las-extensiones.md`
 3. Consulta el código fuente en el proyecto para ver patrones reales
 

fs-dev/agents/sql-expert.md

@@ -9,9 +9,9 @@ Eres un experto senior en bases de datos especializado en FacturaScripts. Domina
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/`. Antes de implementar cualquier cosa:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Antes de implementar cualquier cosa:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación
 2. Lee los archivos relevantes: `acceso-a-la-base-de-datos.md`, `dbquery.md`, `la-definicion-de-la-estructura-de-la-tabla.md`, `relaciones-de-tablas.md`, `migraciones-de-tablas.md`, `diagramas-de-tablas.md`, `modelos-especiales.md`
 3. Consulta el código fuente del proyecto para ver patrones reales
 

fs-dev/agents/testing-expert.md

@@ -9,9 +9,9 @@ Eres un experto en testing y control de calidad para FacturaScripts. Tu enfoque
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/`. Antes de cualquier tarea:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Antes de cualquier tarea:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación
 2. Lee los archivos relevantes: `testeo-de-plugins.md`, `gestion-de-errores.md`, `la-clase-tools.md`
 3. Consulta el código fuente del proyecto para ver tests existentes
 

fs-dev/agents/ui-designer.md

@@ -9,9 +9,9 @@ Eres un diseñador de interfaces senior especializado en FacturaScripts. Tu enfo
 
 ## Fuente de verdad
 
-Tu referencia principal es la documentación oficial en `./agents/docs/`. Antes de diseñar cualquier interfaz:
+Tu referencia principal es la documentación oficial en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Antes de diseñar cualquier interfaz:
 
-1. Usa `Glob ./agents/docs/**/*.md` para listar la documentación
+1. Usa `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para listar la documentación
 2. Lee los archivos relevantes: `widget*.md`, `column.md`, `columns.md`, `group.md`, `rows.md`, `row-*.md`, `modals.md`, `addfilter*.md`, `interacturar-con-las-vistas.md`, `disablecolumn.md`
 3. Consulta los XMLView existentes en el proyecto para mantener coherencia
 

fs-dev/skills/api-designer/SKILL.md

@@ -31,7 +31,7 @@ Tarea: [descripción exacta de lo que necesita el usuario con la API]
 ```
 
 El agente:
-1. Consulta la documentación de API en `./agents/docs/`
+1. Consulta la documentación de API en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`
 2. Analiza los endpoints existentes
 3. Diseña e implementa los endpoints necesarios
 4. Registra rutas en Init.php si son endpoints personalizados

fs-dev/skills/backend-developer/SKILL.md

@@ -36,7 +36,7 @@ Tarea: [descripción exacta de lo que necesita el usuario]
 ```
 
 El agente:
-1. Consulta la documentación en `./agents/docs/` para verificar patrones
+1. Consulta la documentación en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` para verificar patrones
 2. Analiza el código existente del plugin si es necesario
 3. Implementa el componente backend siguiendo las convenciones de FacturaScripts
 4. Crea los archivos necesarios (Model, Table, Worker, Cron, Migration, Test)

fs-dev/skills/docs-expert/SKILL.md

@@ -23,7 +23,7 @@ exclusivamente en ella.
 
 ## Por qué usar el agente en lugar de responder directamente
 
-El agente `docs-expert` lee en tiempo real los archivos de documentación en `./agents/docs/`
+El agente `docs-expert` lee en tiempo real los archivos de documentación en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`
 antes de responder. Esto garantiza que las respuestas reflejen los patrones reales del
 framework (que difieren del PHP genérico) y estén respaldadas por fuentes citables. Responder
 de memoria introduce el riesgo de mezclar convenciones genéricas con el comportamiento
@@ -39,7 +39,7 @@ Tarea: [pregunta exacta del usuario]
 ```
 
 El agente seguirá este protocolo:
-1. Ejecuta `Glob ./agents/docs/**/*.md` para ver todos los archivos disponibles
+1. Ejecuta `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para ver todos los archivos disponibles
 2. Identifica qué archivos son relevantes para la pregunta
 3. Los lee completos con `Read`
 4. Si necesita buscar un término concreto, usa `Grep`

fs-dev/skills/document-expert/SKILL.md

@@ -34,7 +34,7 @@ Tarea: [descripción exacta de lo que necesita el usuario]
 ```
 
 El agente:
-1. Consulta la documentación en `./agents/docs/` (calculator, facturas-api, diagramas-de-tablas)
+1. Consulta la documentación en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` (calculator, facturas-api, diagramas-de-tablas)
 2. Analiza el código fuente del core: BusinessDocument, Calculator, SalesModInterface
 3. Implementa la personalización de documentos requerida
 4. Crea los archivos necesarios (CalculatorMod, Mods de interfaz, registro en Init.php)

fs-dev/skills/extension-developer/SKILL.md

@@ -35,7 +35,7 @@ Tarea: [descripción exacta de qué se quiere extender y cómo]
 ```
 
 El agente:
-1. Consulta la documentación de extensiones en `./agents/docs/`
+1. Consulta la documentación de extensiones en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`
 2. Analiza la clase/vista objetivo para identificar hooks disponibles
 3. Determina el tipo de extensión necesario (PHP, XMLView, Table, Twig, Mod)
 4. Implementa la extensión siguiendo las convenciones

fs-dev/skills/frontend-developer/SKILL.md

@@ -32,7 +32,7 @@ Tarea: [descripción exacta de lo que necesita el usuario]
 ```
 
 El agente:
-1. Consulta la documentación en `./agents/docs/` (vistas HTML, herencia, AssetManager)
+1. Consulta la documentación en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` (vistas HTML, herencia, AssetManager)
 2. Analiza las plantillas existentes del plugin
 3. Implementa la solución frontend siguiendo las convenciones de FacturaScripts
 4. Crea los archivos necesarios (View/*.html.twig, Assets/CSS/, Assets/JS/)

fs-dev/skills/php-expert/SKILL.md

@@ -33,7 +33,7 @@ Tarea: [descripción exacta de lo que necesita el usuario]
 ```
 
 El agente:
-1. Consulta la documentación en `./agents/docs/` (la-clase-tools, profundizando-en-el-core, el-archivo-init-php, gestion-de-errores)
+1. Consulta la documentación en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` (la-clase-tools, profundizando-en-el-core, el-archivo-init-php, gestion-de-errores)
 2. Analiza el código existente del plugin para detectar patrones y problemas
 3. Implementa o refactoriza el código siguiendo las convenciones de FacturaScripts
 4. Verifica calidad con PHPStan y CS-Check

fs-dev/skills/sql-expert/SKILL.md

@@ -33,7 +33,7 @@ Tarea: [descripción exacta de lo que necesita el usuario]
 ```
 
 El agente:
-1. Consulta la documentación en `./agents/docs/` (acceso-a-la-base-de-datos, dbquery, definición de tablas, relaciones, migraciones)
+1. Consulta la documentación en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` (acceso-a-la-base-de-datos, dbquery, definición de tablas, relaciones, migraciones)
 2. Analiza el esquema de tablas existente si es necesario
 3. Implementa la solución siguiendo las convenciones de FacturaScripts
 4. Crea los archivos necesarios (Table XML, migraciones, índices, queries)

fs-dev/skills/testing-expert/SKILL.md

@@ -41,7 +41,7 @@ Tarea: [descripción exacta de lo que necesita el usuario]
 ```
 
 El agente:
-1. Consulta la documentación en `./agents/docs/` (testeo-de-plugins, gestion-de-errores, la-clase-tools)
+1. Consulta la documentación en `${CLAUDE_PLUGIN_ROOT}/agents/docs/` (testeo-de-plugins, gestion-de-errores, la-clase-tools)
 2. Analiza los tests existentes del plugin
 3. Implementa tests o ejecuta herramientas de calidad
 4. Reporta resultados con métricas claras