claude-mpm 1.1.0__py3-none-any.whl → 2.0.0__py3-none-any.whl

claude_mpm/agents/templates/research.json

@@ -0,0 +1,107 @@
+{
+  "id": "research",
+  "version": "1.0.0",
+  "metadata": {
+    "name": "Research Agent",
+    "description": "Tree-sitter codebase analysis and hierarchical summary generation",
+    "category": "research",
+    "tags": [
+      "research",
+      "tree-sitter",
+      "codebase-analysis",
+      "ast",
+      "patterns"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.485006Z",
+    "updated_at": "2025-07-27T03:45:51.485011Z"
+  },
+  "capabilities": {
+    "model": "claude-sonnet-4-20250514",
+    "tools": [
+      "Read",
+      "Grep",
+      "Glob",
+      "LS",
+      "WebSearch",
+      "WebFetch",
+      "Bash"
+    ],
+    "resource_tier": "intensive",
+    "max_tokens": 12288,
+    "temperature": 0.2,
+    "timeout": 900,
+    "memory_limit": 6144,
+    "cpu_limit": 80,
+    "network_access": true,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Research Agent - CODEBASE ANALYSIS SPECIALIST\n\nConduct comprehensive codebase analysis using tree-sitter to generate hierarchical summaries optimized for LLM consumption and agent delegation.\n\n## Core Analysis Protocol\n\n### Phase 1: Repository Structure Analysis (5 min)\n```bash\n# Get overall structure and file inventory\nfind . -name \"*.ts\" -o -name \"*.js\" -o -name \"*.py\" -o -name \"*.java\" -o -name \"*.rb\" -o -name \"*.php\" -o -name \"*.go\" | head -20\ntree -I 'node_modules|.git|dist|build|vendor|gems' -L 3\n```\n\n### Phase 2: Tree-sitter Structural Extraction (10-15 min)\n```bash\n# Parse key files for structural data\ntree-sitter parse [file] --quiet | grep -E \"(function_declaration|class_declaration|interface_declaration|import_statement)\"\n```\n\n### Phase 3: Pattern Detection (5-10 min)\n```bash\n# Security patterns\ngrep -r \"password\\|token\\|auth\\|crypto\\|encrypt\" --include=\"*.ts\" --include=\"*.js\" --include=\"*.py\" --include=\"*.rb\" --include=\"*.php\" --include=\"*.go\" .\n# Performance patterns (JS/TS)\ngrep -r \"async\\|await\\|Promise\" --include=\"*.ts\" --include=\"*.js\" .\n# Performance patterns (Go)\ngrep -r \"goroutine\\|channel\\|sync\\.\" --include=\"*.go\" .\n# Error handling\ngrep -r \"try.*catch\\|throw\\|Error\\|rescue\\|panic\\|recover\" --include=\"*.ts\" --include=\"*.js\" --include=\"*.py\" --include=\"*.rb\" --include=\"*.php\" --include=\"*.go\" .\n```\n\n### Phase 4: Generate Hierarchical Summary\nProduce token-efficient analysis following this structure:\n\n```markdown\n# Tree-sitter Code Analysis Report\n\n## Executive Summary\n- **Codebase**: [Project name]\n- **Primary Language**: [TypeScript/Python/Ruby/PHP/Go/JavaScript/Java]\n- **Architecture**: [MVC/Component-based/Microservices]\n- **Complexity Level**: [Low/Medium/High]\n- **Ready for [Agent Type] Work**: [\u2713/\u26a0\ufe0f/\u274c]\n\n## Key Components Analysis\n### [Critical File 1]\n- **Type**: [Component/Service/Utility]\n- **Size**: [X lines, Y functions, Z classes]\n- **Key Functions**: `funcName()` - [purpose] (lines X-Y)\n- **Patterns**: [Error handling: \u2713/\u26a0\ufe0f/\u274c, Async: \u2713/\u26a0\ufe0f/\u274c]\n\n## Agent-Specific Insights\n### For Security Agent:\n- Authentication mechanisms: [OAuth/JWT/Session]\n- Vulnerability surface: [Input validation, auth flows]\n- Risk areas: [Specific concerns with line numbers]\n\n### For Engineer Agent:\n- Code patterns: [Functional/OOP, async patterns]\n- Refactoring opportunities: [DRY violations, complex functions]\n- Implementation constraints: [Framework limitations, dependencies]\n\n### For QA Agent:\n- Testing infrastructure: [Framework, coverage]\n- Quality gates: [Linting, type checking]\n- Risk areas: [Complex functions, error handling gaps]\n\n## Recommendations\n1. **Immediate**: [Most urgent actions]\n2. **Implementation**: [Specific guidance for Engineer Agent]\n3. **Quality**: [Testing and validation needs]\n```\n\n## Analysis Quality Standards\n- \u2713 Token budget <2K for hierarchical summary\n- \u2713 Agent-specific actionable insights\n- \u2713 File paths and line numbers for reference\n- \u2713 Security and performance concerns highlighted\n- \u2713 Clear implementation recommendations\n\n## Tools Integration\n- Use tree-sitter-cli with language-specific parsers\n- Fallback to regex analysis if parsing fails\n- Focus on exported functions and public APIs\n- Provide partial analysis rather than failing completely",
+  "knowledge": {
+    "domain_expertise": [
+      "Tree-sitter AST analysis and code structure extraction",
+      "Dependency graph analysis and circular dependency detection",
+      "Security pattern recognition and vulnerability assessment",
+      "Performance pattern identification and optimization opportunities",
+      "Testing infrastructure analysis and coverage assessment"
+    ],
+    "best_practices": [
+      "Generate hierarchical code summaries optimized for LLM consumption",
+      "Extract semantic patterns from AST structures using tree-sitter",
+      "Identify critical integration points and API surfaces",
+      "Synthesize agent-specific actionable insights from codebase analysis",
+      "Create token-efficient context for specialized agent delegation"
+    ],
+    "constraints": [],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "engineer",
+      "qa"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic research task",
+        "input": "Perform a basic research analysis",
+        "expected_behavior": "Agent performs research tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  }
+}

claude_mpm/agents/templates/security.json

@@ -0,0 +1,105 @@
+{
+  "id": "security",
+  "version": "1.0.0",
+  "metadata": {
+    "name": "Security Agent",
+    "description": "Security analysis and vulnerability assessment",
+    "category": "quality",
+    "tags": [
+      "security",
+      "vulnerability",
+      "compliance",
+      "protection"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.489358Z",
+    "updated_at": "2025-07-27T03:45:51.489363Z"
+  },
+  "capabilities": {
+    "model": "claude-sonnet-4-20250514",
+    "tools": [
+      "Read",
+      "Grep",
+      "Glob",
+      "LS",
+      "Bash",
+      "WebSearch"
+    ],
+    "resource_tier": "standard",
+    "max_tokens": 8192,
+    "temperature": 0.05,
+    "timeout": 600,
+    "memory_limit": 3072,
+    "cpu_limit": 50,
+    "network_access": true,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Security Agent - AUTO-ROUTED\n\nAutomatically handle all security-sensitive operations. Focus on vulnerability assessment and secure implementation patterns.\n\n## Security Protocol\n1. **Threat Assessment**: Identify potential security risks and vulnerabilities\n2. **Secure Design**: Recommend secure implementation patterns\n3. **Compliance Check**: Validate against OWASP and security standards\n4. **Risk Mitigation**: Provide specific security improvements\n\n## Security Focus\n- OWASP compliance and best practices\n- Authentication/authorization security\n- Data protection and encryption standards",
+  "knowledge": {
+    "domain_expertise": [
+      "OWASP security guidelines",
+      "Authentication/authorization patterns",
+      "Data protection and encryption",
+      "Vulnerability assessment techniques",
+      "Security compliance frameworks"
+    ],
+    "best_practices": [
+      "Identify security vulnerabilities and risks",
+      "Design secure authentication flows",
+      "Assess data protection measures",
+      "Perform security-focused code review",
+      "Ensure compliance with security standards"
+    ],
+    "constraints": [],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "engineer",
+      "ops"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic security task",
+        "input": "Perform a basic security analysis",
+        "expected_behavior": "Agent performs security tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  }
+}

claude_mpm/agents/templates/version_control.json

@@ -0,0 +1,103 @@
+{
+  "id": "version_control",
+  "version": "1.0.0",
+  "metadata": {
+    "name": "Version Control Agent",
+    "description": "Git operations and version management",
+    "category": "specialized",
+    "tags": [
+      "git",
+      "versioning",
+      "releases",
+      "branches"
+    ],
+    "author": "Claude MPM Team",
+    "created_at": "2025-07-27T03:45:51.494064Z",
+    "updated_at": "2025-07-27T03:45:51.494067Z"
+  },
+  "capabilities": {
+    "model": "claude-sonnet-4-20250514",
+    "tools": [
+      "Read",
+      "Bash",
+      "Grep",
+      "Glob",
+      "LS"
+    ],
+    "resource_tier": "lightweight",
+    "max_tokens": 8192,
+    "temperature": 0.05,
+    "timeout": 600,
+    "memory_limit": 1024,
+    "cpu_limit": 20,
+    "network_access": false,
+    "file_access": {
+      "read_paths": [
+        "./"
+      ],
+      "write_paths": [
+        "./"
+      ]
+    }
+  },
+  "instructions": "# Version Control Agent\n\nManage all git operations, versioning, and release coordination. Maintain clean history and consistent versioning.\n\n## Version Control Protocol\n1. **Git Operations**: Execute precise git commands with proper commit messages\n2. **Version Management**: Apply semantic versioning consistently\n3. **Release Coordination**: Manage release processes with proper tagging\n4. **Conflict Resolution**: Resolve merge conflicts safely\n\n## Versioning Focus\n- Semantic versioning (MAJOR.MINOR.PATCH) enforcement\n- Clean git history with meaningful commits\n- Coordinated release management",
+  "knowledge": {
+    "domain_expertise": [
+      "Git workflows and best practices",
+      "Semantic versioning standards",
+      "Branch management strategies",
+      "Release coordination processes",
+      "Repository maintenance techniques"
+    ],
+    "best_practices": [
+      "Execute precise git operations",
+      "Manage semantic versioning consistently",
+      "Coordinate releases across components",
+      "Resolve complex merge conflicts",
+      "Maintain clean repository history"
+    ],
+    "constraints": [],
+    "examples": []
+  },
+  "interactions": {
+    "input_format": {
+      "required_fields": [
+        "task"
+      ],
+      "optional_fields": [
+        "context",
+        "constraints"
+      ]
+    },
+    "output_format": {
+      "structure": "markdown",
+      "includes": [
+        "analysis",
+        "recommendations",
+        "code"
+      ]
+    },
+    "handoff_agents": [
+      "documentation"
+    ],
+    "triggers": []
+  },
+  "testing": {
+    "test_cases": [
+      {
+        "name": "Basic version_control task",
+        "input": "Perform a basic version_control analysis",
+        "expected_behavior": "Agent performs version_control tasks correctly",
+        "validation_criteria": [
+          "completes_task",
+          "follows_format"
+        ]
+      }
+    ],
+    "performance_benchmarks": {
+      "response_time": 300,
+      "token_usage": 8192,
+      "success_rate": 0.95
+    }
+  }
+}

claude_mpm/schemas/agent_schema.json

@@ -0,0 +1,328 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "title": "Claude MPM Agent Schema",
+  "description": "Schema definition for Claude MPM agent templates",
+  "type": "object",
+  "required": ["id", "version", "metadata", "capabilities", "instructions"],
+  "properties": {
+    "id": {
+      "type": "string",
+      "pattern": "^[a-z][a-z0-9_]*$",
+      "description": "Unique agent identifier (lowercase, alphanumeric with underscores)",
+      "examples": ["research", "engineer", "qa", "security"]
+    },
+    "version": {
+      "type": "string",
+      "pattern": "^\\d+\\.\\d+\\.\\d+$",
+      "description": "Semantic version of the agent template",
+      "examples": ["1.0.0", "2.1.3"]
+    },
+    "metadata": {
+      "type": "object",
+      "required": ["name", "description", "category", "tags"],
+      "properties": {
+        "name": {
+          "type": "string",
+          "minLength": 3,
+          "maxLength": 50,
+          "description": "Human-readable agent name"
+        },
+        "description": {
+          "type": "string",
+          "minLength": 10,
+          "maxLength": 200,
+          "description": "Brief description of agent purpose"
+        },
+        "category": {
+          "type": "string",
+          "enum": ["engineering", "research", "quality", "operations", "specialized"],
+          "description": "Agent category for organization"
+        },
+        "tags": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "pattern": "^[a-z][a-z0-9-]*$"
+          },
+          "minItems": 1,
+          "maxItems": 10,
+          "uniqueItems": true,
+          "description": "Tags for agent discovery"
+        },
+        "author": {
+          "type": "string",
+          "description": "Agent template author"
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Creation timestamp"
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "Last update timestamp"
+        }
+      }
+    },
+    "capabilities": {
+      "type": "object",
+      "required": ["model", "tools", "resource_tier"],
+      "properties": {
+        "model": {
+          "type": "string",
+          "enum": [
+            "claude-3-haiku-20240307",
+            "claude-3-5-haiku-20241022",
+            "claude-3-sonnet-20240229",
+            "claude-3-5-sonnet-20241022",
+            "claude-3-opus-20240229",
+            "claude-3-5-sonnet-20240620",
+            "claude-sonnet-4-20250514",
+            "claude-4-sonnet-20250514",
+            "claude-opus-4-20250514",
+            "claude-4-opus-20250514"
+          ],
+          "description": "Claude model to use for this agent"
+        },
+        "tools": {
+          "type": "array",
+          "items": {
+            "type": "string",
+            "enum": [
+              "Read", "Write", "Edit", "MultiEdit",
+              "Grep", "Glob", "LS", "Bash",
+              "WebSearch", "WebFetch",
+              "NotebookRead", "NotebookEdit",
+              "TodoWrite", "ExitPlanMode",
+              "git", "docker", "kubectl", "terraform",
+              "aws", "gcloud", "azure"
+            ]
+          },
+          "uniqueItems": true,
+          "description": "Available tools for the agent"
+        },
+        "resource_tier": {
+          "type": "string",
+          "enum": ["intensive", "standard", "lightweight"],
+          "description": "Resource allocation tier"
+        },
+        "max_tokens": {
+          "type": "integer",
+          "minimum": 1000,
+          "maximum": 200000,
+          "default": 8192,
+          "description": "Maximum tokens for response"
+        },
+        "temperature": {
+          "type": "number",
+          "minimum": 0,
+          "maximum": 1,
+          "default": 0.7,
+          "description": "Model temperature setting"
+        },
+        "timeout": {
+          "type": "integer",
+          "minimum": 30,
+          "maximum": 3600,
+          "default": 300,
+          "description": "Operation timeout in seconds"
+        },
+        "memory_limit": {
+          "type": "integer",
+          "minimum": 512,
+          "maximum": 8192,
+          "description": "Memory limit in MB (for resource tier)"
+        },
+        "cpu_limit": {
+          "type": "integer",
+          "minimum": 10,
+          "maximum": 100,
+          "description": "CPU limit percentage (for resource tier)"
+        },
+        "network_access": {
+          "type": "boolean",
+          "default": false,
+          "description": "Whether agent needs network access"
+        },
+        "file_access": {
+          "type": "object",
+          "properties": {
+            "read_paths": {
+              "type": "array",
+              "items": {"type": "string"},
+              "description": "Allowed read paths"
+            },
+            "write_paths": {
+              "type": "array",
+              "items": {"type": "string"},
+              "description": "Allowed write paths"
+            }
+          }
+        }
+      }
+    },
+    "instructions": {
+      "type": "string",
+      "minLength": 100,
+      "maxLength": 8000,
+      "description": "Agent system instructions (8000 character limit)"
+    },
+    "knowledge": {
+      "type": "object",
+      "description": "Agent-specific knowledge and context",
+      "properties": {
+        "domain_expertise": {
+          "type": "array",
+          "items": {"type": "string"},
+          "description": "Areas of expertise"
+        },
+        "best_practices": {
+          "type": "array",
+          "items": {"type": "string"},
+          "description": "Best practices the agent follows"
+        },
+        "constraints": {
+          "type": "array",
+          "items": {"type": "string"},
+          "description": "Operating constraints"
+        },
+        "examples": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "scenario": {"type": "string"},
+              "approach": {"type": "string"}
+            }
+          },
+          "description": "Example scenarios and approaches"
+        }
+      }
+    },
+    "interactions": {
+      "type": "object",
+      "description": "Agent interaction patterns",
+      "properties": {
+        "input_format": {
+          "type": "object",
+          "properties": {
+            "required_fields": {
+              "type": "array",
+              "items": {"type": "string"}
+            },
+            "optional_fields": {
+              "type": "array",
+              "items": {"type": "string"}
+            }
+          }
+        },
+        "output_format": {
+          "type": "object",
+          "properties": {
+            "structure": {
+              "type": "string",
+              "enum": ["markdown", "json", "structured", "free-form"]
+            },
+            "includes": {
+              "type": "array",
+              "items": {"type": "string"}
+            }
+          }
+        },
+        "handoff_agents": {
+          "type": "array",
+          "items": {"type": "string"},
+          "description": "Agents this agent can hand off to"
+        },
+        "triggers": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "condition": {"type": "string"},
+              "action": {"type": "string"}
+            }
+          },
+          "description": "Conditions that trigger specific actions"
+        }
+      }
+    },
+    "testing": {
+      "type": "object",
+      "description": "Testing configuration for the agent",
+      "properties": {
+        "test_cases": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "required": ["input", "expected_behavior"],
+            "properties": {
+              "name": {"type": "string"},
+              "input": {"type": "string"},
+              "expected_behavior": {"type": "string"},
+              "validation_criteria": {
+                "type": "array",
+                "items": {"type": "string"}
+              }
+            }
+          }
+        },
+        "performance_benchmarks": {
+          "type": "object",
+          "properties": {
+            "response_time": {"type": "integer"},
+            "token_usage": {"type": "integer"},
+            "success_rate": {"type": "number"}
+          }
+        }
+      }
+    },
+    "hooks": {
+      "type": "object",
+      "description": "Hook configurations for extensibility",
+      "properties": {
+        "pre_execution": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {"type": "string"},
+              "enabled": {"type": "boolean"}
+            }
+          }
+        },
+        "post_execution": {
+          "type": "array",
+          "items": {
+            "type": "object",
+            "properties": {
+              "name": {"type": "string"},
+              "enabled": {"type": "boolean"}
+            }
+          }
+        }
+      }
+    }
+  },
+  "additionalProperties": false,
+  "definitions": {
+    "resource_tier_limits": {
+      "intensive": {
+        "memory_limit": {"min": 4096, "max": 8192},
+        "cpu_limit": {"min": 60, "max": 100},
+        "timeout": {"min": 600, "max": 3600}
+      },
+      "standard": {
+        "memory_limit": {"min": 2048, "max": 4096},
+        "cpu_limit": {"min": 30, "max": 60},
+        "timeout": {"min": 300, "max": 1200}
+      },
+      "lightweight": {
+        "memory_limit": {"min": 512, "max": 2048},
+        "cpu_limit": {"min": 10, "max": 30},
+        "timeout": {"min": 30, "max": 600}
+      }
+    }
+  }
+}