@uoyo/mvtt 2.0.0-beta.0 → 2.0.0-beta.2

package/package.json

@@ -1,57 +1,57 @@
-{
-  "name": "@uoyo/mvtt",
-  "version": "2.0.0-beta.0",
-  "description": "My Virtual Tech Team - AI-guided prompt orchestration framework",
-  "type": "module",
-  "bin": {
-    "mvtt": "./dist/index.js"
-  },
-  "files": [
-    "dist/",
-    "sources/",
-    "registry.yaml",
-    "install-manifest.yaml"
-  ],
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "keywords": [
-    "ai",
-    "agents",
-    "prompt-engineering",
-    "claude-code",
-    "cli",
-    "orchestration"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/uoyoCsharp/My-Virtual-TechTeam.git"
-  },
-  "bugs": {
-    "url": "https://github.com/uoyoCsharp/My-Virtual-TechTeam/issues"
-  },
-  "homepage": "https://github.com/uoyoCsharp/My-Virtual-TechTeam#readme",
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json",
-    "test": "vitest run",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage",
-    "prepublishOnly": "npm run build && npm test"
-  },
-  "devDependencies": {
-    "@types/node": "^25.6.0",
-    "@types/prompts": "^2.4.9",
-    "@vitest/coverage-v8": "^2.1.9",
-    "typescript": "^5.4.0",
-    "vitest": "^2.0.0"
-  },
-  "dependencies": {
-    "commander": "^14.0.3",
-    "prompts": "^2.4.2",
-    "yaml": "^2.4.0"
-  },
-  "license": "MIT"
-}
+{
+  "name": "@uoyo/mvtt",
+  "version": "2.0.0-beta.2",
+  "description": "My Virtual Tech Team - AI-guided prompt orchestration framework",
+  "type": "module",
+  "bin": {
+    "mvtt": "dist/index.js"
+  },
+  "files": [
+    "dist/",
+    "sources/",
+    "registry.yaml",
+    "install-manifest.yaml"
+  ],
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "keywords": [
+    "ai",
+    "agents",
+    "prompt-engineering",
+    "claude-code",
+    "cli",
+    "orchestration"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/uoyoCsharp/My-Virtual-TechTeam.git"
+  },
+  "bugs": {
+    "url": "https://github.com/uoyoCsharp/My-Virtual-TechTeam/issues"
+  },
+  "homepage": "https://github.com/uoyoCsharp/My-Virtual-TechTeam#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "devDependencies": {
+    "@types/node": "^25.6.0",
+    "@types/prompts": "^2.4.9",
+    "@vitest/coverage-v8": "^2.1.9",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.3",
+    "prompts": "^2.4.2",
+    "yaml": "^2.4.0"
+  },
+  "license": "MIT"
+}

package/registry.yaml

@@ -1,209 +1,198 @@
-# MVTT Framework Registry (v2)
-# Single source of truth for skill metadata. Consumed at build-time by mvtt CLI
-# and at runtime by /mvt-status and /mvt-help.
-
-version: "2.0"
-last_updated: "2026-04-28"
-
-skills:
-  # --- Conductor Skills ---
-  mvt-init:
-    agent: conductor
-    description: "Initialize or refresh a project with comprehensive analysis"
-    path: .claude/skills/mvt-init/SKILL.md
-    template: .ai-agents/skills/_templates/init-output.md
-    category: project
-    mode: independent
-    phase: null
-    depends_on: []
-    next_suggestions:
-      primary: mvt-analyze
-      primary_desc: "Start analyzing requirements"
-
-  mvt-status:
-    agent: conductor
-    description: "Show current project and workflow status"
-    path: .claude/skills/mvt-status/SKILL.md
-    template: .ai-agents/skills/_templates/status-output.md
-    category: project
-    mode: independent
-    phase: null
-    depends_on: []
-
-  mvt-config:
-    agent: conductor
-    description: "Interactive configuration management for framework settings"
-    path: .claude/skills/mvt-config/SKILL.md
-    template: .ai-agents/skills/_templates/config-output.md
-    category: project
-    mode: independent
-    phase: null
-    depends_on: []
-
-  mvt-sync-context:
-    agent: conductor
-    description: "Synchronize workspace context with code changes"
-    path: .claude/skills/mvt-sync-context/SKILL.md
-    template: .ai-agents/skills/_templates/sync-context-output.md
-    category: project
-    mode: independent
-    phase: null
-    depends_on: []
-
-  mvt-cleanup:
-    agent: conductor
-    description: "Clean up workspace artifacts and maintain workspace health"
-    path: .claude/skills/mvt-cleanup/SKILL.md
-    template: .ai-agents/skills/_templates/cleanup-output.md
-    category: project
-    mode: independent
-    phase: null
-    depends_on: []
-
-  # --- Analyst Skills ---
-  mvt-analyze:
-    agent: analyst
-    description: "Analyze requirements documents and extract domain concepts"
-    path: .claude/skills/mvt-analyze/SKILL.md
-    template: .ai-agents/skills/_templates/analyze-output.md
-    category: workflow
-    mode: full-workflow
-    phase: analyze
-    depends_on: []
-    next_suggestions:
-      primary: mvt-design
-      primary_desc: "Create architecture based on this analysis"
-
-  mvt-analyze-code:
-    agent: analyst
-    description: "Reverse-analyze existing code to generate context"
-    path: .claude/skills/mvt-analyze-code/SKILL.md
-    template: .ai-agents/skills/_templates/analyze-code-output.md
-    category: workflow
-    mode: independent
-    phase: null
-    depends_on: []
-
-  # --- Architect Skills ---
-  mvt-design:
-    agent: architect
-    description: "Create architecture design based on analyzed requirements"
-    path: .claude/skills/mvt-design/SKILL.md
-    template: .ai-agents/skills/_templates/design-output.md
-    category: workflow
-    mode: full-workflow
-    phase: design
-    depends_on: [mvt-analyze]
-    next_suggestions:
-      primary: mvt-implement
-      primary_desc: "Implement features based on this design"
-
-  # --- Developer Skills ---
-  mvt-implement:
-    agent: developer
-    description: "Implement features based on architecture design"
-    path: .claude/skills/mvt-implement/SKILL.md
-    template: .ai-agents/skills/_templates/implement-output.md
-    category: workflow
-    mode: full-workflow
-    phase: implement
-    depends_on: [mvt-design]
-    next_suggestions:
-      primary: mvt-review
-      primary_desc: "Review the implementation"
-
-  mvt-fix:
-    agent: developer
-    description: "Diagnose and fix bugs or issues in the codebase"
-    path: .claude/skills/mvt-fix/SKILL.md
-    template: .ai-agents/skills/_templates/fix-output.md
-    category: shortcut
-    mode: shortcut
-    phase: null
-    depends_on: []
-
-  mvt-refactor:
-    agent: developer
-    description: "Refactor existing code while preserving behavior"
-    path: .claude/skills/mvt-refactor/SKILL.md
-    template: .ai-agents/skills/_templates/refactor-output.md
-    category: shortcut
-    mode: shortcut
-    phase: null
-    depends_on: []
-
-  # --- Reviewer Skills ---
-  mvt-review:
-    agent: reviewer
-    description: "Perform code review for quality and standards compliance"
-    path: .claude/skills/mvt-review/SKILL.md
-    template: .ai-agents/skills/_templates/review-output.md
-    category: workflow
-    mode: full-workflow
-    phase: review
-    depends_on: [mvt-implement]
-    next_suggestions:
-      primary: mvt-fix
-      primary_desc: "Address critical issues"
-
-  # --- Tester Skills ---
-  mvt-test:
-    agent: tester
-    description: "Generate and design tests to validate implementations"
-    path: .claude/skills/mvt-test/SKILL.md
-    template: .ai-agents/skills/_templates/test-output.md
-    category: workflow
-    mode: full-workflow
-    phase: test
-    depends_on: [mvt-implement]
-
-  # --- Utility Skills ---
-  mvt-help:
-    agent: conductor
-    description: "Show available skills, current project status, and workflow guidance"
-    path: .claude/skills/mvt-help/SKILL.md
-    template: null
-    category: utility
-    mode: independent
-    phase: null
-    depends_on: []
-
-  mvt-create-skill:
-    agent: conductor
-    description: "Create custom MVTT skills through interactive guided workflow"
-    path: .claude/skills/mvt-create-skill/SKILL.md
-    template: null
-    category: utility
-    mode: independent
-    phase: null
-    depends_on: []
-
-  mvt-add-context:
-    agent: conductor
-    description: "Interactively add or update project context information"
-    path: .claude/skills/mvt-add-context/SKILL.md
-    template: null
-    category: utility
-    mode: independent
-    phase: null
-    depends_on: []
-
-  mvt-check-context:
-    agent: conductor
-    description: "Analyze context token load and give optimization recommendations"
-    path: .claude/skills/mvt-check-context/SKILL.md
-    template: .ai-agents/skills/_templates/context-check-output.md
-    category: utility
-    mode: independent
-    phase: null
-    depends_on: []
-
-  mvt-template:
-    agent: conductor
-    description: "View, customize, and manage output templates for MVTT skills"
-    path: .claude/skills/mvt-template/SKILL.md
-    template: null
-    category: utility
-    mode: independent
-    phase: null
-    depends_on: []
+# 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

package/sources/defaults/config.yaml

@@ -1,30 +1,27 @@
-# MVTT Framework - User Configuration
-# Unified config center: all skills read and enforce these settings via Activation Protocol
-# Modify via: /mvt-config or edit directly
-
-version: "2.0"
-
-# ============================================================
-# User Preferences (enforced by Activation Protocol Step 2)
-# ============================================================
-preferences:
-  # Output language for all skill responses and document artifacts
-  # Options: en-US, zh-CN
-  language: en-US
-
-  # Output style
-  output:
-    no_emojis: true          # Disable emojis in output
-    data_format: yaml        # Data output format: yaml | json
-
-# ============================================================
-# Pattern Settings
-# ============================================================
-pattern:
-  # Active architecture pattern
-  # Use /mvt-init to auto-detect or /mvt-config to change
-  active: ""
-
-  selection:
-    auto_detect: true
-    confirm_with_user: true
+# MVTT Framework - User Configuration
+# Unified config center: all skills read and enforce these settings via Activation Protocol
+# Modify via: /mvt-config or edit directly
+
+version: "2.0"
+
+# ============================================================
+# User Preferences (enforced by Activation Protocol Step 2)
+# ============================================================
+preferences:
+  # Language used for interactive responses (chat replies, prompts, tables shown to the user)
+  # Options: en-US, zh-CN
+  interaction_language: en-US
+
+  # Language used for persistent document output (artifacts, project-context.md, generated reports)
+  # If absent, falls back to interaction_language.
+  # Options: en-US, 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
+
+  # AI routing for /mvt-manage-context add
+  context_routing:
+    relevance_threshold: 70  # Skills scored >= this are pre-checked; below are folded

package/sources/defaults/project-context.yaml

@@ -1,26 +1,15 @@
-# Unified Project Context
-# Merges: project.yaml + architecture.yaml + requirements.yaml + decisions.yaml
-
-project:
-  name: ""
-  type: ""
-  initialized_at: ""
-  tech_stack:
-    language: ""
-    framework: ""
-    build_tool: ""
-    test_framework: ""
-
-# Requirements summary (written by #analyze)
-requirements:
-  features: []
-  actors: []
-  business_rules: []
-  clarifications: []
-
-# Architecture design (written by #design)
-architecture:
-  overview: ""
-  modules: []
-  components: []
-  decisions: []    # ADR list (merged from former decisions.yaml)
+# 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
+    tech_stack:
+      primary_language: ""
+      secondary_languages: []
+      framework: ""
+      build_tool: ""
+      test_framework: ""