Technical documentation for Claude MPM contributors and extenders.
- Architecture - System design, core concepts, and service architecture
- Extending - Build custom agents, hooks, services, and MCP tools
- Skills Versioning System - Technical implementation details
- API Reference - Complete API documentation for all services
- Integrating Structured Questions - Add structured questions to custom agents
- Agent Modification Workflow - How to modify and contribute agents
- Code Formatting - Code style and formatting standards
- Publishing Guide - Release and publishing procedures
- Pre-publish Checklist - Pre-release verification checklist
- Code Navigation - Detailed codebase navigation guides
- Internals - Internal implementation details and mechanisms
- Troubleshooting - Development troubleshooting guides
- Testing - Testing framework, evaluation system, and QA processes
New to the codebase?
- Read Architecture → Understand system design
- Browse API Reference → Learn service interfaces
- Explore Extending → Build extensions
Common Tasks:
- Understand architecture: Architecture - System Design
- Create custom agent: Extending - Custom Agents
- Add service: Extending - Custom Services
- Create hook: Extending - Custom Hooks
- Build MCP tool: Extending - MCP Tools
Development Setup:
# Clone and install
git clone https://github.com/bobmatnyc/claude-mpm.git
cd claude-mpm
pip install -e ".[dev,monitor]"
# Run tests
make test
# Run quality checks
make quality
# Fix linting issues
make lint-fixService-Oriented Design: Five specialized domains
- Core Services: Fundamental system operations
- Agent Services: Agent lifecycle and management
- Orchestration Services: Multi-agent coordination
- MCP Services: External tool integration
- Utility Services: Supporting functionality
Key Concepts:
- Three-Tier Agent System: PROJECT > USER > SYSTEM hierarchy
- Hook System: Event-driven pre/post execution hooks
- Memory System: Persistent project-specific knowledge
- Service Contracts: Clear interfaces between components
Development Workflow:
- Fork and clone repository
- Create feature branch
- Make changes with tests
- Run quality checks:
make quality - Submit pull request
Code Standards:
- Python 3.11+ compatibility
- Type hints required
- Docstrings for public APIs
- Tests for new features
- Linting with ruff
- Formatting with black
Testing:
# Run all tests
make test
# Run specific test
pytest tests/test_specific.py
# Run with coverage
make test-coverage- Source Code: https://github.com/bobmatnyc/claude-mpm
- Issue Tracker: https://github.com/bobmatnyc/claude-mpm/issues
- User Documentation: ../user/README.md
- Agent Documentation: ../agents/README.md