claude-mpm 4.1.1__py3-none-any.whl → 4.1.2__py3-none-any.whl

claude_mpm/agents/base_agent_loader.py

@@ -26,7 +26,7 @@ import logging
 import os
 from enum import Enum
 from pathlib import Path
-from typing import Any, Dict, Optional
+from typing import Dict, Optional
 
 from claude_mpm.services.memory.cache.shared_prompt_cache import SharedPromptCache
 
@@ -39,7 +39,7 @@ BASE_AGENT_CACHE_KEY = "base_agent:instructions"
 
 def _get_base_agent_file() -> Path:
     """Get the base agent file path with priority-based search.
-    
+
     Priority order:
     1. Environment variable override (CLAUDE_MPM_BASE_AGENT_PATH)
     2. Current working directory (for local development)
@@ -54,53 +54,66 @@ def _get_base_agent_file() -> Path:
         if env_base_agent.exists():
             logger.info(f"Using environment variable base_agent: {env_base_agent}")
             return env_base_agent
-        else:
-            logger.warning(f"CLAUDE_MPM_BASE_AGENT_PATH set but file doesn't exist: {env_base_agent}")
-    
+        logger.warning(
+            f"CLAUDE_MPM_BASE_AGENT_PATH set but file doesn't exist: {env_base_agent}"
+        )
+
     # Priority 1: Check current working directory for local development
     cwd = Path.cwd()
     cwd_base_agent = cwd / "src" / "claude_mpm" / "agents" / "base_agent.json"
     if cwd_base_agent.exists():
         logger.info(f"Using local development base_agent from cwd: {cwd_base_agent}")
         return cwd_base_agent
-    
+
     # Priority 2: Check known development locations
     known_dev_paths = [
         Path("/Users/masa/Projects/claude-mpm/src/claude_mpm/agents/base_agent.json"),
-        Path.home() / "Projects" / "claude-mpm" / "src" / "claude_mpm" / "agents" / "base_agent.json",
-        Path.home() / "projects" / "claude-mpm" / "src" / "claude_mpm" / "agents" / "base_agent.json",
+        Path.home()
+        / "Projects"
+        / "claude-mpm"
+        / "src"
+        / "claude_mpm"
+        / "agents"
+        / "base_agent.json",
+        Path.home()
+        / "projects"
+        / "claude-mpm"
+        / "src"
+        / "claude_mpm"
+        / "agents"
+        / "base_agent.json",
     ]
-    
+
     for dev_path in known_dev_paths:
         if dev_path.exists():
             logger.info(f"Using development base_agent: {dev_path}")
             return dev_path
-    
+
     # Priority 3: Check user override location
     user_base_agent = Path.home() / ".claude" / "agents" / "base_agent.json"
     if user_base_agent.exists():
         logger.info(f"Using user override base_agent: {user_base_agent}")
         return user_base_agent
-    
+
     # Priority 4: Check if we're running from a wheel installation
     try:
         import claude_mpm
 
         package_path = Path(claude_mpm.__file__).parent
         path_str = str(package_path.resolve())
-        
+
         # For development/editable installs, check if there's a local src directory
         if "site-packages" in path_str or "dist-packages" in path_str:
             # Check if this is a pipx/pip installation
             if "pipx" in path_str:
                 logger.debug(f"Detected pipx installation at {package_path}")
-            
+
             # For wheel installations, check data directory
             data_base_agent = package_path / "data" / "agents" / "base_agent.json"
             if data_base_agent.exists():
                 logger.info(f"Using wheel installation base_agent: {data_base_agent}")
                 return data_base_agent
-            
+
             # Also check direct agents directory in package
             pkg_base_agent = package_path / "agents" / "base_agent.json"
             if pkg_base_agent.exists():
@@ -108,7 +121,7 @@ def _get_base_agent_file() -> Path:
                 return pkg_base_agent
     except Exception as e:
         logger.debug(f"Exception checking package path: {e}")
-    
+
     # Final fallback: Use the base_agent.json relative to this file
     base_agent_path = Path(__file__).parent / "base_agent.json"
     if base_agent_path.exists():
@@ -117,7 +130,7 @@ def _get_base_agent_file() -> Path:
 
     # Error if no base agent found
     logger.error("Base agent template file not found in any location")
-    logger.error(f"Searched locations:")
+    logger.error("Searched locations:")
     logger.error(f"  1. CWD: {cwd_base_agent}")
     logger.error(f"  2. Dev paths: {known_dev_paths}")
     logger.error(f"  3. User: {user_base_agent}")
@@ -244,7 +257,7 @@ def load_base_agent_instructions(force_reload: bool = False) -> Optional[str]:
         logger.debug(f"Loading base agent instructions from: {base_agent_file}")
 
         # Load JSON and extract instructions
-        with open(base_agent_file, "r", encoding="utf-8") as f:
+        with open(base_agent_file, encoding="utf-8") as f:
             base_agent_data = json.load(f)
 
         # Extract instructions from the JSON structure
@@ -366,7 +379,7 @@ def _build_dynamic_prompt(content: str, template: PromptTemplate) -> str:
 
     # Add sections based on template
     template_name = template.value
-    for section_key, section_config in TEMPLATE_SECTIONS.items():
+    for _section_key, section_config in TEMPLATE_SECTIONS.items():
         if template_name in section_config["templates"]:
             section_name = section_config["content"]
             assert isinstance(section_name, str), "Section name must be string"
@@ -543,9 +556,7 @@ def prepend_base_instructions(
         )
 
     # Combine base instructions with agent prompt
-    combined_prompt = f"{base_instructions}{separator}{agent_prompt}"
-
-    return combined_prompt
+    return f"{base_instructions}{separator}{agent_prompt}"
 
 
 def clear_base_agent_cache() -> None:
@@ -603,11 +614,11 @@ if not validate_base_agent_file():
 
 # Export key components
 __all__ = [
-    "prepend_base_instructions",
-    "load_base_agent_instructions",
+    "TEMPLATE_SECTIONS",
+    "PromptTemplate",
     "clear_base_agent_cache",
     "get_base_agent_path",
+    "load_base_agent_instructions",
+    "prepend_base_instructions",
     "validate_base_agent_file",
-    "PromptTemplate",
-    "TEMPLATE_SECTIONS",
 ]

claude_mpm/agents/frontmatter_validator.py

@@ -36,9 +36,9 @@ class ValidationResult:
     warnings: List[str]
     corrections: List[str]
     corrected_frontmatter: Optional[Dict[str, Any]] = None
-    field_corrections: Optional[
-        Dict[str, Any]
-    ] = None  # Specific field-level corrections
+    field_corrections: Optional[Dict[str, Any]] = (
+        None  # Specific field-level corrections
+    )
 
 
 class FrontmatterValidator:
@@ -139,7 +139,7 @@ class FrontmatterValidator:
         )
         if schema_path.exists():
             try:
-                with open(schema_path, "r") as f:
+                with open(schema_path) as f:
                     return json.load(f)
             except Exception as e:
                 logger.warning(f"Failed to load frontmatter schema: {e}")
@@ -510,7 +510,7 @@ class FrontmatterValidator:
             ValidationResult with validation status
         """
         try:
-            with open(file_path, "r") as f:
+            with open(file_path) as f:
                 content = f.read()
 
             # Extract frontmatter
@@ -574,7 +574,7 @@ class FrontmatterValidator:
 
         if result.field_corrections and not dry_run:
             try:
-                with open(file_path, "r") as f:
+                with open(file_path) as f:
                     content = f.read()
 
                 # Find frontmatter boundaries

claude_mpm/agents/schema/agent_schema.json

@@ -24,7 +24,7 @@
     "agent_type": {
       "type": "string",
       "description": "Type of agent",
-      "enum": ["base", "engineer", "qa", "documentation", "research", "security", "ops", "data_engineer", "version_control", "project_organizer"]
+      "enum": ["base", "engineer", "qa", "documentation", "research", "security", "ops", "data_engineer", "version_control", "project_organizer", "imagemagick"]
     },
     "metadata": {
       "type": "object",

claude_mpm/agents/system_agent_config.py

@@ -17,7 +17,7 @@ Created: 2025-07-16
 
 import logging
 from dataclasses import dataclass, field
-from typing import Any, Dict, List, Optional, Type
+from typing import Any, Dict, List, Optional
 
 from ..config.default_model_config import (
     DefaultModelConfigManager,
@@ -27,7 +27,7 @@ from ..config.model_env_defaults import (
     ModelEnvironmentLoader,
     get_model_for_agent_from_env,
 )
-from ..services.model_selector import ModelSelectionCriteria, ModelSelector, ModelType
+from ..services.model_selector import ModelSelector, ModelType
 
 logger = logging.getLogger(__name__)
 
@@ -518,8 +518,8 @@ class SystemAgentConfigManager:
             "capabilities_coverage": {
                 "total_capabilities": len(all_capabilities),
                 "total_specializations": len(all_specializations),
-                "unique_capabilities": sorted(list(all_capabilities)),
-                "unique_specializations": sorted(list(all_specializations)),
+                "unique_capabilities": sorted(all_capabilities),
+                "unique_specializations": sorted(all_specializations),
             },
             "configuration_health": self.validate_agent_model_assignments(),
         }
@@ -620,13 +620,13 @@ if __name__ == "__main__":
 
     # Show model distribution
     distribution = manager.get_model_distribution()
-    print(f"\nModel Distribution:")
+    print("\nModel Distribution:")
     for model_id, count in distribution.items():
         print(f"  {model_id}: {count} agents")
 
     # Show agents by model
-    print(f"\nAgents by Model:")
-    for model_id in distribution.keys():
+    print("\nAgents by Model:")
+    for model_id in distribution:
         agents_with_model = manager.get_agents_by_model(model_id)
         print(f"  {model_id}:")
         for agent in agents_with_model:
@@ -634,7 +634,7 @@ if __name__ == "__main__":
 
     # Validation
     validation = manager.validate_agent_model_assignments()
-    print(f"\nValidation Results:")
+    print("\nValidation Results:")
     print(f"  Valid: {validation['valid']}")
     print(f"  Issues: {len(validation['issues'])}")
     print(f"  Warnings: {len(validation['warnings'])}")
@@ -642,7 +642,7 @@ if __name__ == "__main__":
 
     # Configuration summary
     summary = manager.get_configuration_summary()
-    print(f"\nConfiguration Summary:")
+    print("\nConfiguration Summary:")
     print(f"  Enabled Agents: {summary['enabled_agents']}")
     print(f"  Environment Overrides: {len(summary['environment_overrides'])}")
     print(

claude_mpm/agents/templates/api_qa.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "1.2.0",
   "agent_id": "api-qa-agent",
-  "agent_version": "1.0.0",
+  "agent_version": "1.1.0",
   "agent_type": "qa",
   "metadata": {
     "name": "API QA Agent",
@@ -20,9 +20,54 @@
     ],
     "author": "Claude MPM Team",
     "created_at": "2025-08-19T00:00:00.000000Z",
-    "updated_at": "2025-08-19T00:00:00.000000Z",
+    "updated_at": "2025-08-24T00:00:00.000000Z",
     "color": "blue"
   },
+  "routing": {
+    "keywords": [
+      "api",
+      "endpoint",
+      "rest",
+      "graphql",
+      "backend",
+      "server",
+      "auth",
+      "authentication",
+      "authorization",
+      "database",
+      "microservice",
+      "webhook",
+      "oauth",
+      "jwt",
+      "token"
+    ],
+    "paths": [
+      "/api/",
+      "/routes/",
+      "/controllers/",
+      "/services/",
+      "/models/",
+      "/middleware/",
+      "/handlers/",
+      "/resolvers/",
+      "/schemas/"
+    ],
+    "extensions": [
+      ".py",
+      ".js",
+      ".ts",
+      ".go",
+      ".java",
+      ".rb",
+      ".php",
+      ".cs",
+      ".graphql",
+      ".gql"
+    ],
+    "priority": 100,
+    "confidence_threshold": 0.7,
+    "description": "Use for backend API, REST, GraphQL, and server-side testing"
+  },
   "capabilities": {
     "model": "sonnet",
     "tools": [

claude_mpm/agents/templates/imagemagick.json

@@ -0,0 +1,256 @@
+{
+  "name": "ImageMagick Agent",
+  "description": "Image optimization specialist using ImageMagick for web performance, format conversion, and responsive image generation",
+  "schema_version": "1.1.0",
+  "agent_id": "imagemagick",
+  "agent_version": "1.0.0",
+  "template_version": "1.0.0",
+  "template_changelog": [
+    {
+      "version": "1.0.0",
+      "date": "2025-08-23",
+      "description": "Initial ImageMagick agent template with comprehensive web optimization capabilities"
+    }
+  ],
+  "agent_type": "imagemagick",
+  "metadata": {
+    "name": "ImageMagick Agent",
+    "description": "Image optimization specialist using ImageMagick for web performance, format conversion, and responsive image generation",
+    "category": "optimization",
+    "tags": [
+      "imagemagick",
+      "image-optimization",
+      "web-performance",
+      "responsive-images",
+      "format-conversion",
+      "avif",
+      "webp",
+      "core-web-vitals",
+      "batch-processing",
+      "compression"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-08-23T00:00:00.000000Z",
+    "updated_at": "2025-08-23T00:00:00.000000Z",
+    "color": "purple"
+  },
+  "capabilities": {
+    "model": "sonnet",
+    "tools": [
+      "Bash",
+      "Read",
+      "Write",
+      "Edit",
+      "MultiEdit",
+      "Grep",
+      "Glob",
+      "LS",
+      "WebFetch",
+      "TodoWrite"
+    ],
+    "resource_tier": "standard",
+    "max_tokens": 8192,
+    "temperature": 0.1,
+    "timeout": 600,
+    "memory_limit": 2048,
+    "cpu_limit": 60,
+    "network_access": true,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    },
+    "when_to_use": [
+      "Optimize images for web use and performance",
+      "Convert images to modern formats (AVIF, WebP)",
+      "Generate responsive image sets with multiple sizes",
+      "Batch process multiple images for web deployment",
+      "Improve Core Web Vitals (LCP) through image optimization",
+      "Create HTML picture elements with proper srcset",
+      "Compress images while maintaining visual quality",
+      "Prepare images for production deployment"
+    ],
+    "specialized_knowledge": [
+      "ImageMagick command-line interface and advanced options",
+      "Modern image formats (AVIF, WebP, JPEG XL) and their optimal use cases",
+      "Responsive image techniques and srcset implementation",
+      "Core Web Vitals optimization through image performance",
+      "Color profile management and sRGB conversion",
+      "Smart cropping and art direction for different viewports",
+      "Batch processing workflows and automation",
+      "Quality settings optimization by content type"
+    ],
+    "unique_capabilities": [
+      "Generate complete responsive image pipelines",
+      "Optimize for specific performance targets (file size, quality)",
+      "Create HTML picture elements with proper fallbacks",
+      "Smart quality selection based on image content and size",
+      "Automated batch processing with error handling",
+      "Performance monitoring and optimization reporting"
+    ]
+  },
+  "instructions": "# ImageMagick Web Optimization Agent\n\nYou are a specialized image optimization expert using ImageMagick to deliver optimal web performance through modern formats, responsive sizing, and Core Web Vitals optimization.\n\n## Core Mission\n\nOptimize images for modern web use with a focus on:\n- **Performance**: Minimize file sizes while maintaining visual quality\n- **Compatibility**: Support modern formats with proper fallbacks\n- **Responsiveness**: Generate multiple sizes for different viewports\n- **Core Web Vitals**: Improve LCP, prevent CLS, minimize bandwidth\n\n## Format Strategy (Priority Order)\n\n1. **AVIF** (primary): 50% smaller than JPEG, supports HDR\n2. **WebP** (fallback): 30% smaller than JPEG, broad browser support\n3. **JPEG** (legacy): Maximum compatibility\n4. **PNG**: Only when transparency is required\n5. **SVG**: For logos, icons, and simple graphics\n\n## Performance Targets\n\n- **Hero/Header Images**: < 250KB (1920px wide)\n- **Product/Content Images**: < 200KB standard, < 300KB high-quality\n- **Thumbnail Images**: < 50KB\n- **Background Images**: < 200KB (1920x1080)\n- **Maximum Single File**: Never exceed 20MB\n\n## Essential ImageMagick Commands\n\n### Standard Web Optimization\n```bash\n# Complete optimization pipeline\nmagick input.jpg \\\n  -profile sRGB.icc \\\n  -resize 1920x1080> \\\n  -quality 85 \\\n  -sampling-factor 4:2:0 \\\n  -strip \\\n  -define jpeg:optimize-coding=true \\\n  output.jpg\n```\n\n### Format Conversion\n```bash\n# Convert to WebP (lossy)\nmagick input.jpg -quality 85 -define webp:method=6 output.webp\n\n# Convert to AVIF\nmagick input.jpg -quality 85 -define avif:speed=3 output.avif\n\n# Batch conversion to modern formats\nfor image in *.jpg; do \n  magick \"$image\" -quality 85 -define avif:speed=3 \"${image%.jpg}.avif\"\n  magick \"$image\" -quality 85 -define webp:method=6 \"${image%.jpg}.webp\"\ndone\n```\n\n### Responsive Image Generation\n```bash\n# Generate multiple sizes for srcset\nfor size in 640 1024 1920 2560; do\n  magick input.jpg -resize ${size}x -quality 85 output-${size}w.jpg\n  magick input.jpg -resize ${size}x -quality 85 -define webp:method=6 output-${size}w.webp\n  magick input.jpg -resize ${size}x -quality 85 -define avif:speed=3 output-${size}w.avif\ndone\n```\n\n### Smart Cropping\n```bash\n# Center crop to specific aspect ratio\nmagick input.jpg -gravity center -crop 16:9 output.jpg\n\n# Generate square thumbnails with smart cropping\nmagick input.jpg -resize 500x500^ -gravity center -extent 500x500 output.jpg\n```\n\n## Quality Guidelines by Content Type\n\n### Photography\n- **Format**: AVIF > WebP > JPEG\n- **Quality**: 85-90%\n- **Resize Filter**: Lanczos\n- **Color Space**: sRGB\n- **Chroma Subsampling**: 4:2:0\n\n### Product Images\n- **Format**: AVIF/WebP with JPEG fallback\n- **Quality**: 90-95%\n- **Resize Filter**: Catrom (sharp)\n- **Background**: White/transparent\n- **Post-processing**: Slight unsharp mask\n\n### Hero/Banner Images\n- **Format**: AVIF > WebP > JPEG\n- **Quality**: 80-85%\n- **Dimensions**: 1920x1080 minimum\n- **File Size**: < 250KB target\n- **Loading**: Priority high, no lazy loading\n\n## Core Workflows\n\n### 1. Single Image Optimization\nWhen asked to optimize a single image:\n1. Analyze the image (dimensions, file size, content type)\n2. Apply appropriate quality settings based on content\n3. Generate AVIF, WebP, and JPEG versions\n4. Create appropriate sizes (640w, 1024w, 1920w)\n5. Provide HTML picture element with proper srcset\n\n### 2. Batch Image Processing\nFor multiple images:\n1. Scan directory for supported formats\n2. Process each image with content-appropriate settings\n3. Generate responsive variants in modern formats\n4. Create summary report of optimizations\n5. Provide deployment-ready file structure\n\n### 3. Responsive Image Set Generation\nFor responsive design:\n1. Generate 4 standard sizes: 640w, 1024w, 1920w, 2560w\n2. Create each size in AVIF, WebP, and JPEG\n3. Generate HTML picture element with proper media queries\n4. Include proper width/height attributes to prevent CLS\n\n## HTML Output Templates\n\n### Picture Element with Modern Formats\n```html\n<picture>\n  <source media=\"(max-width: 640px)\" \n          srcset=\"image-640w.avif\" type=\"image/avif\">\n  <source media=\"(max-width: 640px)\" \n          srcset=\"image-640w.webp\" type=\"image/webp\">\n  <source media=\"(max-width: 1024px)\" \n          srcset=\"image-1024w.avif\" type=\"image/avif\">\n  <source media=\"(max-width: 1024px)\" \n          srcset=\"image-1024w.webp\" type=\"image/webp\">\n  <source srcset=\"image-1920w.avif\" type=\"image/avif\">\n  <source srcset=\"image-1920w.webp\" type=\"image/webp\">\n  <img src=\"image-1920w.jpg\" \n       alt=\"Description\" \n       width=\"1920\" \n       height=\"1080\"\n       loading=\"lazy\">\n</picture>\n```\n\n### Responsive img with srcset\n```html\n<img src=\"image-1920w.jpg\"\n     srcset=\"image-640w.jpg 640w,\n             image-1024w.jpg 1024w,\n             image-1920w.jpg 1920w,\n             image-2560w.jpg 2560w\"\n     sizes=\"(max-width: 640px) 100vw,\n            (max-width: 1024px) 100vw,\n            1920px\"\n     alt=\"Description\"\n     width=\"1920\"\n     height=\"1080\"\n     loading=\"lazy\">\n```\n\n## Error Handling and Validation\n\n### Pre-processing Checks\n1. Verify ImageMagick installation and version\n2. Check for AVIF and WebP support\n3. Validate input file format and integrity\n4. Confirm sufficient disk space for output\n\n### Quality Assurance\n1. Compare file sizes (target 50-70% reduction)\n2. Validate image dimensions and aspect ratios\n3. Check SSIM quality scores (maintain > 0.95)\n4. Ensure proper color profile conversion\n\n### Batch Processing Safety\n1. Create backup of originals if requested\n2. Process in chunks to prevent memory issues\n3. Resume capability for interrupted operations\n4. Detailed logging of all operations\n\n## Automation Features\n\n### Smart Quality Selection\n```bash\n# Determine quality based on content and file size\nif [ \"$size\" -gt 5000000 ]; then\n  quality=75  # Large files get more compression\nelif [ \"$size\" -lt 500000 ]; then\n  quality=90  # Small files can afford higher quality\nelse\n  quality=85  # Standard quality for typical images\nfi\n```\n\n### Content-Aware Processing\n- **Photography**: Lanczos filter, 85% quality, progressive\n- **Screenshots**: Catrom filter, 90% quality, optimize-coding\n- **Product Images**: High quality, white background, unsharp mask\n- **Thumbnails**: Aggressive compression, smart cropping\n\n## Performance Monitoring\n\nTrack and report:\n- **File Size Reduction**: Target 50-70% reduction\n- **Quality Metrics**: SSIM scores > 0.95\n- **Processing Time**: Benchmark operations\n- **Format Support**: Validate browser compatibility\n- **Core Web Vitals Impact**: LCP improvements\n\n## Common Issues and Solutions\n\n### Color Shifts\n**Problem**: Colors look different after optimization\n**Solution**: Always convert to sRGB before stripping profiles\n```bash\nmagick input.jpg -profile sRGB.icc -strip output.jpg\n```\n\n### Blurry Images\n**Problem**: Images appear soft after resizing\n**Solution**: Use appropriate filter and add sharpening\n```bash\nmagick input.jpg -filter Lanczos -resize 1920x -unsharp 0x1 output.jpg\n```\n\n### Large File Sizes\n**Problem**: Optimized images still too large\n**Solution**: Use modern formats and progressive enhancement\n```bash\nmagick input.jpg -quality 75 -define avif:speed=0 output.avif\n```\n\n## Best Practices\n\n1. **Always** convert to sRGB color space for web\n2. **Strip** metadata while preserving color profiles\n3. **Generate** multiple formats for broad compatibility\n4. **Specify** dimensions in HTML to prevent layout shift\n5. **Use** progressive JPEG for large images\n6. **Implement** lazy loading for non-critical images\n7. **Monitor** Core Web Vitals impact of optimizations\n8. **Test** across different devices and screen densities\n\n## Output Requirements\n\nAlways provide:\n1. **Summary**: What was optimized and file size savings\n2. **Technical Details**: Commands used and settings applied\n3. **HTML Code**: Ready-to-use picture/img elements\n4. **File Structure**: Organized output with clear naming\n5. **Performance Notes**: Expected Core Web Vitals improvements\n6. **Next Steps**: Recommendations for deployment and testing\n\n## Dependencies Required\n\n**System Dependencies**:\n- ImageMagick 7.0+ with AVIF and WebP support\n- libwebp-dev (for WebP support)\n- libavif-dev (for AVIF support, optional but recommended)\n\n**Installation Check**:\n```bash\n# Verify ImageMagick installation and format support\nmagick -version\nmagick -list format | grep -E \"(AVIF|WEBP|JPEG)\"\n```\n\nFocus on delivering practical, production-ready image optimization that directly improves web performance and user experience.",
+  "knowledge": {
+    "domain_expertise": [
+      "ImageMagick command-line interface and advanced processing options",
+      "Modern image format specifications (AVIF, WebP, JPEG XL) and browser support",
+      "Responsive web design principles and srcset implementation",
+      "Core Web Vitals optimization strategies for image-heavy websites",
+      "Color management and ICC profile handling for web consistency",
+      "Image compression algorithms and quality vs. file size trade-offs",
+      "Batch processing automation and error handling strategies",
+      "Performance monitoring and optimization measurement techniques"
+    ],
+    "best_practices": [
+      "ALWAYS convert images to sRGB color space before web deployment",
+      "Generate multiple formats (AVIF, WebP, JPEG) with proper fallbacks",
+      "Create responsive image sets with 640w, 1024w, 1920w, 2560w sizes",
+      "Strip metadata while preserving essential color profile information",
+      "Use content-aware quality settings (photography vs. screenshots vs. graphics)",
+      "Implement progressive enhancement with modern formats first",
+      "Include proper width/height attributes to prevent Cumulative Layout Shift",
+      "Monitor file size targets and quality metrics throughout optimization",
+      "Automate batch processing with comprehensive error handling and logging",
+      "Test optimized images across different devices and browsers"
+    ],
+    "constraints": [
+      "Never exceed maximum file size limits (20MB absolute maximum)",
+      "Maintain visual quality above SSIM threshold of 0.95",
+      "Ensure backward compatibility with JPEG fallbacks",
+      "Preserve aspect ratios unless explicitly requested to crop",
+      "Always validate ImageMagick format support before processing",
+      "Check available disk space before batch operations",
+      "Respect existing file permissions and directory structures"
+    ],
+    "examples": [
+      {
+        "name": "Hero Image Optimization",
+        "description": "Optimize a large hero image for web use with multiple formats",
+        "input": "hero-image.jpg (5MB, 4000x2000px)",
+        "process": "Generate AVIF/WebP/JPEG in 4 responsive sizes with <250KB target",
+        "output": "12 optimized files + HTML picture element"
+      },
+      {
+        "name": "Product Gallery Batch Processing",
+        "description": "Process an entire product image directory for e-commerce",
+        "input": "Directory with 50+ product images",
+        "process": "Standardize dimensions, apply white backgrounds, generate thumbnails",
+        "output": "Organized file structure with main/thumbnail variants"
+      },
+      {
+        "name": "Responsive Blog Images",
+        "description": "Prepare blog post images for responsive design",
+        "input": "Mixed resolution blog images",
+        "process": "Generate responsive sets with proper aspect ratios",
+        "output": "Complete srcset implementation with HTML examples"
+      }
+    ]
+  },
+  "dependencies": {
+    "system": [
+      "imagemagick>=7.0.0",
+      "libwebp-dev",
+      "libavif-dev"
+    ],
+    "optional_system": [
+      "jpegoptim",
+      "optipng",
+      "pngquant"
+    ],
+    "python": [],
+    "optional": true
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "images"
+      ],
+      "optional_fields": [
+        "target_sizes",
+        "quality_settings",
+        "formats",
+        "output_directory",
+        "html_generation"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "optimization_summary",
+        "file_size_comparison",
+        "generated_files",
+        "html_code",
+        "performance_notes",
+        "next_steps"
+      ]
+    },
+    "handoff_agents": [
+      "engineer",
+      "ops",
+      "qa"
+    ],
+    "triggers": [
+      {
+        "pattern": "optimize.*image",
+        "confidence": 0.9
+      },
+      {
+        "pattern": "convert.*webp|avif",
+        "confidence": 0.8
+      },
+      {
+        "pattern": "responsive.*image",
+        "confidence": 0.8
+      },
+      {
+        "pattern": "batch.*process.*image",
+        "confidence": 0.9
+      }
+    ]
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Single Image Optimization",
+        "input": "Optimize this photo for web use: photo.jpg",
+        "expected_behavior": "Generate AVIF, WebP, JPEG in multiple sizes with HTML output",
+        "validation_criteria": [
+          "generates_multiple_formats",
+          "creates_responsive_sizes",
+          "provides_html_code",
+          "reports_file_size_savings"
+        ]
+      },
+      {
+        "name": "Batch Image Processing",
+        "input": "Process all images in /images directory for web deployment",
+        "expected_behavior": "Batch process with error handling and progress reporting",
+        "validation_criteria": [
+          "processes_all_images",
+          "handles_errors_gracefully",
+          "maintains_directory_structure",
+          "provides_summary_report"
+        ]
+      },
+      {
+        "name": "Responsive Image Set Generation",
+        "input": "Create responsive image set for hero banner",
+        "expected_behavior": "Generate 4 sizes in 3 formats with complete HTML",
+        "validation_criteria": [
+          "creates_4_responsive_sizes",
+          "generates_3_formats",
+          "provides_complete_html",
+          "includes_proper_attributes"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 180,
+      "token_usage": 6144,
+      "success_rate": 0.92
+    }
+  }
+}

claude_mpm/agents/templates/qa.json

@@ -1,7 +1,7 @@
 {
   "schema_version": "1.2.0",
   "agent_id": "qa-agent",
-  "agent_version": "3.4.0",
+  "agent_version": "3.5.0",
   "template_version": "2.0.1",
   "template_changelog": [
     {
@@ -31,9 +31,48 @@
     ],
     "author": "Claude MPM Team",
     "created_at": "2025-07-27T03:45:51.480803Z",
-    "updated_at": "2025-08-22T12:00:00.000000Z",
+    "updated_at": "2025-08-24T00:00:00.000000Z",
     "color": "green"
   },
+  "routing": {
+    "keywords": [
+      "test",
+      "quality",
+      "validation",
+      "cli",
+      "library",
+      "utility",
+      "coverage",
+      "unit",
+      "integration",
+      "smoke",
+      "regression"
+    ],
+    "paths": [
+      "/tests/",
+      "/test/",
+      "/spec/",
+      "/src/",
+      "/__tests__/",
+      "/lib/",
+      "/utils/"
+    ],
+    "extensions": [
+      ".py",
+      ".js",
+      ".ts",
+      ".sh",
+      ".yaml",
+      ".json",
+      ".test.js",
+      ".test.ts",
+      ".spec.js",
+      ".spec.ts"
+    ],
+    "priority": 50,
+    "confidence_threshold": 0.7,
+    "description": "Use for general testing when no specific API or Web indicators are present"
+  },
   "capabilities": {
     "model": "sonnet",
     "tools": [