mustflow 1.15.97

package/templates/default/locales/es/.mustflow/skills/web-asset-optimization/SKILL.md

@@ -0,0 +1,108 @@
+---
+mustflow_doc: skill.web-asset-optimization
+locale: es
+canonical: false
+revision: 2
+lifecycle: mustflow-owned
+authority: procedure
+name: web-asset-optimization
+description: Apply this skill when adding, converting, resizing, replacing, or reviewing raster image assets for websites or web applications.
+metadata:
+  mustflow_schema: "1"
+  mustflow_kind: procedure
+  pack_id: mustflow.core
+  skill_id: mustflow.core.web-asset-optimization
+  command_intents:
+    - asset_optimize
+    - build
+---
+
+# Web Asset Optimization
+
+<!-- mustflow-section: purpose -->
+## Purpose
+
+Keep web image assets small, format-appropriate, and correctly referenced without inventing an image pipeline for the project.
+
+<!-- mustflow-section: use-when -->
+## Use When
+
+- A generated PNG, JPEG, WebP, AVIF, GIF, or other raster image is added to a website or web app.
+- An existing web image is replaced, resized, compressed, or converted.
+- A page, component, stylesheet, or metadata file changes image references.
+- A user asks to reduce image size, convert to WebP or AVIF, or prepare generated images for production use.
+
+<!-- mustflow-section: do-not-use-when -->
+## Do Not Use When
+
+- The asset is a vector source such as SVG, icon font, or design-token file.
+- The image is an archival, print, source, or evidence artifact where preserving the original bytes matters more than web delivery size.
+- The repository already has a more specific media, design-system, or framework asset procedure.
+- The task is only to generate a new image and not to install or reference it in the repository.
+
+<!-- mustflow-section: required-inputs -->
+## Required Inputs
+
+- The image file paths and their current or intended references.
+- The expected display size, transparency needs, animation needs, and quality requirements.
+- Existing framework image conventions, static asset folders, and import style.
+- `.mustflow/config/commands.toml` entries for `asset_optimize` and `build`.
+
+<!-- mustflow-section: preconditions -->
+## Preconditions
+
+- The task matches the Use When conditions and does not match the Do Not Use When exclusions.
+- Required inputs are available, or missing inputs can be reported without guessing.
+- Higher-priority instructions and `.mustflow/config/commands.toml` have been checked for the current scope.
+
+<!-- mustflow-section: allowed-edits -->
+## Allowed Edits
+
+- Keep edits within the scope described by this skill, the user request, and the matching route in `.mustflow/skills/INDEX.md`.
+- Do not broaden command permission, invent project facts, or change unrelated workflow files.
+
+<!-- mustflow-section: procedure -->
+## Procedure
+
+1. Identify every changed image asset and every page, component, style, metadata, or manifest reference that depends on it.
+2. Check the original file size, dimensions, format, transparency, and animation before changing the asset.
+3. Prefer the repository's existing image pipeline, framework image component, or configured `asset_optimize` intent when one exists.
+4. Do not add a new dependency, online service, or ad hoc conversion tool unless the user explicitly approves it or the repository already uses it.
+5. Choose the output format based on actual needs: WebP or AVIF for most photographic and generated bitmap website assets, PNG when lossless transparency or exact pixels matter, and SVG only for real vector artwork.
+6. Keep source and derived assets separate when the repository already has that convention. Otherwise, avoid adding duplicate originals unless future editing requires them.
+7. Update imports, static paths, metadata references, dimensions, and cache-sensitive filenames according to the local style.
+8. Compare before and after file sizes and note any quality, transparency, animation, browser-support, or fallback tradeoff.
+
+<!-- mustflow-section: postconditions -->
+## Postconditions
+
+- The expected output can be produced with clear evidence, executed command intents, skipped checks, and remaining risks.
+- Any missing command intent, unknown input, or authority conflict is reported instead of hidden.
+
+<!-- mustflow-section: verification -->
+## Verification
+
+Use configured oneshot command intents when available:
+
+- `asset_optimize`
+- `build`
+
+Do not infer missing image optimization commands. If `asset_optimize` is unknown, missing, manual-only, or not agent-runnable, report that status and describe the intended optimization without executing an unconfigured tool.
+
+<!-- mustflow-section: failure-handling -->
+## Failure Handling
+
+- If optimization visibly degrades the image or breaks transparency, restore or keep the better asset and report the tradeoff.
+- If image references break, fix the nearest import, path, metadata, or build configuration that owns the reference.
+- If the repository lacks an optimization command, propose the smallest project-specific command intent instead of running an external website or guessed package command.
+- If the build fails after asset changes, investigate the first asset-related failure before touching unrelated code.
+
+<!-- mustflow-section: output-format -->
+## Output Format
+
+- Images reviewed or changed
+- Format and size changes
+- References updated
+- Command intents run
+- Skipped command intents and reasons
+- Remaining image quality or browser-support risks

package/templates/default/locales/es/AGENTS.md

@@ -0,0 +1,83 @@
+---
+mustflow_doc: agents.root
+locale: es
+canonical: false
+revision: 10
+lifecycle: user-editable
+authority: binding
+---
+
+# AGENTS.md
+
+Este archivo es el primer acuerdo de trabajo que debe leer un agente de codificación con LLM en este repositorio.  
+Este repositorio sigue el flujo de trabajo de agentes de mustflow.  
+Los detalles gestionados por mustflow se encuentran en `.mustflow/`.
+
+## Orden de Lectura
+
+1. `AGENTS.md`  
+2. `.mustflow/docs/agent-workflow.md`  
+3. `.mustflow/config/mustflow.toml`  
+4. `.mustflow/config/commands.toml`  
+5. `.mustflow/config/preferences.toml` si existe  
+6. `.mustflow/skills/INDEX.md`  
+7. `.mustflow/context/INDEX.md` solo cuando la tarea requiera contexto de proyecto, producto, dominio, interfaz, backend, datos, seguridad u operaciones  
+8. Los archivos `.mustflow/context/<name>.md` correspondientes, solo si el índice de contexto los selecciona  
+9. El archivo `.mustflow/skills/<name>/SKILL.md` correspondiente  
+10. `REPO_MAP.md` solo cuando se necesite una navegación más amplia del repositorio  
+11. Archivos relevantes de código fuente, pruebas y documentación  
+
+## Reglas Principales
+
+- No reviertas cambios previos realizados por el usuario.  
+- No infieras comandos a partir de archivos del gestor de paquetes.  
+- Ejecuta únicamente definiciones de comandos cuyo `status` sea `configured`, cuyo `lifecycle` sea `oneshot` y cuyo `run_policy` sea `agent_allowed`.  
+- Prefiere `mf run <intent>` para comandos oneshot configurados.  
+- Ejecuta los intents de comando de `mf run` en serie. No inicies otro `mf run` mientras una intención configurada esté en ejecución, especialmente si declara `writes` no vacíos como `dist/`.  
+- Elige la intención de verificación configurada más específica que cubra el riesgo. Prioriza pruebas relacionadas o comprobaciones rápidas sobre suites amplias cuando el contrato de comandos las exponga, e informa las intenciones más específicas ausentes en lugar de usar silenciosamente pruebas completas lentas.  
+- No inicies directamente servidores de desarrollo, modos watch, interfaces de navegador, entradas interactivas ni procesos en segundo plano.  
+- No inicies bucles autónomos, procesos worker, sistemas de personas ni procesos de harness de larga duración, salvo que este repositorio los configure explícitamente.  
+- Sigue `[budget]`, `[approval]` y `[isolation]` en `.mustflow/config/mustflow.toml` cuando una tarea pueda ejecutarse por mucho tiempo o afectar estado sensible.  
+- Usa `mf doctor` o `mf doctor --json` para una revisión de salud de solo lectura antes de cambios amplios.  
+- `mf context --json` puede ayudar con orientación legible por máquina, pero no reemplaza las reglas ni la especificación de comandos.  
+- Las preferencias en `.mustflow/config/preferences.toml` tienen menor prioridad que las instrucciones directas del usuario y el estilo existente del proyecto.  
+- Cuando cambies código, plantillas, esquemas, comportamiento de CLI, metadatos de paquete, documentación visible para usuarios, salida de instalación o pruebas, revisa `[release.versioning]` en `.mustflow/config/preferences.toml` antes del informe final. Los archivos de versión solo pueden modificarse según esas preferencias: aplica el aumento automático cuando `auto_bump = true` y `require_user_confirmation = false`; en caso contrario, sugiere el aumento o pide confirmación antes de editar según la configuración. No asumas que la fuente de versión es `package.json`; localiza la fuente propia del repositorio antes de sugerir o editar versiones.  
+- Los archivos de contexto en `.mustflow/context/` explican la dirección del proyecto y las convenciones del dominio. Trátalos como contexto específico de la tarea, no como sustituto de código, pruebas, comandos o instrucciones del usuario.  
+- Si existe `DESIGN.md`, léelo solo para tareas de interfaz, diseño visual, maquetación, tokens de diseño o accesibilidad. No crees un `DESIGN.md` si no existe.  
+- Lee el documento de skill correspondiente cuando aplique a la tarea.  
+- Antes de editar, usa `.mustflow/skills/INDEX.md` para decidir si una o varias skills aplican.  
+- Si una skill se vuelve relevante por nueva evidencia, como un fallo de comando o un cambio de documentación, lee el `SKILL.md` correspondiente antes de continuar esa parte del trabajo.  
+- Los documentos de skill guían el procedimiento. No autorizan comandos fuera de `.mustflow/config/commands.toml` ni reemplazan reglas de usuario, host, repositorio o seguridad.  
+- No modifiques archivos generados, dependencias externas ni archivos de secretos salvo solicitud explícita.  
+- No trates los directorios raíz `config/`, `docs/` o `skills/` como documentos de mustflow.  
+
+## Prioridad de Reglas Padre e Hijo
+
+- El `AGENTS.md` más cercano a los archivos editados es la regla más específica.  
+- Si hay conflicto entre reglas de flujo, estilo, pruebas o comandos, sigue el `AGENTS.md` del repositorio hijo y `.mustflow/config/commands.toml`.  
+- Las reglas de seguridad sobre secretos, privacidad, comandos destructivos y rutas permitidas de edición son acumulativas. Aplica la regla más estricta.  
+- Al entrar en un repositorio anidado, vuelve a leer su `AGENTS.md` y `.mustflow/config/*.toml` antes de editar.  
+- No edites fuera del repositorio hijo seleccionado salvo solicitud explícita.  
+
+## Compatibilidad con Instrucciones del Host
+
+Algunos hosts de codificación pueden leer archivos de instrucciones propios o aplicar sus propias políticas de aprobación, sandbox, checkpoint y ejecución de comandos.  
+
+Trata esas políticas del host como restricciones adicionales de seguridad y ejecución. No sustituyen el contrato de comandos de mustflow de este repositorio. Cuando las instrucciones del host entren en conflicto con las reglas de mustflow:  
+
+- Las instrucciones directas del usuario definen el objetivo de la tarea salvo que sean inseguras.  
+- Las puertas de seguridad y aprobación del host siguen siendo obligatorias.  
+- Las reglas de trabajo del repositorio vienen del `AGENTS.md` más cercano y de `.mustflow/config/*.toml`.  
+- Los comandos de verificación del proyecto deben usar intents configurados de mustflow.  
+- Vence la regla más estricta sobre privacidad, secretos, comandos destructivos y Git push.  
+- El estado generado, los resúmenes y las cachés nunca sustituyen archivos actuales ni instrucciones actuales del usuario.  
+
+Si la regla efectiva no está clara, detente e informa el conflicto en lugar de adivinar.  
+
+## Puntos de Control para Refrescar Instrucciones
+
+- En sesiones largas, vuelve a leer las instrucciones de mustflow antes de la primera edición, antes de ejecutar comandos cuando la intención de comando actual no tenga un refresco reciente, después de la compactación de contexto, tras cambiar `AGENTS.md` o `.mustflow/**`, después de cambiar de raíz de proyecto y antes de escribir el informe final.  
+- Usa la política `[refresh]` en `.mustflow/config/mustflow.toml` para decidir si hace falta un refresco ligero, de comandos, de skills o completo.  
+- No guardes contadores de turnos de conversación ni actividad de sesión en archivos del proyecto. El estado de refresco de la sesión debe vivir en caché local o en la aplicación host.  
+
+El flujo detallado, la política de comandos, el manejo de fallos y las reglas de seguridad están en `.mustflow/docs/agent-workflow.md`.

package/templates/default/locales/fr/.mustflow/context/INDEX.md

@@ -0,0 +1,39 @@
+---
+mustflow_doc: context.index
+kind: mustflow-context
+locale: fr
+canonical: false
+revision: 1
+lifecycle: mustflow-owned
+name: context-index
+authority: router
+stability: medium
+review_status: needs_human_review
+---
+
+# Index de Contexte
+
+Consultez ce fichier pour identifier les fichiers de contexte projet pertinents pour la tâche en cours.  
+Évitez de lire tous les fichiers de contexte par défaut afin de limiter le bruit.
+
+## Contexte Disponible
+
+| Contexte | Utiliser quand | Chemin |
+| --- | --- | --- |
+| project | La tâche peut impacter l’orientation du projet, le périmètre, le comportement public, les non-objectifs ou les conventions du dépôt. | `.mustflow/context/PROJECT.md` |
+
+## Références Externes Optionnelles
+
+| Ancre | Utiliser quand | Chemin |
+| --- | --- | --- |
+| vue humaine | Une vue publique du projet ou un guide d’installation est nécessaire. À considérer comme un contexte général plutôt qu’une politique obligatoire. | `README.md` |
+| roadmap | Un contexte de planification, de priorités, de jalons ou de non-objectifs du projet est nécessaire. À considérer comme un contexte de planification plutôt qu’une politique Mustflow installée. | `ROADMAP.md` |
+| design visuel | La tâche implique des changements d’interface, d’identité visuelle, de design tokens, de mise en page ou d’accessibilité. | `DESIGN.md` |
+
+## Règles de Lecture
+
+- Consultez uniquement les fichiers de contexte pertinents pour la tâche en cours.  
+- Traitez les fichiers de contexte comme des indications, sauf si une source plus autoritaire est explicitement indiquée.  
+- En cas de conflit entre le contexte et le code, les tests, les spécifications de commandes ou les instructions explicites de l’utilisateur, signalez le conflit et référez-vous à la source la plus autoritaire.  
+- Ne supposez pas et ne créez pas les objectifs manquants du projet, les non-objectifs, les design tokens, les contrats d’API ou les règles de données.  
+- Ne dupliquez pas les design tokens de `DESIGN.md` dans `.mustflow/context/`.

package/templates/default/locales/fr/.mustflow/context/PROJECT.md

@@ -0,0 +1,63 @@
+---
+mustflow_doc: context.project
+kind: mustflow-context
+locale: fr
+canonical: false
+revision: 1
+lifecycle: user-editable
+name: project
+authority: contextual
+stability: medium
+review_status: needs_human_review
+source_refs:
+  - AGENTS.md
+  - .mustflow/config/mustflow.toml
+  - .mustflow/config/commands.toml
+---
+
+# Contexte du Projet
+
+Ce fichier décrit le contexte spécifique du projet destiné aux agents de codage.  
+Si un champ est inconnu, laissez-le vide ; ne supposez rien et n’inventez aucun détail.
+
+## Limites d’Autorité
+
+- Ce fichier peut consigner le contexte confirmé, les inconnues et les conflits.  
+- Il ne doit pas autoriser l’exécution de commandes, définir des interdictions de modification de fichiers, remplacer `AGENTS.md` ou `.mustflow/config/*.toml`, ni promettre des fonctionnalités non appuyées par les sources actuelles.  
+- Placez les règles opérationnelles durables dans `AGENTS.md`, `.mustflow/docs/agent-workflow.md` ou dans le fichier de configuration approprié, plutôt que dans ce document.
+
+## Objectif Actuel
+
+Non défini. Remplacez ce champ par l’objectif actuel du projet dès que le propriétaire le fournit.
+
+## Non-Objectifs
+
+Non défini. Listez ici les domaines ou objectifs que l’agent ne doit pas poursuivre dans le cadre des tâches non liées.
+
+## Promesses Principales
+
+- Respecter `AGENTS.md` pour les règles opératoires obligatoires.  
+- Considérer `.mustflow/config/commands.toml` comme la source de vérité pour les commandes.  
+- Considérer `.mustflow/config/mustflow.toml` comme la source de vérité pour les limites des flux de travail et des documents.  
+- Utiliser `REPO_MAP.md` comme carte de navigation de surface lorsqu’une vue plus large du dépôt est nécessaire.
+
+## Termes du Domaine
+
+Non défini. Ajoutez uniquement les termes qui influencent les décisions d’implémentation.
+
+## Zones de Vigilance Supplémentaires
+
+Non défini. Listez ici les chemins, API publiques, fichiers générés, migrations, secrets ou surfaces de compatibilité nécessitant une attention particulière.
+
+## À Lire Ensuite
+
+- `AGENTS.md`  
+- `.mustflow/docs/agent-workflow.md`  
+- `.mustflow/config/mustflow.toml`  
+- `.mustflow/config/commands.toml`  
+- `.mustflow/skills/INDEX.md`
+
+## Vérification d’Obsolescence
+
+- Si ce fichier entre en conflit avec le code actuel, les tests, les contrats de commandes ou les instructions utilisateur, considérez-le comme obsolète et signalez le conflit.  
+- Mettez à jour ce fichier uniquement lorsque la direction du projet, les non-objectifs ou les promesses à l’échelle du dépôt évoluent réellement.