mustflow 1.15.97

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

@@ -0,0 +1,108 @@
+---
+mustflow_doc: skill.web-asset-optimization
+locale: fr
+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
+
+- La tache correspond aux conditions d'utilisation et ne correspond pas aux exclusions.
+- Les entrees requises sont disponibles, ou les entrees manquantes peuvent etre signalees sans supposition.
+- Les instructions de priorite superieure et `.mustflow/config/commands.toml` ont ete verifiees pour le perimetre actuel.
+
+<!-- mustflow-section: allowed-edits -->
+## Modifications Autorisees
+
+- Garder les modifications dans le perimetre decrit par cette skill, la demande utilisateur et la route correspondante dans `.mustflow/skills/INDEX.md`.
+- Ne pas elargir les permissions de commande, inventer des faits projet ou modifier des fichiers de workflow sans rapport.
+
+<!-- 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
+
+- La sortie attendue peut etre produite avec preuves claires, intentions de commande executees, verifications ignorees et risques restants.
+- Toute intention de commande manquante, entree inconnue ou conflit d'autorite est signale au lieu d'etre cache.
+
+<!-- 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/fr/AGENTS.md

@@ -0,0 +1,84 @@
+---
+mustflow_doc: agents.root
+locale: fr
+canonical: false
+revision: 10
+lifecycle: user-editable
+authority: binding
+---
+
+# AGENTS.md
+
+Ce fichier constitue le premier accord de travail qu’un agent de codage LLM doit lire dans ce dépôt.  
+Ce dépôt suit le flux de travail agent de mustflow.  
+Les détails gérés par mustflow se trouvent dans `.mustflow/`.
+
+## Ordre de lecture
+
+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 présent)  
+6. `.mustflow/skills/INDEX.md`  
+7. `.mustflow/context/INDEX.md` uniquement lorsque la tâche requiert du contexte projet, produit, domaine, interface, backend, données, sécurité ou opérations  
+8. Les fichiers `.mustflow/context/<name>.md` correspondants, uniquement s’ils sont sélectionnés par l’index de contexte  
+9. Le fichier `.mustflow/skills/<name>/SKILL.md` correspondant  
+10. `REPO_MAP.md` uniquement si une navigation plus large dans le dépôt est nécessaire  
+11. Les fichiers source, de test et de documentation pertinents  
+
+## Règles principales
+
+- Ne pas annuler les modifications utilisateur déjà présentes.  
+- Ne pas déduire les commandes à partir des fichiers de gestionnaire de paquets.  
+- Exécuter uniquement les définitions de commande dont `status` est `configured`, `lifecycle` est `oneshot` et `run_policy` est `agent_allowed`.  
+- Préférer `mf run <intent>` pour les commandes oneshot configurées.  
+- Exécuter les intentions de commande `mf run` en série. Ne pas lancer un autre `mf run` tant qu’une intention configurée est encore en cours, surtout si elle déclare des `writes` non vides comme `dist/`.  
+- Choisir l’intention de vérification configurée la plus ciblée qui couvre le risque. Préférer les tests liés ou les contrôles rapides aux suites larges quand le contrat de commandes les expose, et signaler les intentions plus ciblées manquantes plutôt que d’utiliser silencieusement des tests complets et lents.  
+- Ne pas lancer directement de serveurs de développement, de modes watch, d’interfaces navigateur, d’invites interactives ou de processus en arrière-plan.  
+- Ne pas lancer de boucles autonomes, de processus worker, de systèmes de persona ni de processus harness longue durée, sauf si ce dépôt les configure explicitement.  
+- Suivre `[budget]`, `[approval]` et `[isolation]` dans `.mustflow/config/mustflow.toml` lorsqu’une tâche peut durer longtemps ou toucher un état sensible.  
+- Utiliser `mf doctor` ou `mf doctor --json` pour un contrôle de santé en lecture seule avant des changements importants.  
+- `mf context --json` peut aider pour une orientation lisible par machine, mais ne remplace pas les règles ni la spécification des commandes.  
+- Les préférences dans `.mustflow/config/preferences.toml` ont une priorité plus faible que les instructions utilisateur directes et que le style existant du projet.  
+- Quand le code, les modèles, les schémas, le comportement CLI, les métadonnées du paquet, la documentation visible par l’utilisateur, la sortie d’installation ou les tests changent, vérifier `[release.versioning]` dans `.mustflow/config/preferences.toml` avant le rapport final.  
+  Les fichiers de version ne peuvent être modifiés que selon ces préférences : appliquer un changement automatique quand `auto_bump = true` et `require_user_confirmation = false` ; sinon, suggérer le changement ou demander confirmation avant modification selon la configuration. Ne pas supposer que la source de version est `package.json` ; localiser la source de version propre au dépôt avant de suggérer ou d’éditer des versions.  
+- Les fichiers de contexte dans `.mustflow/context/` expliquent la direction du projet et les conventions du domaine. Les considérer comme un contexte spécifique à la tâche, pas comme un remplacement du code, des tests, des commandes ou des instructions utilisateur.  
+- Si `DESIGN.md` existe, le lire uniquement pour des tâches d’interface, de design visuel, de mise en page, de design tokens ou d’accessibilité. Ne pas créer de `DESIGN.md` s’il n’existe pas.  
+- Lire le document de skill correspondant lorsqu’il s’applique à la tâche.  
+- Avant d’éditer, utiliser `.mustflow/skills/INDEX.md` pour décider si une ou plusieurs skills s’appliquent.  
+- Si une skill devient pertinente après une nouvelle preuve, comme un échec de commande ou un changement de documentation, lire le `SKILL.md` correspondant avant de poursuivre cette partie du travail.  
+- Les documents de skill guident la procédure. Ils n’autorisent pas de commandes hors de `.mustflow/config/commands.toml` et ne remplacent pas les règles utilisateur, host, dépôt ou sécurité.  
+- Ne pas modifier les fichiers générés, les dépendances externes ou les fichiers secrets, sauf demande explicite.  
+- Ne pas considérer les répertoires racine `config/`, `docs/` ou `skills/` comme des documents mustflow.  
+
+## Priorité des règles parent et enfant
+
+- Le `AGENTS.md` le plus proche des fichiers modifiés est la règle la plus spécifique.  
+- En cas de conflit entre les règles de flux, de style, de tests ou de commandes, suivre le `AGENTS.md` du dépôt enfant et `.mustflow/config/commands.toml`.  
+- Les règles de sécurité sur les secrets, la vie privée, les commandes destructrices et les chemins d’édition autorisés sont cumulatives. Appliquer la règle la plus stricte.  
+- Lors de la navigation vers un dépôt imbriqué, relire le `AGENTS.md` de ce dépôt et `.mustflow/config/*.toml` avant d’éditer.  
+- Ne pas éditer en dehors du dépôt enfant sélectionné, sauf demande explicite.  
+
+## Compatibilité avec les instructions du host
+
+Certains hosts de codage peuvent lire des fichiers d’instructions propres au host ou appliquer leurs propres politiques d’approbation, de sandbox, de checkpoint et d’exécution de commandes.  
+
+Traiter ces politiques du host comme des contraintes de sécurité et d’exécution additionnelles. Elles ne remplacent pas le contrat de commandes mustflow de ce dépôt. Quand les instructions du host entrent en conflit avec les règles mustflow :  
+
+- Les instructions directes de l’utilisateur définissent l’objectif de la tâche sauf si elles sont dangereuses.  
+- Les contrôles de sécurité et d’approbation du host restent obligatoires.  
+- Les règles de travail du dépôt viennent du `AGENTS.md` le plus proche et de `.mustflow/config/*.toml`.  
+- Les commandes de vérification du projet doivent utiliser des intents mustflow configurés.  
+- La règle la plus stricte sur la vie privée, les secrets, les commandes destructrices et Git push l’emporte.  
+- L’état généré, les résumés et les caches ne remplacent jamais les fichiers actuels ni les instructions utilisateur actuelles.  
+
+Si la règle effective n’est pas claire, s’arrêter et signaler le conflit plutôt que de deviner.  
+
+## Points de contrôle de rafraîchissement des instructions
+
+- Dans les longues sessions, relire les instructions mustflow avant la première édition, avant l’exécution de commandes lorsque l’intention de commande actuelle n’a pas déjà un rafraîchissement récent, après la compaction de contexte, après modification de `AGENTS.md` ou `.mustflow/**`, après changement de racine de projet, et avant d’écrire le rapport final.  
+- Utiliser la politique `[refresh]` dans `.mustflow/config/mustflow.toml` pour décider si un rafraîchissement léger, commande, skill ou complet est nécessaire.  
+- Ne pas stocker le nombre de tours de conversation ni l’activité de session dans les fichiers du projet. L’état de rafraîchissement de session doit rester dans le cache local ou dans l’application hôte.  
+
+Le flux détaillé, la politique de commandes, la gestion des échecs et les règles de sécurité se trouvent dans `.mustflow/docs/agent-workflow.md`.

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

@@ -0,0 +1,39 @@
+---
+mustflow_doc: context.index
+kind: mustflow-context
+locale: hi
+canonical: false
+revision: 1
+lifecycle: mustflow-owned
+name: context-index
+authority: router
+stability: medium
+review_status: needs_human_review
+---
+
+# संदर्भ सूचकांक
+
+यह फ़ाइल देखें ताकि यह निर्धारित किया जा सके कि वर्तमान कार्य के लिए कौन-सी परियोजना संदर्भ फ़ाइलें प्रासंगिक हैं।  
+डिफ़ॉल्ट रूप से सभी संदर्भ फ़ाइलें न पढ़ें, ताकि अनावश्यक शोर कम हो।
+
+## उपलब्ध संदर्भ
+
+| संदर्भ | कब उपयोग करें | पथ |
+| --- | --- | --- |
+| project | जब कार्य से परियोजना की दिशा, दायरा, सार्वजनिक व्यवहार, non-goals, या रिपॉजिटरी-स्तरीय परंपराएं प्रभावित हो सकती हों। | `.mustflow/context/PROJECT.md` |
+
+## वैकल्पिक बाहरी संदर्भ
+
+| एंकर | कब उपयोग करें | पथ |
+| --- | --- | --- |
+| human overview | जब सार्वजनिक परियोजना अवलोकन या स्थापना मार्गदर्शिका चाहिए। इसे अनिवार्य नीति नहीं, सामान्य संदर्भ मानें। | `README.md` |
+| roadmap | जब परियोजना योजना, प्राथमिकताएँ, माइलस्टोन, या non-goals संदर्भ चाहिए। इसे इंस्टॉल की गई mustflow नीति नहीं, योजना संदर्भ मानें। | `ROADMAP.md` |
+| visual design | जब कार्य में UI, दृश्य पहचान, design tokens, लेआउट, या अभिगम्यता से संबंधित बदलाव हों। | `DESIGN.md` |
+
+## पढ़ने के नियम
+
+- केवल वही संदर्भ फ़ाइलें पढ़ें जो वर्तमान कार्य के लिए प्रासंगिक हों।  
+- संदर्भ फ़ाइलों को मार्गदर्शन के रूप में मानें, जब तक कि स्पष्ट रूप से अधिक प्रामाणिक स्रोत से समर्थित न बताया गया हो।  
+- यदि संदर्भों में टकराव कोड, परीक्षण, कमांड विनिर्देशन, या स्पष्ट उपयोगकर्ता निर्देशों से हो, तो टकराव रिपोर्ट करें और अधिक प्रामाणिक स्रोत को प्राथमिकता दें।  
+- अनुपस्थित परियोजना लक्ष्य, non-goals, design tokens, API contracts, या डेटा नियमों का अनुमान न लगाएं और न बनाएँ।  
+- `DESIGN.md` के design tokens को `.mustflow/context/` में दोहराएँ नहीं।

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

@@ -0,0 +1,65 @@
+---
+mustflow_doc: context.project
+kind: mustflow-context
+locale: hi
+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
+---
+
+# परियोजना संदर्भ
+
+यह फ़ाइल कोडिंग एजेंटों के लिए परियोजना-विशिष्ट संदर्भ प्रदान करती है।  
+यदि कोई फ़ील्ड अज्ञात हो तो उसे खाली छोड़ें; विवरण का अनुमान न लगाएँ और न ही निर्माण करें।
+
+## अधिकार सीमाएँ
+
+- यह फ़ाइल समर्थित संदर्भ, अज्ञात बातें और टकराव दर्ज कर सकती है।  
+- इसे कमांड चलाने की अनुमति नहीं देनी चाहिए, न ही फ़ाइल-संपादन निषेध परिभाषित करना चाहिए,  
+  `AGENTS.md` या `.mustflow/config/*.toml` को ओवरराइड नहीं करना चाहिए, और न ही वर्तमान स्रोतों से समर्थित न होने वाली सुविधाओं का वादा करना चाहिए।  
+- टिकाऊ संचालन नियमों को यहाँ रखने के बजाय `AGENTS.md`,  
+  `.mustflow/docs/agent-workflow.md` या संबंधित कॉन्फ़िगरेशन फ़ाइलों में रखें।
+
+## वर्तमान लक्ष्य
+
+निर्धारित नहीं। परियोजना स्वामी द्वारा उपलब्ध कराए जाने पर इसे वर्तमान परियोजना लक्ष्य से अपडेट करें।
+
+## गैर-लक्ष्य
+
+निर्धारित नहीं। उन क्षेत्रों या उद्देश्यों की सूची दें जिन्हें एजेंट को असंबंधित कार्यों में शामिल नहीं करना चाहिए।
+
+## मुख्य वादे
+
+- अनिवार्य संचालन नियमों के लिए `AGENTS.md` का पालन करें।  
+- कमांड के लिए `.mustflow/config/commands.toml` को सत्य का प्रमुख स्रोत मानें।  
+- कार्यप्रवाह और दस्तावेज़ सीमाओं के लिए `.mustflow/config/mustflow.toml` को सत्य का प्रमुख स्रोत मानें।  
+- व्यापक रिपॉजिटरी अवलोकन की आवश्यकता होने पर `REPO_MAP.md` को सतही नेविगेशन मानचित्र के रूप में उपयोग करें।
+
+## डोमेन शब्द
+
+निर्धारित नहीं। केवल वे शब्द जोड़ें जो कार्यान्वयन निर्णयों को प्रभावित करते हों।
+
+## अतिरिक्त सावधानी वाले क्षेत्र
+
+निर्धारित नहीं। उन पाथ्स, सार्वजनिक API, जनरेटेड फ़ाइलें, माइग्रेशन, सीक्रेट्स, या संगतता सतहों की सूची दें जिन पर विशेष ध्यान आवश्यक हो।
+
+## आगे पढ़ें
+
+- `AGENTS.md`  
+- `.mustflow/docs/agent-workflow.md`  
+- `.mustflow/config/mustflow.toml`  
+- `.mustflow/config/commands.toml`  
+- `.mustflow/skills/INDEX.md`
+
+## अप्रचलन जांच
+
+- यदि इस फ़ाइल का टकराव वर्तमान कोड, परीक्षण, कमांड अनुबंध, या उपयोगकर्ता निर्देशों से हो, तो इसे अप्रचलित मानें और टकराव रिपोर्ट करें।  
+- इस फ़ाइल को केवल तब अपडेट करें जब परियोजना दिशा, गैर-लक्ष्य, या रिपॉजिटरी-व्यापी वादे वास्तव में बदलें।