claude-mpm 4.16.2__tar.gz → 4.17.0__tar.gz

claude_mpm-4.17.0/BUILD_NUMBER

@@ -0,0 +1 @@
+482

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.16.2
+Version: 4.17.0
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team
@@ -157,7 +157,7 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 ## Features
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
-- 🎯 **Skills System**: 19 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
+- 🎯 **Skills System**: 20 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
 - 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
@@ -310,18 +310,24 @@ Agents learn project-specific patterns using a simple list format and can update
 
 Claude MPM includes a powerful skills system that eliminates redundant agent guidance through reusable skill modules:
 
-**19 Bundled Skills** covering essential development workflows:
+**20 Bundled Skills** covering essential development workflows (all versioned starting at 0.1.0):
 - Git workflow, TDD, code review, systematic debugging
 - API documentation, refactoring patterns, performance profiling
 - Docker containerization, database migrations, security scanning
 - JSON/PDF/XLSX handling, async testing, ImageMagick operations
 - Local development servers: Next.js, FastAPI, Vite, Express
+- Web performance: Lighthouse metrics, Core Web Vitals optimization
 
 **Three-Tier Organization:**
 - **Bundled**: Core skills included with Claude MPM (~15,000 lines of reusable guidance)
 - **User**: Custom skills in `~/.config/claude-mpm/skills/`
 - **Project**: Project-specific skills in `.claude-mpm/skills/`
 
+**Version Tracking:**
+- All skills support semantic versioning (MAJOR.MINOR.PATCH)
+- Check versions with `/mpm-version` command in Claude Code
+- See [Skills Versioning Guide](docs/user/skills-versioning.md) for details
+
 **Quick Access:**
 ```bash
 # Interactive skills management
@@ -395,13 +401,17 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 - **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub
 - **Clear User Paths**: Organized by user type and experience level
 - **Cross-Referenced**: Links between related topics and sections
-- **Up-to-Date**: Version 4.16.1 with local development skills and enhanced documentation
+- **Up-to-Date**: Version 4.16.3 with web performance optimization skill
+
+## Recent Updates (v4.16.3)
+
+**Web Performance Optimization**: New `web-performance-optimization` skill for Lighthouse metrics, Core Web Vitals (LCP, INP, CLS), and framework-specific optimization patterns.
 
-## Recent Updates (v4.16.1)
+## Previous Updates (v4.16.1)
 
 **Local Development Skills**: Added 4 new toolchain-specific skills: `nextjs-local-dev`, `fastapi-local-dev`, `vite-local-dev`, and `express-local-dev` for professional local server management with PM2, HMR, and production-grade patterns.
 
-**Skills System Integration**: 19 bundled skills with auto-linking, three-tier organization, and interactive configuration. Eliminates 85% of redundant guidance across agent templates (~15,000 lines of reusable content).
+**Skills System Integration**: 20 bundled skills with auto-linking, three-tier organization, and interactive configuration. Eliminates 85% of redundant guidance across agent templates (~15,000 lines of reusable content).
 
 **Enhanced Documentation**: Complete documentation suite with PDF guides, reorganized structure, and comprehensive design documents for skills integration.
 

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/README.md

@@ -9,7 +9,7 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 ## Features
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
-- 🎯 **Skills System**: 19 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
+- 🎯 **Skills System**: 20 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
 - 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
@@ -162,18 +162,24 @@ Agents learn project-specific patterns using a simple list format and can update
 
 Claude MPM includes a powerful skills system that eliminates redundant agent guidance through reusable skill modules:
 
-**19 Bundled Skills** covering essential development workflows:
+**20 Bundled Skills** covering essential development workflows (all versioned starting at 0.1.0):
 - Git workflow, TDD, code review, systematic debugging
 - API documentation, refactoring patterns, performance profiling
 - Docker containerization, database migrations, security scanning
 - JSON/PDF/XLSX handling, async testing, ImageMagick operations
 - Local development servers: Next.js, FastAPI, Vite, Express
+- Web performance: Lighthouse metrics, Core Web Vitals optimization
 
 **Three-Tier Organization:**
 - **Bundled**: Core skills included with Claude MPM (~15,000 lines of reusable guidance)
 - **User**: Custom skills in `~/.config/claude-mpm/skills/`
 - **Project**: Project-specific skills in `.claude-mpm/skills/`
 
+**Version Tracking:**
+- All skills support semantic versioning (MAJOR.MINOR.PATCH)
+- Check versions with `/mpm-version` command in Claude Code
+- See [Skills Versioning Guide](docs/user/skills-versioning.md) for details
+
 **Quick Access:**
 ```bash
 # Interactive skills management
@@ -247,13 +253,17 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 - **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub
 - **Clear User Paths**: Organized by user type and experience level
 - **Cross-Referenced**: Links between related topics and sections
-- **Up-to-Date**: Version 4.16.1 with local development skills and enhanced documentation
+- **Up-to-Date**: Version 4.16.3 with web performance optimization skill
+
+## Recent Updates (v4.16.3)
+
+**Web Performance Optimization**: New `web-performance-optimization` skill for Lighthouse metrics, Core Web Vitals (LCP, INP, CLS), and framework-specific optimization patterns.
 
-## Recent Updates (v4.16.1)
+## Previous Updates (v4.16.1)
 
 **Local Development Skills**: Added 4 new toolchain-specific skills: `nextjs-local-dev`, `fastapi-local-dev`, `vite-local-dev`, and `express-local-dev` for professional local server management with PM2, HMR, and production-grade patterns.
 
-**Skills System Integration**: 19 bundled skills with auto-linking, three-tier organization, and interactive configuration. Eliminates 85% of redundant guidance across agent templates (~15,000 lines of reusable content).
+**Skills System Integration**: 20 bundled skills with auto-linking, three-tier organization, and interactive configuration. Eliminates 85% of redundant guidance across agent templates (~15,000 lines of reusable content).
 
 **Enhanced Documentation**: Complete documentation suite with PDF guides, reorganized structure, and comprehensive design documents for skills integration.
 

claude_mpm-4.17.0/VERSION

@@ -0,0 +1 @@
+4.17.0

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "claude-mpm"
-version = "4.16.2"
+version = "4.17.0"
 description = "Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking"
 readme = "README.md"
 requires-python = ">=3.8"
@@ -84,7 +84,7 @@ ignore-imports = false
 
 [tool.commitizen]
 name = "cz_conventional_commits"
-version = "4.16.2"
+version = "4.17.0"
 version_files = [ "VERSION", "src/claude_mpm/VERSION", "package.json:version",]
 tag_format = "v$version"
 update_changelog_on_bump = true
@@ -104,7 +104,7 @@ testpaths = [ "tests",]
 python_files = [ "test_*.py", "*_test.py",]
 python_classes = [ "Test*",]
 python_functions = [ "test_*",]
-addopts = [ "-v", "--tb=short", "--strict-markers", "--disable-warnings", "--asyncio-mode=auto",]
+addopts = [ "--tb=short", "--strict-markers", "--disable-warnings", "--asyncio-mode=auto",]
 markers = [ "unit: Unit tests", "integration: Integration tests", "e2e: End-to-end tests", "regression: Regression tests", "socketio: Socket.IO related tests", "hook: Hook system tests",]
 asyncio_mode = "auto"
 

claude_mpm-4.17.0/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+4.17.0

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/src/claude_mpm/commands/mpm-help.md

@@ -90,6 +90,9 @@ Available Commands:
 /mpm-monitor [start|stop|restart|status|port]
   Manage Socket.IO monitoring server and dashboard
 
+/mpm-version
+  Display comprehensive version information including project version, all agents with versions, and all skills with versions
+
 Use '/mpm-help <command>' for detailed help on a specific command.
 ```
 

claude_mpm-4.17.0/src/claude_mpm/commands/mpm-version.md

@@ -0,0 +1,113 @@
+# Display Claude MPM Version Information
+
+Show comprehensive version information for Claude MPM project, agents, and skills.
+
+## Usage
+
+```
+/mpm-version
+```
+
+## Description
+
+Display version information including:
+- Project version and build number
+- All deployed agents with their versions (grouped by tier: system/user/project)
+- All available skills with their versions (grouped by source: bundled/user/project)
+- Summary statistics
+
+## Implementation
+
+When you run `/mpm-version`, the PM will:
+
+1. **Collect Version Information**
+   - Use VersionService to gather all version data
+   - Project version from pyproject.toml
+   - Build number from BUILD_NUMBER file
+   - Agent versions from AgentRegistry
+   - Skills versions from SkillRegistry
+
+2. **Format Output**
+   - Hierarchical display: Project → Agents → Skills
+   - Grouped by tier/source for clarity
+   - Sorted alphabetically within groups
+   - Summary statistics at the end
+
+3. **Display Results**
+   - Well-formatted tree structure
+   - Easy to scan and read
+   - Includes totals and counts
+
+## Example Output
+
+```
+Claude MPM Version Information
+==============================
+
+Project Version: 4.16.3
+Build: 481
+
+Agents (35 total)
+-----------------
+
+System Agents (30):
+  ├─ agent-manager (1.0.0)
+  ├─ engineer (3.9.1)
+  ├─ research-agent (4.5.1)
+  ├─ documentation (2.1.0)
+  ├─ qa (2.0.3)
+  └─ ... (25 more)
+
+User Agents (3):
+  ├─ custom-agent (1.0.0)
+  ├─ testing-agent (0.5.0)
+  └─ prototype-agent (0.1.0)
+
+Project Agents (2):
+  ├─ project-specific (2.0.0)
+  └─ domain-expert (1.1.0)
+
+Skills (20 total)
+-----------------
+
+Bundled Skills (20):
+  ├─ test-driven-development (0.1.0)
+  ├─ systematic-debugging (0.1.0)
+  ├─ async-testing (0.1.0)
+  ├─ performance-profiling (0.1.0)
+  ├─ security-scanning (0.1.0)
+  └─ ... (15 more)
+
+User Skills (0):
+  (none)
+
+Project Skills (0):
+  (none)
+
+Summary
+-------
+• Project: v4.16.3 (build 481)
+• Agents: 35 total (30 system, 3 user, 2 project)
+• Skills: 20 total (20 bundled, 0 user, 0 project)
+```
+
+## PM Implementation Instructions
+
+To execute this command, PM should:
+
+1. Import and use VersionService:
+   ```python
+   from claude_mpm.services.version_service import VersionService
+
+   service = VersionService()
+   summary = service.get_version_summary()
+   ```
+
+2. Format output following the example structure above
+3. Handle missing data gracefully (show "unknown" for missing versions)
+4. Include all tiers/sources even if counts are zero
+
+## Related Commands
+
+- `/mpm-help` - Show all available MPM commands
+- `/mpm-status` - Show system status information

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/src/claude_mpm/commands/mpm.md

@@ -8,6 +8,7 @@ Available MPM commands:
 - /mpm-help - Show command help
 - /mpm-status - Show MPM status
 - /mpm-config - Manage configuration
+- /mpm-version - Display version information for project, agents, and skills
 
 Claude MPM extends Claude Code with:
 - Multi-agent orchestration

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/src/claude_mpm/services/version_service.py

@@ -9,7 +9,7 @@ Extracted from ClaudeRunner to follow Single Responsibility Principle.
 """
 
 from pathlib import Path
-from typing import Any, Dict, Optional
+from typing import Any, Dict, List, Optional
 
 from claude_mpm.config.paths import paths
 from claude_mpm.core.base_service import BaseService
@@ -274,3 +274,106 @@ class VersionService(BaseService, VersionServiceInterface):
             "message": "Update checking not implemented",
             "checked_at": None,
         }
+
+    def get_agents_versions(self) -> Dict[str, List[Dict[str, str]]]:
+        """Get all agents grouped by tier with versions.
+
+        Returns:
+            Dict with keys: system, user, project
+            Each value is list of agent dicts with: name, version, id
+        """
+        from claude_mpm.core.unified_agent_registry import get_agent_registry
+
+        agents_by_tier = {"system": [], "user": [], "project": []}
+
+        try:
+            registry = get_agent_registry()
+            all_agents = registry.list_agents()
+
+            for agent in all_agents:
+                agent_info = {
+                    "name": agent.name,
+                    "version": agent.version,
+                    "id": agent.name,  # Use name as ID since agent_id doesn't exist
+                }
+                tier = (
+                    agent.tier.value
+                    if hasattr(agent.tier, "value")
+                    else str(agent.tier)
+                )
+                if tier in agents_by_tier:
+                    agents_by_tier[tier].append(agent_info)
+                else:
+                    agents_by_tier["system"].append(agent_info)
+
+            # Sort each tier alphabetically by name
+            for tier, agents in agents_by_tier.items():
+                agents.sort(key=lambda x: x["name"])
+
+        except Exception as e:
+            self.logger.error(f"Failed to get agent versions: {e}")
+
+        return agents_by_tier
+
+    def get_skills_versions(self) -> Dict[str, List[Dict[str, str]]]:
+        """Get all skills grouped by source with versions.
+
+        Returns:
+            Dict with keys: bundled, user, project
+            Each value is list of skill dicts with: name, version, description
+        """
+        from claude_mpm.skills.registry import get_registry
+
+        skills_by_source = {"bundled": [], "user": [], "project": []}
+
+        try:
+            registry = get_registry()
+
+            for skill in registry.list_skills():
+                skill_info = {
+                    "name": skill.name,
+                    "version": skill.version,
+                    "description": (
+                        skill.description[:60] + "..."
+                        if len(skill.description) > 60
+                        else skill.description
+                    ),
+                }
+                source = skill.source if skill.source in skills_by_source else "bundled"
+                skills_by_source[source].append(skill_info)
+
+            # Sort each source alphabetically by name
+            for source, skills in skills_by_source.items():
+                skills.sort(key=lambda x: x["name"])
+
+        except Exception as e:
+            self.logger.error(f"Failed to get skill versions: {e}")
+
+        return skills_by_source
+
+    def get_version_summary(self) -> Dict:
+        """Get complete version summary.
+
+        Returns:
+            Dict with project_version, build, agents, skills, and counts
+        """
+        agents = self.get_agents_versions()
+        skills = self.get_skills_versions()
+        build = self.get_build_number()
+
+        return {
+            "project_version": self.get_base_version(),
+            "build": build,
+            "agents": agents,
+            "skills": skills,
+            "counts": {
+                "agents_total": sum(len(v) for v in agents.values()),
+                "agents_system": len(agents.get("system", [])),
+                "agents_user": len(agents.get("user", [])),
+                "agents_project": len(agents.get("project", [])),
+                "skills_total": sum(len(v) for v in skills.values()),
+                "skills_bundled": len(skills.get("bundled", [])),
+                "skills_user": len(skills.get("user", [])),
+                "skills_project": len(skills.get("project", [])),
+            },
+        }

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/src/claude_mpm/skills/registry.py

@@ -1,8 +1,11 @@
 """Skills registry - manages bundled and discovered skills."""
 
+import re
 from dataclasses import dataclass
 from pathlib import Path
-from typing import Dict, List, Optional
+from typing import Any, Dict, List, Optional
+
+import yaml
 
 from claude_mpm.core.logging_utils import get_logger
 
@@ -17,13 +20,27 @@ class Skill:
     path: Path
     content: str
     source: str  # 'bundled', 'user', or 'project'
+
+    # Version tracking fields
+    version: str = "0.1.0"
+    skill_id: str = ""  # defaults to name if not provided
+
+    # Existing fields
     description: str = ""
     agent_types: List[str] = None  # Which agent types can use this skill
 
+    # Optional metadata
+    updated_at: Optional[str] = None
+    tags: List[str] = None
+
     def __post_init__(self):
-        """Initialize agent_types list if not provided."""
+        """Initialize default values if not provided."""
         if self.agent_types is None:
             self.agent_types = []
+        if self.tags is None:
+            self.tags = []
+        if not self.skill_id:
+            self.skill_id = self.name
 
 
 class SkillsRegistry:
@@ -36,6 +53,28 @@ class SkillsRegistry:
         self._load_user_skills()
         self._load_project_skills()
 
+    def _parse_skill_frontmatter(self, content: str) -> Dict[str, Any]:
+        """Parse YAML frontmatter from skill markdown file.
+
+        Returns:
+            Dict with frontmatter fields or empty dict if no frontmatter
+        """
+        # Check for YAML frontmatter
+        if not content.startswith("---"):
+            return {}
+
+        # Extract frontmatter (match: ---\n...yaml...\n---\nrest)
+        match = re.match(r"^---\n(.*?)\n---\n(.*)$", content, re.DOTALL)
+        if not match:
+            return {}
+
+        try:
+            frontmatter = yaml.safe_load(match.group(1))
+            return frontmatter or {}
+        except yaml.YAMLError as e:
+            logger.warning(f"Failed to parse skill frontmatter: {e}")
+            return {}
+
     def _load_bundled_skills(self):
         """Load skills bundled with MPM."""
         bundled_dir = Path(__file__).parent / "bundled"
@@ -49,21 +88,36 @@ class SkillsRegistry:
                 skill_name = skill_file.stem
                 content = skill_file.read_text(encoding="utf-8")
 
-                # Extract description from first paragraph if available
-                description = self._extract_description(content)
+                # Parse frontmatter
+                frontmatter = self._parse_skill_frontmatter(content)
+
+                # Extract version fields from frontmatter
+                version = frontmatter.get("skill_version", "0.1.0")
+                skill_id = frontmatter.get("skill_id", skill_name)
+                updated_at = frontmatter.get("updated_at")
+                tags = frontmatter.get("tags", [])
+
+                # Extract description (from frontmatter or fallback to content parsing)
+                description = frontmatter.get("description", "")
+                if not description:
+                    description = self._extract_description(content)
 
                 self.skills[skill_name] = Skill(
                     name=skill_name,
                     path=skill_file,
                     content=content,
                     source="bundled",
+                    version=version,
+                    skill_id=skill_id,
                     description=description,
+                    updated_at=updated_at,
+                    tags=tags,
                 )
                 skill_count += 1
             except Exception as e:
                 logger.error(f"Error loading bundled skill {skill_file}: {e}")
 
-        logger.info(f"Loaded {skill_count} bundled skills")
+        logger.debug(f"Loaded {skill_count} bundled skills")
 
     def _load_user_skills(self):
         """Load user-installed skills from ~/.claude/skills/"""
@@ -78,14 +132,31 @@ class SkillsRegistry:
                 skill_name = skill_file.stem
                 # User skills override bundled skills
                 content = skill_file.read_text(encoding="utf-8")
-                description = self._extract_description(content)
+
+                # Parse frontmatter
+                frontmatter = self._parse_skill_frontmatter(content)
+
+                # Extract version fields from frontmatter
+                version = frontmatter.get("skill_version", "0.1.0")
+                skill_id = frontmatter.get("skill_id", skill_name)
+                updated_at = frontmatter.get("updated_at")
+                tags = frontmatter.get("tags", [])
+
+                # Extract description (from frontmatter or fallback to content parsing)
+                description = frontmatter.get("description", "")
+                if not description:
+                    description = self._extract_description(content)
 
                 self.skills[skill_name] = Skill(
                     name=skill_name,
                     path=skill_file,
                     content=content,
                     source="user",
+                    version=version,
+                    skill_id=skill_id,
                     description=description,
+                    updated_at=updated_at,
+                    tags=tags,
                 )
                 skill_count += 1
                 logger.debug(f"User skill '{skill_name}' overrides bundled version")
@@ -93,7 +164,7 @@ class SkillsRegistry:
                 logger.error(f"Error loading user skill {skill_file}: {e}")
 
         if skill_count > 0:
-            logger.info(f"Loaded {skill_count} user skills")
+            logger.debug(f"Loaded {skill_count} user skills")
 
     def _load_project_skills(self):
         """Load project-specific skills from .claude/skills/"""
@@ -108,14 +179,31 @@ class SkillsRegistry:
                 skill_name = skill_file.stem
                 # Project skills override both user and bundled skills
                 content = skill_file.read_text(encoding="utf-8")
-                description = self._extract_description(content)
+
+                # Parse frontmatter
+                frontmatter = self._parse_skill_frontmatter(content)
+
+                # Extract version fields from frontmatter
+                version = frontmatter.get("skill_version", "0.1.0")
+                skill_id = frontmatter.get("skill_id", skill_name)
+                updated_at = frontmatter.get("updated_at")
+                tags = frontmatter.get("tags", [])
+
+                # Extract description (from frontmatter or fallback to content parsing)
+                description = frontmatter.get("description", "")
+                if not description:
+                    description = self._extract_description(content)
 
                 self.skills[skill_name] = Skill(
                     name=skill_name,
                     path=skill_file,
                     content=content,
                     source="project",
+                    version=version,
+                    skill_id=skill_id,
                     description=description,
+                    updated_at=updated_at,
+                    tags=tags,
                 )
                 skill_count += 1
                 logger.debug(f"Project skill '{skill_name}' overrides other versions")
@@ -123,7 +211,7 @@ class SkillsRegistry:
                 logger.error(f"Error loading project skill {skill_file}: {e}")
 
         if skill_count > 0:
-            logger.info(f"Loaded {skill_count} project skills")
+            logger.debug(f"Loaded {skill_count} project skills")
 
     def _extract_description(self, content: str) -> str:
         """Extract description from skill content (first paragraph or summary)."""

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/src/claude_mpm.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 4.16.2
+Version: 4.17.0
 Summary: Claude Multi-Agent Project Manager - Orchestrate Claude with agent delegation and ticket tracking
 Author-email: Bob Matsuoka <bob@matsuoka.com>
 Maintainer: Claude MPM Team
@@ -157,7 +157,7 @@ A powerful orchestration framework for **Claude Code (CLI)** that enables multi-
 ## Features
 
 - 🤖 **Multi-Agent System**: 15 specialized agents for comprehensive project management
-- 🎯 **Skills System**: 19 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
+- 🎯 **Skills System**: 20 bundled skills with auto-linking, three-tier organization (bundled/user/project), and interactive configuration
 - 🧠 **Persistent Knowledge System**: Project-specific kuzu-memory integration for intelligent context retention
 - 🔄 **Session Management**: Resume previous sessions with `--resume`
 - 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
@@ -310,18 +310,24 @@ Agents learn project-specific patterns using a simple list format and can update
 
 Claude MPM includes a powerful skills system that eliminates redundant agent guidance through reusable skill modules:
 
-**19 Bundled Skills** covering essential development workflows:
+**20 Bundled Skills** covering essential development workflows (all versioned starting at 0.1.0):
 - Git workflow, TDD, code review, systematic debugging
 - API documentation, refactoring patterns, performance profiling
 - Docker containerization, database migrations, security scanning
 - JSON/PDF/XLSX handling, async testing, ImageMagick operations
 - Local development servers: Next.js, FastAPI, Vite, Express
+- Web performance: Lighthouse metrics, Core Web Vitals optimization
 
 **Three-Tier Organization:**
 - **Bundled**: Core skills included with Claude MPM (~15,000 lines of reusable guidance)
 - **User**: Custom skills in `~/.config/claude-mpm/skills/`
 - **Project**: Project-specific skills in `.claude-mpm/skills/`
 
+**Version Tracking:**
+- All skills support semantic versioning (MAJOR.MINOR.PATCH)
+- Check versions with `/mpm-version` command in Claude Code
+- See [Skills Versioning Guide](docs/user/skills-versioning.md) for details
+
 **Quick Access:**
 ```bash
 # Interactive skills management
@@ -395,13 +401,17 @@ See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md]
 - **Single Entry Point**: [docs/README.md](docs/README.md) is your navigation hub
 - **Clear User Paths**: Organized by user type and experience level
 - **Cross-Referenced**: Links between related topics and sections
-- **Up-to-Date**: Version 4.16.1 with local development skills and enhanced documentation
+- **Up-to-Date**: Version 4.16.3 with web performance optimization skill
+
+## Recent Updates (v4.16.3)
+
+**Web Performance Optimization**: New `web-performance-optimization` skill for Lighthouse metrics, Core Web Vitals (LCP, INP, CLS), and framework-specific optimization patterns.
 
-## Recent Updates (v4.16.1)
+## Previous Updates (v4.16.1)
 
 **Local Development Skills**: Added 4 new toolchain-specific skills: `nextjs-local-dev`, `fastapi-local-dev`, `vite-local-dev`, and `express-local-dev` for professional local server management with PM2, HMR, and production-grade patterns.
 
-**Skills System Integration**: 19 bundled skills with auto-linking, three-tier organization, and interactive configuration. Eliminates 85% of redundant guidance across agent templates (~15,000 lines of reusable content).
+**Skills System Integration**: 20 bundled skills with auto-linking, three-tier organization, and interactive configuration. Eliminates 85% of redundant guidance across agent templates (~15,000 lines of reusable content).
 
 **Enhanced Documentation**: Complete documentation suite with PDF guides, reorganized structure, and comprehensive design documents for skills integration.
 

{claude_mpm-4.16.2 → claude_mpm-4.17.0}/src/claude_mpm.egg-info/SOURCES.txt

@@ -193,6 +193,7 @@ src/claude_mpm/commands/mpm-monitor.md
 src/claude_mpm/commands/mpm-organize.md
 src/claude_mpm/commands/mpm-status.md
 src/claude_mpm/commands/mpm-tickets.md
+src/claude_mpm/commands/mpm-version.md
 src/claude_mpm/commands/mpm.md
 src/claude_mpm/config/__init__.py
 src/claude_mpm/config/agent_config.py