mustflow 1.15.97

package/templates/default/locales/hi/.mustflow/skills/web-asset-optimization/SKILL.md

@@ -0,0 +1,108 @@
+---
+mustflow_doc: skill.web-asset-optimization
+locale: hi
+canonical: false
+revision: 2
+lifecycle: mustflow-owned
+authority: procedure
+name: web-asset-optimization
+description: Apply this skill when adding, converting, resizing, replacing, or reviewing raster image assets for websites or web applications.
+metadata:
+  mustflow_schema: "1"
+  mustflow_kind: procedure
+  pack_id: mustflow.core
+  skill_id: mustflow.core.web-asset-optimization
+  command_intents:
+    - asset_optimize
+    - build
+---
+
+# Web Asset Optimization
+
+<!-- mustflow-section: purpose -->
+## Purpose
+
+Keep web image assets small, format-appropriate, and correctly referenced without inventing an image pipeline for the project.
+
+<!-- mustflow-section: use-when -->
+## Use When
+
+- A generated PNG, JPEG, WebP, AVIF, GIF, or other raster image is added to a website or web app.
+- An existing web image is replaced, resized, compressed, or converted.
+- A page, component, stylesheet, or metadata file changes image references.
+- A user asks to reduce image size, convert to WebP or AVIF, or prepare generated images for production use.
+
+<!-- mustflow-section: do-not-use-when -->
+## Do Not Use When
+
+- The asset is a vector source such as SVG, icon font, or design-token file.
+- The image is an archival, print, source, or evidence artifact where preserving the original bytes matters more than web delivery size.
+- The repository already has a more specific media, design-system, or framework asset procedure.
+- The task is only to generate a new image and not to install or reference it in the repository.
+
+<!-- mustflow-section: required-inputs -->
+## Required Inputs
+
+- The image file paths and their current or intended references.
+- The expected display size, transparency needs, animation needs, and quality requirements.
+- Existing framework image conventions, static asset folders, and import style.
+- `.mustflow/config/commands.toml` entries for `asset_optimize` and `build`.
+
+<!-- mustflow-section: preconditions -->
+## Preconditions
+
+- The task matches the Use When conditions and does not match the Do Not Use When exclusions.
+- Required inputs are available, or missing inputs can be reported without guessing.
+- Higher-priority instructions and `.mustflow/config/commands.toml` have been checked for the current scope.
+
+<!-- mustflow-section: allowed-edits -->
+## Allowed Edits
+
+- Keep edits within the scope described by this skill, the user request, and the matching route in `.mustflow/skills/INDEX.md`.
+- Do not broaden command permission, invent project facts, or change unrelated workflow files.
+
+<!-- mustflow-section: procedure -->
+## Procedure
+
+1. Identify every changed image asset and every page, component, style, metadata, or manifest reference that depends on it.
+2. Check the original file size, dimensions, format, transparency, and animation before changing the asset.
+3. Prefer the repository's existing image pipeline, framework image component, or configured `asset_optimize` intent when one exists.
+4. Do not add a new dependency, online service, or ad hoc conversion tool unless the user explicitly approves it or the repository already uses it.
+5. Choose the output format based on actual needs: WebP or AVIF for most photographic and generated bitmap website assets, PNG when lossless transparency or exact pixels matter, and SVG only for real vector artwork.
+6. Keep source and derived assets separate when the repository already has that convention. Otherwise, avoid adding duplicate originals unless future editing requires them.
+7. Update imports, static paths, metadata references, dimensions, and cache-sensitive filenames according to the local style.
+8. Compare before and after file sizes and note any quality, transparency, animation, browser-support, or fallback tradeoff.
+
+<!-- mustflow-section: postconditions -->
+## Postconditions
+
+- The expected output can be produced with clear evidence, executed command intents, skipped checks, and remaining risks.
+- Any missing command intent, unknown input, or authority conflict is reported instead of hidden.
+
+<!-- mustflow-section: verification -->
+## Verification
+
+Use configured oneshot command intents when available:
+
+- `asset_optimize`
+- `build`
+
+Do not infer missing image optimization commands. If `asset_optimize` is unknown, missing, manual-only, or not agent-runnable, report that status and describe the intended optimization without executing an unconfigured tool.
+
+<!-- mustflow-section: failure-handling -->
+## Failure Handling
+
+- If optimization visibly degrades the image or breaks transparency, restore or keep the better asset and report the tradeoff.
+- If image references break, fix the nearest import, path, metadata, or build configuration that owns the reference.
+- If the repository lacks an optimization command, propose the smallest project-specific command intent instead of running an external website or guessed package command.
+- If the build fails after asset changes, investigate the first asset-related failure before touching unrelated code.
+
+<!-- mustflow-section: output-format -->
+## Output Format
+
+- Images reviewed or changed
+- Format and size changes
+- References updated
+- Command intents run
+- Skipped command intents and reasons
+- Remaining image quality or browser-support risks

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

@@ -0,0 +1,83 @@
+---
+mustflow_doc: agents.root
+locale: hi
+canonical: false
+revision: 10
+lifecycle: user-editable
+authority: binding
+---
+
+# AGENTS.md
+
+यह फाइल इस रिपॉजिटरी में LLM कोडिंग एजेंट के लिए पढ़ने योग्य पहला कार्य-समझौता है।  
+यह रिपॉजिटरी mustflow एजेंट कार्यप्रवाह का पालन करती है।  
+mustflow द्वारा प्रबंधित विवरण `.mustflow/` के अंतर्गत रखे गए हैं।
+
+## पढ़ने का क्रम
+
+1. `AGENTS.md`  
+2. `.mustflow/docs/agent-workflow.md`  
+3. `.mustflow/config/mustflow.toml`  
+4. `.mustflow/config/commands.toml`  
+5. `.mustflow/config/preferences.toml` (यदि मौजूद हो)  
+6. `.mustflow/skills/INDEX.md`  
+7. `.mustflow/context/INDEX.md` — केवल तब, जब कार्य के लिए परियोजना, उत्पाद, डोमेन, UI, बैकएंड, डेटा, सुरक्षा या संचालन संदर्भ आवश्यक हो  
+8. `.mustflow/context/<name>.md` की संबंधित फाइलें — केवल तब जब संदर्भ सूचकांक उन्हें चुने  
+9. `.mustflow/skills/<name>/SKILL.md` की संबंधित फाइलें  
+10. `REPO_MAP.md` — केवल तब, जब रिपॉजिटरी में व्यापक नेविगेशन की जरूरत हो  
+11. संबंधित स्रोत, परीक्षण और दस्तावेज़ फाइलें  
+
+## मुख्य नियम
+
+- उपयोगकर्ता द्वारा किए गए मौजूदा बदलाव वापस न करें।  
+- पैकेज प्रबंधक फाइलों से कमांड का अनुमान न लगाएं।  
+- केवल वे कमांड चलाएं जिनमें `status` = `configured`, `lifecycle` = `oneshot`, और `run_policy` = `agent_allowed` हो।  
+- कॉन्फ़िगर किए गए oneshot कमांड के लिए `mf run <intent>` को प्राथमिकता दें।  
+- `mf run` कमांड intents को क्रमबद्ध तरीके से चलाएं। जब कोई configured intent चल रहा हो तो दूसरा `mf run` शुरू न करें, खासकर जब intent `dist/` जैसे non-empty `writes` घोषित करता हो।  
+- जोखिम को कवर करने वाली सबसे संकरी configured verification intent चुनें। यदि command contract में संबंधित tests या तेज़ checks उपलब्ध हों तो व्यापक suites से पहले उन्हें चलाएं। यदि संकरी intent न हो तो धीमे full-suite tests को चुपचाप डिफ़ॉल्ट न बनाएं, बल्कि कमी रिपोर्ट करें।  
+- विकास सर्वर, watcher, ब्राउज़र इंटरफेस, इंटरैक्टिव prompt, या पृष्ठभूमि प्रक्रियाएं सीधे शुरू न करें।  
+- स्वायत्त लूप, worker प्रक्रिया, persona प्रणाली, या लंबी अवधि harness प्रक्रियाएं तभी शुरू करें जब रिपॉजिटरी उन्हें स्पष्ट रूप से कॉन्फ़िगर करे।  
+- जब कार्य लंबा चल सकता हो या संवेदनशील स्थिति प्रभावित कर सकता हो, तब `.mustflow/config/mustflow.toml` में `[budget]`, `[approval]`, और `[isolation]` का पालन करें।  
+- बड़े बदलावों से पहले read-only स्वास्थ्य जांच के लिए `mf doctor` या `mf doctor --json` चलाएं।  
+- `mf context --json` मशीन-पठनीय आउटपुट दे सकता है, लेकिन यह नियम और कमांड विनिर्देशन का विकल्प नहीं है।  
+- `.mustflow/config/preferences.toml` की प्राथमिकता सीधे उपयोगकर्ता निर्देशों और मौजूदा परियोजना शैली से कम है।  
+- code, templates, schemas, CLI व्यवहार, package metadata, user-visible docs, installation output, या tests बदलने पर अंतिम रिपोर्ट से पहले `.mustflow/config/preferences.toml` में `[release.versioning]` देखें। version files केवल उन्हीं preferences के अनुसार बदली जा सकती हैं: यदि `auto_bump = true` और `require_user_confirmation = false` हो तो automatic bump लागू करें; अन्यथा configuration के अनुसार bump सुझाएं या संपादन से पहले confirmation मांगें। version source को `package.json` मानकर न चलें; version suggest या edit करने से पहले repository-specific version source खोजें।  
+- `.mustflow/context/` की संदर्भ फाइलें परियोजना दिशा और डोमेन परंपराएं बताती हैं। इन्हें कार्य-विशिष्ट संदर्भ के रूप में लें, न कि कोड, परीक्षण, कमांड या उपयोगकर्ता निर्देशों के स्थान पर।  
+- यदि `DESIGN.md` मौजूद हो, तो उसे केवल UI, दृश्य डिज़ाइन, लेआउट, design token, या अभिगम्यता कार्य के लिए पढ़ें। यदि `DESIGN.md` नहीं है, तो नई फाइल न बनाएं।  
+- जब उपयुक्त skill लागू हो, उसकी संबंधित skill फाइल पढ़ें।  
+- संपादन से पहले `.mustflow/skills/INDEX.md` से तय करें कि एक या अधिक skills लागू होती हैं या नहीं।  
+- यदि नए प्रमाण, जैसे command failure या documentation change, से कोई skill प्रासंगिक हो जाए, तो उस हिस्से पर आगे बढ़ने से पहले संबंधित `SKILL.md` पढ़ें।  
+- skill दस्तावेज़ केवल procedure बताते हैं। वे `.mustflow/config/commands.toml` के बाहर commands चलाने की अनुमति नहीं देते और user, host, repository, या safety rules को override नहीं करते।  
+- स्पष्ट अनुरोध के बिना generated files, external dependencies, या secrets files संशोधित न करें।  
+- root के `config/`, `docs/`, या `skills/` डायरेक्टरी को mustflow दस्तावेज़ न मानें।  
+
+## Parent और Child नियम प्राथमिकता
+
+- संपादित फाइलों के सबसे निकट का `AGENTS.md` अधिक विशिष्ट नियम है।  
+- यदि कार्यप्रवाह, शैली, परीक्षण, या कमांड नियमों में टकराव हो, तो child रिपॉजिटरी के `AGENTS.md` और `.mustflow/config/commands.toml` का पालन करें।  
+- secrets, गोपनीयता, destructive commands, और अनुमत संपादन मार्गों के सुरक्षा नियम संचयी होते हैं। अधिक सख्त नियम अपनाएं।  
+- nested रिपॉजिटरी में जाने पर संपादन से पहले उसका `AGENTS.md` और `.mustflow/config/*.toml` फिर से पढ़ें।  
+- स्पष्ट अनुरोध के बिना चुनी हुई child रिपॉजिटरी के बाहर संपादन न करें।  
+
+## होस्ट-विशिष्ट निर्देश अनुकूलता
+
+कुछ कोडिंग होस्ट अपने अलग निर्देश फाइल पढ़ सकते हैं या अपनी approval, sandbox, checkpoint, और command execution नीतियां लागू कर सकते हैं।  
+
+इन host नीतियों को अतिरिक्त सुरक्षा और execution constraints मानें। ये इस रिपॉजिटरी के mustflow command contract को प्रतिस्थापित नहीं करतीं। जब host निर्देश mustflow नियमों से टकराएं:  
+
+- सीधे उपयोगकर्ता निर्देश task goal तय करते हैं, जब तक वे असुरक्षित न हों।  
+- host safety और approval gates बाध्यकारी रहते हैं।  
+- repository work rules सबसे निकट के `AGENTS.md` और `.mustflow/config/*.toml` से आते हैं।  
+- project verification commands को configured mustflow intents का उपयोग करना चाहिए।  
+- privacy, secrets, destructive commands, और Git push पर अधिक सख्त नियम लागू होते हैं।  
+- generated state, summaries, और caches कभी भी current files या current user instructions से ऊपर नहीं होते।  
+
+यदि effective rule स्पष्ट न हो, तो अनुमान लगाने के बजाय रुकें और conflict रिपोर्ट करें।  
+
+## निर्देश पुनर्पाठ जाँच बिंदु
+
+- लंबी सत्रों में mustflow निर्देशों को पहली बार संपादन से पहले, command intent के पास fresh command refresh न होने पर command चलाने से पहले, संदर्भ संपीड़न के बाद, `AGENTS.md` या `.mustflow/**` बदलने के बाद, परियोजना root बदलने के बाद, और अंतिम रिपोर्ट लिखने से पहले दोबारा पढ़ें।  
+- `.mustflow/config/mustflow.toml` में `[refresh]` नीति से तय करें कि light, command, skill, या full refresh की आवश्यकता है।  
+- बातचीत के turn count या session activity को परियोजना फाइलों में संग्रहीत न करें। session refresh स्थिति local cache या host application में रहनी चाहिए।  
+
+विस्तृत कार्यप्रवाह, कमांड नीति, विफलता प्रबंधन, और सुरक्षा नियम `.mustflow/docs/agent-workflow.md` में उपलब्ध हैं।

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

@@ -0,0 +1,39 @@
+---
+mustflow_doc: context.index
+kind: mustflow-context
+locale: ko
+canonical: false
+revision: 1
+name: context-index
+authority: router
+lifecycle: mustflow-owned
+stability: medium
+review_status: needs_human_review
+---
+
+# 문맥 색인
+
+이 파일은 현재 작업에 필요한 프로젝트 문맥 파일을 결정하고 참조하는 안내서입니다.  
+불필요한 정보 유입을 방지하기 위해 기본적으로 모든 문맥 파일을 읽지 않습니다.
+
+## 사용 가능한 문맥
+
+| 문맥 | 적용 시나리오 | 경로 |
+| --- | --- | --- |
+| project | 작업이 프로젝트 방향, 범위, 공개 동작, 비목표, 저장소 전반의 규칙에 잠재적으로 영향을 미치는 경우 | `.mustflow/context/PROJECT.md` |
+
+## 선택적 외부 참조
+
+| 앵커 | 적용 시나리오 | 경로 |
+| --- | --- | --- |
+| 사용자용 개요 | 공개 프로젝트 개요나 설치 안내가 필요한 경우입니다. 강제 정책이 아닌 일반 문맥으로 참조하십시오. | `README.md` |
+| 로드맵 | 프로젝트 계획, 우선순위, 마일스톤 또는 비목표 문맥이 필요한 경우입니다. 설치된 mustflow 정책이 아닌 계획 문맥으로 참조하십시오. | `ROADMAP.md` |
+| 시각 디자인 | UI, 시각적 정체성, 디자인 토큰, 레이아웃 또는 접근성을 변경하는 경우 | `DESIGN.md` |
+
+## 읽기 규칙
+
+- 현재 작업에 해당하는 문맥 파일만 참조하십시오.  
+- 문맥 파일은 더 높은 권한의 출처에 기반한다고 명시되지 않은 경우 참고용 지침으로 간주합니다.  
+- 문맥이 코드, 테스트, 명령 계약, 명시적 사용자 지시와 충돌하는 경우 이를 보고하고 더 높은 권한의 출처를 우선 적용하십시오.  
+- 누락된 프로젝트 목표, 비목표, 디자인 토큰, API 계약, 데이터 규칙을 임의로 추측하거나 생성하지 마십시오.  
+- `DESIGN.md`의 디자인 토큰을 `.mustflow/context/` 내에 중복 기록하지 마십시오.

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

@@ -0,0 +1,66 @@
+---
+mustflow_doc: context.project
+kind: mustflow-context
+locale: ko
+canonical: false
+revision: 1
+name: project
+authority: contextual
+lifecycle: user-editable
+stability: medium
+review_status: needs_human_review
+source_refs:
+  - AGENTS.md
+  - .mustflow/config/mustflow.toml
+  - .mustflow/config/commands.toml
+---
+
+# 프로젝트 문맥
+
+이 파일은 코딩 에이전트를 위한 프로젝트별 문맥을 정의합니다.  
+알 수 없는 항목은 비워 두시고, 내용을 임의로 추측하여 작성하지 마십시오.
+
+## 권한 경계
+
+- 이 파일에는 근거가 있는 문맥, 알 수 없는 사항, 충돌 내용을 기록할 수 있습니다.  
+- 이 파일은 명령 실행 권한을 부여하거나, 파일 수정 금지 규칙을 정의하거나,  
+  `AGENTS.md` 또는 `.mustflow/config/*.toml`을 재정의하거나, 현재 근거가 없는  
+  기능을 약속해서는 안 됩니다.  
+- 장기적으로 유지해야 하는 작업 규칙은 이 파일이 아니라 `AGENTS.md`,  
+  `.mustflow/docs/agent-workflow.md` 또는 해당 설정 파일에 두십시오.
+
+## 현재 목표
+
+미설정 상태입니다. 프로젝트 소유자가 제공하는 현재 프로젝트 목표로 업데이트해 주십시오.
+
+## 비목표
+
+미설정 상태입니다. 관련 없는 작업 수행 시 에이전트가 다루지 말아야 할 범위를 정의해 주십시오.
+
+## 핵심 약속
+
+- 반드시 준수해야 하는 작업 규칙은 `AGENTS.md`를 따릅니다.  
+- 명령의 기준 원본(Source of Truth)은 `.mustflow/config/commands.toml`입니다.  
+- 작업 흐름과 문서 경계의 기준 원본은 `.mustflow/config/mustflow.toml`입니다.  
+- 저장소 전반의 개요 파악이 필요할 때만 `REPO_MAP.md`를 얕은 탐색 지도로 참조하십시오.
+
+## 도메인 용어
+
+미설정 상태입니다. 구현 결정에 영향을 미치는 도메인 용어만 추가해 주십시오.
+
+## 특히 조심할 영역
+
+미설정 상태입니다. 특별한 주의가 필요한 경로, 공개 API, 생성 파일, 마이그레이션, 비밀 정보, 호환성 표면 등을 정의해 주십시오.
+
+## 다음으로 읽을 파일
+
+- `AGENTS.md`  
+- `.mustflow/docs/agent-workflow.md`  
+- `.mustflow/config/mustflow.toml`  
+- `.mustflow/config/commands.toml`  
+- `.mustflow/skills/INDEX.md`
+
+## 오래된 내용 확인
+
+- 이 파일이 현재 코드, 테스트, 명령 계약, 명시적 사용자 지시와 충돌하는 경우, 이를 오래된 문맥으로 간주하고 충돌 내용을 보고해 주십시오.  
+- 프로젝트 방향, 비목표, 저장소 전반의 규칙이 실제로 변경된 경우에만 이 파일을 수정해 주십시오.