@uoyo/mvtt 2.0.0-beta.3 → 2.0.0-beta.6

package/dist/scripts/session-update.cjs

@@ -7326,7 +7326,11 @@ var ERRORS = {
   NO_SESSION_YAML: () => "session.yaml not found. Run /mvt-init first to initialize the project.",
   SESSION_PARSE_FAILED: (detail) => `Failed to parse session.yaml: ${detail}. Check the file for syntax errors.`,
   SESSION_WRITE_FAILED: (detail) => `Failed to write session.yaml: ${detail}`,
-  CONFIG_LIMIT_INVALID: (key, val, min, max, fallback) => `Warning: config history_limits.${key} value "${val}" is invalid (must be integer ${min}-${max}). Using default ${fallback}.`
+  CONFIG_LIMIT_INVALID: (key, val, min, max, fallback) => `Warning: config history_limits.${key} value "${val}" is invalid (must be integer ${min}-${max}). Using default ${fallback}.`,
+  EPIC_ID_REQUIRED: () => "--new-epic requires --epic-id",
+  CLOSE_NEW_EPIC_CONFLICT: () => "--close-epic and --new-epic are mutually exclusive",
+  NO_ACTIVE_EPIC: (flag) => `${flag} requires an active epic (active_epic.id is empty)`,
+  EPIC_ID_ORPHAN: () => "--epic-id (for sub-change) requires --new-change"
 };
 var DEFAULT_LIMITS = {
   history: 20,
@@ -7388,6 +7392,9 @@ function validate(args) {
   if (!args.skill) return ERRORS.MISSING_SKILL();
   if (!args.summary) return ERRORS.MISSING_SUMMARY();
   if (args["new-change"] && !args["change-id"]) return ERRORS.CHANGE_ID_REQUIRED();
+  if (args["new-epic"] && !args["epic-id"]) return ERRORS.EPIC_ID_REQUIRED();
+  if (args["close-epic"] && args["new-epic"]) return ERRORS.CLOSE_NEW_EPIC_CONFLICT();
+  if (args["epic-id"] && !args["new-change"] && !args["new-epic"]) return ERRORS.EPIC_ID_ORPHAN();
   return null;
 }
 function main() {
@@ -7440,7 +7447,8 @@ function main() {
         title: session.active_change.title || "",
         plan_path: session.active_change.plan_path || "",
         status: "active",
-        updated_at: now
+        updated_at: now,
+        epic_id: session.active_change.epic_id || ""
       };
       if (existingIdx >= 0) {
         session.changes[existingIdx] = snapshotEntry;
@@ -7456,6 +7464,7 @@ function main() {
     session.active_change.title = args["new-change"];
     session.active_change.created_at = now;
     session.active_change.plan_path = "";
+    session.active_change.epic_id = args["epic-id"] || "";
   }
   if (args["set-initialized"]) {
     session.session = session.session || {};
@@ -7482,7 +7491,8 @@ function main() {
       title: ac.title || "",
       plan_path: ac.plan_path || "",
       status: "active",
-      updated_at: now
+      updated_at: now,
+      epic_id: ac.epic_id || ""
     };
     if (existingIdx >= 0) {
       session.changes[existingIdx] = entry;
@@ -7508,7 +7518,8 @@ function main() {
         title: ac.title || "",
         plan_path: ac.plan_path || "",
         status: "done",
-        updated_at: now
+        updated_at: now,
+        epic_id: ac.epic_id || ""
       };
       if (existingIdx >= 0) {
         session.changes[existingIdx] = entry;
@@ -7526,7 +7537,8 @@ function main() {
       id: "",
       title: "",
       created_at: "",
-      plan_path: ""
+      plan_path: "",
+      epic_id: ""
     };
   }
   if (args["set-change-status"]) {
@@ -7551,9 +7563,75 @@ function main() {
       }
     }
   }
+  if (args["new-epic"]) {
+    session.active_epic = session.active_epic || {};
+    if (session.active_epic.id) {
+      session.epics = session.epics || [];
+      const existingIdx = session.epics.findIndex(
+        (e) => e.id === session.active_epic.id
+      );
+      const snapshotEntry = {
+        id: session.active_epic.id,
+        title: session.active_epic.title || "",
+        epic_path: session.active_epic.epic_path || "",
+        status: "active",
+        updated_at: now
+      };
+      if (existingIdx >= 0) {
+        session.epics[existingIdx] = snapshotEntry;
+      } else {
+        session.epics.push(snapshotEntry);
+      }
+    }
+    session.active_epic.id = args["epic-id"];
+    session.active_epic.title = args["new-epic"];
+    session.active_epic.created_at = now;
+    session.active_epic.epic_path = "";
+  }
+  if (args["set-epic-path"]) {
+    session.active_epic = session.active_epic || {};
+    if (!session.active_epic.id && !args["new-epic"]) {
+      process.stderr.write(ERRORS.NO_ACTIVE_EPIC("--set-epic-path") + "\n");
+      process.exit(1);
+    }
+    session.active_epic.epic_path = args["set-epic-path"];
+  }
+  if (args["set-epic-status"]) {
+    session.active_epic = session.active_epic || {};
+    if (!session.active_epic.id && !args["new-epic"]) {
+      process.stderr.write(ERRORS.NO_ACTIVE_EPIC("--set-epic-status") + "\n");
+      process.exit(1);
+    }
+    session.epics = session.epics || [];
+    const epicIdx = session.epics.findIndex(
+      (e) => e.id === session.active_epic.id
+    );
+    if (epicIdx >= 0) {
+      session.epics[epicIdx].status = args["set-epic-status"];
+      session.epics[epicIdx].updated_at = now;
+    }
+  }
+  if (args["close-epic"]) {
+    session.epics = session.epics || [];
+    session.active_epic = session.active_epic || {};
+    const aeId = session.active_epic.id;
+    if (aeId) {
+      const epicIdx = session.epics.findIndex((e) => e.id === aeId);
+      if (epicIdx >= 0) {
+        session.epics[epicIdx].status = "done";
+        session.epics[epicIdx].updated_at = now;
+      }
+    }
+    session.active_epic = {
+      id: "",
+      title: "",
+      created_at: "",
+      epic_path: ""
+    };
+  }
   const tmpPath = sessionPath + ".tmp";
   try {
-    (0, import_node_fs.writeFileSync)(tmpPath, (0, import_yaml.stringify)(session), "utf-8");
+    (0, import_node_fs.writeFileSync)(tmpPath, (0, import_yaml.stringify)(session, { lineWidth: 200 }), "utf-8");
     (0, import_node_fs.renameSync)(tmpPath, sessionPath);
   } catch (e) {
     try {

package/dist/types/platform.d.ts

@@ -0,0 +1,12 @@
+export type PlatformId = "claude" | "qoder";
+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,CAAC;AAE5C,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,EAalC,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,24 @@
+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",
+    },
+];
+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;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/install-manifest.yaml

@@ -3,16 +3,20 @@ 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"
     source: "build:templates"
   - pattern: ".ai-agents/knowledge/core/_framework/**"
     source: "copy:sources/knowledge/core/_framework/"
-  - pattern: ".ai-agents/registry.yaml"
-    source: "copy:registry.yaml"
   - pattern: ".ai-agents/scripts/session-update.cjs"
     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"
@@ -23,6 +27,10 @@ create_once:
     source: "sources/defaults/project-context.yaml"
   - path: ".ai-agents/knowledge/core/manifest.yaml"
     source: "sources/knowledge/core/manifest.yaml"
+  # Reconcile-merged on update (see src/fs/registry-merge.ts): framework skills
+  # are refreshed, user `custom: true` skills and added knowledge bindings kept.
+  - path: ".ai-agents/registry.yaml"
+    source: "registry.yaml"
 
 user_data_dirs:
   - ".ai-agents/workspace/artifacts/"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@uoyo/mvtt",
-  "version": "2.0.0-beta.3",
+  "version": "2.0.0-beta.6",
   "description": "My Virtual Tech Team - AI-guided prompt orchestration framework",
   "type": "module",
   "bin": {

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:
-  shared:
-    - id: "core"
-      source: "knowledge/core/"
-      files_from_manifest: true
-    - id: "project-context"
-      source: "knowledge/project/_generated/"
-      files: ["project-context.md"]
-
-# ============================================================
-# 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
-
-  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
-
-  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
-
-  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
-
-  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 ---
-  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
-    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
-    template: .ai-agents/skills/_templates/project-context.md
-    category: workflow
-
-  # --- Architect Skills ---
-  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
-    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]
-
-  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 ---
-  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
-  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
-    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
-
-  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
-
-  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 ---
-  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
-    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
-    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
-
-  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
-
-  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
-
-  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
-
-  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
-
-  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
+last_updated: "2026-05-23"
+
+# ============================================================
+# 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:
+  # _all:
+  #   - id: "core"
+  #     source: "knowledge/core/"
+  #     files_from_manifest: true
+
+# ============================================================
+# Skills
+# ============================================================
+skills:
+  mvt-init:
+    description: "Initialize or refresh a project: scan structure, detect tech stack, infer project type."
+  mvt-status:
+    description: "Display current project and workflow status: skill history, active changes, session state."
+  mvt-config:
+    description: "Manage framework configuration: language, output format, and other settings."
+  mvt-sync-context:
+    description: "Synchronize workspace context with code after manual edits or git operations."
+  mvt-cleanup:
+    description: "Clean up workspace artifacts, summarize completed changes, and archive change records."
+  mvt-analyze:
+    description: "Analyze requirements and extract domain concepts, features, and business rules."
+    template: .ai-agents/skills/_templates/analyze-output.md
+  mvt-analyze-code:
+    description: "Reverse-analyze existing code into project-context.md (terms, modules, layers, rules)."
+    template: .ai-agents/skills/_templates/project-context.md
+  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:
+    description: "Create architecture design from analyzed requirements."
+    template: .ai-agents/skills/_templates/design-output.md
+  mvt-plan-dev:
+    description: "Generate a tracked development plan (plan.yaml) for a large change."
+  mvt-update-plan:
+    description: "Update one task in the active plan.yaml: status, artifacts, notes; auto-advance current_task."
+  mvt-bug-detect:
+    description: "Diagnose a bug (root cause, severity, impact scope) without applying fixes."
+  mvt-implement:
+    description: "Implement features from architecture design; write production code."
+    template: .ai-agents/skills/_templates/implement-output.md
+  mvt-fix:
+    description: "Diagnose and fix bugs or errors in the codebase."
+  mvt-refactor:
+    description: "Refactor existing code while preserving behavior."
+  mvt-quick-dev:
+    description: "Quickly implement small, well-scoped changes (1-3 files) without the full workflow."
+  mvt-review:
+    description: "Review code for quality, standards compliance, and best practices."
+    template: .ai-agents/skills/_templates/review-output.md
+  mvt-test:
+    description: "Generate and design tests to validate implementations."
+    template: .ai-agents/skills/_templates/test-output.md
+  mvt-help:
+    description: "Show available skills, project status, and workflow guidance."
+  mvt-resume:
+    description: "Resume an in-progress task in a new conversation from session.yaml and recent artifacts."
+  mvt-create-skill:
+    description: "Create custom MVTT skills through an interactive guided workflow."
+  mvt-manage-context:
+    description: "Manage knowledge and registry: add (with AI routing), remove, move, rename, list."
+  mvt-check-context:
+    description: "Analyze context token load and provide optimization recommendations."
+  mvt-template:
+    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: []