@uoyo/mvtt 2.0.0-beta.4 → 2.0.0

package/dist/types/platform.d.ts

@@ -0,0 +1,12 @@
+export type PlatformId = "claude" | "qoder" | "cursor" | "opencode";
+export interface PlatformDef {
+    id: PlatformId;
+    dir: string;
+    skillDir: string;
+    description: string;
+}
+export declare const PLATFORMS: PlatformDef[];
+export declare const DEFAULT_PLATFORMS: PlatformId[];
+export declare function getPlatformById(id: string): PlatformDef | undefined;
+export declare function getPlatformsByIds(ids: PlatformId[]): PlatformDef[];
+//# sourceMappingURL=platform.d.ts.map

package/dist/types/platform.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.d.ts","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEpE,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,UAAU,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,eAAO,MAAM,SAAS,EAAE,WAAW,EAyBlC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UAAU,EAAe,CAAC;AAE1D,wBAAgB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEnE;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,UAAU,EAAE,GAAG,WAAW,EAAE,CAIlE"}

package/dist/types/platform.js

@@ -0,0 +1,36 @@
+export const PLATFORMS = [
+    {
+        id: "claude",
+        dir: ".claude",
+        skillDir: ".claude/skills",
+        description: "Claude Code / Claude Desktop / Github Copilot",
+    },
+    {
+        id: "qoder",
+        dir: ".qoder",
+        skillDir: ".qoder/skills",
+        description: "Qoder IDE",
+    },
+    {
+        id: "cursor",
+        dir: ".cursor",
+        skillDir: ".cursor/skills",
+        description: "Cursor IDE",
+    },
+    {
+        id: "opencode",
+        dir: ".opencode",
+        skillDir: ".opencode/skills",
+        description: "Opencode CLI",
+    },
+];
+export const DEFAULT_PLATFORMS = ["claude"];
+export function getPlatformById(id) {
+    return PLATFORMS.find((p) => p.id === id);
+}
+export function getPlatformsByIds(ids) {
+    return ids
+        .map((id) => getPlatformById(id))
+        .filter((p) => p !== undefined);
+}
+//# sourceMappingURL=platform.js.map

package/dist/types/platform.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"platform.js","sourceRoot":"","sources":["../../src/types/platform.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,SAAS,GAAkB;IACtC;QACE,EAAE,EAAE,QAAQ;QACZ,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,+CAA+C;KAC7D;IACD;QACE,EAAE,EAAE,OAAO;QACX,GAAG,EAAE,QAAQ;QACb,QAAQ,EAAE,eAAe;QACzB,WAAW,EAAE,WAAW;KACzB;IACD;QACE,EAAE,EAAE,QAAQ;QACZ,GAAG,EAAE,SAAS;QACd,QAAQ,EAAE,gBAAgB;QAC1B,WAAW,EAAE,YAAY;KAC1B;IACD;QACE,EAAE,EAAE,UAAU;QACd,GAAG,EAAE,WAAW;QAChB,QAAQ,EAAE,kBAAkB;QAC5B,WAAW,EAAE,cAAc;KAC5B;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAiB,CAAC,QAAQ,CAAC,CAAC;AAE1D,MAAM,UAAU,eAAe,CAAC,EAAU;IACxC,OAAO,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAiB;IACjD,OAAO,GAAG;SACP,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC;SAChC,MAAM,CAAC,CAAC,CAAC,EAAoB,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;AACtD,CAAC"}

package/dist/types/registry.d.ts

@@ -1,33 +1,12 @@
-export interface NextSuggestionBranch {
-    condition: string;
-    primary: string;
-    primary_desc: string;
-}
-export interface NextSuggestionAlternative {
-    skill: string;
-    desc?: string;
-    when?: string;
-}
-export interface NextSuggestions {
-    primary?: string;
-    primary_desc?: string;
-    conditional?: NextSuggestionBranch[];
-    alternatives?: NextSuggestionAlternative[];
-}
 export interface SkillEntry {
-    agent: string;
     description: string;
-    path: string;
-    template: string | null;
-    category: "workflow" | "shortcut" | "utility" | "project";
-    mode: string;
-    phase?: string | null;
-    depends_on?: string[];
-    next_suggestions?: NextSuggestions;
+    knowledge?: Record<string, unknown[]>;
+    [key: string]: unknown;
 }
 export interface Registry {
     version: string;
     last_updated: string;
+    knowledge?: Record<string, unknown[]>;
     skills: Record<string, SkillEntry>;
 }
 //# sourceMappingURL=registry.d.ts.map

package/dist/types/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oBAAoB;IACnC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAE9B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB,WAAW,CAAC,EAAE,oBAAoB,EAAE,CAAC;IACrC,YAAY,CAAC,EAAE,yBAAyB,EAAE,CAAC;CAC5C;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,UAAU,GAAG,UAAU,GAAG,SAAS,GAAG,SAAS,CAAC;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,eAAe,CAAC;CACpC;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/types/registry.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,CAAC;IACtC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;CACpC"}

package/dist/util/bilingual.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Combine an English string with its Chinese translation into a single
+ * bilingual message. The English text always comes first, separated from the
+ * Chinese text by " / ".
+ *
+ * @example
+ *   bilingual("Install complete", "安装完成") // "Install complete / 安装完成"
+ */
+export declare function bilingual(en: string, zh: string): string;
+//# sourceMappingURL=bilingual.d.ts.map

package/dist/util/bilingual.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bilingual.d.ts","sourceRoot":"","sources":["../../src/util/bilingual.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAGxD"}

package/dist/util/bilingual.js

@@ -0,0 +1,14 @@
+/**
+ * Combine an English string with its Chinese translation into a single
+ * bilingual message. The English text always comes first, separated from the
+ * Chinese text by " / ".
+ *
+ * @example
+ *   bilingual("Install complete", "安装完成") // "Install complete / 安装完成"
+ */
+export function bilingual(en, zh) {
+    if (en === zh)
+        return en; // Avoid redundancy when both languages are the same
+    return `${en} / ${zh}`;
+}
+//# sourceMappingURL=bilingual.js.map

package/dist/util/bilingual.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bilingual.js","sourceRoot":"","sources":["../../src/util/bilingual.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,EAAU,EAAE,EAAU;IAC9C,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,EAAE,CAAC,CAAC,oDAAoD;IAC9E,OAAO,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC;AACzB,CAAC"}

package/dist/util/cancel.d.ts

@@ -0,0 +1,2 @@
+export declare function cancelled(): never;
+//# sourceMappingURL=cancel.d.ts.map

package/dist/util/cancel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.d.ts","sourceRoot":"","sources":["../../src/util/cancel.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,IAAI,KAAK,CAGjC"}

package/dist/util/cancel.js

@@ -0,0 +1,6 @@
+import * as p from "@clack/prompts";
+export function cancelled() {
+    p.cancel("Cancelled.");
+    throw new Error("Cancelled");
+}
+//# sourceMappingURL=cancel.js.map

package/dist/util/cancel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel.js","sourceRoot":"","sources":["../../src/util/cancel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,gBAAgB,CAAC;AAEpC,MAAM,UAAU,SAAS;IACvB,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC;IACvB,MAAM,IAAI,KAAK,CAAC,WAAW,CAAC,CAAC;AAC/B,CAAC"}

package/dist/util/color.d.ts

@@ -1,9 +1,12 @@
 export declare const color: {
-    green: (s: string) => string;
-    yellow: (s: string) => string;
-    red: (s: string) => string;
-    cyan: (s: string) => string;
-    gray: (s: string) => string;
-    bold: (s: string) => string;
+    green: import("picocolors/types.js").Formatter;
+    yellow: import("picocolors/types.js").Formatter;
+    red: import("picocolors/types.js").Formatter;
+    cyan: import("picocolors/types.js").Formatter;
+    gray: import("picocolors/types.js").Formatter;
+    bold: import("picocolors/types.js").Formatter;
+    dim: import("picocolors/types.js").Formatter;
+    magenta: import("picocolors/types.js").Formatter;
+    blue: import("picocolors/types.js").Formatter;
 };
 //# sourceMappingURL=color.d.ts.map

package/dist/util/color.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,KAAK;eACL,MAAM;gBACL,MAAM;aACT,MAAM;cACL,MAAM;cACN,MAAM;cACN,MAAM;CACjB,CAAC"}
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,KAAK;;;;;;;;;;CAUjB,CAAC"}

package/dist/util/color.js

@@ -1,13 +1,13 @@
-const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
-function wrap(code, text) {
-    return useColor ? `\x1b[${code}m${text}\x1b[0m` : text;
-}
+import pc from "picocolors";
 export const color = {
-    green: (s) => wrap(32, s),
-    yellow: (s) => wrap(33, s),
-    red: (s) => wrap(31, s),
-    cyan: (s) => wrap(36, s),
-    gray: (s) => wrap(90, s),
-    bold: (s) => wrap(1, s),
+    green: pc.green,
+    yellow: pc.yellow,
+    red: pc.red,
+    cyan: pc.cyan,
+    gray: pc.gray,
+    bold: pc.bold,
+    dim: pc.dim,
+    magenta: pc.magenta,
+    blue: pc.blue,
 };
 //# sourceMappingURL=color.js.map

package/dist/util/color.js.map

@@ -1 +1 @@
-{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC;AAE/D,SAAS,IAAI,CAAC,IAAY,EAAE,IAAY;IACtC,OAAO,QAAQ,CAAC,CAAC,CAAC,QAAQ,IAAI,IAAI,IAAI,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;AACzD,CAAC;AAED,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACjC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAClC,GAAG,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAC/B,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,IAAI,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC;CAChC,CAAC"}
+{"version":3,"file":"color.js","sourceRoot":"","sources":["../../src/util/color.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAC;AAE5B,MAAM,CAAC,MAAM,KAAK,GAAG;IACnB,KAAK,EAAE,EAAE,CAAC,KAAK;IACf,MAAM,EAAE,EAAE,CAAC,MAAM;IACjB,GAAG,EAAE,EAAE,CAAC,GAAG;IACX,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,IAAI,EAAE,EAAE,CAAC,IAAI;IACb,GAAG,EAAE,EAAE,CAAC,GAAG;IACX,OAAO,EAAE,EAAE,CAAC,OAAO;IACnB,IAAI,EAAE,EAAE,CAAC,IAAI;CACd,CAAC"}

package/dist/util/spinner.d.ts

@@ -0,0 +1,8 @@
+import { type Ora } from "ora";
+export type SpinnerHandle = Ora;
+export declare function startSpinner(text: string): SpinnerHandle;
+export declare function withSpinner<T>(text: string, fn: () => Promise<T> | T, options?: {
+    successText?: string;
+    failText?: string;
+}): Promise<T>;
+//# sourceMappingURL=spinner.d.ts.map

package/dist/util/spinner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.d.ts","sourceRoot":"","sources":["../../src/util/spinner.ts"],"names":[],"mappings":"AAAA,OAAY,EAAE,KAAK,GAAG,EAAE,MAAM,KAAK,CAAC;AAEpC,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC;AAEhC,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAExD;AAED,wBAAsB,WAAW,CAAC,CAAC,EACjC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EACxB,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACd,GACL,OAAO,CAAC,CAAC,CAAC,CAUZ"}

package/dist/util/spinner.js

@@ -0,0 +1,17 @@
+import ora from "ora";
+export function startSpinner(text) {
+    return ora({ text, color: "cyan" }).start();
+}
+export async function withSpinner(text, fn, options = {}) {
+    const spinner = startSpinner(text);
+    try {
+        const result = await fn();
+        spinner.succeed(options.successText ?? text);
+        return result;
+    }
+    catch (err) {
+        spinner.fail(options.failText ?? text);
+        throw err;
+    }
+}
+//# sourceMappingURL=spinner.js.map

package/dist/util/spinner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spinner.js","sourceRoot":"","sources":["../../src/util/spinner.ts"],"names":[],"mappings":"AAAA,OAAO,GAAiB,MAAM,KAAK,CAAC;AAIpC,MAAM,UAAU,YAAY,CAAC,IAAY;IACvC,OAAO,GAAG,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,IAAY,EACZ,EAAwB,EACxB,UAGI,EAAE;IAEN,MAAM,OAAO,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,EAAE,EAAE,CAAC;QAC1B,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC;QAC7C,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC;QACvC,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/install-manifest.yaml

@@ -3,6 +3,8 @@ version: 2
 generated:
   - pattern: ".claude/skills/mvt-*/SKILL.md"
     source: "build:skills"
+  - pattern: ".qoder/skills/mvt-*/SKILL.md"
+    source: "build:skills"
   - pattern: ".ai-agents/skills/_templates/*-output.md"
     source: "build:templates"
   - pattern: ".ai-agents/skills/_templates/project-context.md"
@@ -13,6 +15,8 @@ generated:
     source: "bundle:sources/scripts/session-update.js"
   - pattern: ".ai-agents/scripts/plan-update.cjs"
     source: "bundle:sources/scripts/plan-update.js"
+  - pattern: ".ai-agents/scripts/epic-update.cjs"
+    source: "bundle:sources/scripts/epic-update.js"
 
 create_once:
   - path: ".ai-agents/config.yaml"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uoyo/mvtt",
-  "version": "2.0.0-beta.4",
+  "version": "2.0.0",
   "description": "My Virtual Tech Team - AI-guided prompt orchestration framework",
   "type": "module",
   "bin": {
@@ -43,15 +43,16 @@
   },
   "devDependencies": {
     "@types/node": "^25.6.0",
-    "@types/prompts": "^2.4.9",
     "@vitest/coverage-v8": "^2.1.9",
     "esbuild": "^0.28.0",
     "typescript": "^5.4.0",
     "vitest": "^2.0.0"
   },
   "dependencies": {
+    "@clack/prompts": "^1.5.1",
     "commander": "^14.0.3",
-    "prompts": "^2.4.2",
+    "ora": "^9.4.0",
+    "picocolors": "^1.1.1",
     "yaml": "^2.4.0"
   },
   "license": "MIT"

package/registry.yaml

@@ -1,198 +1,72 @@
-# MVTT Framework Registry (v2)
-# Single source of truth for skill metadata and knowledge declarations.
-# Consumed at build-time by mvtt CLI and at runtime by /mvt-status and /mvt-help.
-
-version: "2.0"
 last_updated: "2026-05-23"
 
 # ============================================================
-# Shared Knowledge
-# Loaded by ALL skills at execution time.
-# Managed by /mvt-manage-context (user selects "shared") and /mvt-init (project-context).
-# Reviewed by /mvt-config and /mvt-check-context.
+# Knowledge
+# Project-keyed map. Each key is a project name;
+# "_all" is the reserved key for entries loaded by all projects and all skills.
 # ============================================================
 knowledge:
-  shared:
-    - id: "core"
-      source: "knowledge/core/"
-      files_from_manifest: true
-    - id: "project-context"
-      source: "knowledge/project/_generated/"
-      files: ["project-context.md"]
+  # _all:
+  #   - id: "core"
+  #     source: "knowledge/core/"
+  #     files_from_manifest: true
 
 # ============================================================
 # Skills
 # ============================================================
 skills:
-  # --- Conductor Skills ---
   mvt-init:
-    agent: conductor
-    description: "Initialize or refresh a project by scanning its structure, detecting tech stack, and inferring project type. This skill should be used when starting a new project, re-initializing after structural changes, or setting up the MVTT workspace."
-    path: .claude/skills/mvt-init/SKILL.md
-    template: null
-    category: project
-
+    description: "Initialize or refresh a project: scan structure, detect tech stack, infer project type."
   mvt-status:
-    agent: conductor
-    description: "Display current project and workflow status including skill history, active changes, and session state. This skill should be used when user wants to check project status, review workflow progress, or see where they are in the development cycle."
-    path: .claude/skills/mvt-status/SKILL.md
-    template: null
-    category: project
-
+    description: "Display current project and workflow status: skill history, active changes, session state."
   mvt-config:
-    agent: conductor
-    description: "Manage MVTT framework configuration interactively. This skill should be used when user wants to change language, output format, or other framework settings."
-    path: .claude/skills/mvt-config/SKILL.md
-    template: null
-    category: project
-
+    description: "Manage framework configuration: language, output format, and other settings."
   mvt-sync-context:
-    agent: conductor
-    description: "Synchronize workspace context with code changes after manual modifications or git operations. This skill should be used when context appears out of sync with code, after manual edits outside the workflow, or after git merge/rebase."
-    path: .claude/skills/mvt-sync-context/SKILL.md
-    template: null
-    category: project
-
+    description: "Synchronize workspace context with code after manual edits or git operations."
   mvt-cleanup:
-    agent: conductor
-    description: "Clean up workspace artifacts, summarize completed changes, and maintain workspace health. This skill should be used when workspace has accumulated old artifacts, token footprint needs reduction, or to archive completed change records."
-    path: .claude/skills/mvt-cleanup/SKILL.md
-    template: null
-    category: project
-
-  # --- Analyst Skills ---
+    description: "Clean up workspace artifacts, summarize completed changes, and archive change records."
   mvt-analyze:
-    agent: analyst
-    description: "Analyze requirements documents and extract domain concepts. This skill should be used when user wants to analyze requirements, extract features and business rules, or start the analysis phase of a development workflow."
-    path: .claude/skills/mvt-analyze/SKILL.md
+    description: "Analyze requirements and extract domain concepts, features, and business rules."
     template: .ai-agents/skills/_templates/analyze-output.md
-    category: workflow
-
   mvt-analyze-code:
-    agent: analyst
-    description: "Analyze existing code to generate project-context.md with terms, modules, layers, and business rules. This skill should be used when user wants to understand an existing codebase, generate documentation for legacy code, onboard to a new project, or extract requirements from source code."
-    path: .claude/skills/mvt-analyze-code/SKILL.md
+    description: "Reverse-analyze existing code into project-context.md (terms, modules, layers, rules)."
     template: .ai-agents/skills/_templates/project-context.md
-    category: workflow
-
-  # --- Architect Skills ---
+  mvt-decompose:
+    description: "Decompose epic-scale requirements into right-sized sub-changes with DAG dependencies."
+    template: .ai-agents/skills/_templates/decompose-output.md
   mvt-design:
-    agent: architect
-    description: "Create architecture design based on analyzed requirements. This skill should be used when user wants to design system architecture, define module structure, or create technical blueprints for implementation."
-    path: .claude/skills/mvt-design/SKILL.md
+    description: "Create architecture design from analyzed requirements."
     template: .ai-agents/skills/_templates/design-output.md
-    category: workflow
-    depends_on: [mvt-analyze]
-
   mvt-plan-dev:
-    agent: architect
-    description: "Generate a structured development plan (plan.yaml) for a large change so progress can be tracked across sessions. This skill should be used after /mvt-design when a change is too big to implement in one pass and needs task-level tracking."
-    path: .claude/skills/mvt-plan-dev/SKILL.md
-    template: null
-    category: workflow
-    depends_on: [mvt-analyze]
-
+    description: "Generate a tracked development plan (plan.yaml) for a large change."
   mvt-update-plan:
-    agent: architect
-    description: "Update a single task in the active change's plan.yaml: change status, attach artifacts, leave notes, and auto-advance current_task. This skill should be used after a workflow skill finishes work that maps to a plan task."
-    path: .claude/skills/mvt-update-plan/SKILL.md
-    template: null
-    category: project
-
-  # --- Developer Skills ---
+    description: "Update one task in the active plan.yaml: status, artifacts, notes; auto-advance current_task."
   mvt-bug-detect:
-    agent: analyst
-    description: "Analyze and detect bugs by investigating root cause, assessing severity and impact scope. Produces a structured diagnosis in conversation without applying fixes. This skill should be used when user suspects a bug, wants to understand a problem before fixing, or needs impact analysis."
-    path: .claude/skills/mvt-bug-detect/SKILL.md
-    template: null
-    category: shortcut
+    description: "Diagnose a bug (root cause, severity, impact scope) without applying fixes."
   mvt-implement:
-    agent: developer
-    description: "Implement features based on architecture design. This skill should be used when user wants to implement a feature, write production code, or translate design blueprints into working code."
-    path: .claude/skills/mvt-implement/SKILL.md
+    description: "Implement features from architecture design; write production code."
     template: .ai-agents/skills/_templates/implement-output.md
-    category: workflow
-    depends_on: [mvt-design]
-
   mvt-fix:
-    agent: developer
-    description: "Diagnose and fix bugs or issues in the codebase. This skill should be used when user reports a bug, encounters an error, or wants to diagnose and resolve an issue."
-    path: .claude/skills/mvt-fix/SKILL.md
-    template: null
-    category: shortcut
-
+    description: "Diagnose and fix bugs or errors in the codebase."
   mvt-refactor:
-    agent: developer
-    description: "Refactor existing code while preserving behavior. This skill should be used when user wants to improve code structure, rename symbols, extract methods or classes, or reorganize code without changing functionality."
-    path: .claude/skills/mvt-refactor/SKILL.md
-    template: null
-    category: shortcut
-
+    description: "Refactor existing code while preserving behavior."
   mvt-quick-dev:
-    agent: developer
-    description: "Quickly implement simple, well-scoped changes without the full analyze-design-implement workflow. This skill should be used when the change is small (1-3 files), architecturally neutral, and clearly specified — such as adding a field, fixing a label, adjusting config, or making a targeted enhancement."
-    path: .claude/skills/mvt-quick-dev/SKILL.md
-    template: null
-    category: shortcut
-
-  # --- Reviewer Skills ---
+    description: "Quickly implement small, well-scoped changes (1-3 files) without the full workflow."
   mvt-review:
-    agent: reviewer
-    description: "Perform code review for quality, standards compliance, and best practices. This skill should be used when user wants code reviewed, quality checked, or to identify issues before merging."
-    path: .claude/skills/mvt-review/SKILL.md
+    description: "Review code for quality, standards compliance, and best practices."
     template: .ai-agents/skills/_templates/review-output.md
-    category: workflow
-    depends_on: [mvt-implement]
-
-
-  # --- Tester Skills ---
   mvt-test:
-    agent: tester
-    description: "Generate and design tests to validate implementations. This skill should be used when user wants to write tests, validate code, generate test cases, or analyze test coverage."
-    path: .claude/skills/mvt-test/SKILL.md
+    description: "Generate and design tests to validate implementations."
     template: .ai-agents/skills/_templates/test-output.md
-    category: workflow
-    depends_on: [mvt-implement]
-
-  # --- Utility Skills ---
   mvt-help:
-    agent: conductor
-    description: "Show available skills, current project status, and workflow guidance. This skill should be used when user is new to MVTT, wants to discover available commands, or needs guidance on what to do next."
-    path: .claude/skills/mvt-help/SKILL.md
-    template: null
-    category: utility
-
+    description: "Show available skills, project status, and workflow guidance."
   mvt-resume:
-    agent: conductor
-    description: "Resume an in-progress development task in a new conversation. Reads session.yaml (active_change, skill_history, recent_actions) and recent artifacts to reconstruct context. Does not read git state."
-    path: .claude/skills/mvt-resume/SKILL.md
-    template: null
-    category: utility
-
+    description: "Resume an in-progress task in a new conversation from session.yaml and recent artifacts."
   mvt-create-skill:
-    agent: conductor
-    description: "Create custom MVTT skills through interactive guided workflow. This skill should be used when user wants to create a new skill, extend the framework with custom functionality, or build project-specific automation."
-    path: .claude/skills/mvt-create-skill/SKILL.md
-    template: null
-    category: utility
-
+    description: "Create custom MVTT skills through an interactive guided workflow."
   mvt-manage-context:
-    agent: conductor
-    description: "Unified entry point for managing knowledge and registry. Supports subcommands: add (with AI routing), remove, move, rename, list. Use this skill instead of mvt-add-context."
-    path: .claude/skills/mvt-manage-context/SKILL.md
-    template: null
-    category: utility
-
+    description: "Manage knowledge and registry: add (with AI routing), remove, move, rename, list."
   mvt-check-context:
-    agent: conductor
-    description: "Analyze context token load and provide optimization recommendations. This skill should be used when user wants to check how much context MVTT loads, identify large files, or optimize workspace size for better performance."
-    path: .claude/skills/mvt-check-context/SKILL.md
-    template: null
-    category: utility
-
+    description: "Analyze context token load and provide optimization recommendations."
   mvt-template:
-    agent: conductor
-    description: "View, customize, and manage output templates for MVTT skills. This skill should be used when user wants to inspect available templates, create custom template versions, reset customizations, or export templates."
-    path: .claude/skills/mvt-template/SKILL.md
-    template: null
-    category: utility
+    description: "View, customize, and manage output templates for MVTT skills."

package/sources/defaults/config.yaml

@@ -1,27 +1,22 @@
-# MVTT Framework - User Configuration
-
-version: "2.0"
-
 preferences:
   # Language used for interactive responses
-  # Options: en-US, zh-CN
+  # Options: en-US (English), zh-CN (简体中文)
   interaction_language: en-US
 
   # Language used for persistent document output
-  # If absent, falls back to interaction_language.
-  # Options: en-US, zh-CN
+  # Options: en-US (English), zh-CN (简体中文)
   document_output_language: en-US
 
   # Output style
   output:
-    no_emojis: true          # Disable emojis in output
-    data_format: yaml        # Data output format: yaml | json
+    no_emojis: true
+    data_format: yaml
 
-  # AI routing for /mvt-manage-context add
+  # AI routing for skill selection in /mvt-manage-context
   context_routing:
-    relevance_threshold: 70  # Skills scored >= this are pre-checked; below are folded
+    relevance_threshold: 70
 
   # Session history limits
   history_limits:
-    history: 20             # Max history entries (1-100)
-    changes: 20             # Max changes entries (1-100)
+    history: 10
+    changes: 10

package/sources/defaults/project-context.yaml

@@ -1,12 +1,9 @@
 # Project Context Index
-# Lean index: structural info only. Semantic data lives in project-context.md.
-# Single project: one entry with name="default", path="."
-# Multi-project: one entry per detected sub-project.
-
 projects:
   - name: "default"                 # Project identifier (unique within workspace)
     path: "."                       # Relative path from repo root
-    type: ""                        # web-frontend | api-service | cli-tool | library | monorepo | data-pipeline | mobile-app | generic
+    type: ""                        # web-frontend,api-service,etc.
+    source_paths: []
     tech_stack:
       primary_language: ""
       secondary_languages: []

package/sources/defaults/session.yaml

@@ -1,14 +1,26 @@
-# Workspace Session State
-
 session:
   initialized_at: ""
   last_synced_at: ""
 
+active_epic:
+  id: ""
+  title: ""
+  created_at: ""
+  epic_path: ""
+
+epics: []
+  # - id: "epic-20260608-ecommerce-platform"
+  #   title: "ecommerce platform"
+  #   epic_path: ".ai-agents/workspace/artifacts/epic-20260608-ecommerce-platform/epic.yaml"
+  #   status: "active"   # active | done | abandoned
+  #   updated_at: "..."
+
 active_change:
   id: ""
   title: ""
   created_at: ""
   plan_path: ""
+  epic_id: ""            # epic parent id or empty
 
 changes: []
   # - id: "chg-001"

package/sources/knowledge/core/manifest.yaml

@@ -1,6 +1,3 @@
 id: core
 type: shared
-
-files:
-  # User-added entries (origin: user) are appended by /mvt-manage-context.
-  # `mvtt update` preserves them and only rewrites origin: framework entries.
+files: []