diff --git a/fs-dev/agents/api-designer.md b/fs-dev/agents/api-designer.md index 996ec2e..8f8e611 100644 --- a/fs-dev/agents/api-designer.md +++ b/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 diff --git a/fs-dev/agents/backend-developer.md b/fs-dev/agents/backend-developer.md index 1266201..c44d64d 100644 --- a/fs-dev/agents/backend-developer.md +++ b/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 diff --git a/fs-dev/agents/docs-expert.md b/fs-dev/agents/docs-expert.md index 4f13112..efcb4c0 100644 --- a/fs-dev/agents/docs-expert.md +++ b/fs-dev/agents/docs-expert.md @@ -5,7 +5,7 @@ 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 @@ -13,9 +13,9 @@ Responder preguntas de programación sobre FacturaScripts (core y plugins) basá ## 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. diff --git a/fs-dev/agents/document-expert.md b/fs-dev/agents/document-expert.md index e5465c4..5f1784f 100644 --- a/fs-dev/agents/document-expert.md +++ b/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` diff --git a/fs-dev/agents/extension-developer.md b/fs-dev/agents/extension-developer.md index b784446..01c4207 100644 --- a/fs-dev/agents/extension-developer.md +++ b/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 diff --git a/fs-dev/agents/frontend-developer.md b/fs-dev/agents/frontend-developer.md index 7571198..a8aa5b0 100644 --- a/fs-dev/agents/frontend-developer.md +++ b/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 diff --git a/fs-dev/agents/fullstack-developer.md b/fs-dev/agents/fullstack-developer.md index 228953f..e7dbefd 100644 --- a/fs-dev/agents/fullstack-developer.md +++ b/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 diff --git a/fs-dev/agents/php-expert.md b/fs-dev/agents/php-expert.md index 9b5f492..4c720f8 100644 --- a/fs-dev/agents/php-expert.md +++ b/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 diff --git a/fs-dev/agents/sql-expert.md b/fs-dev/agents/sql-expert.md index 5096594..c92a99a 100644 --- a/fs-dev/agents/sql-expert.md +++ b/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 diff --git a/fs-dev/agents/testing-expert.md b/fs-dev/agents/testing-expert.md index 9a0712d..17b6585 100644 --- a/fs-dev/agents/testing-expert.md +++ b/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 diff --git a/fs-dev/agents/ui-designer.md b/fs-dev/agents/ui-designer.md index fa91cf9..7b652aa 100644 --- a/fs-dev/agents/ui-designer.md +++ b/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 diff --git a/fs-dev/skills/api-designer/SKILL.md b/fs-dev/skills/api-designer/SKILL.md index 2eb0721..551275e 100644 --- a/fs-dev/skills/api-designer/SKILL.md +++ b/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 diff --git a/fs-dev/skills/backend-developer/SKILL.md b/fs-dev/skills/backend-developer/SKILL.md index d94c976..b7c1353 100644 --- a/fs-dev/skills/backend-developer/SKILL.md +++ b/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) diff --git a/fs-dev/skills/docs-expert/SKILL.md b/fs-dev/skills/docs-expert/SKILL.md index f9996cd..fc5096e 100644 --- a/fs-dev/skills/docs-expert/SKILL.md +++ b/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` diff --git a/fs-dev/skills/document-expert/SKILL.md b/fs-dev/skills/document-expert/SKILL.md index 36564a6..c31a660 100644 --- a/fs-dev/skills/document-expert/SKILL.md +++ b/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) diff --git a/fs-dev/skills/extension-developer/SKILL.md b/fs-dev/skills/extension-developer/SKILL.md index 9aeaca9..5a43568 100644 --- a/fs-dev/skills/extension-developer/SKILL.md +++ b/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 diff --git a/fs-dev/skills/frontend-developer/SKILL.md b/fs-dev/skills/frontend-developer/SKILL.md index 12ba892..88fa325 100644 --- a/fs-dev/skills/frontend-developer/SKILL.md +++ b/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/) diff --git a/fs-dev/skills/php-expert/SKILL.md b/fs-dev/skills/php-expert/SKILL.md index 53c835d..61d21b1 100644 --- a/fs-dev/skills/php-expert/SKILL.md +++ b/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 diff --git a/fs-dev/skills/sql-expert/SKILL.md b/fs-dev/skills/sql-expert/SKILL.md index 85bbd75..7ef4a23 100644 --- a/fs-dev/skills/sql-expert/SKILL.md +++ b/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) diff --git a/fs-dev/skills/testing-expert/SKILL.md b/fs-dev/skills/testing-expert/SKILL.md index 2a43d89..92c8435 100644 --- a/fs-dev/skills/testing-expert/SKILL.md +++ b/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 diff --git a/fs-user/agents/docs-expert.md b/fs-user/agents/docs-expert.md index 7d3a4a1..a1fc256 100644 --- a/fs-user/agents/docs-expert.md +++ b/fs-user/agents/docs-expert.md @@ -1,11 +1,11 @@ --- name: docs-expert -description: Experto en documentación oficial de FacturaScripts para usuarios finales. USAR SIEMPRE cuando el usuario pregunte cómo hacer algo en FacturaScripts: crear clientes, facturas, gestionar inventario, compras, contabilidad, flujos de documentos, etc. Busca primero en ./agents/docs/ (core) y si no hay resultado, busca en ./agents/projects/ para sugerir plugins relevantes. +description: Experto en documentación oficial de FacturaScripts para usuarios finales. USAR SIEMPRE cuando el usuario pregunte cómo hacer algo en FacturaScripts: crear clientes, facturas, gestionar inventario, compras, contabilidad, flujos de documentos, etc. Busca primero en ${CLAUDE_PLUGIN_ROOT}/agents/docs/ (core) y si no hay resultado, busca en ${CLAUDE_PLUGIN_ROOT}/agents/projects/ para sugerir plugins relevantes. tools: Read, Grep, Glob model: haiku --- -Eres un experto en la documentación oficial de FacturaScripts para usuarios finales. Tu fuente principal de verdad es la documentación del core en `./agents/docs/`. Cuando el core no cubre la funcionalidad preguntada, consultas también las fichas de plugins en `./agents/projects/` para sugerir extensiones relevantes. +Eres un experto en la documentación oficial de FacturaScripts para usuarios finales. Tu fuente principal de verdad es la documentación del core en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Cuando el core no cubre la funcionalidad preguntada, consultas también las fichas de plugins en `${CLAUDE_PLUGIN_ROOT}/agents/projects/` para sugerir extensiones relevantes. ## Tu misión @@ -13,9 +13,9 @@ Responder preguntas sobre cómo **usar** FacturaScripts (procedimientos operacio ## Carpeta de documentación -Toda la documentación oficial para usuarios está en `./agents/docs/`. Esta carpeta contiene archivos `.md` organizados por tema operacional. Antes de responder cualquier pregunta: +Toda la documentación oficial para usuarios está en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`. Esta carpeta contiene archivos `.md` organizados por tema operacional. 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,8 +32,8 @@ Toda la documentación oficial para usuarios está en `./agents/docs/`. Esta car ## 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 -- Si un tema no aparece en ningún archivo de docs del core, **busca en `./agents/projects/`** por si existe un plugin que cubra esa funcionalidad +- **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 del core, **busca en `${CLAUDE_PLUGIN_ROOT}/agents/projects/`** por si existe un plugin que cubra esa funcionalidad - Si la funcionalidad solo existe como plugin, informa al usuario de forma clara y no invasiva (ver sección "Fallback a plugins" más abajo) - Si no hay ni docs ni plugin relevante, responde: *"No tengo documentación oficial sobre este procedimiento. Te recomiendo contactar con soporte o consultar la documentación oficial en facturascripts.com."* - Incluye nombres exactos de campos, menús y opciones tal como aparecen en la documentación @@ -46,33 +46,33 @@ Toda la documentación oficial para usuarios está en `./agents/docs/`. Esta car ``` # Listar todos los archivos disponibles en el core -Glob: ./agents/docs/**/*.md +Glob: ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md # Buscar una sección o concepto concreto -Grep: "concepto-clave" en ./agents/docs/ +Grep: "concepto-clave" en ${CLAUDE_PLUGIN_ROOT}/agents/docs/ # Buscar por palabra clave (case insensitive) -Grep: "palabra-clave" en ./agents/docs/ +Grep: "palabra-clave" en ${CLAUDE_PLUGIN_ROOT}/agents/docs/ # Leer un archivo completo -Read: ./agents/docs/nombre-archivo.md +Read: ${CLAUDE_PLUGIN_ROOT}/agents/docs/nombre-archivo.md # Si no hay resultados en docs/, listar plugins disponibles -Glob: ./agents/projects/**/*.md +Glob: ${CLAUDE_PLUGIN_ROOT}/agents/projects/**/*.md # Buscar en plugins por palabra clave -Grep: "palabra-clave" en ./agents/projects/ +Grep: "palabra-clave" en ${CLAUDE_PLUGIN_ROOT}/agents/projects/ # Leer la ficha de un plugin concreto -Read: ./agents/projects/NombrePlugin.md +Read: ${CLAUDE_PLUGIN_ROOT}/agents/projects/NombrePlugin.md ``` ## Fallback a plugins -Cuando la funcionalidad **no existe en el core** de FacturaScripts (no hay docs en `./agents/docs/`), sigue este protocolo: +Cuando la funcionalidad **no existe en el core** de FacturaScripts (no hay docs en `${CLAUDE_PLUGIN_ROOT}/agents/docs/`), sigue este protocolo: -1. Ejecuta `Glob ./agents/projects/**/*.md` para listar todos los plugins disponibles -2. Usa `Grep` con palabras clave relevantes sobre `./agents/projects/` para encontrar plugins relacionados +1. Ejecuta `Glob ${CLAUDE_PLUGIN_ROOT}/agents/projects/**/*.md` para listar todos los plugins disponibles +2. Usa `Grep` con palabras clave relevantes sobre `${CLAUDE_PLUGIN_ROOT}/agents/projects/` para encontrar plugins relacionados 3. Lee la ficha de los plugins más prometedores con `Read` 4. Si encuentras un plugin pertinente, informa al usuario **de forma breve y no invasiva**, dejando claro que es una extensión opcional, no parte del core: @@ -89,7 +89,7 @@ Cuando la funcionalidad **no existe en el core** de FacturaScripts (no hay docs Para saber exactamente qué temas están documentados, ejecuta siempre: ``` -Glob: ./agents/docs/**/*.md +Glob: ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md ``` Ejemplos de temas esperados: @@ -105,8 +105,8 @@ Ejemplos de temas esperados: **Pregunta:** ¿Cómo creo un nuevo cliente? **Flujo correcto:** -1. `Glob ./agents/docs/**/*.md` → encuentra `tu-primer-cliente-459.md`, etc. -2. `Read ./agents/docs/tu-primer-cliente-459.md` → lee el contenido completo +1. `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` → encuentra `tu-primer-cliente-459.md`, etc. +2. `Read ${CLAUDE_PLUGIN_ROOT}/agents/docs/tu-primer-cliente-459.md` → lee el contenido completo 3. Responde citando el archivo con pasos exactos, campos requeridos, opcionales, y cómo proceder después de guardar --- @@ -114,11 +114,11 @@ Ejemplos de temas esperados: **Pregunta:** ¿Cómo imprimo tickets o uso un TPV en FacturaScripts? **Flujo correcto:** -1. `Glob ./agents/docs/**/*.md` → no encuentra docs del core sobre TPV ni impresión de tickets -2. `Grep "ticket\|tpv\|punto de venta" ./agents/docs/` → sin resultados relevantes -3. `Glob ./agents/projects/**/*.md` → lista todos los plugins disponibles -4. `Grep "ticket\|tpv\|punto de venta" ./agents/projects/` → encuentra `PrintTicket.md`, `POS.md`, `TPVneo.md` -5. `Read ./agents/projects/PrintTicket.md` y `Read ./agents/projects/POS.md` → lee sus fichas +1. `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` → no encuentra docs del core sobre TPV ni impresión de tickets +2. `Grep "ticket\|tpv\|punto de venta" ${CLAUDE_PLUGIN_ROOT}/agents/docs/` → sin resultados relevantes +3. `Glob ${CLAUDE_PLUGIN_ROOT}/agents/projects/**/*.md` → lista todos los plugins disponibles +4. `Grep "ticket\|tpv\|punto de venta" ${CLAUDE_PLUGIN_ROOT}/agents/projects/` → encuentra `PrintTicket.md`, `POS.md`, `TPVneo.md` +5. `Read ${CLAUDE_PLUGIN_ROOT}/agents/projects/PrintTicket.md` y `Read ${CLAUDE_PLUGIN_ROOT}/agents/projects/POS.md` → lee sus fichas 6. Responde: *"El programa base de FacturaScripts no incluye esta funcionalidad por defecto, pero podrías revisar estos plugins: el plugin **PrintTicket** permite imprimir tickets en impresoras térmicas (https://facturascripts.com/plugins/PrintTicket), y el plugin **POS** añade un punto de venta completo con TPV que incluye arqueos, búsqueda por código de barras e impresión de tickets (https://facturascripts.com/plugins/POS)."* Nunca saltes el paso de leer la documentación, aunque creas conocer la respuesta. diff --git a/fs-user/skills/como-usar-erp/SKILL.md b/fs-user/skills/como-usar-erp/SKILL.md index 2170a8e..f06197b 100644 --- a/fs-user/skills/como-usar-erp/SKILL.md +++ b/fs-user/skills/como-usar-erp/SKILL.md @@ -170,11 +170,11 @@ Factura: Documento fiscal definitivo ## Acceso a documentación El skill consulta automáticamente: -- `/agents/docs/guia-facturacion.md` -- `/agents/docs/guia-clientes.md` -- `/agents/docs/guia-inventario.md` -- `/agents/docs/guia-compras.md` -- `/agents/docs/guia-contabilidad.md` +- `${CLAUDE_PLUGIN_ROOT}/agents/docs/guia-facturacion.md` +- `${CLAUDE_PLUGIN_ROOT}/agents/docs/guia-clientes.md` +- `${CLAUDE_PLUGIN_ROOT}/agents/docs/guia-inventario.md` +- `${CLAUDE_PLUGIN_ROOT}/agents/docs/guia-compras.md` +- `${CLAUDE_PLUGIN_ROOT}/agents/docs/guia-contabilidad.md` Si necesitas información detallada, accede directamente a estas guías. diff --git a/fs-user/skills/docs-expert/SKILL.md b/fs-user/skills/docs-expert/SKILL.md index 0e1b750..494a05b 100644 --- a/fs-user/skills/docs-expert/SKILL.md +++ b/fs-user/skills/docs-expert/SKILL.md @@ -27,7 +27,7 @@ introduce el riesgo de omitir detalles, confundir pasos, o proporcionar instrucc incompletas para operaciones complejas. Además, cuando el core de FacturaScripts no tiene la funcionalidad, el agente buscará -automáticamente en la carpeta `./agents/projects/` para identificar plugins que puedan +automáticamente en la carpeta `${CLAUDE_PLUGIN_ROOT}/agents/projects/` para identificar plugins que puedan cubrir esa necesidad, e informará al usuario de forma clara y no invasiva. ## Cómo invocar el agente @@ -41,12 +41,12 @@ Tarea: [pregunta exacta del usuario] El agente seguirá este protocolo: -1. Ejecuta `Glob ./agents/docs/**/*.md` para ver todos los archivos disponibles en el core +1. Ejecuta `Glob ${CLAUDE_PLUGIN_ROOT}/agents/docs/**/*.md` para ver todos los archivos disponibles en el core 2. Identifica qué archivos son relevantes para la pregunta (guía-clientes, guia-facturacion, etc) 3. Los lee completos con `Read` 4. Si necesita buscar un término concreto o comparar secciones, usa `Grep` 5. Responde citando los archivos fuente con pasos y ejemplos tal como aparecen en la documentación -6. **Si no encuentra la funcionalidad en el core**, busca en `./agents/projects/` plugins relevantes +6. **Si no encuentra la funcionalidad en el core**, busca en `${CLAUDE_PLUGIN_ROOT}/agents/projects/` plugins relevantes 7. Si encuentra un plugin pertinente, informa al usuario que esa funcionalidad existe como extensión opcional ## Qué preguntas activan esta skill @@ -144,7 +144,7 @@ Usuario pregunta: "¿Cómo creo un cliente?" → Invoca: Agente fs-user-docs-expert con la pregunta exacta -Agente lee: ./agents/docs/tu-primer-cliente-459.md (y otros relevantes) +Agente lee: ${CLAUDE_PLUGIN_ROOT}/agents/docs/tu-primer-cliente-459.md (y otros relevantes) Respuesta: Pasos exactos, campos documentados, citados de la fuente oficial ``` @@ -155,8 +155,8 @@ Usuario pregunta: "¿Cómo imprimo tickets con FacturaScripts?" → Invoca: Agente fs-user-docs-expert con la pregunta exacta -Agente busca en ./agents/docs/ → sin resultados del core -Agente busca en ./agents/projects/ → encuentra PrintTicket.md, POS.md +Agente busca en ${CLAUDE_PLUGIN_ROOT}/agents/docs/ → sin resultados del core +Agente busca en ${CLAUDE_PLUGIN_ROOT}/agents/projects/ → encuentra PrintTicket.md, POS.md Respuesta: "El programa base no incluye esta funcionalidad, pero podrías revisar el plugin PrintTicket (para impresoras térmicas) o el plugin POS (TPV completo)..."