claude-mpm 3.8.1__tar.gz → 3.9.2__tar.gz

{claude_mpm-3.8.1 → claude_mpm-3.9.2}/CLAUDE.md

@@ -6,7 +6,7 @@ This document provides development guidelines for the claude-mpm project codebas
 
 Claude MPM (Multi-Agent Project Manager) is a framework that extends Claude Desktop with multi-agent orchestration capabilities, featuring a modern service-oriented architecture with interface-based contracts and dependency injection.
 
-## Architecture (v3.7.8+)
+## Architecture (v3.8.2+)
 
 Following the TSK-0053 refactoring, Claude MPM features:
 

claude_mpm-3.9.2/PKG-INFO

@@ -0,0 +1,200 @@
+Metadata-Version: 2.4
+Name: claude-mpm
+Version: 3.9.2
+Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
+Home-page: https://github.com/bobmatnyc/claude-mpm
+Author: Claude MPM Team
+Author-email: bob@matsuoka.com
+License: MIT
+Keywords: claude,orchestration,multi-agent,ticket-management
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: ai-trackdown-pytools>=1.4.0
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: python-dotenv>=0.19.0
+Requires-Dist: click>=8.0.0
+Requires-Dist: pexpect>=4.8.0
+Requires-Dist: psutil>=5.9.0
+Requires-Dist: requests>=2.25.0
+Requires-Dist: flask>=3.0.0
+Requires-Dist: flask-cors>=4.0.0
+Requires-Dist: watchdog>=3.0.0
+Requires-Dist: tree-sitter>=0.21.0
+Requires-Dist: python-socketio>=5.11.0
+Requires-Dist: aiohttp>=3.9.0
+Requires-Dist: aiohttp-cors<0.8.0,>=0.7.0
+Requires-Dist: python-engineio>=4.8.0
+Requires-Dist: python-frontmatter>=1.0.0
+Requires-Dist: mistune>=3.0.0
+Requires-Dist: aiofiles>=23.0.0
+Provides-Extra: dev
+Requires-Dist: pytest>=7.0; extra == "dev"
+Requires-Dist: pytest-asyncio; extra == "dev"
+Requires-Dist: pytest-cov; extra == "dev"
+Requires-Dist: black; extra == "dev"
+Requires-Dist: flake8; extra == "dev"
+Requires-Dist: mypy; extra == "dev"
+Provides-Extra: docs
+Requires-Dist: sphinx>=7.2.0; extra == "docs"
+Requires-Dist: sphinx-rtd-theme>=1.3.0; extra == "docs"
+Requires-Dist: sphinx-autobuild>=2021.3.14; extra == "docs"
+Provides-Extra: monitor
+Provides-Extra: agents
+Requires-Dist: bandit>=1.7.5; extra == "agents"
+Requires-Dist: black>=23.0.0; extra == "agents"
+Requires-Dist: commitizen>=3.13.0; extra == "agents"
+Requires-Dist: dask>=2023.12.0; extra == "agents"
+Requires-Dist: detect-secrets>=1.4.0; extra == "agents"
+Requires-Dist: diagrams>=0.23.0; extra == "agents"
+Requires-Dist: docstring-parser>=0.15.0; extra == "agents"
+Requires-Dist: faker>=20.0.0; extra == "agents"
+Requires-Dist: gitlint>=0.19.0; extra == "agents"
+Requires-Dist: gitpython>=3.1.40; extra == "agents"
+Requires-Dist: hypothesis>=6.92.0; extra == "agents"
+Requires-Dist: isort>=5.12.0; extra == "agents"
+Requires-Dist: lizard>=1.17.0; extra == "agents"
+Requires-Dist: mermaid-py>=0.2.0; extra == "agents"
+Requires-Dist: mkdocs>=1.5.0; extra == "agents"
+Requires-Dist: mutmut>=2.4.0; extra == "agents"
+Requires-Dist: mypy>=1.8.0; extra == "agents"
+Requires-Dist: pandas>=2.1.0; extra == "agents"
+Requires-Dist: pre-commit>=3.5.0; extra == "agents"
+Requires-Dist: prometheus-client>=0.19.0; extra == "agents"
+Requires-Dist: pydoc-markdown>=4.8.0; extra == "agents"
+Requires-Dist: pydriller>=2.5.0; extra == "agents"
+Requires-Dist: pygments>=2.17.0; extra == "agents"
+Requires-Dist: pytest>=7.4.0; extra == "agents"
+Requires-Dist: pytest-benchmark>=4.0.0; extra == "agents"
+Requires-Dist: pytest-cov>=4.1.0; extra == "agents"
+Requires-Dist: radon>=6.0.0; extra == "agents"
+Requires-Dist: rope>=1.11.0; extra == "agents"
+Requires-Dist: sphinx>=7.2.0; extra == "agents"
+Requires-Dist: sqlalchemy>=2.0.0; extra == "agents"
+Requires-Dist: sqlparse>=0.4.4; extra == "agents"
+Requires-Dist: tree-sitter>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-python>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-javascript>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-typescript>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-go>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-rust>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-java>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-cpp>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-c>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-ruby>=0.21.0; extra == "agents"
+Requires-Dist: tree-sitter-php>=0.21.0; extra == "agents"
+Dynamic: author-email
+Dynamic: home-page
+Dynamic: license-file
+Dynamic: requires-python
+
+# Claude MPM - Multi-Agent Project Manager
+
+A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through an intuitive interface.
+
+> **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
+
+## Features
+
+- 🤖 **Multi-Agent System**: Automatically delegates tasks to specialized agents (PM, Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, Version Control)
+- 🧠 **Agent Memory System**: Persistent learning with project-specific knowledge retention
+- 🔄 **Session Management**: Resume previous sessions with `--resume` 
+- 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
+- 📁 **Multi-Project Support**: Per-session working directories
+- 🔍 **Git Integration**: View diffs and track changes across projects
+- 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
+
+## Quick Installation
+
+```bash
+pip install claude-mpm
+```
+
+**That's it!** See [QUICKSTART.md](QUICKSTART.md) for immediate usage or [docs/user/installation.md](docs/user/installation.md) for advanced options.
+
+## Quick Usage
+
+```bash
+# Start interactive mode (recommended)
+claude-mpm
+
+# Start with monitoring dashboard
+claude-mpm run --monitor
+```
+
+See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
+
+
+## Architecture
+
+Claude MPM v3.8.2+ features a **modern service-oriented architecture** with interface-based design, dependency injection, and intelligent caching for 50-80% performance improvements.
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed architecture information.
+
+## Key Capabilities
+
+### Multi-Agent Orchestration
+The PM agent automatically delegates work to specialized agents including Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, and Version Control.
+
+### Agent Memory System
+Agents learn project-specific patterns and remember insights across sessions. Initialize with `claude-mpm memory init`.
+
+### Real-Time Monitoring
+The `--monitor` flag opens a web dashboard showing live agent activity, file operations, and session management.
+
+See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
+
+
+## Documentation
+
+### User Documentation
+- **[Quick Start Guide](QUICKSTART.md)** - Get running in 5 minutes
+- **[Installation Guide](docs/user/installation.md)** - Complete installation options
+- **[User Guide](docs/user/)** - Detailed usage documentation
+- **[Memory System](docs/MEMORY.md)** - Agent memory documentation
+- **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
+
+### Developer Documentation
+- **[Architecture Overview](docs/ARCHITECTURE.md)** - Service-oriented architecture and design
+- **[API Reference](docs/api/)** - Complete API documentation with Sphinx
+- **[Service Layer Guide](docs/developer/SERVICES.md)** - Service interfaces and implementations
+- **[Performance Guide](docs/PERFORMANCE.md)** - Optimization and caching strategies
+- **[Security Guide](docs/SECURITY.md)** - Security framework and best practices
+- **[Testing Guide](docs/TESTING.md)** - Testing patterns and strategies
+- **[Migration Guide](docs/MIGRATION.md)** - Upgrading from previous versions
+- **[Developer Guide](docs/developer/)** - Comprehensive development documentation
+
+### API Documentation
+Comprehensive API documentation is available at [docs/api/](docs/api/) - build with `make html` in that directory.
+
+## Recent Updates (v3.8.2)
+
+**Major Architecture Refactoring (TSK-0053)**: Complete service-oriented redesign with 50-80% performance improvements, enhanced security, and interface-based design.
+
+See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
+
+## Development
+
+### Contributing
+Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
+
+### Project Structure
+See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
+
+### License
+MIT License - see [LICENSE](LICENSE) file.
+
+## Credits
+
+- Based on [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm)
+- Enhanced for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) integration
+- Built with ❤️ by the Claude MPM community

claude_mpm-3.9.2/README.md

@@ -0,0 +1,101 @@
+# Claude MPM - Multi-Agent Project Manager
+
+A powerful orchestration framework for Claude Code that enables multi-agent workflows, session management, and real-time monitoring through an intuitive interface.
+
+> **Quick Start**: See [QUICKSTART.md](QUICKSTART.md) to get running in 5 minutes!
+
+## Features
+
+- 🤖 **Multi-Agent System**: Automatically delegates tasks to specialized agents (PM, Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, Version Control)
+- 🧠 **Agent Memory System**: Persistent learning with project-specific knowledge retention
+- 🔄 **Session Management**: Resume previous sessions with `--resume` 
+- 📊 **Real-Time Monitoring**: Live dashboard with `--monitor` flag
+- 📁 **Multi-Project Support**: Per-session working directories
+- 🔍 **Git Integration**: View diffs and track changes across projects
+- 🎯 **Smart Task Orchestration**: PM agent intelligently routes work to specialists
+
+## Quick Installation
+
+```bash
+pip install claude-mpm
+```
+
+**That's it!** See [QUICKSTART.md](QUICKSTART.md) for immediate usage or [docs/user/installation.md](docs/user/installation.md) for advanced options.
+
+## Quick Usage
+
+```bash
+# Start interactive mode (recommended)
+claude-mpm
+
+# Start with monitoring dashboard
+claude-mpm run --monitor
+```
+
+See [QUICKSTART.md](QUICKSTART.md) for complete usage examples.
+
+
+## Architecture
+
+Claude MPM v3.8.2+ features a **modern service-oriented architecture** with interface-based design, dependency injection, and intelligent caching for 50-80% performance improvements.
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for detailed architecture information.
+
+## Key Capabilities
+
+### Multi-Agent Orchestration
+The PM agent automatically delegates work to specialized agents including Research, Engineer, QA, Documentation, Security, Ops, Data Engineer, Test Integration, and Version Control.
+
+### Agent Memory System
+Agents learn project-specific patterns and remember insights across sessions. Initialize with `claude-mpm memory init`.
+
+### Real-Time Monitoring
+The `--monitor` flag opens a web dashboard showing live agent activity, file operations, and session management.
+
+See [docs/MEMORY.md](docs/MEMORY.md) and [docs/developer/11-dashboard/README.md](docs/developer/11-dashboard/README.md) for details.
+
+
+## Documentation
+
+### User Documentation
+- **[Quick Start Guide](QUICKSTART.md)** - Get running in 5 minutes
+- **[Installation Guide](docs/user/installation.md)** - Complete installation options
+- **[User Guide](docs/user/)** - Detailed usage documentation
+- **[Memory System](docs/MEMORY.md)** - Agent memory documentation
+- **[Troubleshooting](docs/user/troubleshooting.md)** - Common issues and solutions
+
+### Developer Documentation
+- **[Architecture Overview](docs/ARCHITECTURE.md)** - Service-oriented architecture and design
+- **[API Reference](docs/api/)** - Complete API documentation with Sphinx
+- **[Service Layer Guide](docs/developer/SERVICES.md)** - Service interfaces and implementations
+- **[Performance Guide](docs/PERFORMANCE.md)** - Optimization and caching strategies
+- **[Security Guide](docs/SECURITY.md)** - Security framework and best practices
+- **[Testing Guide](docs/TESTING.md)** - Testing patterns and strategies
+- **[Migration Guide](docs/MIGRATION.md)** - Upgrading from previous versions
+- **[Developer Guide](docs/developer/)** - Comprehensive development documentation
+
+### API Documentation
+Comprehensive API documentation is available at [docs/api/](docs/api/) - build with `make html` in that directory.
+
+## Recent Updates (v3.8.2)
+
+**Major Architecture Refactoring (TSK-0053)**: Complete service-oriented redesign with 50-80% performance improvements, enhanced security, and interface-based design.
+
+See [CHANGELOG.md](CHANGELOG.md) for full history and [docs/MIGRATION.md](docs/MIGRATION.md) for upgrade instructions.
+
+## Development
+
+### Contributing
+Contributions are welcome! Please see our [project structure guide](docs/STRUCTURE.md) and follow the established patterns.
+
+### Project Structure
+See [docs/STRUCTURE.md](docs/STRUCTURE.md) for codebase organization.
+
+### License
+MIT License - see [LICENSE](LICENSE) file.
+
+## Credits
+
+- Based on [claude-multiagent-pm](https://github.com/kfsone/claude-multiagent-pm)
+- Enhanced for [Claude Code](https://docs.anthropic.com/en/docs/claude-code) integration
+- Built with ❤️ by the Claude MPM community

claude_mpm-3.9.2/VERSION

@@ -0,0 +1 @@
+3.9.2

{claude_mpm-3.8.1 → claude_mpm-3.9.2}/pyproject.toml

@@ -10,7 +10,7 @@ readme = "README.md"
 requires-python = ">=3.8"
 keywords = [ "claude", "orchestration", "multi-agent", "ticket-management",]
 classifiers = [ "Development Status :: 3 - Alpha", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Programming Language :: Python :: 3", "Programming Language :: Python :: 3.8", "Programming Language :: Python :: 3.9", "Programming Language :: Python :: 3.10", "Programming Language :: Python :: 3.11", "Programming Language :: Python :: 3.12",]
-dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "tree-sitter>=0.21.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.8.0", "python-engineio>=4.8.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "aiofiles>=23.0.0",]
+dependencies = [ "ai-trackdown-pytools>=1.4.0", "pyyaml>=6.0", "python-dotenv>=0.19.0", "click>=8.0.0", "pexpect>=4.8.0", "psutil>=5.9.0", "requests>=2.25.0", "flask>=3.0.0", "flask-cors>=4.0.0", "watchdog>=3.0.0", "tree-sitter>=0.21.0", "python-socketio>=5.11.0", "aiohttp>=3.9.0", "aiohttp-cors>=0.7.0,<0.8.0", "python-engineio>=4.8.0", "python-frontmatter>=1.0.0", "mistune>=3.0.0", "aiofiles>=23.0.0",]
 [[project.authors]]
 name = "Claude MPM Team"
 
@@ -19,6 +19,7 @@ text = "MIT"
 
 [project.optional-dependencies]
 dev = [ "pytest>=7.0", "pytest-asyncio", "pytest-cov", "black", "flake8", "mypy",]
+docs = [ "sphinx>=7.2.0", "sphinx-rtd-theme>=1.3.0", "sphinx-autobuild>=2021.3.14",]
 monitor = []
 # Pure Python agent dependencies - no compilation required
 agents = [ "bandit>=1.7.5", "black>=23.0.0", "commitizen>=3.13.0", "dask>=2023.12.0", "detect-secrets>=1.4.0", "diagrams>=0.23.0", "docstring-parser>=0.15.0", "faker>=20.0.0", "gitlint>=0.19.0", "gitpython>=3.1.40", "hypothesis>=6.92.0", "isort>=5.12.0", "lizard>=1.17.0", "mermaid-py>=0.2.0", "mkdocs>=1.5.0", "mutmut>=2.4.0", "mypy>=1.8.0", "pandas>=2.1.0", "pre-commit>=3.5.0", "prometheus-client>=0.19.0", "pydoc-markdown>=4.8.0", "pydriller>=2.5.0", "pygments>=2.17.0", "pytest>=7.4.0", "pytest-benchmark>=4.0.0", "pytest-cov>=4.1.0", "radon>=6.0.0", "rope>=1.11.0", "sphinx>=7.2.0", "sqlalchemy>=2.0.0", "sqlparse>=0.4.4", "tree-sitter>=0.21.0", "tree-sitter-python>=0.21.0", "tree-sitter-javascript>=0.21.0", "tree-sitter-typescript>=0.21.0", "tree-sitter-go>=0.21.0", "tree-sitter-rust>=0.21.0", "tree-sitter-java>=0.21.0", "tree-sitter-cpp>=0.21.0", "tree-sitter-c>=0.21.0", "tree-sitter-ruby>=0.21.0", "tree-sitter-php>=0.21.0",]

claude_mpm-3.9.2/src/claude_mpm/VERSION

@@ -0,0 +1 @@
+3.9.2

claude_mpm-3.9.2/src/claude_mpm/agents/BASE_AGENT_TEMPLATE.md

@@ -0,0 +1,85 @@
+# Base Agent Template Instructions
+
+## Essential Operating Rules
+
+### 1. Never Assume
+- Read files before editing - don't trust names/titles
+- Check documentation and actual code implementation
+- Verify your understanding before acting
+
+### 2. Always Verify
+- Test your changes: run functions, test APIs, review edits
+- Document what you verified and how
+- Request validation from QA/PM for complex work
+
+### 3. Challenge the Unexpected
+- Investigate anomalies - don't ignore them
+- Document expected vs. actual results
+- Escalate blockers immediately
+
+**Critical Escalation Triggers:** Security issues, data integrity problems, breaking changes, >20% performance degradation
+
+## Task Management
+
+### Reporting Format
+Report tasks in your response using: `[Agent] Task description (status)`
+
+**Status indicators:**
+- `(completed)` - Done
+- `(in_progress)` - Working on it
+- `(pending)` - Not started
+- `(blocked: reason)` - Can't proceed
+
+**Examples:**
+```
+[Research] Analyze auth patterns (completed)
+[Engineer] Implement rate limiting (pending)
+[Security] Patch SQL injection (blocked: need prod access)
+```
+
+### Tools Available
+- **Core**: Read, Write, Edit/MultiEdit
+- **Search**: Grep, Glob, LS
+- **Execute**: Bash (if authorized)
+- **Research**: WebSearch/WebFetch (if authorized)
+- **Tracking**: TodoWrite (varies by agent)
+
+## Response Structure
+
+### 1. Task Summary
+Brief overview of what you accomplished
+
+### 2. Completed Work
+List of specific achievements
+
+### 3. Key Findings/Changes
+Detailed results relevant to the task
+
+### 4. Follow-up Tasks
+Tasks for other agents using `[Agent] Task` format
+
+### 5. Required JSON Block
+End every response with this structured data:
+
+```json
+{
+  "task_completed": true/false,
+  "instructions": "Original task you received",
+  "results": "What you accomplished",
+  "files_modified": [
+    {"file": "path/file.py", "action": "created|modified|deleted", "description": "What changed"}
+  ],
+  "tools_used": ["Read", "Edit", "etc"],
+  "remember": ["Key learnings"] or null
+}
+```
+
+## Quick Reference
+
+**When blocked:** Stop and ask for help  
+**When uncertain:** Verify through testing  
+**When delegating:** Use `[Agent] Task` format  
+**Always include:** JSON response block at end  
+
+## Remember
+You're a specialist in your domain. Focus on your expertise, communicate clearly with the PM who coordinates multi-agent workflows, and always think about what other agents need next.

claude_mpm-3.9.2/src/claude_mpm/agents/MEMORY.md

@@ -0,0 +1,97 @@
+## Static Memory Management Protocol
+
+### Overview
+
+This system provides **Static Memory** support where you (PM) directly manage memory files for agents. This is the first phase of memory implementation, with **Dynamic mem0AI Memory** coming in future releases.
+
+### PM Memory Update Mechanism
+
+**As PM, you handle memory updates directly by:**
+
+1. **Reading** existing memory files from `.claude-mpm/memories/`
+2. **Consolidating** new information with existing knowledge
+3. **Saving** updated memory files with enhanced content
+4. **Maintaining** 20k token limit (~80KB) per file
+
+### Memory File Format
+
+- **Project Memory Location**: `.claude-mpm/memories/`
+  - **PM Memory**: `.claude-mpm/memories/PM.md` (Project Manager's memory)
+  - **Agent Memories**: `.claude-mpm/memories/{agent_name}.md` (e.g., engineer.md, qa.md, research.md)
+- **Size Limit**: 80KB (~20k tokens) per file
+- **Format**: Single-line facts and behaviors in markdown sections
+- **Sections**: Project Architecture, Implementation Guidelines, Common Mistakes, etc.
+- **Naming**: Use exact agent names (engineer, qa, research, security, etc.) matching agent definitions
+
+### Memory Update Process (PM Instructions)
+
+**When memory indicators detected**:
+1. **Identify** which agent should store this knowledge
+2. **Read** current memory file: `.claude-mpm/memories/{agent_id}_agent.md`
+3. **Consolidate** new information with existing content
+4. **Write** updated memory file maintaining structure and limits
+5. **Confirm** to user: "Updated {agent} memory with: [brief summary]"
+
+**Memory Trigger Words/Phrases**:
+- "remember", "don't forget", "keep in mind", "note that"
+- "make sure to", "always", "never", "important" 
+- "going forward", "in the future", "from now on"
+- "this pattern", "this approach", "this way"
+- Project-specific standards or requirements
+
+**Storage Guidelines**:
+- Keep facts concise (single-line entries)
+- Organize by appropriate sections
+- Remove outdated information when adding new
+- Maintain readability and structure
+- Respect 80KB file size limit
+
+### Agent Memory Routing Matrix
+
+**Engineering Agent Memory**:
+- Implementation patterns and anti-patterns
+- Code architecture and design decisions
+- Performance optimizations and bottlenecks
+- Technology stack choices and constraints
+
+**Research Agent Memory**:
+- Analysis findings and investigation results
+- Domain knowledge and business logic
+- Architectural decisions and trade-offs
+- Codebase patterns and conventions
+
+**QA Agent Memory**:
+- Testing strategies and coverage requirements
+- Quality standards and acceptance criteria
+- Bug patterns and regression risks
+- Test infrastructure and tooling
+
+**Security Agent Memory**:
+- Security patterns and vulnerabilities
+- Threat models and attack vectors
+- Compliance requirements and policies
+- Authentication/authorization patterns
+
+**Documentation Agent Memory**:
+- Writing standards and style guides
+- Content organization patterns
+- API documentation conventions
+- User guide templates
+
+**Data Engineer Agent Memory**:
+- Data pipeline patterns and ETL strategies
+- Schema designs and migrations
+- Performance tuning techniques
+- Data quality requirements
+
+**Ops Agent Memory**:
+- Deployment patterns and rollback procedures
+- Infrastructure configurations
+- Monitoring and alerting strategies
+- CI/CD pipeline requirements
+
+**Version Control Agent Memory**:
+- Branching strategies and conventions
+- Commit message standards
+- Code review processes
+- Release management patterns

{claude_mpm-3.8.1 → claude_mpm-3.9.2}/src/claude_mpm/agents/WORKFLOW.md

@@ -1,5 +1,5 @@
-<!-- WORKFLOW_VERSION: 0001 -->
-<!-- LAST_MODIFIED: 2025-01-14T00:00:00Z -->
+<!-- WORKFLOW_VERSION: 0002 -->
+<!-- LAST_MODIFIED: 2025-01-14T18:30:00Z -->
 
 # PM Workflow Configuration
 
@@ -68,7 +68,7 @@ Delegate to Research when:
 - Architecture decisions needed
 - Domain knowledge required
 
-### Ticketing Agent Scenarios
+### Ticketing Agent Integration
 
 **ALWAYS delegate to Ticketing Agent when user mentions:**
 - "ticket", "tickets", "ticketing"
@@ -79,8 +79,58 @@ Delegate to Research when:
 - "work breakdown"
 - "user stories"
 
+**AUTOMATIC TICKETING WORKFLOW** (when ticketing is requested):
+
+#### Session Initialization
+1. **Single Session Work**: Create an ISS (Issue) ticket for the session
+   - Title: Clear description of user's request
+   - Parent: Attach to appropriate existing epic or create new one
+   - Status: Set to "in_progress"
+   
+2. **Multi-Session Work**: Create an EP (Epic) ticket
+   - Title: High-level objective
+   - Create first ISS (Issue) for current session
+   - Attach session issue to the epic
+
+#### Phase Tracking
+After EACH workflow phase completion, delegate to Ticketing Agent to:
+
+1. **Create TSK (Task) ticket** for the completed phase:
+   - **Research Phase**: TSK ticket with research findings
+   - **Implementation Phase**: TSK ticket with code changes summary
+   - **QA Phase**: TSK ticket with test results
+   - **Documentation Phase**: TSK ticket with docs created/updated
+   
+2. **Update parent ISS ticket** with:
+   - Comment summarizing phase completion
+   - Link to the created TSK ticket
+   - Update status if needed
+
+3. **Task Ticket Content** should include:
+   - Agent that performed the work
+   - Summary of what was accomplished
+   - Key decisions or findings
+   - Files modified or created
+   - Any blockers or issues encountered
+
+#### Continuous Updates
+- **After significant changes**: Add comment to relevant ticket
+- **When blockers arise**: Update ticket status to "blocked" with explanation
+- **On completion**: Update ISS ticket to "done" with final summary
+
+#### Ticket Hierarchy Example
+```
+EP-0001: Authentication System Overhaul (Epic)
+└── ISS-0001: Implement OAuth2 Support (Session Issue)
+    ├── TSK-0001: Research OAuth2 patterns and existing auth (Research Agent)
+    ├── TSK-0002: Implement OAuth2 provider integration (Engineer Agent)
+    ├── TSK-0003: Test OAuth2 implementation (QA Agent)
+    └── TSK-0004: Document OAuth2 setup and API (Documentation Agent)
+```
+
 The Ticketing Agent specializes in:
 - Creating and managing epics, issues, and tasks
 - Generating structured project documentation
 - Breaking down work into manageable pieces
-- Tracking project progress and dependencies
+- Tracking project progress and dependencies
+- Maintaining clear audit trail of all work performed

{claude_mpm-3.8.1 → claude_mpm-3.9.2}/src/claude_mpm/agents/agents_metadata.py

@@ -191,6 +191,29 @@ DATA_ENGINEER_CONFIG = {
     }
 }
 
+# Project Organizer Agent Metadata
+PROJECT_ORGANIZER_CONFIG = {
+    "name": "project_organizer_agent",
+    "version": "1.0.0",
+    "type": "core_agent",
+    "capabilities": [
+        "pattern_detection",
+        "file_organization",
+        "structure_validation",
+        "convention_enforcement",
+        "batch_reorganization",
+        "framework_recognition",
+        "documentation_maintenance"
+    ],
+    "primary_interface": "organization_tools",
+    "performance_targets": {
+        "structure_analysis": "2m",
+        "file_placement": "10s",
+        "validation_scan": "5m",
+        "batch_reorganization": "15m"
+    }
+}
+
 # Aggregate all configs for easy access
 ALL_AGENT_CONFIGS = {
     "documentation": DOCUMENTATION_CONFIG,
@@ -200,5 +223,6 @@ ALL_AGENT_CONFIGS = {
     "ops": OPS_CONFIG,
     "security": SECURITY_CONFIG,
     "engineer": ENGINEER_CONFIG,
-    "data_engineer": DATA_ENGINEER_CONFIG
+    "data_engineer": DATA_ENGINEER_CONFIG,
+    "project_organizer": PROJECT_ORGANIZER_CONFIG
 }

{claude_mpm-3.8.1 → claude_mpm-3.9.2}/src/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"]
+      "enum": ["base", "engineer", "qa", "documentation", "research", "security", "ops", "data_engineer", "version_control", "project_organizer"]
     },
     "metadata": {
       "type": "object",