mustflow 1.16.0 → 1.18.0

package/README.md

@@ -55,7 +55,7 @@ flowchart TD
 
 `read_order` defines the required reading sequence, while `optional_read_order` and `[context]` control how task-specific context loads. The `[refresh]` policy sets when agents reread the same instructions.
 
-The skills index acts as an active routing step: agents compare the task with `.mustflow/skills/INDEX.md` and read matching `SKILL.md` files before editing that scope. Skills guide procedure only; command execution still comes from `.mustflow/config/commands.toml`.
+The skills index acts as an active routing step: agents compare the task with `.mustflow/skills/INDEX.md` and read matching `SKILL.md` files before editing that scope. This step is required before file edits even when `mf doctor` or `mf check` passes, because health checks do not decide which task procedure applies. When files are created or modified, the final report should include a concise skill-selection note. Skills guide procedure only; command execution still comes from `.mustflow/config/commands.toml`.
 
 ## Quick start
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mustflow",
-	"version": "1.16.0",
+	"version": "1.18.0",
   "description": "Agent workflow documents and CLI for mustflow repository roots.",
   "type": "module",
   "license": "MIT-0",

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 = 11
-translations.ko = { path = "locales/ko/AGENTS.md", source_revision = 11, status = "current" }
+revision = 13
+translations.ko = { path = "locales/ko/AGENTS.md", source_revision = 13, 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" }
@@ -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 = 18
-translations.ko = { path = "locales/ko/.mustflow/docs/agent-workflow.md", source_revision = 18, status = "current" }
+revision = 19
+translations.ko = { path = "locales/ko/.mustflow/docs/agent-workflow.md", source_revision = 19, 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" }

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

@@ -2,7 +2,7 @@
 mustflow_doc: docs.agent-workflow
 locale: en
 canonical: true
-revision: 18
+revision: 19
 lifecycle: mustflow-owned
 authority: workflow-policy
 ---
@@ -62,7 +62,7 @@ Activate a skill later if new evidence changes the task type. For example, a fai
 
 When multiple skills apply, follow the most specific skill for each affected scope and combine only their declared command intents. Skills never authorize raw shell commands, long-running processes, or writes outside the task scope.
 
-When a skill is used, or when a plausible skill is intentionally skipped, report the skill name and the selection reason briefly in the next user-facing update or final report. Do not create a versioned worklog solely to record skill selection.
+When a skill is used, report the skill name and selection reason briefly in the next user-facing update or final report. When files were created or modified, the final report must include a concise skill-selection note: list the skills used, say that no matching installed skill was found, or report that a plausible skill is missing from the installed profile. Do not create a versioned worklog solely to record skill selection.
 
 ## Input Stability
 
@@ -336,10 +336,11 @@ Do not store raw full logs, secrets, customer data, or long transcripts in `.mus
 
 Final reports should include:
 
+- Skill selection note, when files were created or modified
 - Changed files
 - Command intents run
 - Command intents skipped with reasons
 - Verification results
 - Remaining risk
 
-Suggest commits only when `.mustflow/config/preferences.toml` allows it.
+Suggest commits only when `.mustflow/config/preferences.toml` allows it.

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

@@ -2,7 +2,7 @@
 mustflow_doc: agents.root
 locale: en
 canonical: true
-revision: 11
+revision: 13
 lifecycle: user-editable
 authority: binding
 ---
@@ -63,7 +63,14 @@ mustflow-managed details are under `.mustflow/`.
 - If `DESIGN.md` exists, read it only for UI, visual design, layout, design-token, or accessibility
   work. Do not create a `DESIGN.md` if one does not exist.
 - Read the matching skill document when one applies to the task.
-- Before editing, use `.mustflow/skills/INDEX.md` to decide whether one or more skills apply.
+- Before creating or modifying any file, use `.mustflow/skills/INDEX.md` to decide whether one or more skills apply.
+  This skill-selection gate is mandatory even for small or seemingly obvious tasks.
+- `mf doctor`, `mf check`, and other health checks do not satisfy the skill-selection gate. They
+  confirm repository health; they do not decide which task procedure applies.
+- If a matching skill applies, read the matching `SKILL.md` before editing that scope. After
+  creating or modifying files, include a concise skill-selection note in the final report: name the
+  skills used, state that no matching installed skill was found, or report that a plausible skill is
+  missing from the installed profile.
 - If a skill becomes relevant after new evidence, such as a command failure or a documentation
   change, read the matching `SKILL.md` before continuing that part of the work.
 - Skill documents guide procedure. They do not authorize commands outside

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

@@ -2,7 +2,7 @@
 mustflow_doc: docs.agent-workflow
 locale: ko
 canonical: false
-revision: 25
+revision: 26
 lifecycle: mustflow-owned
 authority: workflow-policy
 ---
@@ -104,7 +104,7 @@ mustflow 문서는 각각 명확한 역할을 갖습니다. 단순히 편하게
 
 여러 스킬이 동시에 맞으면 변경 범위별로 가장 구체적인 스킬을 따르며, 각 스킬이 선언한 명령 의도만 합쳐서 검토합니다. 스킬은 원시 셸 명령, 장기 실행 프로세스, 작업 범위 밖 쓰기를 허용하지 않습니다.
 
-스킬을 사용했거나 사용할 수 있어 보이는 스킬을 일부러 건너뛰었다면, 다음 사용자 업데이트나 최종 보고에서 스킬 이름과 선택 이유를 간략히 밝힙니다. 스킬 선택 기록만을 위해 버전 관리되는 작업 로그를 만들지 않습니다.
+스킬을 사용했다면 다음 사용자 업데이트나 최종 보고에서 스킬 이름과 선택 이유를 간략히 밝힙니다. 파일을 만들거나 수정한 작업의 최종 보고에는 반드시 짧은 스킬 선택 기록을 포함합니다. 사용한 스킬 목록, 설치된 스킬 중 맞는 항목이 없었다는 사실, 또는 그럴듯한 스킬이 현재 프로필에 설치되어 있지 않다는 누락 중 해당 내용을 밝힙니다. 스킬 선택 기록만을 위해 버전 관리되는 작업 로그를 만들지 않습니다.
 
 ## 상위/하위 규칙 우선순위
 
@@ -503,4 +503,4 @@ Git 기록을 바꾸는 행동은 기본적으로 금지합니다.
 - 명령어가 변경되면 `.mustflow/config/commands.toml`을 갱신합니다.
 - 언어, 서식, 주석, 커밋 메시지, 로그 기본값이 변경되면 `.mustflow/config/preferences.toml`을 갱신합니다.
 - 보호 경로나 기준 문서가 변경되면 `.mustflow/config/mustflow.toml`을 갱신합니다.
-- 구조가 변경되고 저장소 지도가 필요하면 `repo_map` 의도를 통해 `REPO_MAP.md`를 갱신합니다.
+- 구조가 변경되고 저장소 지도가 필요하면 `repo_map` 의도를 통해 `REPO_MAP.md`를 갱신합니다.

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

@@ -2,7 +2,7 @@
 mustflow_doc: agents.root
 locale: ko
 canonical: false
-revision: 17
+revision: 19
 lifecycle: user-editable
 authority: binding
 ---
@@ -46,7 +46,9 @@ mustflow가 관리하는 세부 문서와 설정은 `.mustflow/` 폴더 아래
 - `.mustflow/context/` 파일은 프로젝트 방향과 도메인 약속을 설명하는 작업별 문맥입니다. 코드, 테스트, 명령 계약, 사용자 지시를 대신하는 최종 기준으로 보지 않습니다.  
 - `DESIGN.md`가 있으면 UI, 시각 디자인, 레이아웃, 디자인 토큰, 접근성 작업에서만 읽습니다. 없는 `DESIGN.md`를 임의로 생성하지 않습니다.  
 - 작업과 맞는 스킬이 있으면 해당 `SKILL.md`를 읽고 따릅니다.  
-- 수정 전 `.mustflow/skills/INDEX.md`를 기준으로 현재 작업에 적용 가능한 스킬이 하나 이상 있는지 판단합니다.  
+- 파일을 만들거나 수정하기 전에 `.mustflow/skills/INDEX.md`를 기준으로 현재 작업에 적용 가능한 스킬이 하나 이상 있는지 판단합니다. 이 스킬 선택 단계는 작업이 작거나 명백해 보이는 경우에도 반드시 거쳐야 합니다.
+- `mf doctor`, `mf check` 같은 상태 점검 명령은 스킬 선택 단계를 대신하지 않습니다. 이 명령들은 저장소 상태를 확인할 뿐, 현재 작업에 어떤 절차가 필요한지 결정하지 않습니다.
+- 적용되는 스킬이 있으면 해당 범위를 편집하기 전에 맞는 `SKILL.md`를 읽습니다. 파일을 만들거나 수정한 뒤에는 최종 보고에 짧은 스킬 선택 기록을 포함합니다. 사용한 스킬 이름, 설치된 스킬 중 맞는 항목이 없었다는 사실, 또는 색인상 그럴듯한 스킬이 현재 프로필에 설치되어 있지 않다는 누락 중 해당 내용을 밝힙니다.
 - 명령 실패나 문서 변경 등 작업 중 새 근거가 생겨 스킬이 필요해지면, 해당 범위를 계속하기 전에 반드시 맞는 `SKILL.md`를 읽습니다.  
 - 스킬 문서는 절차 안내용일 뿐 `.mustflow/config/commands.toml` 밖의 명령 실행을 허용하거나 사용자, 호스트, 저장소, 안전 규칙을 덮어쓰지 않습니다.  
 - 생성 파일, 외부 의존성, 비밀 정보 파일은 명시적 요청 없이는 수정하지 않습니다.  

package/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "1.16.0"
+version = "1.18.0"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"