maskweaver 0.9.3 → 0.9.5

package/README.md

@@ -1,22 +1,22 @@
-# 🎭 Maskweaver: Expert Persona Framework for OpenCode
+# ?렚 Maskweaver: Expert Persona Framework for OpenCode
 
 <div align="center">
 
 <img src="docs/images/hero.png" width="800" alt="Maskweaver Hero Image">
 
-> **The npm for AI personas** — Level up your OpenCode assistant with expert personalities
+> **The npm for AI personas** ??Level up your OpenCode assistant with expert personalities
 
 [![GitHub Release](https://img.shields.io/github/v/release/ulgerang/maskweaver?color=369eff&labelColor=black&logo=github&style=flat-square)](https://github.com/ulgerang/maskweaver/releases)
 [![License](https://img.shields.io/badge/license-MIT-white?labelColor=black&style=flat-square)](LICENSE)
 [![npm](https://img.shields.io/npm/v/maskweaver?color=ff6b35&labelColor=black&style=flat-square)](https://www.npmjs.com/package/maskweaver)
 
-[English](README.md) | [한국어](README.ko.md)
+[English](README.md) | [?쒓뎅??(README.ko.md)
 
 </div>
 
 ---
 
-## 🔌 OpenCode Plugin
+## ?뵆 OpenCode Plugin
 
 **Maskweaver is a handy plugin for [OpenCode](https://github.com/sst/opencode).**
 
@@ -24,8 +24,8 @@ While it can be used as a standalone library, it works great with OpenCode to ad
 - **Expert Personas (Masks)**: Standardized YAML profiles for legendary developers.
 - **Smart Delegation**: Multi-agent workflows optimized for OpenCode.
 - **Project Memory**: Hybrid semantic search for your entire codebase.
-- **🆕 Weave Workflow**: Phase-driven development with AI self-verification.
-- **🔗 GDC Integration**: Graph-Driven Codebase support for enhanced research and design-time verification gates.
+- **?넅 Weave Workflow**: Phase-driven development with AI self-verification.
+- **?뵕 GDC Integration**: Graph-Driven Codebase support for enhanced research and design-time verification gates.
 
 ---
 
@@ -58,7 +58,7 @@ Install and configure maskweaver by following the instructions here:
 https://raw.githubusercontent.com/ulgerang/maskweaver/master/docs/installation.md
 ```
 
-Or read the [Installation Guide](docs/installation.md) directly—but **we strongly recommend letting an agent handle it. Humans make mistakes.**
+Or read the [Installation Guide](docs/installation.md) directly?봟ut **we strongly recommend letting an agent handle it. Humans make mistakes.**
 
 ### For LLM Agents
 
@@ -145,7 +145,7 @@ npm list maskweaver
 
 # In OpenCode chat
 # Use the maskweaver_status tool or type:
-/weave help
+/weave-help
 ```
 
 ```typescript
@@ -174,7 +174,7 @@ console.log(VERSION); // "0.7.29"
 
 ## Features
 
-### 🎭 Expert Personas (Masks)
+### ?렚 Expert Personas (Masks)
 
 Apply legendary developer personalities to your AI assistant:
 
@@ -193,25 +193,25 @@ profile:
 ```
 
 **Current Masks:**
-- 🐧 **Linus Torvalds** - Systems, C, Linux, performance
-- 🏗️ **Martin Fowler** - Architecture, refactoring, patterns
-- 🧪 **Kent Beck** - TDD, XP, testing
-- 🧠 **Andrew Ng** - ML/AI systems
-- ⚛️ **Dan Abramov** - React, frontend architecture
+- ?맕 **Linus Torvalds** - Systems, C, Linux, performance
+- ?룛截?**Martin Fowler** - Architecture, refactoring, patterns
+- ?㎦ **Kent Beck** - TDD, XP, testing
+- ?쭬 **Andrew Ng** - ML/AI systems
+- ?쏉툘 **Dan Abramov** - React, frontend architecture
 
-### 🤖 Dummy-Human System
+### ?쨼 Dummy-Human System
 
 Smart subagents for cost-efficient multi-agent workflows:
 
 | Agent | Model Tier | Cost | Best For |
 |-------|-----------|------|----------|
-| `@dummy-flash` | Fast | 💰 | File search, summaries, simple tasks |
-| `@dummy-human` | Balanced | 💰💰 | Code writing, reviews, general work |
-| `@dummy-premium` | Powerful | 💰💰💰 | Architecture, complex debugging |
+| `@dummy-flash` | Fast | ?뮥 | File search, summaries, simple tasks |
+| `@dummy-human` | Balanced | ?뮥?뮥 | Code writing, reviews, general work |
+| `@dummy-premium` | Powerful | ?뮥?뮥?뮥 | Architecture, complex debugging |
 
-### 🧵 Weave Workflow
+### ?㏊ Weave Workflow
 
-**Phase-Driven Development** — "AI verifies, Human validates"
+**Phase-Driven Development** ??"AI verifies, Human validates"
 
 Weave is Maskweaver's flagship workflow. It breaks work into testable phases, auto-selects expert masks, and provides structured verification before handoff.
 
@@ -219,42 +219,37 @@ Weave is Maskweaver's flagship workflow. It breaks work into testable phases, au
 
 | Command | Description |
 |---------|-------------|
-| `/weave init` | Initialize Weave (once per repo) |
-| `/weave prepare [docs]` | Generate research + spec + plan in one step (auto-split if oversized) |
-| `/weave refine-plan` | Apply structured plan notes (`tasks/plan-notes.md`) to active plan |
-| `/weave approve` | Explicit human approval gate before implementation |
-| `/weave craft [P#]` | Prepare phase execution context and guidance |
-| `/weave build` | Autonomous build loop (`action=run/status/stop/list/resume/sync`) |
-| `/weave verify` | Run build/test verification (auto-detect) |
-| `/weave worktree ...` | Manage git worktrees for parallel work |
-| `/weave status` | View project progress and stats |
-| `/weave agents` | Sync agent files or init config (`sync=true` / `init=true`) |
-| `/weave troubleshoot` | Search global knowledge (`record=true` to save a solution) |
-| `/weave archive` | Archive the verified active change |
-| `/weave help` | Show documentation |
-
-> Tip: In OpenCode chat you can use `/weave ...` commands, and they map to the underlying `weave command=...` tool calls.
+| `/weave-init` | Initialize Weave (once per repo) |
+| `/weave-prepare [docs]` | Generate research + spec + plan in one step (auto-split if oversized) |
+| `/weave-refine-plan` | Apply structured plan notes (`tasks/plan-notes.md`) to active plan |
+| `/weave-approve` | Explicit human approval gate before implementation |
+| `/weave-craft [P#]` | Prepare phase execution context and guidance |
+| `/build` | Autonomous build loop (`action=run/status/stop/list/resume/sync`) |
+| `/weave-verify` | Run build/test verification (auto-detect) |
+| `/weave-worktree ...` | Manage git worktrees for parallel work |
+| `/weave-status` | View project progress and stats |
+| `/weave-agents` | Sync agent files or init config (`sync=true` / `init=true`) |
+| `/weave-troubleshoot` | Search global knowledge (`record=true` to save a solution) |
+| `/weave-archive` | Archive the verified active change |
+| `/weave-help` | Show documentation |
+
+> Tip: In OpenCode chat, use the visible slash commands above. They map to the underlying `weave command=...` tool calls.
 
 #### Workflow
 
 ```
-0. INIT (once): /weave init
-       ↓
-1. PLAN: /weave prepare docs/
+0. INIT (once): /weave-init
+       ??1. PLAN: /weave-prepare docs/
     - Generates research + spec + phase plan (auto-splits if oversized)
-       ↓
-2. REFINE (optional): /weave refine-plan
+       ??2. REFINE (optional): /weave-refine-plan
     - apply annotation notes from tasks/plan-notes.md
-       ↓
-3. APPROVAL GATE: /weave approve
+       ??3. APPROVAL GATE: /weave-approve
     - required before craft execution
-       ↓
-4. CRAFT: /weave craft
+       ??4. CRAFT: /weave-craft
      - Generates an execution plan and next actions
      - Implement/verify changes, then finalize with approve
-     - Use `/weave verify` anytime for build/test checks
-       ↓
-5. HANDOFF: You validate UX/intent and move to next phase
+     - Use `/weave-verify` anytime for build/test checks
+       ??5. HANDOFF: You validate UX/intent and move to next phase
 ```
 
 #### Multi-Layer AI Verification
@@ -263,15 +258,15 @@ Before handing off to you, AI runs these verification layers:
 
 | Layer | Type | Tool |
 |-------|------|------|
-| 1️⃣ TypeCheck | Build | `tsc --noEmit` |
-| 2️⃣ Lint | Build | `eslint` |
-| 3️⃣ Build | Build | `npm run build` |
-| 4️⃣ Unit Tests | Test | `jest` / `vitest` |
-| 5️⃣ E2E Tests | Test | **Playwright** |
-| 6️⃣ Screenshot | Visual | Playwright / browser capture |
-| 7️⃣ API Check | API | `fetch` health checks |
-| 8️⃣ A11y | Accessibility | `axe-core` |
-| 0️⃣ GDC Check | Design | `gdc check --machine` |
+| 1截뤴깵 TypeCheck | Build | `tsc --noEmit` |
+| 2截뤴깵 Lint | Build | `eslint` |
+| 3截뤴깵 Build | Build | `npm run build` |
+| 4截뤴깵 Unit Tests | Test | `jest` / `vitest` |
+| 5截뤴깵 E2E Tests | Test | **Playwright** |
+| 6截뤴깵 Screenshot | Visual | Playwright / browser capture |
+| 7截뤴깵 API Check | API | `fetch` health checks |
+| 8截뤴깵 A11y | Accessibility | `axe-core` |
+| 0截뤴깵 GDC Check | Design | `gdc check --machine` |
 
 #### GDC Integration (Graph-Driven Codebase)
 
@@ -324,23 +319,23 @@ The AI automatically picks the best expert for each task:
 
 | Task Type | Auto-Selected Mask |
 |-----------|-------------------|
-| Architecture/Design | 🏗️ Martin Fowler |
-| Testing/TDD | 🧪 Kent Beck |
-| React/Frontend | ⚛️ Dan Abramov |
-| Performance/Systems | 🐧 Linus Torvalds |
-| ML/AI | 🧠 Andrew Ng |
+| Architecture/Design | ?룛截?Martin Fowler |
+| Testing/TDD | ?㎦ Kent Beck |
+| React/Frontend | ?쏉툘 Dan Abramov |
+| Performance/Systems | ?맕 Linus Torvalds |
+| ML/AI | ?쭬 Andrew Ng |
 
 #### Global Knowledge Base (Cross-Project RAG)
 
 Troubleshooting solutions are stored globally and shared across all projects:
 
 ```
-Error occurs → Search ~/.maskweaver/knowledge.sqlite
-    ├── Found → Apply solution → Retry
-    └── Not found → Fix manually → Record solution for future
+Error occurs ??Search ~/.maskweaver/knowledge.sqlite
+    ?쒋??€ Found ??Apply solution ??Retry
+    ?붴??€ Not found ??Fix manually ??Record solution for future
 ```
 
-### 🧠 Memory System
+### ?쭬 Memory System
 
 Remember past conversations, decisions, and mask effectiveness:
 
@@ -359,13 +354,13 @@ const results = await memory.hybridSearch(
 ```
 
 **Embedding Providers:**
-- 🦙 **Ollama** - Local, private (bge-m3, nomic-embed)
-- 🤖 **OpenAI** - text-embedding-3-large
-- 🚀 **VoyageAI** - Code-specialized embeddings!
-- 🔀 **OpenRouter** - Access to multiple providers
-- 📝 **Text-only** - No embeddings, pure FTS5
+- ?쬂 **Ollama** - Local, private (bge-m3, nomic-embed)
+- ?쨼 **OpenAI** - text-embedding-3-large
+- ?? **VoyageAI** - Code-specialized embeddings!
+- ?? **OpenRouter** - Access to multiple providers
+- ?뱷 **Text-only** - No embeddings, pure FTS5
 
-### 🗂️ Context System
+### ?뾺截?Context System
 
 Track long-running features with file associations:
 
@@ -383,7 +378,7 @@ Track long-running features with file associations:
 @context done
 ```
 
-### 🔄 Retrospect System
+### ?봽 Retrospect System
 
 Evaluate mask effectiveness after each session:
 
@@ -404,7 +399,7 @@ Evaluate mask effectiveness after each session:
 
 ---
 
-## 📦 Package Structure
+## ?벀 Package Structure
 
 Maskweaver is a single npm package with modular exports:
 
@@ -434,12 +429,12 @@ import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
 
 ---
 
-## 🧵 Weave Usage Guide
+## ?㏊ Weave Usage Guide
 
 ### Step 0: Initialize (Once)
 
 ```bash
-/weave init
+/weave-init
 ```
 
 ### Step 1: Create a Plan
@@ -447,13 +442,13 @@ import { WeaveOrchestrator, GlobalKnowledge } from 'maskweaver/weave';
 Generate research + spec + plan in one command:
 
 ```bash
-/weave prepare docs/
+/weave-prepare docs/
 ```
 
 Then approve the plan:
 
 ```bash
-/weave approve
+/weave-approve
 ```
 
 The AI will:
@@ -464,7 +459,7 @@ The AI will:
 
 Example output:
 ```markdown
-## 📋 Execution Plan
+## ?뱥 Execution Plan
 
 ### Vision
 Build a modern emotion diary app with AI-powered insights
@@ -482,7 +477,7 @@ Is this plan okay? Let me know if changes are needed.
 ### Step 2: Approve the Plan (Required)
 
 ```bash
-/weave approve
+/weave-approve
 ```
 
 ### Step 3: Craft a Phase (Auto-select if omitted)
@@ -490,10 +485,10 @@ Is this plan okay? Let me know if changes are needed.
 Start with the first phase:
 
 ```bash
-/weave craft
+/weave-craft
 ```
 
-`/weave craft` returns execution context for the phase. Implement changes, then rerun `/weave craft` if you want to refresh the plan view.
+`/weave-craft` returns execution context for the phase. Implement changes, then rerun `/weave-craft` if you want to refresh the plan view.
 
 ### Step 4: Continue Implementation
 
@@ -520,23 +515,23 @@ weave command=approve
 When all verifications pass:
 
 ```markdown
-## ✅ Phase P1 Verification Complete!
+## ??Phase P1 Verification Complete!
 
-### 🤖 AI Test Results
+### ?쨼 AI Test Results
 | Test | Result |
 |------|--------|
-| Build | ✅ Success |
-| Unit Tests | ✅ 15/15 |
-| Lint | ✅ Passed |
+| Build | ??Success |
+| Unit Tests | ??15/15 |
+| Lint | ??Passed |
 
-### 🎭 Masks Used
+### ?렚 Masks Used
 - Kent Beck (testing)
 - Dan Abramov (React components)
 
-### 🔗 Access
+### ?뵕 Access
 http://localhost:5173
 
-### 👤 Human Validation (Only you can judge)
+### ?뫀 Human Validation (Only you can judge)
 - [ ] Does it feel right?
 - [ ] Is the UX good?
 - [ ] Is this what you wanted?
@@ -547,24 +542,24 @@ http://localhost:5173
 ### Step 6: Check Status Anytime
 
 ```bash
-/weave status
+/weave-status
 ```
 
 Output:
 ```markdown
-## 📊 Weave Progress
+## ?뱤 Weave Progress
 
 **Project**: Emotion Diary App
 **Progress**: 40%
 
-[████████░░░░░░░░░░░░] 2/5
+[?댿뻽?댿뻽?댿뻽?댿뻽?묅뼇?묅뼇?묅뼇?묅뼇?묅뼇?묅뼇] 2/5
 
 ### Phases
-✅ **P1**: Emotion Selection UI (2.5h) [kent-beck, dan-abramov]
-🔄 **P2**: Data Persistence
-⏳ **P3**: History View
-⏳ **P4**: Statistics
-⏳ **P5**: Theme Settings
+??**P1**: Emotion Selection UI (2.5h) [kent-beck, dan-abramov]
+?봽 **P2**: Data Persistence
+??**P3**: History View
+??**P4**: Statistics
+??**P5**: Theme Settings
 
 ### Global Knowledge Stats
 - Total troubleshooting records: 47
@@ -574,7 +569,7 @@ Output:
 
 ---
 
-## 🎭 Creating Masks
+## ?렚 Creating Masks
 
 Masks are simple YAML files:
 
@@ -620,35 +615,35 @@ usage:
 
 ---
 
-## 🌍 Multilingual
+## ?뙇 Multilingual
 
 Infrastructure ready for:
-- 🇺🇸 English
-- 🇰🇷 Korean
-- 🇨🇳 Chinese *(coming soon)*
-- 🇯🇵 Japanese *(coming soon)*
+- ?눣?눡 English
+- ?눖?눟 Korean
+- ?눊?눛 Chinese *(coming soon)*
+- ?눓?눝 Japanese *(coming soon)*
 
 Masks can have multiple language versions:
 ```
 masks/
-├── linus-torvalds.en.yaml
-├── linus-torvalds.ko.yaml
-└── linus-torvalds.zh.yaml
+?쒋??€ linus-torvalds.en.yaml
+?쒋??€ linus-torvalds.ko.yaml
+?붴??€ linus-torvalds.zh.yaml
 ```
 
 ---
 
-## 🤝 Contributing
+## ?쩃 Contributing
 
 We need your help!
 
 ### Add a Mask
 
 Create a YAML file in `masks/` and submit a PR:
-- ✅ Real expertise (domain knowledge)
-- ✅ Distinct personality (thinking style)
-- ✅ Clear use cases (when to use)
-- ✅ Examples (expected behavior)
+- ??Real expertise (domain knowledge)
+- ??Distinct personality (thinking style)
+- ??Clear use cases (when to use)
+- ??Examples (expected behavior)
 
 ### Report Bugs
 
@@ -661,12 +656,13 @@ See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
 
 ---
 
-## 📄 License
+## ?뱞 License
 
 MIT - See [LICENSE](LICENSE)
 
 ---
 
 <p align="center">
-  <sub>Crafted with 🎭 by <a href="https://github.com/ulgerang">ULJI SOFT</a></sub>
+  <sub>Crafted with ?렚 by <a href="https://github.com/ulgerang">ULJI SOFT</a></sub>
 </p>
+

package/assets/commands/meta/commands.json

@@ -19,11 +19,11 @@
       "name": "map",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "코드베이스 구조 분석 + GDC 그래프 연동",
-      "descriptionEn": "Analyze codebase structure via GDC + Graphify (knowledge graph)",
+      "description": "Analyze codebase structure via GDC and optional Graphify",
+      "descriptionEn": "Analyze codebase structure via GDC and optional Graphify",
       "category": "analysis",
       "args": [
-        { "name": "deep", "type": "boolean", "default": false, "description": "Run deep analysis with graphify-windows skill" }
+        { "name": "deep", "type": "boolean", "default": false, "description": "Run deeper Graphify analysis when available" }
       ],
       "mdFile": "weave-map.md",
       "handler": "handleMap",
@@ -33,8 +33,8 @@
       "name": "interview",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "코드베이스 맵 기반 멀티스텝 요구사항 인터뷰",
-      "descriptionEn": "Multi-step question asking until clarity, with structural change detection",
+      "description": "Ask clarifying questions until requirements and structural changes are clear",
+      "descriptionEn": "Ask clarifying questions until requirements and structural changes are clear",
       "category": "analysis",
       "args": [
         { "name": "docsPath", "type": "string", "required": false, "description": "Path to requirements documents" }
@@ -47,12 +47,12 @@
       "name": "prepare",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "research + spec + plan을 한 번에 생성 (큰 계획은 자동 분할)",
-      "descriptionEn": "Create research + spec + plan with defaults (auto-splits oversized plans)",
+      "description": "Create research, spec, and phase plan artifacts from requirements",
+      "descriptionEn": "Create research, spec, and phase plan artifacts from requirements",
       "category": "planning",
       "args": [
         { "name": "docsPath", "type": "string", "required": false, "description": "Path to requirements documents" },
-        { "name": "planName", "type": "string", "required": false, "description": "Plan name (kebab-case)" },
+        { "name": "planName", "type": "string", "required": false, "description": "Plan name in kebab-case" },
         { "name": "splitPlans", "type": "boolean", "default": true, "description": "Auto-split oversized plans into multiple shard plan files" },
         { "name": "splitMaxPhases", "type": "number", "default": 3, "min": 2, "max": 8, "description": "Max phases per shard when splitPlans is enabled" },
         { "name": "splitMaxHours", "type": "number", "default": 10, "min": 4, "max": 40, "description": "Max estimated hours per shard when splitPlans is enabled" }
@@ -65,11 +65,11 @@
       "name": "refine-plan",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "Apply structured plan-note directives to active plan",
-      "descriptionEn": "Apply structured plan-note directives to active plan",
+      "description": "Apply structured plan-note directives to the active plan",
+      "descriptionEn": "Apply structured plan-note directives to the active plan",
       "category": "planning",
       "args": [
-        { "name": "notesPath", "type": "string", "required": false, "description": "Path to structured plan notes (default: tasks/plan-notes.md)" },
+        { "name": "notesPath", "type": "string", "required": false, "description": "Path to structured plan notes" },
         { "name": "applyNotes", "type": "boolean", "default": true, "description": "Auto-apply plan notes during approve" }
       ],
       "mdFile": "weave-refine-plan.md",
@@ -80,11 +80,11 @@
       "name": "approve",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "Plan 승인 게이트 통과 (구현 전 필수)",
+      "description": "Approve the plan, or finalize a crafted phase when phaseId is provided",
       "descriptionEn": "Approve the plan, or finalize a crafted phase when phaseId is provided",
       "category": "planning",
       "args": [
-        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID to finalize (optional)" },
+        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID to finalize" },
         { "name": "planReview", "type": "string", "required": false, "description": "Plan review summary text" },
         { "name": "applyNotes", "type": "boolean", "default": true, "description": "Auto-apply plan notes during approve" }
       ],
@@ -96,12 +96,12 @@
       "name": "craft",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "단일 Phase 수동 실행 준비 (실행 컨텍스트 생성)",
-      "descriptionEn": "Prepare execution context for a phase (phase auto-select if omitted)",
+      "description": "Prepare execution context for a phase",
+      "descriptionEn": "Prepare execution context for a phase",
       "category": "execution",
       "args": [
-        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID (auto-select if omitted)" },
-        { "name": "projectType", "type": "string", "required": false, "description": "Project type hint (react, nextjs, go, etc.)" }
+        { "name": "phaseId", "type": "string", "required": false, "description": "Phase ID, auto-selected if omitted" },
+        { "name": "projectType", "type": "string", "required": false, "description": "Project type hint" }
       ],
       "mdFile": "weave-craft.md",
       "handler": "handleCraft",
@@ -111,14 +111,14 @@
       "name": "build",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "자율 빌드 루프 실행 및 관리",
-      "descriptionEn": "Autonomous build loop — run, resume, or inspect builds",
+      "description": "Run, resume, stop, list, or inspect autonomous build loops",
+      "descriptionEn": "Run, resume, stop, list, or inspect autonomous build loops",
       "category": "execution",
       "args": [
         { "name": "action", "type": "enum", "values": ["run", "status", "stop", "list", "resume", "sync"], "default": "run", "description": "Build sub-action" },
         { "name": "phaseIds", "type": "string", "required": false, "description": "Comma-separated phase IDs for run action" },
         { "name": "buildId", "type": "string", "required": false, "description": "Build ID for status/stop/resume/sync actions" },
-        { "name": "maxRetries", "type": "number", "default": 3, "min": 1, "max": 10, "description": "Maximum retries per task (for run action)" },
+        { "name": "maxRetries", "type": "number", "default": 3, "min": 1, "max": 10, "description": "Maximum retries per task" },
         { "name": "maxIterations", "type": "number", "default": 1, "min": 1, "max": 20, "description": "Maximum loop iterations before blocking" },
         { "name": "maxNoProgress", "type": "number", "default": 1, "min": 0, "max": 10, "description": "Maximum repeated no-progress failures before blocking" }
       ],
@@ -136,8 +136,8 @@
       "name": "status",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "전체 플랜 목록 + 진행 상황 확인",
-      "descriptionEn": "View overall progress",
+      "description": "View plans, active phase, and progress",
+      "descriptionEn": "View plans, active phase, and progress",
       "category": "management",
       "args": [],
       "mdFile": "weave-status.md",
@@ -148,8 +148,8 @@
       "name": "worktree",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "git worktree 기반 병렬 작업 관리",
-      "descriptionEn": "Manage git worktrees for parallel work",
+      "description": "Manage git worktrees for parallel phase or feature work",
+      "descriptionEn": "Manage git worktrees for parallel phase or feature work",
       "category": "management",
       "args": [
         { "name": "worktreeAction", "type": "enum", "values": ["create", "list", "open", "remove", "merge"], "required": false, "description": "Worktree action" },
@@ -165,8 +165,8 @@
       "name": "verify",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "빌드/테스트 검증 실행 (프로젝트 유형 자동 감지)",
-      "descriptionEn": "Run build/test verification for current worktree",
+      "description": "Run build and test verification for the current worktree",
+      "descriptionEn": "Run build and test verification for the current worktree",
       "category": "management",
       "args": [
         { "name": "verifyMode", "type": "enum", "values": ["quick", "full"], "default": "full", "description": "Verification mode" },
@@ -180,7 +180,7 @@
       "name": "archive",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "검증된 변경사항 아카이브",
+      "description": "Archive the verified active change artifact",
       "descriptionEn": "Archive the verified active change artifact",
       "category": "management",
       "args": [],
@@ -192,13 +192,13 @@
       "name": "troubleshoot",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "글로벌 지식 검색 및 솔루션 기록",
+      "description": "Search global knowledge for solutions or record a new one",
       "descriptionEn": "Search global knowledge for solutions or record a new one",
       "category": "knowledge",
       "args": [
         { "name": "error", "type": "string", "required": false, "description": "Error message to search solutions for" },
         { "name": "record", "type": "boolean", "default": false, "description": "Record a new solution instead of searching" },
-        { "name": "solution", "type": "string", "required": false, "description": "Solution to record (when record=true)" },
+        { "name": "solution", "type": "string", "required": false, "description": "Solution to record when record=true" },
         { "name": "context", "type": "string", "required": false, "description": "Context for the troubleshooting entry" }
       ],
       "mdFile": "weave-troubleshoot.md",
@@ -212,7 +212,7 @@
       "name": "repair",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "plan YAML 파일 자동 검사 및 수리",
+      "description": "Scan and auto-repair corrupted plan YAML files",
       "descriptionEn": "Scan and auto-repair corrupted plan YAML files",
       "category": "knowledge",
       "args": [],
@@ -224,11 +224,11 @@
       "name": "agents",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "에이전트 파일 동기화 및 설정 초기화",
-      "descriptionEn": "Sync dummy-human agent files and initialize configuration",
+      "description": "Sync generated agent files and initialize runtime configuration",
+      "descriptionEn": "Sync generated agent files and initialize runtime configuration",
       "category": "configuration",
       "args": [
-        { "name": "sync", "type": "boolean", "default": false, "description": "Force regenerate agent .md files from config pool" },
+        { "name": "sync", "type": "boolean", "default": false, "description": "Force regenerate agent markdown files from config pool" },
         { "name": "init", "type": "boolean", "default": false, "description": "Create default maskweaver.config.json with pool template" }
       ],
       "mdFile": "weave-agents.md",
@@ -242,7 +242,7 @@
       "name": "help",
       "aliases": [],
       "deprecatedAliases": [],
-      "description": "Weave 워크플로우 도움말",
+      "description": "Show weave workflow help",
       "descriptionEn": "Show weave workflow help",
       "category": "meta",
       "args": [],