mustflow 2.59.0 → 2.69.0

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

@@ -3,7 +3,7 @@ mustflow_doc: context.project
 kind: mustflow-context
 locale: ko
 canonical: false
-revision: 2
+revision: 4
 name: project
 authority: contextual
 lifecycle: user-editable
@@ -58,7 +58,9 @@ source_refs:
 - `.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`
+- 사람이 읽을 라우트 근거가 필요할 때만 `.mustflow/skills/INDEX.md`
 
 ## 오래된 내용 확인
 

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

@@ -2,7 +2,7 @@
 mustflow_doc: docs.agent-workflow
 locale: ko
 canonical: false
-revision: 28
+revision: 31
 lifecycle: mustflow-owned
 authority: workflow-policy
 ---
@@ -44,7 +44,9 @@ mustflow 문서는 각각 명확한 역할을 갖습니다. 단순히 편하게
 | `.mustflow/config/preferences.toml` | 스타일, 언어, Git 제안, 테스트 작성 성향, 검증 선택, 버전 영향의 기본값입니다. | 권한이 아닌 낮은 권위의 선호 설정입니다. | 저장소별로 사용자가 조정할 수 있는 TOML 파일입니다. |
 | `.mustflow/context/INDEX.md` | 작업별 컨텍스트 파일을 선택하는 라우터입니다. | 선택형 컨텍스트만 고르며 정책 설명서는 아닙니다. | mustflow가 소유하는 Markdown 문서입니다. |
 | `.mustflow/context/PROJECT.md` | 신중한 프로젝트 사실, 미지점, 도메인 관습을 기록합니다. | 사용자 지시, 코드, 테스트, 명령 계약, 설정된 정책보다 낮은 권위의 참고 자료입니다. | 사용자가 수정 가능한 컨텍스트 문서입니다. |
-| `.mustflow/skills/INDEX.md` | 작업에 맞는 절차 문서를 선택하는 라우터입니다. | 선택 계약만 담당하며 자세한 절차는 `SKILL.md`에 둡니다. | mustflow가 소유하는 Markdown 문서입니다. |
+| `.mustflow/skills/router.toml` | 프롬프트 캐시에 친화적인 첫 스킬 선택을 위한 안정적인 압축 라우트 범주와 fallback 규칙입니다. | 선택 kernel만 담당하며 자세한 절차는 `SKILL.md`에 둡니다. | mustflow가 소유하는 TOML 파일입니다. |
+| `.mustflow/skills/routes.toml` | 압축 router만으로 부족할 때 사용하는 전체 라우트 메타데이터입니다. | 선택 힌트만 담당하며 자세한 절차는 `SKILL.md`에 둡니다. | mustflow가 소유하는 TOML 파일입니다. |
+| `.mustflow/skills/INDEX.md` | 상세 스킬 선택과 라우트 유지보수를 위한 사람이 읽는 확장 라우트 표입니다. | 선택 계약만 담당하며 자세한 절차는 `SKILL.md`에 둡니다. | mustflow가 소유하는 Markdown 문서입니다. |
 | `.mustflow/skills/<name>/SKILL.md` | 반복 작업의 입력, 허용 범위, 검사, 보고 형식을 담은 절차입니다. | 절차 안내일 뿐이며 명령 실행 권한을 부여하거나 다른 규칙을 덮어쓰지 않습니다. | mustflow가 소유하는 Markdown 문서이며, 필요 시 언어별로 설치됩니다. |
 | `REPO_MAP.md` | 넓은 탐색과 하위 저장소 진입점을 위한 생성 앵커 지도입니다. | 현재 파일과 현재 지시보다 낮은 생성 탐색 보조 자료입니다. | 생성 파일이며 `repo_map` 인텐트 또는 `mf map`으로 갱신합니다. |
 
@@ -68,9 +70,11 @@ mustflow 문서는 각각 명확한 역할을 갖습니다. 단순히 편하게
 3. `.mustflow/config/mustflow.toml`
 4. `.mustflow/config/commands.toml`
 5. `.mustflow/config/preferences.toml`이 있으면 읽기
-6. `.mustflow/skills/INDEX.md`
-7. 현재 작업과 맞는 `.mustflow/skills/<name>/SKILL.md`
-8. 관련 소스, 테스트, 문서 파일
+6. `.mustflow/skills/router.toml`
+7. 압축 router만으로 부족하거나 스킬 라우팅을 수정하거나 상세 라우트 메타데이터가 필요하거나 라우트 확신도가 애매할 때 `.mustflow/skills/routes.toml`
+8. 전체 라우트 메타데이터만으로도 부족하거나 확장 라우트 표를 수정하거나 사람이 읽을 트리거 근거가 필요할 때 `.mustflow/skills/INDEX.md`
+9. 현재 작업과 맞는 `.mustflow/skills/<name>/SKILL.md`
+10. 관련 소스, 테스트, 문서 파일
 
 `REPO_MAP.md`는 넓은 저장소 탐색이 필요할 때만 읽습니다. 이 파일은 전체 파일 목록이 아니라 `AGENTS.md`, `README.md`, `package.json`, `SKILL.md`, 주요 설정 파일 같은 앵커를 찾아 에이전트가 처음 볼 위치를 줄이기 위한 생성 지도입니다. 전체 파일 목록이 필요하면 `git ls-files`나 편집기 파일 탐색기를 사용합니다. `node_modules`, `dist`, `build`, `.git`, 캐시, 대용량 산출물은 제외합니다.
 
@@ -95,10 +99,12 @@ mustflow 문서는 각각 명확한 역할을 갖습니다. 단순히 편하게
 
 작업 시작 시점과 첫 수정 전에는 다음 순서를 따릅니다.
 
-1. `.mustflow/skills/INDEX.md`를 읽습니다.
-2. 현재 사용자 요청과 예상 변경 파일을 색인의 시나리오와 비교합니다.
-3. 맞는 시나리오가 하나 이상 있으면 해당 `SKILL.md`를 읽은 뒤 그 범위를 수정합니다.
-4. 맞는 스킬이 없으면 새 스킬을 추측하지 않고 `AGENTS.md`와 `.mustflow/config/commands.toml`을 기준으로 가장 작은 안전한 변경을 수행합니다.
+1. `.mustflow/skills/router.toml`에서 안정적인 라우트 범주, 범주 신호, 선택 제한, fallback 규칙을 읽습니다.
+2. 현재 사용자 요청, 예상 변경 파일, 발견한 기술 스택, 이벤트 신호를 범주 신호와 비교합니다.
+3. 압축 router만으로 부족하거나 스킬 라우팅을 수정하거나 상세 라우트 메타데이터가 필요하거나 라우트 확신도가 애매하면 `.mustflow/skills/routes.toml`을 읽습니다.
+4. 전체 라우트 메타데이터만으로도 부족하거나 확장 라우트 표를 수정하거나 사람이 읽을 트리거 근거가 필요하면 `.mustflow/skills/INDEX.md`를 읽습니다.
+5. 맞는 시나리오가 하나 이상 있으면 해당 `SKILL.md`를 읽은 뒤 그 범위를 수정합니다.
+6. 맞는 스킬이 없으면 새 스킬을 추측하지 않고 `AGENTS.md`와 `.mustflow/config/commands.toml`을 기준으로 가장 작은 안전한 변경을 수행합니다.
 
 작업 중 새 근거가 생겨 작업 유형이 바뀌면 그때 스킬을 다시 선택합니다. 예를 들어 설정된 명령이 실패하면 실패 원인 추적 스킬을, 테스트 계약이 바뀌면 테스트 유지보수 스킬을, 문서나 워크플로가 바뀌면 문서 수정 스킬을 읽습니다.
 
@@ -160,8 +166,8 @@ mustflow는 LLM 제공자의 입력 캐시 적중을 보장하지 않습니다.
 
 호스트나 에이전트 실행 하네스가 모델 입력을 조립할 때는 다음 순서를 지켜야 합니다.
 
-1. 안정 접두부: `mf context --json --cache-profile stable`에서 얻은 저장소 규칙과 작업 흐름 문서입니다.
-2. 작업 컨텍스트: 선택된 컨텍스트 파일, 맞는 스킬, 저장소 지도 앵커, 관련 소스 파일, 그리고 `cache_layer`가 `task`인 `mf search --json` 결과입니다.
+1. 안정 접두부: `mf context --json --cache-profile stable`에서 얻은 저장소 진입 규칙과 압축 route kernel입니다.
+2. 작업 컨텍스트: 선택된 컨텍스트 파일, 작업 흐름과 구성 refresh 조각, 명령 인텐트 정의, 전체 라우트 메타데이터 fallback, 상세 스킬 색인 fallback, 맞는 스킬, 저장소 지도 앵커, 관련 소스 파일, 그리고 `cache_layer`가 `task`인 `mf search --json` 결과입니다.
 3. 변동 접미부: 현재 사용자 요청, 변경 파일 목록, 명령 출력 끝부분, 최신 실행 기록 메타데이터, 시각 정보, 그리고 `volatile` 값이 `true`인 `mf search --json` 결과입니다.
 
 안정 접두부를 재사용하기 전에는 보고된 콘텐츠 해시를 현재 파일과 비교합니다. 안정 문서의 해시가 하나라도 바뀌면 캐시된 텍스트를 재사용하지 말고 해당 문서를 다시 읽어야 합니다. 절대로 로컬 경로, 실행 기록 시각, 명령 출력, 변경 파일, 현재 사용자 작업 문구는 안정 접두부보다 앞에 두지 않습니다.
@@ -204,7 +210,7 @@ mustflow 지침은 다음 지점에서 다시 확인합니다.
 - `command`: `AGENTS.md`와 `.mustflow/config/commands.toml`을 다시 읽습니다.
 - `edit`: 민감한 수정 전에 `AGENTS.md`, `.mustflow/config/mustflow.toml`, `.mustflow/docs/agent-workflow.md`를 다시 읽습니다.
 - `report`: 최종 보고 전에 `AGENTS.md`, `.mustflow/config/mustflow.toml`, `.mustflow/config/preferences.toml`을 다시 읽습니다.
-- `skill`: `AGENTS.md`와 `.mustflow/skills/INDEX.md`를 다시 읽습니다.
+- `skill`: `AGENTS.md`와 `.mustflow/skills/router.toml`을 다시 읽습니다.
 - `full`: mustflow 필수 읽기 순서 전체를 다시 읽습니다.
 
 `before_command_run`은 현재 명령 인텐트에 대한 최신성 확인 지점입니다. 명령 계약이 바뀌지 않았다면 같은 명령을 반복할 때마다 모든 파일을 다시 읽으라는 뜻이 아닙니다.

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

@@ -2,7 +2,7 @@
 mustflow_doc: agents.root
 locale: ko
 canonical: false
-revision: 22
+revision: 24
 lifecycle: user-editable
 authority: binding
 ---
@@ -21,13 +21,15 @@ mustflow가 관리하는 세부 문서와 설정은 `.mustflow/` 폴더 아래
 4. `.mustflow/config/commands.toml`  
 5. `.mustflow/config/preferences.toml` (있다면)  
 6. `.mustflow/config/technology.toml` (있다면)  
-7. `.mustflow/skills/INDEX.md`  
+7. `.mustflow/skills/router.toml`
 8. 프로젝트, 제품, 도메인, UI, 백엔드, 데이터, 보안, 운영 컨텍스트가 필요한 경우  
    `.mustflow/context/INDEX.md`  
 9. 컨텍스트 색인에서 선택된 `.mustflow/context/<name>.md` 파일  
-10. 현재 작업과 관련된 `.mustflow/skills/<name>/SKILL.md`  
-11. 넓은 저장소 탐색이 필요할 때만 `REPO_MAP.md`  
-12. 관련 소스, 테스트, 문서 파일
+10. 압축 router만으로 판단이 부족하거나 스킬 라우팅을 수정하거나 상세 라우트 메타데이터가 필요하거나 라우트 확신도가 애매한 경우에만 `.mustflow/skills/routes.toml`
+11. 라우트 메타데이터만으로 부족하거나 확장 라우트 표를 수정하거나 사람이 읽을 트리거 근거가 필요한 경우에만 `.mustflow/skills/INDEX.md`
+12. 현재 작업과 관련된 `.mustflow/skills/<name>/SKILL.md`
+13. 넓은 저장소 탐색이 필요할 때만 `REPO_MAP.md`
+14. 관련 소스, 테스트, 문서 파일
 
 ## 핵심 규칙
 
@@ -47,7 +49,7 @@ mustflow가 관리하는 세부 문서와 설정은 `.mustflow/` 폴더 아래
 - `.mustflow/context/` 파일은 프로젝트 방향과 도메인 약속을 설명하는 작업별 컨텍스트입니다. 코드, 테스트, 명령 계약, 사용자 지시를 대신하는 최종 기준으로 보지 않습니다.  
 - `DESIGN.md`가 있으면 UI, 시각 디자인, 레이아웃, 디자인 토큰, 접근성 작업에서만 읽습니다. 없는 `DESIGN.md`를 임의로 생성하지 않습니다.  
 - 작업과 맞는 스킬이 있으면 해당 `SKILL.md`를 읽고 따릅니다.  
-- 파일을 만들거나 수정하기 전에 `.mustflow/skills/INDEX.md`를 기준으로 현재 작업에 적용 가능한 스킬이 하나 이상 있는지 판단합니다. 이 스킬 선택 단계는 작업이 작거나 명백해 보이는 경우에도 반드시 거쳐야 합니다.
+- 파일을 만들거나 수정하기 전에 `.mustflow/skills/router.toml`로 현재 작업에 맞는 라우트 범주와 스킬 절차가 있는지 먼저 판단합니다. 압축 router만으로 부족하거나, 스킬 라우팅을 수정하거나, 상세 라우트 메타데이터가 필요하거나, 라우트 확신도가 애매할 때만 `.mustflow/skills/routes.toml`을 읽습니다. 전체 라우트 메타데이터만으로도 부족하거나, 확장 라우트 표를 수정하거나, 사람이 읽을 트리거 근거가 필요할 때만 `.mustflow/skills/INDEX.md`를 읽습니다. 이 스킬 선택 단계는 작업이 작거나 명백해 보이는 경우에도 반드시 거쳐야 합니다.
 - `mf doctor`, `mf check` 같은 상태 점검 명령은 스킬 선택 단계를 대신하지 않습니다. 이 명령들은 저장소 상태를 확인할 뿐, 현재 작업에 어떤 절차가 필요한지 결정하지 않습니다.
 - 적용되는 스킬이 있으면 해당 범위를 편집하기 전에 맞는 `SKILL.md`를 읽습니다. 파일을 만들거나 수정한 뒤에는 최종 보고에 짧은 스킬 선택 기록을 포함합니다. 사용한 스킬 이름, 설치된 스킬 중 맞는 항목이 없었다는 사실, 또는 색인상 그럴듯한 스킬이 현재 프로필에 설치되어 있지 않다는 누락 중 해당 내용을 밝힙니다.
 - 명령 실패나 문서 변경 등 작업 중 새 근거가 생겨 스킬이 필요해지면, 해당 범위를 계속하기 전에 반드시 맞는 `SKILL.md`를 읽습니다.  

package/templates/default/manifest.toml

@@ -1,6 +1,6 @@
 id = "default"
 name = "default"
-version = "2.59.0"
+version = "2.69.0"
 description = "Minimal workflow for LLM agents to read, edit, and verify their work in a repository."
 common_root = "common"
 locales_root = "locales"
@@ -10,6 +10,7 @@ creates = [
   ".mustflow/context/INDEX.md",
   ".mustflow/context/PROJECT.md",
   ".mustflow/skills/INDEX.md",
+  ".mustflow/skills/router.toml",
   ".mustflow/skills/routes.toml",
   ".mustflow/skills/adapter-boundary/SKILL.md",
   ".mustflow/skills/api-contract-change/SKILL.md",
@@ -169,7 +170,9 @@ creates = [
   ".mustflow/skills/security-regression-tests/SKILL.md",
   ".mustflow/skills/secret-exposure-response/SKILL.md",
   ".mustflow/skills/search-ad-content-authoring/SKILL.md",
+  ".mustflow/skills/skill-refresh/SKILL.md",
   ".mustflow/skills/skill-authoring/SKILL.md",
+  ".mustflow/skills/task-instruction-authoring/SKILL.md",
   ".mustflow/skills/template-install-surface-sync/SKILL.md",
   ".mustflow/skills/visual-review-artifact/SKILL.md",
   ".mustflow/skills/visual-review-artifact/resources.toml",
@@ -323,6 +326,7 @@ minimal = [
   "secret-exposure-response",
   "source-anchor-authoring",
   "source-freshness-check",
+  "task-instruction-authoring",
   "structure-discovery-gate",
   "structure-first-engineering",
   "test-design-guard",
@@ -460,6 +464,7 @@ patterns = [
   "secret-exposure-response",
   "source-anchor-authoring",
   "source-freshness-check",
+  "task-instruction-authoring",
   "state-machine-pattern",
   "strategy-pattern",
   "structure-discovery-gate",
@@ -612,10 +617,12 @@ oss = [
   "security-privacy-review",
   "security-regression-tests",
   "secret-exposure-response",
+  "skill-refresh",
   "skill-authoring",
   "template-install-surface-sync",
   "source-anchor-authoring",
   "source-freshness-check",
+  "task-instruction-authoring",
   "state-machine-pattern",
   "strategy-pattern",
   "structure-discovery-gate",
@@ -758,6 +765,7 @@ team = [
   "secret-exposure-response",
   "source-anchor-authoring",
   "source-freshness-check",
+  "task-instruction-authoring",
   "state-machine-pattern",
   "strategy-pattern",
   "structure-discovery-gate",
@@ -900,6 +908,7 @@ product = [
   "search-ad-content-authoring",
   "source-anchor-authoring",
   "source-freshness-check",
+  "task-instruction-authoring",
   "state-machine-pattern",
   "strategy-pattern",
   "structure-discovery-gate",
@@ -1053,9 +1062,11 @@ library = [
   "security-privacy-review",
   "security-regression-tests",
   "secret-exposure-response",
+  "skill-refresh",
   "template-install-surface-sync",
   "source-anchor-authoring",
   "source-freshness-check",
+  "task-instruction-authoring",
   "state-machine-pattern",
   "strategy-pattern",
   "structure-discovery-gate",