npm - mustflow - Versions diffs - 1.18.16 → 1.30.0 - Mend

mustflow 1.18.16 → 1.30.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (303) hide show

package/templates/default/locales/es/.mustflow/skills/visual-review-artifact/assets/review-template.html DELETED Viewed

@@ -1,286 +0,0 @@
-<!doctype html>
-<html lang="en">
-<head>
-  <meta charset="utf-8">
-  <meta name="viewport" content="width=device-width, initial-scale=1">
-  <title>Visual Review Artifact</title>
-  <style>
-    :root {
-      color-scheme: light dark;
-      --bg: #f7f7f4;
-      --fg: #1f2328;
-      --muted: #656d76;
-      --line: #d0d7de;
-      --panel: #ffffff;
-      --accent: #0969da;
-      --approve: #1a7f37;
-      --reject: #cf222e;
-      --discuss: #9a6700;
-    }
-    @media (prefers-color-scheme: dark) {
-      :root {
-        --bg: #0d1117;
-        --fg: #e6edf3;
-        --muted: #8b949e;
-        --line: #30363d;
-        --panel: #161b22;
-        --accent: #58a6ff;
-        --approve: #3fb950;
-        --reject: #ff7b72;
-        --discuss: #d29922;
-      }
-    }
-    * {
-      box-sizing: border-box;
-    }
-    body {
-      margin: 0;
-      background: var(--bg);
-      color: var(--fg);
-      font: 15px/1.5 system-ui, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
-    }
-    main {
-      max-width: 1120px;
-      margin: 0 auto;
-      padding: 24px;
-    }
-    header {
-      display: grid;
-      gap: 8px;
-      padding-block: 8px 20px;
-      border-bottom: 1px solid var(--line);
-    }
-    h1,
-    h2 {
-      margin: 0;
-      line-height: 1.2;
-    }
-    h1 {
-      font-size: 28px;
-    }
-    h2 {
-      font-size: 18px;
-    }
-    p {
-      margin: 0;
-    }
-    .meta,
-    .note {
-      color: var(--muted);
-    }
-    .toolbar {
-      display: flex;
-      flex-wrap: wrap;
-      gap: 8px;
-      margin-block: 18px;
-    }
-    .sections {
-      display: grid;
-      gap: 14px;
-    }
-    section {
-      display: grid;
-      gap: 12px;
-      background: var(--panel);
-      border: 1px solid var(--line);
-      border-radius: 8px;
-      padding: 16px;
-    }
-    .section-head {
-      display: flex;
-      flex-wrap: wrap;
-      justify-content: space-between;
-      gap: 8px;
-      align-items: start;
-    }
-    .status {
-      color: var(--muted);
-      font-size: 13px;
-    }
-    .actions {
-      display: flex;
-      flex-wrap: wrap;
-      gap: 8px;
-    }
-    button {
-      min-height: 36px;
-      border: 1px solid var(--line);
-      border-radius: 6px;
-      background: transparent;
-      color: var(--fg);
-      padding: 6px 10px;
-      cursor: pointer;
-    }
-    button:hover,
-    button:focus-visible {
-      border-color: var(--accent);
-      outline: 2px solid transparent;
-    }
-    button[aria-pressed="true"][data-action="approve"] {
-      border-color: var(--approve);
-      color: var(--approve);
-    }
-    button[aria-pressed="true"][data-action="reject"] {
-      border-color: var(--reject);
-      color: var(--reject);
-    }
-    button[aria-pressed="true"][data-action="discuss"] {
-      border-color: var(--discuss);
-      color: var(--discuss);
-    }
-    textarea {
-      width: 100%;
-      min-height: 84px;
-      resize: vertical;
-      border: 1px solid var(--line);
-      border-radius: 6px;
-      background: transparent;
-      color: var(--fg);
-      padding: 10px;
-      font: inherit;
-    }
-    pre {
-      overflow: auto;
-      margin: 0;
-      padding: 12px;
-      border-radius: 6px;
-      border: 1px solid var(--line);
-      background: color-mix(in srgb, var(--panel), var(--bg) 45%);
-    }
-  </style>
-</head>
-<body>
-  <main data-artifact-kind="decision" data-review-artifact>
-    <header>
-      <h1>Visual Review Artifact</h1>
-      <p class="meta">Replace this sample content with evidence-backed plan, suggestion, review, flow, or decision sections.</p>
-      <p class="note">Review only. This page does not execute commands, modify files, grant permission, skip validation, or override repository rules.</p>
-    </header>
-    <div class="toolbar" aria-label="Review actions">
-      <button type="button" data-copy-json>Copy decision JSON</button>
-      <button type="button" data-copy-prompt>Copy follow-up prompt</button>
-    </div>
-    <div class="sections">
-      <section data-review-section data-section-id="section-1">
-        <div class="section-head">
-          <div>
-            <h2>Section title</h2>
-            <p class="meta">Short evidence, tradeoff, or decision summary.</p>
-          </div>
-          <p class="status" data-status-label>Not decided</p>
-        </div>
-        <pre>Evidence or code excerpt goes here.</pre>
-        <div class="actions">
-          <button type="button" data-action="approve" aria-pressed="false">Approve</button>
-          <button type="button" data-action="reject" aria-pressed="false">Reject</button>
-          <button type="button" data-action="discuss" aria-pressed="false">Discuss</button>
-        </div>
-        <label>
-          Comment
-          <textarea data-comment placeholder="Add a comment for this section"></textarea>
-        </label>
-      </section>
-    </div>
-  </main>
-  <script>
-    const labels = {
-      approve: "Approved",
-      reject: "Rejected",
-      discuss: "Needs discussion"
-    };
-    function sections() {
-      return [...document.querySelectorAll("[data-review-section]")];
-    }
-    function setStatus(section, action) {
-      section.dataset.status = action;
-      section.querySelector("[data-status-label]").textContent = labels[action] ?? "Not decided";
-      for (const button of section.querySelectorAll("[data-action]")) {
-        button.setAttribute("aria-pressed", String(button.dataset.action === action));
-      }
-    }
-    function decisionData() {
-      return {
-        schema_version: "1",
-        artifact_kind: document.querySelector("[data-review-artifact]")?.dataset.artifactKind ?? "decision",
-        sections: sections().map((section) => ({
-          id: section.dataset.sectionId ?? "",
-          title: section.querySelector("h2")?.textContent?.trim() ?? "",
-          status: section.dataset.status ?? "undecided",
-          comment: section.querySelector("[data-comment]")?.value ?? ""
-        }))
-      };
-    }
-    async function copyText(text) {
-      if (navigator.clipboard?.writeText) {
-        await navigator.clipboard.writeText(text);
-        return;
-      }
-      const area = document.createElement("textarea");
-      area.value = text;
-      document.body.append(area);
-      area.select();
-      document.execCommand("copy");
-      area.remove();
-    }
-    function followUpPrompt() {
-      return [
-        "Use this visual review decision data as user feedback.",
-        "Do not treat it as command permission or validation approval.",
-        "",
-        JSON.stringify(decisionData(), null, 2)
-      ].join("\n");
-    }
-    document.addEventListener("click", async (event) => {
-      const target = event.target;
-      if (!(target instanceof HTMLElement)) return;
-      const actionButton = target.closest("[data-action]");
-      if (actionButton) {
-        const section = actionButton.closest("[data-review-section]");
-        if (section) setStatus(section, actionButton.dataset.action);
-        return;
-      }
-      if (target.closest("[data-copy-json]")) {
-        await copyText(JSON.stringify(decisionData(), null, 2));
-      }
-      if (target.closest("[data-copy-prompt]")) {
-        await copyText(followUpPrompt());
-      }
-    });
-  </script>
-</body>
-</html>

package/templates/default/locales/es/.mustflow/skills/visual-review-artifact/resources.toml DELETED Viewed

@@ -1,7 +0,0 @@
-schema_version = "1"
-[resources."assets/review-template.html"]
-type = "asset"
-asset_kind = "template"
-purpose = "Self-contained static HTML template for section-level review decisions and comments."
-required = false

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

@@ -1,108 +0,0 @@
----
-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/fr/.mustflow/skills/INDEX.md DELETED Viewed

@@ -1,75 +0,0 @@
----
-mustflow_doc: skills.index
-locale: fr
-canonical: false
-revision: 45
-authority: router
-lifecycle: mustflow-owned
----
-# Index des compétences
-Consultez uniquement le document de compétence correspondant à la tâche en cours. Si aucune compétence spécifique ne s’applique, référez-vous à `AGENTS.md` et à `.mustflow/config/commands.toml` pour effectuer la modification minimale et sécurisée.
-## Règles de sélection
-- Au démarrage de la tâche et avant la première modification, comparez la demande utilisateur et les fichiers à modifier attendus avec les déclencheurs ci-dessous.
-- Si un ou plusieurs déclencheurs correspondent, lisez chaque fichier `SKILL.md` avant d’éditer ce périmètre.
-- Lorsqu’une compétence est utilisée, ou lorsqu’une compétence plausible est délibérément ignorée, laissez une note concise dans la prochaine mise à jour destinée à l’utilisateur ou dans le rapport final.
-- Si une nouvelle condition apparaît en cours de tâche, comme un échec de commande, un changement de contrat de test ou une modification de documentation, faites une pause et consultez la compétence nouvellement applicable avant de continuer.
-- Si aucun déclencheur ne s’applique, n’inventez pas de compétence. Poursuivez avec `AGENTS.md`, `.mustflow/docs/agent-workflow.md` et `.mustflow/config/commands.toml`.
-- Les documents de compétences ne décrivent que la procédure. Ils n’autorisent pas l’exécution de commandes en dehors des intentions déclarées.
-- Maintenez la table des routes concise : chaque route indique le déclencheur, les entrées requises, le périmètre d’édition, le niveau de risque, les intentions de vérification et les résultats attendus.
-| Déclencheur | Document de compétence | Entrée requise | Portée de la modification | Risque | Intentions de vérification | Résultat attendu |
-| --- | --- | --- | --- | --- | --- | --- |
-| Création, référence ou rapport d’artefacts générés, fichiers empaquetés, ressources binaires, rapports ou fichiers téléchargeables | `.mustflow/skills/artifact-integrity-check/SKILL.md` | Chemins des artefacts, chemin source ou de génération, règles de packaging et attentes sur les artefacts | Références aux artefacts, métadonnées du package, tests et documentation | revendication d’artefact non vérifiée ou obsolète | `changes_status`, `changes_diff_summary`, `test_release`, `build`, `mustflow_check` | Preuves d’artefact, contrôles d’inclusion ou de format, contrôles ignorés et risques d’intégrité |
-| Modifications de code nécessitant une revue avant rapport | `.mustflow/skills/code-review/SKILL.md` | Diff et objectif de la tâche | Fichiers modifiés | comportement et régression | `test`, `test_related`, `test_audit`, `lint` | Résultats ou note d’absence de problème |
-| Refactorisation, réorganisation, renommage, déduplication, simplification ou amélioration structurelle du code tout en conservant le comportement existant | `.mustflow/skills/behavior-preserving-refactor/SKILL.md` | Objectif du refactoring, zone cible, preuves du comportement, motifs locaux, fichiers modifiés actuels et entrées du contrat de commande | Étapes de refactorisation préservant le comportement, tests associés et documentation ou contrats synchronisés directement | modification cachée du comportement, nettoyage étendu, abstraction trompeuse, déduplication non sécurisée ou changement hérité non vérifié | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `docs_validate_fast`, `test_release`, `mustflow_check` | Objectif, preuves du comportement, risques structurels, échelle du refactoring, modifications effectuées, changements de comportement exclus, vérification et risques résiduels |
-| Introduction, revue ou refactorisation d’héritage de classes, classes de base, classes abstraites, méthodes modèles, état protégé, mixins, sous-classes de framework ou hiérarchies de sous-types, notamment pour la réutilisation de comportement ou variantes de fonctionnalités | `.mustflow/skills/composition-over-inheritance/SKILL.md` | Surface d’héritage, objectif de réutilisation, dimensions du changement, motifs locaux de composition, contraintes de compatibilité, fichiers modifiés actuels et entrées du contrat de commande | Classes, fonctions, interfaces de rôle, politiques, stratégies, adaptateurs, décorateurs, machines à états, tests, wrappers et documentation ou templates synchronisés directement | couplage fragile parent-enfant, explosion de sous-classes, substituabilité rompue, état protégé caché, sur-composition ou refactorisation préservant le comportement non testée | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Revue de l’héritage, décision garder ou remplacer, dimensions du changement, motif de composition, tests, vérification et risques hiérarchiques résiduels |
-| Plusieurs algorithmes, politiques, calculs, méthodes de scoring, tri, recommandation, règles de tarification, remises, modes de livraison, paiement, notification, politiques d’autorisation, choix de fournisseurs, variantes de feature-flag ou branches répétées interchangeables déterminant comment effectuer une même tâche | `.mustflow/skills/strategy-pattern/SKILL.md` | Workflow stable, variantes et objectif commun, emplacements actuels des branches, forme commune des entrées et sorties, critères de sélection, motifs locaux Result, injection de dépendances, décorateur, registre et tests, fichiers modifiés actuels et entrées du contrat de commande | Types de fonctions stratégie, interfaces, stratégies concrètes, sélecteurs, résolveurs, registres, décorateurs, câblage de contexte, tests et documentation ou templates synchronisés directement | branche trop abstraite, regroupement inadapté des cas d’usage, contexte connaissant les stratégies concrètes, repli silencieux, stratégie utilisateur non sécurisée, stratégie avec état de requête, explosion de combinaisons de stratégies ou comportement de sélecteur non testé | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Classification des stratégies, contrat partagé, registre des stratégies, sélecteur ou résolveur, comportement par défaut et clés non supportées, tests, vérification et risques résiduels |
-| Intentions utilisateur ou système modifiant l’état, objets de données de commande, gestionnaires de commande, bus de commande, idempotence, autorisation, transactions, événements outbox, journaux d’audit, retries, concurrence, tâches longues ou effets secondaires externes nécessitant une unité d’exécution traçable | `.mustflow/skills/command-pattern/SKILL.md` | Intention utilisateur ou système, frontière source, charge utile, acteur et contexte, ressources affectées, motifs locaux Result, repository, gateway, unité de travail, outbox, idempotence, audit, retry et tests | Charges utiles de commande, contexte de commande, gestionnaires, câblage du bus de commande si justifié, idempotence, outbox, audit, retry, transaction, adaptateurs contrôleur ou worker, tests et documentation ou templates synchronisés directement | surcharge de cérémonie pour les lectures, gestionnaire monolithique, politique métier cachée, effet secondaire dupliqué non sécurisé, couplage transaction-appel externe, absence de piste d’audit, retry sans idempotence ou frontière de commande non testée | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Classification des commandes, forme de la charge utile et du contexte, dépendances des gestionnaires, délégation métier, transaction, outbox, idempotence, retry, audit, choix de concurrence, tests, vérification et risques résiduels de sécurité |
-| Contrôleurs, gestionnaires, workers, services ou événements UI nécessitant un point d’entrée stable et haut niveau sur un sous-système complexe, un workflow multi-étapes répété, de multiples dépendances, services externes, stockage, files, caches, transactions, idempotence, retries, journalisation ou résultats normalisés | `.mustflow/skills/facade-pattern/SKILL.md` | Surface appelante, opération haut niveau, séquence interne répétée, détails de sous-système exposés, dépendances, réponses et erreurs attendues, autorisation, idempotence, retry, transaction, observabilité, sécurité, performance, motifs locaux Result, port, adaptateur, commande et tests | Types de requête, contexte, réponse et erreur de la façade, collaborateurs injectés, orchestration, mappers, normalisateurs d’erreur, idempotence, transactions, retries, événements, invalidation de cache, journalisation, tests et documentation ou templates synchronisés directement | wrapper passe-plat, service monolithique, politique métier cachée, étapes internes publiques, fuite SDK ou ORM, couplage façade-à-façade, façade avec état de requête, retry non sécurisé, appel externe dans une transaction ou orchestration de sous-système non testée | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Classification de la façade, simplification de l’appelant, forme de la requête et du contexte, résultat normalisé, dépendances injectées, règles métier déléguées, choix transaction/idempotence/retry/journalisation, tests, vérification et risques résiduels |
-| Les décisions métier, la validation, l’autorisation, la tarification, l’éligibilité, les transitions d’état, les événements du domaine, les descriptions d’effets ou les calculs sont mélangés avec les bases de données, les gestionnaires HTTP, les dépôts, les appels SDK, les fichiers, les files d’attente, les logs, les métriques, les horloges, l’aléatoire, les lectures d’environnement, les paiements, les emails ou les objets requête/réponse du framework | `.mustflow/skills/pure-core-imperative-shell/SKILL.md` | Actions métier, faits décisionnels, effets secondaires, forme actuelle des frontières, motifs locaux de résultats/événements/effets, preuves de comportement, fichiers modifiés et entrées du contrat de commande | Fonctions décisionnelles centrales, orchestration shell, mappers, types résultat/erreur, événements, descriptions d’effets, tests et documentation ou modèles synchronisés directement | Règles métier cachées dans les E/S, cœur non déterministe, tests fortement mockés, décisions obsolètes, effets secondaires dupliqués, couplage transaction/appels externes ou CRUD trivial surcouché | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Décision isolée, entrée et sortie explicites du cœur, responsabilités du shell, événements ou effets, échecs métier typés, tests, vérification et risque résiduel de logique mixte |
-| Les objets du domaine ont un cycle de vie, des champs d’état ou de statut, des champs de phase ou d’étape, les actions autorisées dépendent de l’état, les transitions sont dispersées, les résultats externes modifient l’état, des événements dupliqués sont possibles, ou les changements d’état nécessitent des tables de transition, des gardes, des effets, un historique, de l’idempotence ou un contrôle de concurrence | `.mustflow/skills/state-machine-pattern/SKILL.md` | Entité, champ d’état, liste d’états, liste d’événements, états terminaux, code actuel modifiant l’état, gardes, faits contextuels, effets, historique, idempotence, risques de concurrence, motifs locaux Result et outbox, et entrées du contrat de commande | Unions d’états, unions d’événements, tables de transition, fonctions garde, fonctions de transition pures, shell de dispatch, outbox, journaux de transition, enregistrements d’idempotence, aides aux actions disponibles, tests et documentation ou modèles synchronisés directement | Affectation directe d’état, transition invalide cachée, no-op silencieux, garde impure, effet externe avant commit, dommage par webhook dupliqué, explosion d’états, transition concurrente obsolète, dérive règle UI/serveur ou cycle de vie non testé | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Classification du cycle de vie, états et événements, table de transition, gardes et faits contextuels, effets et historique, choix d’idempotence et de concurrence, nettoyage d’affectation directe, tests, vérification et risque résiduel de machine à états |
-| Les échecs attendus, absences significatives, retours null ou indéfinis, erreurs métier levées, indicateurs booléens de succès, erreurs sous forme brute de chaîne, recherches en dépôt, validations, parsages, erreurs d’adaptateurs externes ou mappages d’erreurs en frontière nécessitent une gestion explicite basée sur les valeurs | `.mustflow/skills/result-option/SKILL.md` | Sémantique des opérations, cas d’absence et d’échec, conventions locales Result/Option/erreur, propriété des couches, règles de réponse publique, contraintes sur données sensibles, fichiers modifiés et entrées du contrat de commande | Helpers Result et Option, signatures de fonctions, erreurs typées, mappers de frontière, contrats dépôt/service/controlleur, tests et documentation ou modèles synchronisés directement | Null caché, erreur avalée, échec métier levé, résultat booléen ambigu, fuite d’erreur fournisseur, dérive de forme d’erreur publique ou fonction totale sur-emballée | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Décision sur la forme de retour, codes et catégories d’erreurs, gestion des absences, conversions en frontière, préservation des chemins d’exception, tests, vérification et risque résiduel d’exception ou null |
-| Les vérifications répétées de null, undefined, None ou nil, dépendances optionnelles, intégrations désactivées, loggers nuls, analytics nuls, caches nuls, notifications optionnelles, collaborateurs no-op, processeurs identité ou implémentations neutres sûres sont introduits ou refactorés | `.mustflow/skills/null-object-pattern/SKILL.md` | Collaborateur optionnel, interface, sémantique d’absence, besoins de branche appelante, sortie neutre, effets secondaires requis, risques sécurité, argent, données et audit, emplacement d’assemblage, Result local, Option, injection de dépendances, stratégie et motifs de test | Interfaces, implémentations null, no-op, désactivées, identité, vides, deny-all ou en échec, câblage d’assemblage, types de dépendances non-null, tests et documentation ou modèles synchronisés directement | Échec requis caché, succès factice, contournement d’autorisation, persistance perdue, audit sauté, erreur d’initialisation avalée, objet null avec état ou appelant encore nullable | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Classification de l’absence, décision objet null, implémentation neutre, sélection d’assemblage, nettoyage appelant nullable, tests, vérification et risque résiduel d’échec caché |
-| Les exigences utilisateurs, critères d’acceptation, rapports d’incidents, rapports de bugs, notes produit, promesses de compatibilité ou exemples doivent être préservés comme couverture de régression avant ou pendant l’implémentation | `.mustflow/skills/requirement-regression-guard/SKILL.md` | Source de l’exigence, comportement observable, tests ou fixtures existants, périmètre d’implémentation, fichiers modifiés et entrées du contrat de commande | Tests ciblés, fixtures, exemples, schémas, docs et modifications d’implémentation directement liées à l’exigence | Exigence non testée, critères d’acceptation inventés, tests affaiblis, dérive comportementale cachée ou revendication d’implémentation non vérifiable | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `test_audit`, `docs_validate_fast`, `test_release`, `mustflow_check` | Sources d’exigences, carte de couverture, gardes ajoutés ou réutilisés, modifications d’implémentation, exigences différées, vérification et risque résiduel de régression |
-| Plusieurs agents IA, sous-agents, agents externes, exécuteurs de tâches parallèles ou rôles de travailleurs basés sur worktree sont prévus ou utilisés pour une tâche de dépôt | `.mustflow/skills/multi-agent-work-coordination/SKILL.md` | Objectif de la tâche, rôles des travailleurs, permissions d’écriture, propriété des fichiers, isolation des espaces de travail, frontière des identifiants, propriétaire de fusion et entrées du contrat de commande | Plan de coordination, instructions aux travailleurs, frontières de propriété, notes de fusion et tests ou docs synchronisés directement | Conflits sur même fichier, instructions contradictoires, fuite d’identifiants, cache d’auth partagé, sortie non fiable du travailleur, dérive de fusion ou résultat parallèle non vérifié | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `docs_validate_fast`, `test_release`, `mustflow_check` | Limite des travailleurs, carte des rôles, propriété d’écriture, isolation et frontières d’identifiants, propriétaire de fusion, vérification, contrôles ignorés et risque résiduel de coordination |
-| Une zone inconnue du code nécessite une cartographie basée sur des preuves avant planification, implémentation ou rapport | `.mustflow/skills/codebase-orientation/SKILL.md` | Demande utilisateur, zone cible, instructions pertinentes et fichiers source, test, schéma, modèle, configuration ou documentation actuels | Notes d’orientation en lecture seule et toute plus petite modification de suivi choisie parmi les preuves inspectées | Documentation obsolète, frontière de propriété erronée ou revendication d’architecture inventée | `changes_status`, `changes_diff_summary`, `mustflow_check` | Périmètre inspecté, points d’entrée, carte de flux, frontières de propriété, options de vérification, risques, inconnus et plus petite étape sûre suivante |
-| Une amélioration du dépôt, audit, priorisation, stabilisation, polissage, intégration, préparation contributeur, préparation production ou amélioration itérative est demandée sans modification prédéfinie unique | `.mustflow/skills/repo-improvement-loop/SKILL.md` | Objectif utilisateur, mode d’amélioration, preuves du dépôt, risques candidats, fichiers modifiés actuels et entrées du contrat de commande | Diagnostic du dépôt, candidats classés et au plus un cycle d’amélioration ciblé sauf demande explicite d’analyse seule | Idées en vrac, priorisation sans fondement, dérive autonome, réécriture large ou revendication d’amélioration non vérifiée | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Mode, preuves inspectées, candidats notés, amélioration sélectionnée, fichiers modifiés ou note analyse seule, vérification, question d’amélioration suivante et raison d’arrêt |
-| Un plan dense, une suggestion, une explication de code, un résultat de revue, une carte de flux ou un ensemble de décisions serait plus facile à inspecter sous forme d’artefact de revue HTML statique sécurisé | `.mustflow/skills/visual-review-artifact/SKILL.md` | Demande utilisateur, objectif de l’artefact, public cible, preuves sources, chemin de sortie et entrées du contrat de commande pertinentes | Sortie temporaire `.mustflow/state/artifacts/**` ou artefact HTML versionné explicitement demandé, plus références directes, docs ou métadonnées du package | Comportement HTML non sécurisé, injection de prompt, revendication d’artefact non vérifiée ou approbation erronée | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Type et chemin de l’artefact, preuves sources, frontière revue seule, interactions locales, vérification, contrôles ignorés et risque décisionnel résiduel |
-| Les fichiers modifiés nécessitent une classification des risques et une sélection de vérification | `.mustflow/skills/diff-risk-review/SKILL.md` | Liste des fichiers modifiés, résumé des différences et objectif de la tâche | Surfaces modifiées et rapport de vérification | Sous- ou sur-vérification | `changes_status`, `changes_diff_summary`, `test`, `test_related`, `test_audit`, `lint`, `build`, `docs_validate`, `mustflow_check` | Niveau de risque, choix de vérification, notes de rollback |
-| Le comportement déclaré doit rester aligné entre code, schémas, modèles, tests et documentation | `.mustflow/skills/contract-sync-check/SKILL.md` | Fichiers modifiés, comportement attendu, source de vérité, surfaces dérivées et entrées du contrat de commande | Source du contrat et surfaces synchronisées requises | Dérive du contrat | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Source du contrat, surfaces synchronisées, surfaces différées, vérification et risque de dérive |
-| Des dates, versions, comptes, durées, limites, métriques, benchmarks, prix, pourcentages ou autres faits numériques sont créés, édités ou rapportés | `.mustflow/skills/date-number-audit/SKILL.md` | Fait numérique ou date, source de vérité, surfaces dépendantes, attente de précision et entrées du contrat de commande | Énoncés numériques, métadonnées, tests, docs, modèles et rapports | Revendication numérique inventée, obsolète ou non concordante | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Valeurs auditées, source de vérité, surfaces synchronisées, contrôles ignorés et risque numérique résiduel |
-| Database schema, query, transaction, ORM model, repository/store, index, cache-backed read model, data retention, pagination, concurrency, idempotency, audit log, or persistence boundary is introduced, changed, reviewed, or reported | `.mustflow/skills/database-change-safety/SKILL.md` | Data role, affected tables or stores, read/write path, transaction boundary, migration or rollback expectations, local DB or ORM patterns, changed files, and command contract entries | Schema, migrations, repositories, stores, queries, transactions, indexes, read models, fixtures, tests, docs, and directly synchronized templates | data loss, stale cache, authorization leak, transaction bug, duplicate side effect, slow query, or unverified migration claim | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Data role, schema/query/transaction review, migration and rollback status, index/performance notes, security/retention checks, tests, verification, and remaining database risk |
-| Des paquets, runtimes, outils, commandes, services ou capacités de plateforme sont supposés, ajoutés, invoqués ou documentés | `.mustflow/skills/dependency-reality-check/SKILL.md` | Dépendance ou capacité, déclarations du dépôt, version ou revendication de capacité et entrées du contrat de commande | Déclarations de dépendances, imports, métadonnées de commande, tests et docs | Dépendance inventée ou indisponible | `changes_status`, `changes_diff_summary`, `build`, `test_release`, `mustflow_check` | Statut de la dépendance, surfaces synchronisées, vérification et risque résiduel de dépendance |
-| Systèmes externes, protocoles, SDK, bases de données, webhooks, files d’attente, fichiers, caches, requêtes ou réponses du framework, modèles d’IA, stockage navigateur ou données fournisseur franchissant la frontière du cœur ou nécessitant une traduction port/adaptateur, un mappage d’erreurs, une gestion de retry, d’idempotence, de sécurité ou d’observabilité | `.mustflow/skills/adapter-boundary/SKILL.md` | Système ou protocole externe, direction inbound/outbound, cas d’usage interne, modèles locaux port/adaptateur, risque fournisseur, fichiers modifiés et entrées du contrat de commande | Ports, adaptateurs, mappeurs, contrôleurs, workers, stores, passerelles, tests, fixtures, câblage d’assemblage et documents ou templates synchronisés directement | Fuite fournisseur, wrapper pass-through, échec externe non classifié, effet secondaire dupliqué, retry non sécurisé, timeout manquant, fuite de secret ou de données personnelles, ou dérive d’intégration non testée | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Classification de la frontière, port interne, confinement fournisseur, validation et mappage, gestion timeout/retry/idempotence, notes de sécurité, vérification et risque fournisseur résiduel |
-| La logique cœur ou applicative crée, importe, résout ou masque des dépendances externes telles que bases de données, SDK, horloges, générateurs aléatoires, configuration, loggers, objets framework, systèmes de fichiers, files d’attente, clients IA ou fournisseurs de paiement/email | `.mustflow/skills/dependency-injection/SKILL.md` | Zone de code cible, dépendance cachée, capacité métier visée, propriété de couche, modèles locaux port/adaptateur, fichiers modifiés et entrées du contrat de commande | Signatures de la logique cœur, ports, adaptateurs, racines d’assemblage, tests et documents ou templates synchronisés directement | État global caché, logique métier non testable, fuite fournisseur, dérive de cycle de vie, couplage service-locator | `changes_status`, `changes_diff_summary`, `test_related`, `test`, `lint`, `build`, `docs_validate_fast`, `test_release`, `mustflow_check` | Frontière de dépendance, dépendances directes détectées, style d’injection, ports/adaptateurs, frontière d’assemblage, tests ou mocks, vérification et fuite de dépendance résiduelle |
-| Git signale des avertissements CRLF/LF ou des fichiers texte suivis nécessitent une normalisation des fins de ligne | `.mustflow/skills/line-ending-hygiene/SKILL.md` | Texte d’avertissement ou preuve de fichier modifié, politique de fin de ligne, statut des fichiers modifiés et entrées du contrat de commande | Fichiers de politique de fin de ligne, fichiers texte suivis, métadonnées de commande, tests et rapports | Réécriture silencieuse de l’arbre de travail ou dérive de politique | `line_endings_check`, `changes_status`, `mustflow_check` | Politique identifiée, fichiers en dérive, statut de normalisation, vérification et risque résiduel lié aux fins de ligne |
-| Budgets de performance, taille de bundle, poids de page, temps de démarrage, durée de commande, consommation mémoire, taille d’actifs, débit, latence, résultats de benchmark ou revendications de performance sont planifiés, édités, revus ou rapportés | `.mustflow/skills/performance-budget-check/SKILL.md` | Surface de performance, source du budget, méthode de mesure, frontière d’environnement et entrées du contrat de commande | Contrôles de budget, seuils, mesures, notes de compromis de dépendances, tests, docs, métadonnées de package et rapports | Budgets inventés, mesures obsolètes, coût de performance caché ou revendication de vitesse non vérifiée | `changes_status`, `changes_diff_summary`, `build`, `test_related`, `docs_validate_fast`, `test_release`, `mustflow_check` | Surface de performance, source du budget, frontière de mesure, revendications synchronisées, mesures sautées et risque de performance résiduel |
-| New tests or test cases are designed, TDD RED or GREEN evidence is reported, or test-case choices are made for requirements, bugs, refactors, security boundaries, schemas, templates, or public docs | `.mustflow/skills/test-design-guard/SKILL.md` | Contract source, existing coverage, intended RED evidence, candidate cases, baseline status, and command contract entries | Tests, fixtures, helpers, and directly synchronized contract docs | invalid RED, happy-path-only coverage, speculative edge cases, weak assertions, mock-only confidence, or implementation-detail coupling | `test_related`, `test_audit`, `test`, `lint`, `build`, `test_release`, `mustflow_check` | RED category, selected test shape, evidence-backed cases, rejected speculation, verification objective, commands, and remaining test-design risk |
-| Tests ajoutés, mis à jour, supprimés ou audités | `.mustflow/skills/test-maintenance/SKILL.md` | Comportement modifié ou preuve de test obsolète | Fichiers de test et source associée | Dérive de contrat | `test`, `test_related`, `test_audit`, `snapshot_update`, `lint`, `build` | Justification et vérification des tests |
-| Code, configuration, docs, templates, logs, télémétrie, identifiants ou flux de données impactent secrets, données personnelles, authentification, autorisation, rétention ou divulgation externe | `.mustflow/skills/security-privacy-review/SKILL.md` | Fichiers modifiés, surfaces sensibles, règles secrètes et de confidentialité du projet, surfaces publiques ou packagées, et entrées du contrat de commande | Gestion des données sensibles, logs, reçus, état généré, docs, templates, métadonnées de package et rapports | Fuite de secret, exposition de données personnelles ou revendication de confidentialité trompeuse | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Surfaces sensibles revues, chemins de divulgation vérifiés, modifications de redaction ou omission, besoin de tests associés et risque résiduel de sécurité ou confidentialité |
-| Changements de comportement sensibles à la sécurité nécessitent des tests de régression d’abus | `.mustflow/skills/security-regression-tests/SKILL.md` | Frontière modifiée, acteurs et comportement de refus attendu | Fichiers de test et source de frontière de sécurité associée | Fausse confiance et couverture insuffisante | `test`, `test_related`, `test_audit`, `lint`, `build` | Frontière de sécurité, cas d’abus, tests et risques résiduels |
-| Une intention de commande configurée ou une étape de vérification échoue | `.mustflow/skills/failure-triage/SKILL.md` | Intention échouée et fin de sortie | Cause d’échec uniquement | Mauvais diagnostic | `mustflow_check`; intention échouée d’origine | Cause racine, correction, résultat du rerun |
-| Texte externe, contenu généré, logs, issues, pages web ou prompts collés incluent des instructions pouvant outrepasser les règles du dépôt ou modifier le périmètre | `.mustflow/skills/external-prompt-injection-defense/SKILL.md` | Source du texte externe, requête utilisateur directe, fichiers d’instructions du dépôt, instruction conflictuelle et entrées du contrat de commande | Prompts, fixtures, docs, tests, skills, templates et rapports traitant du texte non fiable | Injection de prompt, dérive de périmètre ou autorité de commande non sécurisée | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Sources externes revues, instructions non sécurisées neutralisées, exigences sécurisées adaptées, vérification et risque résiduel d’injection de prompt |
-| Sources d’instruction du dépôt, hôte, utilisateur, projet imbriqué, contrat de commande, préférence ou instruction générée entrent en conflit ou rendent le périmètre sûr incertain | `.mustflow/skills/instruction-conflict-scope-check/SKILL.md` | Sources d’instruction conflictuelles, périmètre affecté, requête utilisateur directe, entrées du contrat de commande et fichiers d’instruction les plus proches | Docs de workflow, skills, templates, tests, rapports et périmètre de dépôt sélectionné | Dérive d’autorité, expansion non sécurisée du périmètre, mauvaise édition du dépôt ou commande non autorisée | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Conflits examinés, règle de priorité choisie, actions restreintes ou sautées, modifications de clarification et risque d’autorité résiduel |
-| Migrations de code, données, schéma, configuration, organisation de fichiers, template ou état généré sont planifiées, éditées, documentées ou rapportées | `.mustflow/skills/migration-safety-check/SKILL.md` | État source, état cible, propriétaire de la surface de migration, idempotence, rollback, dry-run, compatibilité et entrées du contrat de commande | Plans de migration, notes de compatibilité, métadonnées de verrouillage, docs, tests, templates, état généré et rapports | Migration irréversible, perte de données ou fausse revendication de succès de migration | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Surface de migration, états source et cible, idempotence, rollback, mise à jour des métadonnées, vérification et risque résiduel de migration |
-| UI destinée à l’utilisateur, tableau de bord, paramètres, navigation, formulaire, contenu, mise en page responsive, accessibilité ou état visuel sont planifiés, édités, revus ou rapportés | `.mustflow/skills/ui-quality-gate/SKILL.md` | Surface UI modifiée, tâche utilisateur, parcours d’interaction, modèles existants, combinaisons d’états, règles de localisation et entrées du contrat de commande | Contrôles UI, libellés, états, contraintes de mise en page, attributs d’accessibilité, hooks de localisation, docs, templates et rapports | Dérive décorative UI, contrôles inaccessibles, rupture de mise en page ou revendication visuelle non vérifiée | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Surface UI revue, états vérifiés, notes de mise en page/accessibilité/localisation, contrôles visuels sautés et risque UI résiduel |
-| Une implémentation dans un domaine inconnu nécessite un précédent local avant d’introduire une nouvelle structure | `.mustflow/skills/pattern-scout/SKILL.md` | Requête utilisateur, zone de fichier visée, exemples proches et fichiers modifiés actuels | Preuves de pattern et fichiers nécessaires pour le suivre | Structure parallèle inventée | `changes_status`, `changes_diff_summary`, `mustflow_check` | Pattern local, alignement appliqué, écarts intentionnels et vérification |
-| Nouvelle fonctionnalité, module, organisation des dossiers, architecture, squelette, refactorisation, routage, modèle de données ou intégration de service externe pouvant nécessiter des décisions structurelles implicites avant le codage | `.mustflow/skills/structure-discovery-gate/SKILL.md` | Demande utilisateur, capacité visée, hypothèses implicites, technologies ou services nommés, et motifs locaux pertinents | Questions, hypothèses, propositions de limites de fichiers, et plus petite implémentation résultante | structure fragile, fuite de nom de fournisseur, questionnements excessifs ou abstraction spéculative | `changes_status`, `changes_diff_summary`, `docs_validate_fast`, `test_release`, `mustflow_check` | Questions bloquantes, hypothèses, fichiers et responsabilités proposés, direction des dépendances, motif local, vérification et risques structurels restants |
-| Un bug ou une erreur confuse nécessite une correction avant qu’une reproduction minimale soit claire | `.mustflow/skills/repro-first-debug/SKILL.md` | Symptôme, comportement attendu, sortie observée, et fichiers probablement modifiés | Notes de reproduction, test ciblé, et cause probable | correction spéculative ou sur-testing | `test_related`, `test_fast`, `mustflow_check` | Preuve de reproduction, correction minimale, vérification et risques résiduels |
-| Les affirmations dépendent de sources actuelles, externes, datées, versionnées ou sujettes à dérive | `.mustflow/skills/source-freshness-check/SKILL.md` | Affirmation sensible à la péremption, texte ou page source, contexte de date ou version, et politique source | Formulation source, documentation, et rapport de fraîcheur | affirmation périmée ou non vérifiable | `changes_status`, `docs_validate_fast`, `mustflow_check` | Limite source vérifiée, modifications de formulation, actualisations ignorées, et risque lié à la source périmée |
-| `.mustflow/context/PROJECT.md` nécessite un contexte projet prudent | `.mustflow/skills/project-context-authoring/SKILL.md` | Faits projet supportés | `.mustflow/context/PROJECT.md` | dérive d’autorité | `mustflow_check` | Contexte prudent mis à jour |
-| Procédures ou routes de compétences créées ou maintenues | `.mustflow/skills/skill-authoring/SKILL.md` | Preuves de tâche répétée | `.mustflow/skills/**` | chevauchement et dérive de commande | `mustflow_check`, `docs_validate` | Modifications des routes et procédures de compétences |
-| `README.md` créé, restructuré ou réécrit substantiellement | `.mustflow/skills/readme-authoring/SKILL.md` | Demande utilisateur, README existant le cas échéant, preuves du dépôt, instructions proches, et contrats de commande | `README.md` et documentation publique directement liée | affirmations projet inventées, dérive marketing, ou perte de l’intention humaine | `docs_validate_fast`, `mustflow_check` | Modifications basées sur preuves, sections préservées ou différées, notes de vérification |
-| Entrées de la file de revue documentaire nécessitant un nettoyage de prose | `.mustflow/skills/docs-prose-review/SKILL.md` | Entrée de file de revue ou chemin du document sélectionné, commentaire de revue éventuel, langue cible, métadonnées du réviseur | Fichier de documentation sélectionné et entrée de registre de revue | dérive de sens ou file périmée | `docs_validate`, `mustflow_check` | Modifications de prose, statut de revue enregistré, notes de vérification |
-| Ajout, conversion, redimensionnement ou remplacement d’images web | `.mustflow/skills/web-asset-optimization/SKILL.md` | Demande d’image et chemin cible | Images web | qualité et taille des ressources | `asset_optimize`, `build` | Notes d’optimisation des ressources |
-| Modifications documentaires affectant la documentation publique ou des workflows | `.mustflow/skills/docs-update/SKILL.md` | Comportement ou champ modifié | Documentation concernée uniquement | documentation publique périmée | `docs_validate_fast`, `docs_validate`, `mustflow_check` | Modifications documentaires et contrôles ignorés |
-Lors de l’introduction d’une nouvelle compétence, liez-la ici et définissez les champs spécifiques de déclenchement et de route.
-Évitez d’inclure des commandes shell brutes dans les documents de compétences ; référencez plutôt les noms d’intention de commande définis dans `.mustflow/config/commands.toml`.