mustflow 2.58.1 → 2.68.6

package/schemas/quality-gaming-report.schema.json

@@ -0,0 +1,96 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/quality-gaming-report.schema.json",
+  "title": "mustflow quality-gaming report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "command",
+    "mode",
+    "scope",
+    "ok",
+    "mustflow_root",
+    "git_tracked",
+    "checked_files",
+    "risk_count",
+    "risky_files",
+    "issues"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "command": { "const": "quality" },
+    "mode": { "const": "check" },
+    "scope": { "enum": ["changed", "tracked"] },
+    "ok": { "type": "boolean" },
+    "mustflow_root": { "type": "string" },
+    "git_tracked": { "type": "boolean" },
+    "checked_files": { "type": "integer", "minimum": 0 },
+    "risk_count": { "type": "integer", "minimum": 0 },
+    "risky_files": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/riskyFile" }
+    },
+    "issues": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "metric": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["name", "value", "threshold"],
+      "properties": {
+        "name": { "type": "string" },
+        "value": { "type": "number" },
+        "threshold": { "type": "number" }
+      }
+    },
+    "risk": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["code", "severity", "path", "line", "detail", "metric"],
+      "properties": {
+        "code": {
+          "enum": [
+            "line_stuffing_added",
+            "multiple_statements_per_line_added",
+            "suppression_added",
+            "type_escape_added",
+            "test_bypass_marker_added",
+            "placeholder_added",
+            "empty_catch_swallow_added",
+            "generated_or_vendor_logic_added",
+            "large_helper_container_added"
+          ]
+        },
+        "severity": { "enum": ["medium", "high", "critical"] },
+        "path": { "type": "string" },
+        "line": { "type": ["integer", "null"], "minimum": 1 },
+        "detail": { "type": "string" },
+        "metric": {
+          "anyOf": [
+            { "$ref": "#/$defs/metric" },
+            { "type": "null" }
+          ]
+        }
+      }
+    },
+    "riskyFile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "checked_lines", "risk_count", "risks"],
+      "properties": {
+        "path": { "type": "string" },
+        "checked_lines": { "type": "integer", "minimum": 0 },
+        "risk_count": { "type": "integer", "minimum": 1 },
+        "risks": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/risk" },
+          "minItems": 1
+        }
+      }
+    }
+  }
+}

package/schemas/route-fixture.schema.json

@@ -0,0 +1,57 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/route-fixture.schema.json",
+  "title": "mustflow skill route fixture",
+  "type": "object",
+  "additionalProperties": false,
+  "required": ["schema_version", "cases"],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "cases": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/case" }
+    }
+  },
+  "$defs": {
+    "nonEmptyString": {
+      "type": "string",
+      "minLength": 1
+    },
+    "nonEmptyStringArray": {
+      "type": "array",
+      "minItems": 1,
+      "items": { "$ref": "#/$defs/nonEmptyString" }
+    },
+    "case": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["id", "paths", "reasons"],
+      "anyOf": [
+        { "required": ["required_main"] },
+        { "required": ["required_candidates"] },
+        { "required": ["required_adjuncts"] },
+        { "required": ["forbidden_candidates"] }
+      ],
+      "properties": {
+        "id": { "$ref": "#/$defs/nonEmptyString" },
+        "task": {
+          "oneOf": [
+            { "$ref": "#/$defs/nonEmptyString" },
+            { "type": "null" }
+          ]
+        },
+        "paths": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "reasons": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "max_candidates": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10
+        },
+        "required_main": { "$ref": "#/$defs/nonEmptyString" },
+        "required_candidates": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "required_adjuncts": { "$ref": "#/$defs/nonEmptyStringArray" },
+        "forbidden_candidates": { "$ref": "#/$defs/nonEmptyStringArray" }
+      }
+    }
+  }
+}

package/schemas/skill-route-report.schema.json

@@ -0,0 +1,242 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://mustflow.github.io/schemas/skill-route-report.schema.json",
+  "title": "mustflow skill route report",
+  "type": "object",
+  "additionalProperties": false,
+  "required": [
+    "schema_version",
+    "kind",
+    "input",
+    "signals",
+    "selected",
+    "candidates",
+    "source_files",
+    "gap_notes",
+    "command",
+    "action"
+  ],
+  "properties": {
+    "schema_version": { "const": "1" },
+    "kind": { "const": "skill_route_resolution" },
+    "command": { "const": "skill" },
+    "action": { "const": "route" },
+    "input": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["task_text_present", "paths", "reasons", "max_candidates"],
+      "properties": {
+        "task_text_present": { "type": "boolean" },
+        "paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "max_candidates": {
+          "type": "integer",
+          "minimum": 1,
+          "maximum": 10
+        }
+      }
+    },
+    "signals": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["task_terms", "path_terms", "reasons", "read_shards"],
+      "properties": {
+        "task_terms": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "path_terms": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "read_shards": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "selected": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["main", "adjuncts"],
+      "properties": {
+        "main": {
+          "oneOf": [
+            { "$ref": "#/$defs/candidate" },
+            { "type": "null" }
+          ]
+        },
+        "adjuncts": {
+          "type": "array",
+          "items": { "$ref": "#/$defs/candidate" }
+        }
+      }
+    },
+    "candidates": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/candidate" }
+    },
+    "read_plan": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "selection_limits",
+        "stable_kernel",
+        "selected_skill_paths",
+        "candidate_skill_paths",
+        "fallback_route_metadata",
+        "expanded_index",
+        "avoid_by_default",
+        "notes"
+      ],
+      "properties": {
+        "selection_limits": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["candidates", "main", "adjuncts"],
+          "properties": {
+            "candidates": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 10
+            },
+            "main": {
+              "type": "integer",
+              "minimum": 1,
+              "maximum": 1
+            },
+            "adjuncts": {
+              "type": "integer",
+              "minimum": 0,
+              "maximum": 2
+            }
+          }
+        },
+        "stable_kernel": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "selected_skill_paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "candidate_skill_paths": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "fallback_route_metadata": { "$ref": "#/$defs/readPlanFile" },
+        "expanded_index": { "$ref": "#/$defs/readPlanFile" },
+        "avoid_by_default": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "notes": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "source_files": {
+      "type": "array",
+      "items": { "type": "string" }
+    },
+    "gap_notes": {
+      "type": "array",
+      "items": { "type": "string" }
+    }
+  },
+  "$defs": {
+    "candidate": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": [
+        "skill",
+        "skill_path",
+        "trigger",
+        "category",
+        "route_type",
+        "priority",
+        "applies_to_reasons",
+        "score",
+        "score_breakdown",
+        "selection_reasons",
+        "verification_intents"
+      ],
+      "properties": {
+        "skill": { "type": "string" },
+        "skill_path": { "type": "string" },
+        "trigger": { "type": "string" },
+        "category": {
+          "type": ["string", "null"],
+          "enum": [
+            "bug_failure",
+            "general_code",
+            "tests",
+            "docs_release",
+            "security_privacy",
+            "data_external",
+            "ui_assets",
+            "architecture_patterns",
+            "workflow_contracts",
+            null
+          ]
+        },
+        "route_type": { "type": "string" },
+        "priority": { "type": "integer" },
+        "applies_to_reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "score": { "type": "number" },
+        "score_breakdown": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": [
+            "reason_match",
+            "task_text_match",
+            "path_match",
+            "route_type_weight",
+            "priority_weight"
+          ],
+          "properties": {
+            "reason_match": { "type": "number" },
+            "task_text_match": { "type": "number" },
+            "path_match": { "type": "number" },
+            "route_type_weight": { "type": "number" },
+            "priority_weight": { "type": "number" }
+          }
+        },
+        "selection_reasons": {
+          "type": "array",
+          "items": { "type": "string" }
+        },
+        "verification_intents": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    },
+    "readPlanFile": {
+      "type": "object",
+      "additionalProperties": false,
+      "required": ["path", "read_when"],
+      "properties": {
+        "path": { "type": "string" },
+        "read_when": {
+          "type": "array",
+          "items": { "type": "string" }
+        }
+      }
+    }
+  }
+}

package/templates/default/common/.mustflow/config/commands.toml

@@ -127,6 +127,38 @@ network = false
 destructive = false
 required_after = ["line_ending_warning", "formatting_change"]
 
+[intents.quality_gaming_check]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Inspect changed files for AI quality-gaming patterns."
+argv = ["mf", "quality", "check", "--json"]
+cwd = "."
+timeout_seconds = 120
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["code_change", "behavior_change", "test_change", "public_api_change", "performance_change", "unknown_change"]
+
+[intents.prompt_cache_audit]
+status = "configured"
+kind = "mustflow_builtin"
+lifecycle = "oneshot"
+run_policy = "agent_allowed"
+description = "Measure prompt-cache profile sizes and configured budget status read-only."
+argv = ["mf", "context", "--json", "--cache-profile", "all", "--cache-audit"]
+cwd = "."
+timeout_seconds = 120
+stdin = "closed"
+success_exit_codes = [0]
+writes = []
+network = false
+destructive = false
+required_after = ["mustflow_config_change", "mustflow_docs_change", "public_api_change", "performance_change", "unknown_change"]
+
 [intents.line_endings_normalize]
 status = "manual_only"
 description = "Normalize tracked text files to the repository line-ending policy."
@@ -234,8 +266,8 @@ status = "configured"
 kind = "mustflow_builtin"
 lifecycle = "oneshot"
 run_policy = "agent_allowed"
-description = "Create or refresh the generated mustflow SQLite local index."
-argv = ["mf", "index"]
+description = "Create or refresh the generated mustflow SQLite local index, including bounded source anchors."
+argv = ["mf", "index", "--source"]
 cwd = "."
 timeout_seconds = 300
 stdin = "closed"

package/templates/default/common/.mustflow/config/mustflow.toml

@@ -8,10 +8,12 @@ read_order = [
   ".mustflow/config/commands.toml",
   ".mustflow/config/preferences.toml",
   ".mustflow/config/technology.toml",
-  ".mustflow/skills/INDEX.md",
+  ".mustflow/skills/router.toml",
 ]
 optional_read_order = [
   ".mustflow/context/INDEX.md",
+  ".mustflow/skills/routes.toml",
+  ".mustflow/skills/INDEX.md",
   "REPO_MAP.md",
 ]
 
@@ -19,6 +21,8 @@ optional_read_order = [
 primary_instruction = "AGENTS.md"
 repository_map = "REPO_MAP.md"
 skill_index = ".mustflow/skills/INDEX.md"
+skill_router = ".mustflow/skills/router.toml"
+skill_routes = ".mustflow/skills/routes.toml"
 command_contract = ".mustflow/config/commands.toml"
 workflow_preferences = ".mustflow/config/preferences.toml"
 technology_preferences = ".mustflow/config/technology.toml"
@@ -38,6 +42,8 @@ anchor_files = [
   ".mustflow/config/commands.toml",
   ".mustflow/config/preferences.toml",
   ".mustflow/config/technology.toml",
+  ".mustflow/skills/router.toml",
+  ".mustflow/skills/routes.toml",
   ".mustflow/skills/INDEX.md",
   "README.md",
   "PROJECT.md",
@@ -130,25 +136,24 @@ stable_prefix_policy = "hash_verified"
 prefer_references_when_unchanged = true
 exclude_volatile_state_from_prefix = true
 include_content_hashes = true
-max_stable_prefix_kb = 96
+max_stable_prefix_kb = 48
 max_task_context_kb = 48
 max_volatile_suffix_kb = 24
 
 [prompt_cache.layers.stable]
+target_kb = 32
 read = [
   "AGENTS.md",
-  ".mustflow/docs/agent-workflow.md",
-  ".mustflow/config/mustflow.toml",
-  ".mustflow/config/commands.toml",
-  ".mustflow/config/technology.toml",
-  ".mustflow/skills/INDEX.md",
+  ".mustflow/skills/router.toml",
 ]
 
 [prompt_cache.layers.task]
 read_policy = "task_relevant_only"
 sources = [
   ".mustflow/context/INDEX.md",
-  "REPO_MAP.md",
+  "skill_route_candidates",
+  "route_metadata_fallback",
+  "repo_map_navigation",
   "matching_skill",
   "relevant_source_files",
 ]
@@ -242,7 +247,7 @@ read = [
 method = "hash_check"
 read = [
   "AGENTS.md",
-  ".mustflow/skills/INDEX.md",
+  ".mustflow/skills/router.toml",
 ]
 
 [refresh.levels.full]
@@ -254,7 +259,8 @@ read = [
   ".mustflow/config/commands.toml",
   ".mustflow/config/preferences.toml",
   ".mustflow/config/technology.toml",
-  ".mustflow/skills/INDEX.md",
+  ".mustflow/skills/router.toml",
+  ".mustflow/skills/routes.toml",
 ]
 
 [compaction]

package/templates/default/i18n.toml

@@ -10,8 +10,8 @@ status_values = ["current", "stale", "needs_review", "missing"]
 [documents."agents.root"]
 source = "locales/en/AGENTS.md"
 source_locale = "en"
-revision = 15
-translations.ko = { path = "locales/ko/AGENTS.md", source_revision = 15, status = "current" }
+revision = 17
+translations.ko = { path = "locales/ko/AGENTS.md", source_revision = 17, status = "current" }
 translations.zh = { path = "locales/zh/AGENTS.md", source_revision = 11, status = "needs_review" }
 translations.es = { path = "locales/es/AGENTS.md", source_revision = 11, status = "needs_review" }
 translations.fr = { path = "locales/fr/AGENTS.md", source_revision = 11, status = "needs_review" }
@@ -30,8 +30,8 @@ translations.hi = { path = "locales/hi/.mustflow/context/INDEX.md", source_revis
 [documents."context.project"]
 source = "locales/en/.mustflow/context/PROJECT.md"
 source_locale = "en"
-revision = 1
-translations.ko = { path = "locales/ko/.mustflow/context/PROJECT.md", source_revision = 1, status = "current" }
+revision = 3
+translations.ko = { path = "locales/ko/.mustflow/context/PROJECT.md", source_revision = 3, status = "current" }
 translations.zh = { path = "locales/zh/.mustflow/context/PROJECT.md", source_revision = 1, status = "needs_review" }
 translations.es = { path = "locales/es/.mustflow/context/PROJECT.md", source_revision = 1, status = "needs_review" }
 translations.fr = { path = "locales/fr/.mustflow/context/PROJECT.md", source_revision = 1, status = "needs_review" }
@@ -40,8 +40,8 @@ translations.hi = { path = "locales/hi/.mustflow/context/PROJECT.md", source_rev
 [documents."docs.agent-workflow"]
 source = "locales/en/.mustflow/docs/agent-workflow.md"
 source_locale = "en"
-revision = 20
-translations.ko = { path = "locales/ko/.mustflow/docs/agent-workflow.md", source_revision = 20, status = "current" }
+revision = 23
+translations.ko = { path = "locales/ko/.mustflow/docs/agent-workflow.md", source_revision = 23, status = "current" }
 translations.zh = { path = "locales/zh/.mustflow/docs/agent-workflow.md", source_revision = 18, status = "needs_review" }
 translations.es = { path = "locales/es/.mustflow/docs/agent-workflow.md", source_revision = 18, status = "needs_review" }
 translations.fr = { path = "locales/fr/.mustflow/docs/agent-workflow.md", source_revision = 18, status = "needs_review" }
@@ -62,7 +62,7 @@ translations = {}
 [documents."skills.index"]
 source = "locales/en/.mustflow/skills/INDEX.md"
 source_locale = "en"
-revision = 167
+revision = 169
 translations = {}
 
 [documents."skill.adapter-boundary"]
@@ -119,6 +119,12 @@ source_locale = "en"
 revision = 2
 translations = {}
 
+[documents."skill.quality-gaming-guard"]
+source = "locales/en/.mustflow/skills/quality-gaming-guard/SKILL.md"
+source_locale = "en"
+revision = 2
+translations = {}
+
 [documents."skill.module-boundary-review"]
 source = "locales/en/.mustflow/skills/module-boundary-review/SKILL.md"
 source_locale = "en"
@@ -978,7 +984,7 @@ translations = {}
 [documents."skill.llm-token-cost-control-review"]
 source = "locales/en/.mustflow/skills/llm-token-cost-control-review/SKILL.md"
 source_locale = "en"
-revision = 1
+revision = 2
 translations = {}
 
 [documents."skill.llm-response-latency-review"]

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

@@ -3,7 +3,7 @@ mustflow_doc: context.project
 kind: mustflow-context
 locale: en
 canonical: true
-revision: 1
+revision: 3
 name: project
 authority: contextual
 lifecycle: user-editable
@@ -58,9 +58,11 @@ Unset. List paths, public APIs, generated files, migrations, secrets, or compati
 - `.mustflow/docs/agent-workflow.md`  
 - `.mustflow/config/mustflow.toml`  
 - `.mustflow/config/commands.toml`  
-- `.mustflow/skills/INDEX.md`
+- `.mustflow/skills/router.toml`
+- `.mustflow/skills/routes.toml` only when detailed route metadata is needed
+- `.mustflow/skills/INDEX.md` only when human-readable route evidence is needed
 
 ## Staleness Check
 
 - If this file conflicts with current code, tests, command contracts, or user instructions, treat it as stale and report the conflict.  
-- Update this file only when the project direction, non-goals, or repository-wide promises change.
+- Update this file only when the project direction, non-goals, or repository-wide promises change.

package/templates/default/locales/en/.mustflow/docs/agent-workflow.md

@@ -2,7 +2,7 @@
 mustflow_doc: docs.agent-workflow
 locale: en
 canonical: true
-revision: 20
+revision: 23
 lifecycle: mustflow-owned
 authority: workflow-policy
 ---
@@ -31,7 +31,9 @@ mustflow documents have specific, narrow roles. Do not move a rule into a lower-
 | `.mustflow/config/preferences.toml` | Repository-level defaults for style, language, Git suggestions, testing tendency, verification selection, and version-impact handling. | Lower-authority preferences; not permissions. | Repository-local TOML, user-customizable. |
 | `.mustflow/context/INDEX.md` | Router for task-specific context files. | Selects optional context only; not a policy manual. | mustflow-owned Markdown. |
 | `.mustflow/context/PROJECT.md` | Cautious project facts, unknowns, and domain conventions. | Contextual reference below user instructions, code, tests, commands, and configured policies. | User-editable context. |
-| `.mustflow/skills/INDEX.md` | Router that selects which procedure document to read for a task. | Selection contract only; procedure detail remains in `SKILL.md`. | mustflow-owned Markdown. |
+| `.mustflow/skills/router.toml` | Stable compact route taxonomy and fallback rules for prompt-cache-friendly first-pass skill selection. | Selection kernel only; procedure detail remains in `SKILL.md`. | mustflow-owned TOML. |
+| `.mustflow/skills/routes.toml` | Full route metadata for detailed procedure selection when the compact router is insufficient. | Selection hint only; procedure detail remains in `SKILL.md`. | mustflow-owned TOML. |
+| `.mustflow/skills/INDEX.md` | Expanded human-readable route table for detailed skill selection and route maintenance. | Selection contract only; procedure detail remains in `SKILL.md`. | mustflow-owned Markdown. |
 | `.mustflow/skills/<name>/SKILL.md` | Repeatable task procedure with inputs, allowed scope, checks, and reporting format. | Procedure guidance only; cannot authorize commands or override rules. | mustflow-owned Markdown, optionally localized. |
 | `REPO_MAP.md` | Generated anchor map for broad navigation and nested repository entry points. | Generated navigation aid below current files and instructions. | Generated; refresh with the configured `repo_map` intent or `mf map`. |
 
@@ -53,10 +55,12 @@ Skills are task procedures, not autonomous tools. Activating a skill means readi
 
 At task start and before the first edit:
 
-1. Read `.mustflow/skills/INDEX.md`.
-2. Match the current task against the listed scenarios.
-3. Read every matching `SKILL.md` before editing that part of the work.
-4. If no skill applies, proceed with the smallest safe change under `AGENTS.md` and `.mustflow/config/commands.toml`.
+1. Read `.mustflow/skills/router.toml` for the stable route taxonomy, category signals, selection limits, and fallback rules.
+2. Match the current task against category signals, user intent, expected paths, discovered technology, and event signals.
+3. Read `.mustflow/skills/routes.toml` when the compact router is insufficient, the task edits skill routing, detailed route metadata is needed, or route confidence is ambiguous.
+4. Read `.mustflow/skills/INDEX.md` when full route metadata is insufficient, the task edits the expanded route table, or human-readable trigger evidence is needed.
+5. Read every matching `SKILL.md` before editing that part of the work.
+6. If no skill applies, proceed with the smallest safe change under `AGENTS.md` and `.mustflow/config/commands.toml`.
 
 Activate a skill later if new evidence changes the task type. For example, a failing configured command activates failure triage; a test contract change activates test maintenance; and a documentation or workflow change activates documentation update.
 
@@ -82,8 +86,8 @@ Prompt caching is a performance optimization, not an authority source. A cached
 
 Hosts and agent harnesses assembling model input should keep context in this order:
 
-1. Stable prefix: repository rules and workflow files from `mf context --json --cache-profile stable`.
-2. Task context: selected context files, matching skills, repository-map anchors, relevant source files, and `mf search --json` results with `cache_layer` set to `task`.
+1. Stable prefix: repository entrypoint rules and the compact route kernel from `mf context --json --cache-profile stable`.
+2. Task context: selected context files, workflow/configuration refresh slices, command intent definitions, full route metadata fallback, detailed skill index fallback, matching skills, repository-map anchors, relevant source files, and `mf search --json` results with `cache_layer` set to `task`.
 3. Volatile suffix: current user request, changed-file lists, command output tails, latest run receipt metadata, timestamps, and any `mf search --json` result whose `volatile` field is `true`.
 
 Before reusing a stable prefix, compare the reported content hashes with the current files. If any stable document hash changes, reread the document instead of reusing cached text. Do not place absolute local paths, run receipt timestamps, command output, changed files, or current user task text before the stable prefix.
@@ -126,7 +130,7 @@ Use `.mustflow/config/mustflow.toml` `[refresh]` to determine the refresh level:
 - `command`: reread `AGENTS.md` and `.mustflow/config/commands.toml`
 - `edit`: reread `AGENTS.md`, `.mustflow/config/mustflow.toml`, and `.mustflow/docs/agent-workflow.md` before sensitive edits
 - `report`: reread `AGENTS.md`, `.mustflow/config/mustflow.toml`, and `.mustflow/config/preferences.toml` before the final report
-- `skill`: reread `AGENTS.md` and `.mustflow/skills/INDEX.md`
+- `skill`: reread `AGENTS.md` and `.mustflow/skills/router.toml`
 - `full`: reread the full mustflow read sequence
 
 `before_command_run` is a freshness checkpoint for the current command intent, not a requirement to reread every file before every repeated command when the command contract has not changed.