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
  1. package/README.md +16 -6
  2. package/dist/cli/commands/adapters.js +90 -0
  3. package/dist/cli/commands/classify.js +3 -4
  4. package/dist/cli/commands/contract-lint.js +26 -6
  5. package/dist/cli/commands/dashboard.js +103 -4
  6. package/dist/cli/commands/explain-verify.js +213 -0
  7. package/dist/cli/commands/explain.js +48 -4
  8. package/dist/cli/commands/handoff.js +136 -0
  9. package/dist/cli/commands/run.js +97 -136
  10. package/dist/cli/commands/update.js +91 -61
  11. package/dist/cli/commands/verify.js +230 -137
  12. package/dist/cli/i18n/en.js +65 -4
  13. package/dist/cli/i18n/es.js +65 -4
  14. package/dist/cli/i18n/fr.js +65 -4
  15. package/dist/cli/i18n/hi.js +65 -4
  16. package/dist/cli/i18n/ko.js +65 -4
  17. package/dist/cli/i18n/zh.js +65 -4
  18. package/dist/cli/index.js +11 -0
  19. package/dist/cli/lib/command-registry.js +10 -0
  20. package/dist/cli/lib/dashboard-export.js +775 -0
  21. package/dist/cli/lib/local-index.js +22 -6
  22. package/dist/cli/lib/run-plan.js +222 -0
  23. package/dist/cli/lib/templates.js +18 -3
  24. package/dist/cli/lib/update-diff-preview.js +163 -0
  25. package/dist/cli/lib/validation.js +22 -0
  26. package/dist/core/adapter-compatibility.js +235 -0
  27. package/dist/core/change-classification.js +9 -0
  28. package/dist/core/change-verification.js +10 -3
  29. package/dist/core/check-issues.js +4 -0
  30. package/dist/core/command-contract-validation.js +14 -0
  31. package/dist/core/command-cwd.js +18 -6
  32. package/dist/core/command-env.js +91 -0
  33. package/dist/core/contract-lint.js +165 -3
  34. package/dist/core/contract-models.js +172 -0
  35. package/dist/core/dashboard-verification.js +2 -0
  36. package/dist/core/doc-review-triage.js +1 -0
  37. package/dist/core/handoff-record.js +376 -0
  38. package/dist/core/public-json-contracts.js +16 -0
  39. package/dist/core/run-receipt.js +46 -7
  40. package/dist/core/run-write-drift.js +180 -0
  41. package/dist/core/secret-redaction.js +39 -0
  42. package/dist/core/source-anchors.js +3 -5
  43. package/dist/core/verification-decision-graph.js +223 -0
  44. package/package.json +3 -1
  45. package/schemas/README.md +11 -4
  46. package/schemas/adapter-compatibility-report.schema.json +184 -0
  47. package/schemas/change-verification-report.schema.json +133 -1
  48. package/schemas/commands.schema.json +8 -1
  49. package/schemas/contract-lint-report.schema.json +48 -0
  50. package/schemas/explain-report.schema.json +265 -2
  51. package/schemas/handoff-validation-report.schema.json +68 -0
  52. package/schemas/run-receipt.schema.json +74 -1
  53. package/templates/default/common/.mustflow/config/commands.toml +2 -0
  54. package/templates/default/i18n.toml +78 -234
  55. package/templates/default/locales/en/.mustflow/skills/INDEX.md +7 -3
  56. package/templates/default/locales/en/.mustflow/skills/architecture-deepening-review/SKILL.md +154 -0
  57. package/templates/default/locales/en/.mustflow/skills/behavior-preserving-refactor/SKILL.md +8 -3
  58. package/templates/default/locales/en/.mustflow/skills/code-review/SKILL.md +9 -4
  59. package/templates/default/locales/en/.mustflow/skills/date-number-audit/SKILL.md +19 -4
  60. package/templates/default/locales/en/.mustflow/skills/diff-risk-review/SKILL.md +4 -2
  61. package/templates/default/locales/en/.mustflow/skills/external-skill-intake/SKILL.md +141 -0
  62. package/templates/default/locales/en/.mustflow/skills/release-notes-authoring/SKILL.md +143 -0
  63. package/templates/default/locales/en/.mustflow/skills/repro-first-debug/SKILL.md +22 -8
  64. package/templates/default/locales/en/.mustflow/skills/skill-authoring/SKILL.md +3 -3
  65. package/templates/default/locales/en/.mustflow/skills/source-freshness-check/SKILL.md +22 -9
  66. package/templates/default/locales/en/.mustflow/skills/ui-quality-gate/SKILL.md +21 -13
  67. package/templates/default/locales/en/.mustflow/skills/vertical-slice-tdd/SKILL.md +167 -0
  68. package/templates/default/manifest.toml +16 -1
  69. package/templates/default/locales/es/.mustflow/skills/INDEX.md +0 -75
  70. package/templates/default/locales/es/.mustflow/skills/adapter-boundary/SKILL.md +0 -193
  71. package/templates/default/locales/es/.mustflow/skills/artifact-integrity-check/SKILL.md +0 -114
  72. package/templates/default/locales/es/.mustflow/skills/behavior-preserving-refactor/SKILL.md +0 -182
  73. package/templates/default/locales/es/.mustflow/skills/code-review/SKILL.md +0 -115
  74. package/templates/default/locales/es/.mustflow/skills/codebase-orientation/SKILL.md +0 -115
  75. package/templates/default/locales/es/.mustflow/skills/command-pattern/SKILL.md +0 -247
  76. package/templates/default/locales/es/.mustflow/skills/composition-over-inheritance/SKILL.md +0 -176
  77. package/templates/default/locales/es/.mustflow/skills/contract-sync-check/SKILL.md +0 -116
  78. package/templates/default/locales/es/.mustflow/skills/database-change-safety/SKILL.md +0 -155
  79. package/templates/default/locales/es/.mustflow/skills/date-number-audit/SKILL.md +0 -116
  80. package/templates/default/locales/es/.mustflow/skills/dependency-injection/SKILL.md +0 -161
  81. package/templates/default/locales/es/.mustflow/skills/dependency-reality-check/SKILL.md +0 -115
  82. package/templates/default/locales/es/.mustflow/skills/diff-risk-review/SKILL.md +0 -136
  83. package/templates/default/locales/es/.mustflow/skills/docs-prose-review/SKILL.md +0 -119
  84. package/templates/default/locales/es/.mustflow/skills/docs-update/SKILL.md +0 -97
  85. package/templates/default/locales/es/.mustflow/skills/external-prompt-injection-defense/SKILL.md +0 -116
  86. package/templates/default/locales/es/.mustflow/skills/facade-pattern/SKILL.md +0 -210
  87. package/templates/default/locales/es/.mustflow/skills/failure-triage/SKILL.md +0 -97
  88. package/templates/default/locales/es/.mustflow/skills/instruction-conflict-scope-check/SKILL.md +0 -118
  89. package/templates/default/locales/es/.mustflow/skills/line-ending-hygiene/SKILL.md +0 -111
  90. package/templates/default/locales/es/.mustflow/skills/migration-safety-check/SKILL.md +0 -117
  91. package/templates/default/locales/es/.mustflow/skills/multi-agent-work-coordination/SKILL.md +0 -260
  92. package/templates/default/locales/es/.mustflow/skills/null-object-pattern/SKILL.md +0 -196
  93. package/templates/default/locales/es/.mustflow/skills/pattern-scout/SKILL.md +0 -110
  94. package/templates/default/locales/es/.mustflow/skills/performance-budget-check/SKILL.md +0 -121
  95. package/templates/default/locales/es/.mustflow/skills/project-context-authoring/SKILL.md +0 -107
  96. package/templates/default/locales/es/.mustflow/skills/pure-core-imperative-shell/SKILL.md +0 -212
  97. package/templates/default/locales/es/.mustflow/skills/readme-authoring/SKILL.md +0 -115
  98. package/templates/default/locales/es/.mustflow/skills/repo-improvement-loop/SKILL.md +0 -150
  99. package/templates/default/locales/es/.mustflow/skills/repro-first-debug/SKILL.md +0 -112
  100. package/templates/default/locales/es/.mustflow/skills/requirement-regression-guard/SKILL.md +0 -152
  101. package/templates/default/locales/es/.mustflow/skills/result-option/SKILL.md +0 -186
  102. package/templates/default/locales/es/.mustflow/skills/security-privacy-review/SKILL.md +0 -116
  103. package/templates/default/locales/es/.mustflow/skills/security-regression-tests/SKILL.md +0 -131
  104. package/templates/default/locales/es/.mustflow/skills/skill-authoring/SKILL.md +0 -110
  105. package/templates/default/locales/es/.mustflow/skills/source-freshness-check/SKILL.md +0 -111
  106. package/templates/default/locales/es/.mustflow/skills/state-machine-pattern/SKILL.md +0 -214
  107. package/templates/default/locales/es/.mustflow/skills/strategy-pattern/SKILL.md +0 -215
  108. package/templates/default/locales/es/.mustflow/skills/structure-discovery-gate/SKILL.md +0 -159
  109. package/templates/default/locales/es/.mustflow/skills/test-design-guard/SKILL.md +0 -162
  110. package/templates/default/locales/es/.mustflow/skills/test-maintenance/SKILL.md +0 -122
  111. package/templates/default/locales/es/.mustflow/skills/ui-quality-gate/SKILL.md +0 -117
  112. package/templates/default/locales/es/.mustflow/skills/visual-review-artifact/SKILL.md +0 -127
  113. package/templates/default/locales/es/.mustflow/skills/visual-review-artifact/assets/review-template.html +0 -286
  114. package/templates/default/locales/es/.mustflow/skills/visual-review-artifact/resources.toml +0 -7
  115. package/templates/default/locales/es/.mustflow/skills/web-asset-optimization/SKILL.md +0 -108
  116. package/templates/default/locales/fr/.mustflow/skills/INDEX.md +0 -75
  117. package/templates/default/locales/fr/.mustflow/skills/adapter-boundary/SKILL.md +0 -193
  118. package/templates/default/locales/fr/.mustflow/skills/artifact-integrity-check/SKILL.md +0 -114
  119. package/templates/default/locales/fr/.mustflow/skills/behavior-preserving-refactor/SKILL.md +0 -182
  120. package/templates/default/locales/fr/.mustflow/skills/code-review/SKILL.md +0 -115
  121. package/templates/default/locales/fr/.mustflow/skills/codebase-orientation/SKILL.md +0 -115
  122. package/templates/default/locales/fr/.mustflow/skills/command-pattern/SKILL.md +0 -247
  123. package/templates/default/locales/fr/.mustflow/skills/composition-over-inheritance/SKILL.md +0 -176
  124. package/templates/default/locales/fr/.mustflow/skills/contract-sync-check/SKILL.md +0 -116
  125. package/templates/default/locales/fr/.mustflow/skills/database-change-safety/SKILL.md +0 -155
  126. package/templates/default/locales/fr/.mustflow/skills/date-number-audit/SKILL.md +0 -116
  127. package/templates/default/locales/fr/.mustflow/skills/dependency-injection/SKILL.md +0 -161
  128. package/templates/default/locales/fr/.mustflow/skills/dependency-reality-check/SKILL.md +0 -115
  129. package/templates/default/locales/fr/.mustflow/skills/diff-risk-review/SKILL.md +0 -136
  130. package/templates/default/locales/fr/.mustflow/skills/docs-prose-review/SKILL.md +0 -119
  131. package/templates/default/locales/fr/.mustflow/skills/docs-update/SKILL.md +0 -97
  132. package/templates/default/locales/fr/.mustflow/skills/external-prompt-injection-defense/SKILL.md +0 -116
  133. package/templates/default/locales/fr/.mustflow/skills/facade-pattern/SKILL.md +0 -210
  134. package/templates/default/locales/fr/.mustflow/skills/failure-triage/SKILL.md +0 -97
  135. package/templates/default/locales/fr/.mustflow/skills/instruction-conflict-scope-check/SKILL.md +0 -118
  136. package/templates/default/locales/fr/.mustflow/skills/line-ending-hygiene/SKILL.md +0 -111
  137. package/templates/default/locales/fr/.mustflow/skills/migration-safety-check/SKILL.md +0 -117
  138. package/templates/default/locales/fr/.mustflow/skills/multi-agent-work-coordination/SKILL.md +0 -260
  139. package/templates/default/locales/fr/.mustflow/skills/null-object-pattern/SKILL.md +0 -196
  140. package/templates/default/locales/fr/.mustflow/skills/pattern-scout/SKILL.md +0 -110
  141. package/templates/default/locales/fr/.mustflow/skills/performance-budget-check/SKILL.md +0 -121
  142. package/templates/default/locales/fr/.mustflow/skills/project-context-authoring/SKILL.md +0 -107
  143. package/templates/default/locales/fr/.mustflow/skills/pure-core-imperative-shell/SKILL.md +0 -212
  144. package/templates/default/locales/fr/.mustflow/skills/readme-authoring/SKILL.md +0 -115
  145. package/templates/default/locales/fr/.mustflow/skills/repo-improvement-loop/SKILL.md +0 -150
  146. package/templates/default/locales/fr/.mustflow/skills/repro-first-debug/SKILL.md +0 -112
  147. package/templates/default/locales/fr/.mustflow/skills/requirement-regression-guard/SKILL.md +0 -152
  148. package/templates/default/locales/fr/.mustflow/skills/result-option/SKILL.md +0 -186
  149. package/templates/default/locales/fr/.mustflow/skills/security-privacy-review/SKILL.md +0 -116
  150. package/templates/default/locales/fr/.mustflow/skills/security-regression-tests/SKILL.md +0 -131
  151. package/templates/default/locales/fr/.mustflow/skills/skill-authoring/SKILL.md +0 -110
  152. package/templates/default/locales/fr/.mustflow/skills/source-freshness-check/SKILL.md +0 -111
  153. package/templates/default/locales/fr/.mustflow/skills/state-machine-pattern/SKILL.md +0 -214
  154. package/templates/default/locales/fr/.mustflow/skills/strategy-pattern/SKILL.md +0 -215
  155. package/templates/default/locales/fr/.mustflow/skills/structure-discovery-gate/SKILL.md +0 -159
  156. package/templates/default/locales/fr/.mustflow/skills/test-design-guard/SKILL.md +0 -162
  157. package/templates/default/locales/fr/.mustflow/skills/test-maintenance/SKILL.md +0 -122
  158. package/templates/default/locales/fr/.mustflow/skills/ui-quality-gate/SKILL.md +0 -117
  159. package/templates/default/locales/fr/.mustflow/skills/visual-review-artifact/SKILL.md +0 -127
  160. package/templates/default/locales/fr/.mustflow/skills/visual-review-artifact/assets/review-template.html +0 -286
  161. package/templates/default/locales/fr/.mustflow/skills/visual-review-artifact/resources.toml +0 -7
  162. package/templates/default/locales/fr/.mustflow/skills/web-asset-optimization/SKILL.md +0 -108
  163. package/templates/default/locales/hi/.mustflow/skills/INDEX.md +0 -75
  164. package/templates/default/locales/hi/.mustflow/skills/adapter-boundary/SKILL.md +0 -193
  165. package/templates/default/locales/hi/.mustflow/skills/artifact-integrity-check/SKILL.md +0 -114
  166. package/templates/default/locales/hi/.mustflow/skills/behavior-preserving-refactor/SKILL.md +0 -182
  167. package/templates/default/locales/hi/.mustflow/skills/code-review/SKILL.md +0 -115
  168. package/templates/default/locales/hi/.mustflow/skills/codebase-orientation/SKILL.md +0 -115
  169. package/templates/default/locales/hi/.mustflow/skills/command-pattern/SKILL.md +0 -247
  170. package/templates/default/locales/hi/.mustflow/skills/composition-over-inheritance/SKILL.md +0 -176
  171. package/templates/default/locales/hi/.mustflow/skills/contract-sync-check/SKILL.md +0 -116
  172. package/templates/default/locales/hi/.mustflow/skills/database-change-safety/SKILL.md +0 -155
  173. package/templates/default/locales/hi/.mustflow/skills/date-number-audit/SKILL.md +0 -116
  174. package/templates/default/locales/hi/.mustflow/skills/dependency-injection/SKILL.md +0 -161
  175. package/templates/default/locales/hi/.mustflow/skills/dependency-reality-check/SKILL.md +0 -115
  176. package/templates/default/locales/hi/.mustflow/skills/diff-risk-review/SKILL.md +0 -136
  177. package/templates/default/locales/hi/.mustflow/skills/docs-prose-review/SKILL.md +0 -119
  178. package/templates/default/locales/hi/.mustflow/skills/docs-update/SKILL.md +0 -97
  179. package/templates/default/locales/hi/.mustflow/skills/external-prompt-injection-defense/SKILL.md +0 -116
  180. package/templates/default/locales/hi/.mustflow/skills/facade-pattern/SKILL.md +0 -210
  181. package/templates/default/locales/hi/.mustflow/skills/failure-triage/SKILL.md +0 -97
  182. package/templates/default/locales/hi/.mustflow/skills/instruction-conflict-scope-check/SKILL.md +0 -118
  183. package/templates/default/locales/hi/.mustflow/skills/line-ending-hygiene/SKILL.md +0 -111
  184. package/templates/default/locales/hi/.mustflow/skills/migration-safety-check/SKILL.md +0 -117
  185. package/templates/default/locales/hi/.mustflow/skills/multi-agent-work-coordination/SKILL.md +0 -260
  186. package/templates/default/locales/hi/.mustflow/skills/null-object-pattern/SKILL.md +0 -196
  187. package/templates/default/locales/hi/.mustflow/skills/pattern-scout/SKILL.md +0 -110
  188. package/templates/default/locales/hi/.mustflow/skills/performance-budget-check/SKILL.md +0 -121
  189. package/templates/default/locales/hi/.mustflow/skills/project-context-authoring/SKILL.md +0 -107
  190. package/templates/default/locales/hi/.mustflow/skills/pure-core-imperative-shell/SKILL.md +0 -212
  191. package/templates/default/locales/hi/.mustflow/skills/readme-authoring/SKILL.md +0 -115
  192. package/templates/default/locales/hi/.mustflow/skills/repo-improvement-loop/SKILL.md +0 -150
  193. package/templates/default/locales/hi/.mustflow/skills/repro-first-debug/SKILL.md +0 -112
  194. package/templates/default/locales/hi/.mustflow/skills/requirement-regression-guard/SKILL.md +0 -152
  195. package/templates/default/locales/hi/.mustflow/skills/result-option/SKILL.md +0 -186
  196. package/templates/default/locales/hi/.mustflow/skills/security-privacy-review/SKILL.md +0 -116
  197. package/templates/default/locales/hi/.mustflow/skills/security-regression-tests/SKILL.md +0 -131
  198. package/templates/default/locales/hi/.mustflow/skills/skill-authoring/SKILL.md +0 -110
  199. package/templates/default/locales/hi/.mustflow/skills/source-freshness-check/SKILL.md +0 -111
  200. package/templates/default/locales/hi/.mustflow/skills/state-machine-pattern/SKILL.md +0 -214
  201. package/templates/default/locales/hi/.mustflow/skills/strategy-pattern/SKILL.md +0 -215
  202. package/templates/default/locales/hi/.mustflow/skills/structure-discovery-gate/SKILL.md +0 -159
  203. package/templates/default/locales/hi/.mustflow/skills/test-design-guard/SKILL.md +0 -162
  204. package/templates/default/locales/hi/.mustflow/skills/test-maintenance/SKILL.md +0 -122
  205. package/templates/default/locales/hi/.mustflow/skills/ui-quality-gate/SKILL.md +0 -117
  206. package/templates/default/locales/hi/.mustflow/skills/visual-review-artifact/SKILL.md +0 -127
  207. package/templates/default/locales/hi/.mustflow/skills/visual-review-artifact/assets/review-template.html +0 -286
  208. package/templates/default/locales/hi/.mustflow/skills/visual-review-artifact/resources.toml +0 -7
  209. package/templates/default/locales/hi/.mustflow/skills/web-asset-optimization/SKILL.md +0 -108
  210. package/templates/default/locales/ko/.mustflow/skills/INDEX.md +0 -80
  211. package/templates/default/locales/ko/.mustflow/skills/adapter-boundary/SKILL.md +0 -193
  212. package/templates/default/locales/ko/.mustflow/skills/artifact-integrity-check/SKILL.md +0 -114
  213. package/templates/default/locales/ko/.mustflow/skills/behavior-preserving-refactor/SKILL.md +0 -182
  214. package/templates/default/locales/ko/.mustflow/skills/code-review/SKILL.md +0 -118
  215. package/templates/default/locales/ko/.mustflow/skills/codebase-orientation/SKILL.md +0 -115
  216. package/templates/default/locales/ko/.mustflow/skills/command-pattern/SKILL.md +0 -247
  217. package/templates/default/locales/ko/.mustflow/skills/composition-over-inheritance/SKILL.md +0 -176
  218. package/templates/default/locales/ko/.mustflow/skills/contract-sync-check/SKILL.md +0 -116
  219. package/templates/default/locales/ko/.mustflow/skills/database-change-safety/SKILL.md +0 -155
  220. package/templates/default/locales/ko/.mustflow/skills/date-number-audit/SKILL.md +0 -116
  221. package/templates/default/locales/ko/.mustflow/skills/dependency-injection/SKILL.md +0 -161
  222. package/templates/default/locales/ko/.mustflow/skills/dependency-reality-check/SKILL.md +0 -115
  223. package/templates/default/locales/ko/.mustflow/skills/diff-risk-review/SKILL.md +0 -136
  224. package/templates/default/locales/ko/.mustflow/skills/docs-prose-review/SKILL.md +0 -119
  225. package/templates/default/locales/ko/.mustflow/skills/docs-update/SKILL.md +0 -107
  226. package/templates/default/locales/ko/.mustflow/skills/external-prompt-injection-defense/SKILL.md +0 -116
  227. package/templates/default/locales/ko/.mustflow/skills/facade-pattern/SKILL.md +0 -210
  228. package/templates/default/locales/ko/.mustflow/skills/failure-triage/SKILL.md +0 -119
  229. package/templates/default/locales/ko/.mustflow/skills/instruction-conflict-scope-check/SKILL.md +0 -118
  230. package/templates/default/locales/ko/.mustflow/skills/line-ending-hygiene/SKILL.md +0 -111
  231. package/templates/default/locales/ko/.mustflow/skills/migration-safety-check/SKILL.md +0 -117
  232. package/templates/default/locales/ko/.mustflow/skills/multi-agent-work-coordination/SKILL.md +0 -259
  233. package/templates/default/locales/ko/.mustflow/skills/null-object-pattern/SKILL.md +0 -196
  234. package/templates/default/locales/ko/.mustflow/skills/pattern-scout/SKILL.md +0 -110
  235. package/templates/default/locales/ko/.mustflow/skills/performance-budget-check/SKILL.md +0 -121
  236. package/templates/default/locales/ko/.mustflow/skills/project-context-authoring/SKILL.md +0 -107
  237. package/templates/default/locales/ko/.mustflow/skills/pure-core-imperative-shell/SKILL.md +0 -212
  238. package/templates/default/locales/ko/.mustflow/skills/readme-authoring/SKILL.md +0 -115
  239. package/templates/default/locales/ko/.mustflow/skills/repo-improvement-loop/SKILL.md +0 -150
  240. package/templates/default/locales/ko/.mustflow/skills/repro-first-debug/SKILL.md +0 -112
  241. package/templates/default/locales/ko/.mustflow/skills/requirement-regression-guard/SKILL.md +0 -152
  242. package/templates/default/locales/ko/.mustflow/skills/result-option/SKILL.md +0 -186
  243. package/templates/default/locales/ko/.mustflow/skills/security-privacy-review/SKILL.md +0 -116
  244. package/templates/default/locales/ko/.mustflow/skills/security-regression-tests/SKILL.md +0 -131
  245. package/templates/default/locales/ko/.mustflow/skills/skill-authoring/SKILL.md +0 -110
  246. package/templates/default/locales/ko/.mustflow/skills/source-freshness-check/SKILL.md +0 -111
  247. package/templates/default/locales/ko/.mustflow/skills/state-machine-pattern/SKILL.md +0 -214
  248. package/templates/default/locales/ko/.mustflow/skills/strategy-pattern/SKILL.md +0 -215
  249. package/templates/default/locales/ko/.mustflow/skills/structure-discovery-gate/SKILL.md +0 -159
  250. package/templates/default/locales/ko/.mustflow/skills/test-design-guard/SKILL.md +0 -162
  251. package/templates/default/locales/ko/.mustflow/skills/test-maintenance/SKILL.md +0 -130
  252. package/templates/default/locales/ko/.mustflow/skills/ui-quality-gate/SKILL.md +0 -117
  253. package/templates/default/locales/ko/.mustflow/skills/visual-review-artifact/SKILL.md +0 -127
  254. package/templates/default/locales/ko/.mustflow/skills/visual-review-artifact/assets/review-template.html +0 -286
  255. package/templates/default/locales/ko/.mustflow/skills/visual-review-artifact/resources.toml +0 -7
  256. package/templates/default/locales/ko/.mustflow/skills/web-asset-optimization/SKILL.md +0 -108
  257. package/templates/default/locales/zh/.mustflow/skills/INDEX.md +0 -74
  258. package/templates/default/locales/zh/.mustflow/skills/adapter-boundary/SKILL.md +0 -193
  259. package/templates/default/locales/zh/.mustflow/skills/artifact-integrity-check/SKILL.md +0 -114
  260. package/templates/default/locales/zh/.mustflow/skills/behavior-preserving-refactor/SKILL.md +0 -182
  261. package/templates/default/locales/zh/.mustflow/skills/code-review/SKILL.md +0 -115
  262. package/templates/default/locales/zh/.mustflow/skills/codebase-orientation/SKILL.md +0 -115
  263. package/templates/default/locales/zh/.mustflow/skills/command-pattern/SKILL.md +0 -247
  264. package/templates/default/locales/zh/.mustflow/skills/composition-over-inheritance/SKILL.md +0 -176
  265. package/templates/default/locales/zh/.mustflow/skills/contract-sync-check/SKILL.md +0 -116
  266. package/templates/default/locales/zh/.mustflow/skills/database-change-safety/SKILL.md +0 -155
  267. package/templates/default/locales/zh/.mustflow/skills/date-number-audit/SKILL.md +0 -116
  268. package/templates/default/locales/zh/.mustflow/skills/dependency-injection/SKILL.md +0 -161
  269. package/templates/default/locales/zh/.mustflow/skills/dependency-reality-check/SKILL.md +0 -115
  270. package/templates/default/locales/zh/.mustflow/skills/diff-risk-review/SKILL.md +0 -136
  271. package/templates/default/locales/zh/.mustflow/skills/docs-prose-review/SKILL.md +0 -119
  272. package/templates/default/locales/zh/.mustflow/skills/docs-update/SKILL.md +0 -97
  273. package/templates/default/locales/zh/.mustflow/skills/external-prompt-injection-defense/SKILL.md +0 -116
  274. package/templates/default/locales/zh/.mustflow/skills/facade-pattern/SKILL.md +0 -210
  275. package/templates/default/locales/zh/.mustflow/skills/failure-triage/SKILL.md +0 -96
  276. package/templates/default/locales/zh/.mustflow/skills/instruction-conflict-scope-check/SKILL.md +0 -118
  277. package/templates/default/locales/zh/.mustflow/skills/line-ending-hygiene/SKILL.md +0 -111
  278. package/templates/default/locales/zh/.mustflow/skills/migration-safety-check/SKILL.md +0 -117
  279. package/templates/default/locales/zh/.mustflow/skills/multi-agent-work-coordination/SKILL.md +0 -260
  280. package/templates/default/locales/zh/.mustflow/skills/null-object-pattern/SKILL.md +0 -196
  281. package/templates/default/locales/zh/.mustflow/skills/pattern-scout/SKILL.md +0 -110
  282. package/templates/default/locales/zh/.mustflow/skills/performance-budget-check/SKILL.md +0 -121
  283. package/templates/default/locales/zh/.mustflow/skills/project-context-authoring/SKILL.md +0 -107
  284. package/templates/default/locales/zh/.mustflow/skills/pure-core-imperative-shell/SKILL.md +0 -212
  285. package/templates/default/locales/zh/.mustflow/skills/readme-authoring/SKILL.md +0 -115
  286. package/templates/default/locales/zh/.mustflow/skills/repo-improvement-loop/SKILL.md +0 -150
  287. package/templates/default/locales/zh/.mustflow/skills/repro-first-debug/SKILL.md +0 -112
  288. package/templates/default/locales/zh/.mustflow/skills/requirement-regression-guard/SKILL.md +0 -152
  289. package/templates/default/locales/zh/.mustflow/skills/result-option/SKILL.md +0 -186
  290. package/templates/default/locales/zh/.mustflow/skills/security-privacy-review/SKILL.md +0 -116
  291. package/templates/default/locales/zh/.mustflow/skills/security-regression-tests/SKILL.md +0 -131
  292. package/templates/default/locales/zh/.mustflow/skills/skill-authoring/SKILL.md +0 -110
  293. package/templates/default/locales/zh/.mustflow/skills/source-freshness-check/SKILL.md +0 -111
  294. package/templates/default/locales/zh/.mustflow/skills/state-machine-pattern/SKILL.md +0 -214
  295. package/templates/default/locales/zh/.mustflow/skills/strategy-pattern/SKILL.md +0 -215
  296. package/templates/default/locales/zh/.mustflow/skills/structure-discovery-gate/SKILL.md +0 -159
  297. package/templates/default/locales/zh/.mustflow/skills/test-design-guard/SKILL.md +0 -162
  298. package/templates/default/locales/zh/.mustflow/skills/test-maintenance/SKILL.md +0 -122
  299. package/templates/default/locales/zh/.mustflow/skills/ui-quality-gate/SKILL.md +0 -117
  300. package/templates/default/locales/zh/.mustflow/skills/visual-review-artifact/SKILL.md +0 -127
  301. package/templates/default/locales/zh/.mustflow/skills/visual-review-artifact/assets/review-template.html +0 -286
  302. package/templates/default/locales/zh/.mustflow/skills/visual-review-artifact/resources.toml +0 -7
  303. package/templates/default/locales/zh/.mustflow/skills/web-asset-optimization/SKILL.md +0 -108
@@ -1,116 +0,0 @@
1
- ---
2
- mustflow_doc: skill.security-privacy-review
3
- locale: fr
4
- canonical: false
5
- revision: 1
6
- lifecycle: mustflow-owned
7
- authority: procedure
8
- name: security-privacy-review
9
- description: Apply this skill when code, configuration, docs, templates, logs, telemetry, credentials, or data flows affect secrets, personal data, authentication, authorization, retention, or external disclosure.
10
- metadata:
11
- mustflow_schema: "1"
12
- mustflow_kind: procedure
13
- pack_id: mustflow.core
14
- skill_id: mustflow.core.security-privacy-review
15
- command_intents:
16
- - changes_status
17
- - changes_diff_summary
18
- - docs_validate_fast
19
- - test_release
20
- - mustflow_check
21
- ---
22
-
23
- # Security and Privacy Review
24
-
25
- <!-- mustflow-section: purpose -->
26
- ## Purpose
27
-
28
- Catch security, privacy, and disclosure risks introduced by ordinary code, documentation, template, configuration, logging, or reporting changes.
29
-
30
- <!-- mustflow-section: use-when -->
31
- ## Use When
32
-
33
- - A change touches authentication, authorization, sessions, admin behavior, tenant boundaries, personal data, secrets, tokens, credentials, API keys, or private files.
34
- - A change adds or modifies logging, telemetry, diagnostics, receipts, reports, caches, generated state, retention, redaction, export, or external transmission.
35
- - Documentation, templates, examples, tests, or final reports mention sensitive data handling, privacy behavior, secret handling, or user-identifying data.
36
- - A diff could expose data through filenames, paths, command output, screenshots, generated artifacts, package contents, or public docs.
37
-
38
- <!-- mustflow-section: do-not-use-when -->
39
- ## Do Not Use When
40
-
41
- - The task needs a concrete abuse-case regression test; use `security-regression-tests` for that part.
42
- - The task is only dependency availability, package version freshness, or artifact packaging without sensitive data.
43
- - The task is a general security checklist with no changed boundary, data flow, or disclosure surface to inspect.
44
-
45
- <!-- mustflow-section: required-inputs -->
46
- ## Required Inputs
47
-
48
- - Changed files, diff summary, and the user goal.
49
- - Sensitive data, actor, trust boundary, storage, logging, retention, export, or external disclosure surfaces involved.
50
- - Existing project rules for secrets, privacy, generated state, public docs, package contents, and command output.
51
- - Relevant command-intent contract entries for status, diff, docs, release, or mustflow validation.
52
-
53
- <!-- mustflow-section: preconditions -->
54
- ## Preconditions
55
-
56
- - The task matches the Use When conditions and does not match the Do Not Use When exclusions.
57
- - Required inputs are available, or missing inputs can be reported without guessing.
58
- - Higher-priority instructions and `.mustflow/config/commands.toml` have been checked for the current scope.
59
-
60
- <!-- mustflow-section: allowed-edits -->
61
- ## Allowed Edits
62
-
63
- - Add or tighten redaction, masking, omission, retention, disclosure, or documentation wording when the changed surface justifies it.
64
- - Remove sensitive-looking sample values from docs, fixtures, templates, logs, reports, and final output when they are not required.
65
- - Mark unknown privacy or secret-handling behavior as unverified instead of claiming it is safe.
66
- - Do not invent compliance claims, privacy guarantees, secret scanning results, or audit coverage.
67
-
68
- <!-- mustflow-section: procedure -->
69
- ## Procedure
70
-
71
- 1. Identify the sensitive surface: secret, personal data, actor, permission, storage location, log, generated artifact, package file, public document, or external recipient.
72
- 2. Decide whether the change creates, stores, reads, transforms, logs, exports, deletes, or reports sensitive information.
73
- 3. Check whether the changed surface is public, packaged, generated, cached, retained, user-visible, or sent outside the repository boundary.
74
- 4. Verify that examples, fixtures, screenshots, command outputs, and final reports do not expose real-looking secrets or unnecessary personal data.
75
- 5. Prefer omission or minimal metadata over masking when the sensitive value is not needed for the user to understand the result.
76
- 6. If the change affects an authorization or abuse boundary, activate `security-regression-tests` for test selection instead of folding test generation into this review.
77
- 7. Run the narrowest configured verification that covers the changed docs, templates, package, or mustflow contract.
78
-
79
- <!-- mustflow-section: postconditions -->
80
- ## Postconditions
81
-
82
- - Sensitive data and disclosure surfaces have been identified or explicitly reported as unknown.
83
- - Public and packaged surfaces do not include unnecessary secrets, personal data, or misleading privacy guarantees.
84
- - The final report names remaining unverified security or privacy risks without revealing sensitive values.
85
-
86
- <!-- mustflow-section: verification -->
87
- ## Verification
88
-
89
- Use configured oneshot command intents when available:
90
-
91
- - `changes_status`
92
- - `changes_diff_summary`
93
- - `docs_validate_fast`
94
- - `test_release`
95
- - `mustflow_check`
96
-
97
- Use a narrower configured test, build, or documentation intent when it better proves the changed sensitive surface.
98
-
99
- <!-- mustflow-section: failure-handling -->
100
- ## Failure Handling
101
-
102
- - If a sensitive value appears in command output, stop copying it and summarize the issue without the value.
103
- - If the project lacks enough context to confirm privacy or secret handling, report the uncertainty and avoid claiming safety.
104
- - If a package, generated artifact, or public doc includes sensitive data, remove or redact it before continuing unrelated work.
105
- - If verification requires unavailable scanners or live systems, report the missing check and the remaining risk.
106
-
107
- <!-- mustflow-section: output-format -->
108
- ## Output Format
109
-
110
- - Sensitive surfaces reviewed
111
- - Disclosure or retention paths checked
112
- - Redaction, omission, or wording changes made
113
- - Related security-regression test need
114
- - Command intents run
115
- - Skipped checks and reasons
116
- - Remaining security or privacy risk
@@ -1,131 +0,0 @@
1
- ---
2
- mustflow_doc: skill.security-regression-tests
3
- locale: fr
4
- canonical: false
5
- revision: 1
6
- lifecycle: mustflow-owned
7
- authority: procedure
8
- name: security-regression-tests
9
- description: Apply this skill when security-sensitive code or behavior changes need abuse-case regression tests.
10
- metadata:
11
- mustflow_schema: "1"
12
- mustflow_kind: procedure
13
- pack_id: mustflow.core
14
- skill_id: mustflow.core.security-regression-tests
15
- command_intents:
16
- - test
17
- - test_related
18
- - test_audit
19
- - lint
20
- - build
21
- ---
22
-
23
- # Security Regression Tests
24
-
25
- <!-- mustflow-section: purpose -->
26
- ## Purpose
27
-
28
- Convert security-sensitive behavior changes into safe negative tests that preserve defensive expectations without turning the task into vulnerability scanning, exploit development, or penetration testing.
29
-
30
- <!-- mustflow-section: use-when -->
31
- ## Use When
32
-
33
- - Authentication, authorization, session, CSRF, rate-limit, admin, payment, credit, subscription, personal-data, or tenant-boundary behavior changes.
34
- - Input validation, output encoding, file upload, path handling, webhook callback, redirect, or external URL handling changes.
35
- - A bug fix closes an abuse case and the fix needs a regression test to prevent reintroduction.
36
- - A review identifies a concrete security-sensitive boundary that can be expressed as a deterministic test.
37
-
38
- <!-- mustflow-section: do-not-use-when -->
39
- ## Do Not Use When
40
-
41
- - The task is only a general security review, dependency audit, static analysis request, or policy discussion.
42
- - The repository lacks enough application context to identify the real protected resource, actor, trust boundary, or existing test harness.
43
- - The only available output would be a generic test such as "prevents XSS" without a specific route, component, serializer, or data flow.
44
- - The test would require real external services, live attack traffic, credential guessing, destructive input, or unsafe payload collection.
45
- - The user explicitly asks not to add or propose tests.
46
-
47
- <!-- mustflow-section: required-inputs -->
48
- ## Required Inputs
49
-
50
- - The changed behavior, diff, route, component, handler, data model, or bug fix that creates the security-sensitive boundary.
51
- - The relevant actors, ownership rules, trust boundary, allowed and denied state combinations, and expected status or error behavior.
52
- - Existing test framework, fixtures, factories, mocks, request helpers, and naming conventions.
53
- - `.mustflow/config/commands.toml` entries for test, audit, lint, and build-related intents.
54
- - Any project context or public contract that defines privacy, authorization, upload, callback, payment, or tenant rules.
55
-
56
- <!-- mustflow-section: preconditions -->
57
- ## Preconditions
58
-
59
- - The task matches the Use When conditions and does not match the Do Not Use When exclusions.
60
- - Required inputs are available, or missing inputs can be reported without guessing.
61
- - Higher-priority instructions and `.mustflow/config/commands.toml` have been checked for the current scope.
62
- - The test can be written as a defensive expectation without teaching an exploit recipe or contacting unsafe targets.
63
-
64
- <!-- mustflow-section: allowed-edits -->
65
- ## Allowed Edits
66
-
67
- - Keep edits within the scope described by this skill, the user request, and the matching route in `.mustflow/skills/INDEX.md`.
68
- - Prefer existing test files, fixtures, factories, mocks, and helper APIs before adding new test structure.
69
- - Do not broaden command permission, invent project facts, introduce external scanners, add offensive payload corpora, or change unrelated workflow files.
70
-
71
- <!-- mustflow-section: procedure -->
72
- ## Procedure
73
-
74
- 1. Identify the protected boundary: actor, resource, operation, trust boundary, and expected defensive outcome.
75
- 2. Classify the abuse case using project-specific facts, not broad labels alone:
76
- - unauthorized actor or cross-tenant access
77
- - invalid ownership or privilege escalation
78
- - unsafe input shape, size, encoding, path, or MIME mismatch
79
- - unsafe output rendering or serialization
80
- - unsafe external URL, callback, redirect, or server-side request target
81
- - payment, credit, coupon, subscription, refund, or entitlement abuse
82
- - personal-data or admin-only access leakage
83
- 3. Search for existing tests that already cover the same boundary. Strengthen the existing test when that gives clearer coverage than adding a new one.
84
- 4. Build the smallest safe negative test data: at least one allowed control case when useful, and one denied case that proves the boundary rejects the abuse condition.
85
- 5. Use mocks or local fakes for external requests, uploads, redirects, webhooks, payment providers, and file systems. Do not contact live suspicious endpoints.
86
- 6. Name the test after the defensive expectation, such as `cannot_read_other_users_invoice` or `rejects_private_network_callback_url`.
87
- 7. Keep assertions tied to observable behavior: status code, returned error shape, unchanged database state, missing side effect, sanitized output, or rejected job.
88
- 8. Avoid dumping long exploit strings into the test. Use minimal representative input that proves the validation or boundary rule.
89
- 9. If the project lacks enough context to write a deterministic test, output a concrete test proposal instead of inventing fixtures or behavior.
90
-
91
- <!-- mustflow-section: postconditions -->
92
- ## Postconditions
93
-
94
- - The expected output can be produced with clear evidence, executed command intents, skipped checks, and remaining risks.
95
- - Any missing command intent, unknown input, or authority conflict is reported instead of hidden.
96
- - New tests are justified by a concrete security-sensitive behavior contract, not by a habit of adding tests to every change.
97
-
98
- <!-- mustflow-section: verification -->
99
- ## Verification
100
-
101
- Use configured oneshot command intents when available:
102
-
103
- - `test_related`
104
- - `test`
105
- - `test_audit`
106
- - `lint`
107
- - `build`
108
-
109
- Prefer the narrowest configured test intent that covers the changed boundary. Do not infer missing test, lint, scanner, or build commands. If a relevant intent is unknown or manual-only, report that status and the remaining verification risk.
110
-
111
- <!-- mustflow-section: failure-handling -->
112
- ## Failure Handling
113
-
114
- - If a generated test fails because the defensive behavior is missing, inspect the nearest production code that owns the boundary before weakening the test.
115
- - If a generated test fails because fixtures or assumptions are wrong, fix the test setup or report the missing project fact.
116
- - If the test would require unsafe traffic, real credentials, live external targets, or destructive data, replace it with a local mock-based expectation or a written test proposal.
117
- - If existing tests already prove the boundary, report the existing coverage rather than adding duplicate cases.
118
- - If the repository's testing policy requires more evidence before adding tests, report the security-sensitive contract that justifies the test or stop at a proposal.
119
-
120
- <!-- mustflow-section: output-format -->
121
- ## Output Format
122
-
123
- - Security-sensitive boundary reviewed
124
- - Abuse case classification
125
- - Required test data
126
- - Tests added or strengthened
127
- - Existing coverage reused
128
- - Suspected code location if the test fails
129
- - Command intents run
130
- - Skipped command intents and reasons
131
- - Remaining security or verification risks
@@ -1,110 +0,0 @@
1
- ---
2
- mustflow_doc: skill.skill-authoring
3
- locale: fr
4
- canonical: false
5
- revision: 3
6
- lifecycle: mustflow-owned
7
- authority: procedure
8
- name: skill-authoring
9
- description: Apply this skill when creating or maintaining `.mustflow/skills/*/SKILL.md` procedures and `.mustflow/skills/INDEX.md` routes.
10
- metadata:
11
- mustflow_schema: "1"
12
- mustflow_kind: procedure
13
- pack_id: mustflow.core
14
- skill_id: mustflow.core.skill-authoring
15
- command_intents:
16
- - mustflow_check
17
- - docs_validate
18
- ---
19
-
20
- # Skill Authoring
21
-
22
- <!-- mustflow-section: purpose -->
23
- ## Purpose
24
-
25
- Create narrow, repeatable mustflow skill procedures without turning skills into broad advice, project context, or command-permission sources.
26
-
27
- <!-- mustflow-section: use-when -->
28
- ## Use When
29
-
30
- - A `.mustflow/skills/<name>/SKILL.md` file is created, renamed, split, removed, or substantially changed.
31
- - `.mustflow/skills/INDEX.md` needs a new or updated route for a skill.
32
- - A skill needs clearer use conditions, exclusion conditions, required inputs, command intent references, verification, or failure handling.
33
- - A broad prompt, checklist, or outside recommendation needs to be adapted into mustflow's skill format.
34
-
35
- <!-- mustflow-section: do-not-use-when -->
36
- ## Do Not Use When
37
-
38
- - The task only applies an existing skill to code, docs, tests, context, or assets.
39
- - The content belongs in `AGENTS.md`, `.mustflow/docs/agent-workflow.md`, `.mustflow/context/PROJECT.md`, or `.mustflow/config/commands.toml`.
40
- - The proposed skill is broad advice such as "write better code" or "be careful" without a repeatable trigger and procedure.
41
- - The skill would duplicate project-domain context, authorize commands, install dependencies, or define raw shell commands.
42
-
43
- <!-- mustflow-section: required-inputs -->
44
- ## Required Inputs
45
-
46
- - The user request and the repeated task the skill should cover.
47
- - Existing `.mustflow/skills/INDEX.md` and nearby skill documents.
48
- - `.mustflow/config/commands.toml` command intent names relevant to verification.
49
- - Any repository evidence showing that the task is repeatable and not better handled by an existing skill.
50
- - Localization and template metadata when the skill is part of an installed template.
51
-
52
- <!-- mustflow-section: preconditions -->
53
- ## Preconditions
54
-
55
- - La tache correspond aux conditions d'utilisation et ne correspond pas aux exclusions.
56
- - Les entrees requises sont disponibles, ou les entrees manquantes peuvent etre signalees sans supposition.
57
- - Les instructions de priorite superieure et `.mustflow/config/commands.toml` ont ete verifiees pour le perimetre actuel.
58
-
59
- <!-- mustflow-section: allowed-edits -->
60
- ## Modifications Autorisees
61
-
62
- - Garder les modifications dans le perimetre decrit par cette skill, la demande utilisateur et la route correspondante dans `.mustflow/skills/INDEX.md`.
63
- - Ne pas elargir les permissions de commande, inventer des faits projet ou modifier des fichiers de workflow sans rapport.
64
-
65
- <!-- mustflow-section: procedure -->
66
- ## Procedure
67
-
68
- 1. Define the smallest repeatable task the skill should cover. If the task is too broad, split it or leave it as repository guidance instead of creating a skill.
69
- 2. Search existing skills before adding a new one. Prefer updating a matching skill over creating overlapping procedures.
70
- 3. Use a stable folder name and matching frontmatter `name`. Set `mustflow_doc` to `skill.<name>`, `metadata.mustflow_schema` to `"1"`, `metadata.mustflow_kind` to `procedure`, `metadata.pack_id` to the package namespace, and `metadata.skill_id` to `<pack_id>.<name>`.
71
- 4. Redigez les sections standard : Objectif, Utiliser Quand, Ne Pas Utiliser Quand, Entrees Requises, Preconditions, Modifications Autorisees, Procedure, Postconditions, Verification, Gestion Des Echecs et Format De Sortie.
72
- 5. Keep the procedure concrete and bounded. Include what to read, what to change, what to avoid, and what evidence to report.
73
- 6. Reference command intent names only. Do not include raw shell command blocks or claim that the skill authorizes command execution.
74
- 7. Mettez a jour `.mustflow/skills/INDEX.md` avec une route compacte qui inclut declencheur, entree requise, perimetre de modification, risque, intentions de verification et sortie attendue.
75
- 8. If the skill is installed by a template, update template manifests, localization metadata, installation docs, package tests, and public docs that list installed files.
76
-
77
- <!-- mustflow-section: postconditions -->
78
- ## Postconditions
79
-
80
- - La sortie attendue peut etre produite avec preuves claires, intentions de commande executees, verifications ignorees et risques restants.
81
- - Toute intention de commande manquante, entree inconnue ou conflit d'autorite est signale au lieu d'etre cache.
82
-
83
- <!-- mustflow-section: verification -->
84
- ## Verification
85
-
86
- Use configured oneshot command intents when available:
87
-
88
- - `mustflow_check`
89
- - `docs_validate`
90
-
91
- If the skill changes tests or behavior-sensitive template output, also use the relevant configured test or build intents.
92
-
93
- <!-- mustflow-section: failure-handling -->
94
- ## Failure Handling
95
-
96
- - If `mustflow_check` reports missing sections, metadata drift, unknown command intents, raw shell commands, or command-permission claims, fix the skill contract before changing unrelated files.
97
- - If two skills overlap, tighten their use and non-use conditions or merge the duplicate procedure.
98
- - If a needed command intent is missing, record the missing intent instead of inventing a command inside the skill.
99
- - If translation confidence is low, keep the source skill authoritative and mark translations for review through template metadata.
100
-
101
- <!-- mustflow-section: output-format -->
102
- ## Output Format
103
-
104
- - Skill files added, updated, renamed, or removed
105
- - Skill index routes changed
106
- - Command intents referenced
107
- - Template or localization metadata updated
108
- - Command intents run
109
- - Skipped command intents and reasons
110
- - Remaining overlap, translation, or validation risks
@@ -1,111 +0,0 @@
1
- ---
2
- mustflow_doc: skill.source-freshness-check
3
- locale: fr
4
- canonical: false
5
- revision: 1
6
- lifecycle: mustflow-owned
7
- authority: procedure
8
- name: source-freshness-check
9
- description: Apply this skill when a task depends on information that may become stale, such as current versions, external docs, prices, dates, schedules, or product behavior.
10
- metadata:
11
- mustflow_schema: "1"
12
- mustflow_kind: procedure
13
- pack_id: mustflow.core
14
- skill_id: mustflow.core.source-freshness-check
15
- command_intents:
16
- - changes_status
17
- - docs_validate_fast
18
- - mustflow_check
19
- ---
20
-
21
- # Source Freshness Check
22
-
23
- <!-- mustflow-section: purpose -->
24
- ## Purpose
25
-
26
- Prevent stale or unverifiable claims from entering code, documentation, templates, release notes, or final reports.
27
-
28
- <!-- mustflow-section: use-when -->
29
- ## Use When
30
-
31
- - The task asks for the latest, current, newest, today, yesterday, tomorrow, or a specific recent date.
32
- - A claim depends on external products, APIs, package versions, pricing, legal rules, schedules, sports, markets, or vendor documentation.
33
- - Documentation or user-facing text mentions support status, release behavior, command availability, or compatibility that may drift.
34
- - A source, quote, screenshot, or generated summary may be older than the current task.
35
-
36
- <!-- mustflow-section: do-not-use-when -->
37
- ## Do Not Use When
38
-
39
- - The fact is purely local to the repository and can be verified from current files.
40
- - The task is a mechanical edit that does not introduce or preserve time-sensitive claims.
41
- - The user explicitly provides the source text to use and asks only for formatting or translation.
42
-
43
- <!-- mustflow-section: required-inputs -->
44
- ## Required Inputs
45
-
46
- - The claim or decision that may become stale.
47
- - The file, command output, source page, screenshot, or user-provided text that supports the claim.
48
- - The date or version context when it is visible.
49
- - Any repository policy about allowed sources, official documentation, or offline work.
50
-
51
- <!-- mustflow-section: preconditions -->
52
- ## Preconditions
53
-
54
- - The task matches the Use When conditions and does not match the Do Not Use When exclusions.
55
- - Required inputs are available, or missing inputs can be reported without guessing.
56
- - Higher-priority instructions and `.mustflow/config/commands.toml` have been checked for the current scope.
57
-
58
- <!-- mustflow-section: allowed-edits -->
59
- ## Allowed Edits
60
-
61
- - Add or update source-date notes only where they clarify freshness risk.
62
- - Replace unstable wording such as "latest" with a dated or versioned claim when appropriate.
63
- - Mark translations or docs for review when the source cannot be verified confidently.
64
- - Do not invent citations, release dates, compatibility ranges, or vendor behavior.
65
-
66
- <!-- mustflow-section: procedure -->
67
- ## Procedure
68
-
69
- 1. Identify every claim that depends on time, external behavior, or an upstream source.
70
- 2. Prefer the current repository file, official source, declared package metadata, or user-provided source text before secondary summaries.
71
- 3. Capture the freshness boundary: date checked, version checked, release tag, documentation page, or reason the claim is local and stable.
72
- 4. If a claim cannot be refreshed within the allowed tools or command contract, keep the wording conservative and report the unverified source.
73
- 5. Avoid open-ended words such as "latest", "current", or "recent" unless the sentence includes the concrete date or version that makes the claim inspectable.
74
- 6. When editing documentation, keep source notes close to the claim or in the final report rather than adding broad provenance sections.
75
- 7. Run the smallest configured verification that covers the changed files.
76
-
77
- <!-- mustflow-section: postconditions -->
78
- ## Postconditions
79
-
80
- - Time-sensitive claims are either verified, dated, versioned, or explicitly reported as unverified.
81
- - Documentation does not imply live freshness when only a snapshot was checked.
82
- - The final report names skipped refresh checks and any remaining stale-source risk.
83
-
84
- <!-- mustflow-section: verification -->
85
- ## Verification
86
-
87
- Use configured oneshot command intents when available:
88
-
89
- - `changes_status`
90
- - `docs_validate_fast`
91
- - `mustflow_check`
92
-
93
- Also run the relevant configured test, build, or documentation intent if the refreshed claim changes executable behavior or public documentation.
94
-
95
- <!-- mustflow-section: failure-handling -->
96
- ## Failure Handling
97
-
98
- - If the requested source cannot be accessed, report the access gap and avoid presenting the claim as current.
99
- - If sources conflict, prefer the highest-authority source and report the conflict.
100
- - If the freshness check changes meaning in translated docs, mark the affected translation for review.
101
- - If checking freshness would require network access or tools outside the current host permissions, stop at the permission boundary and state what remains unchecked.
102
-
103
- <!-- mustflow-section: output-format -->
104
- ## Output Format
105
-
106
- - Freshness-sensitive claims found
107
- - Source or version checked
108
- - Wording changed or claim left conservative
109
- - Command intents run
110
- - Skipped source checks and reasons
111
- - Remaining stale-source risk