claude-mpm 0.3.0__py3-none-any.whl → 1.0.0__py3-none-any.whl

claude_mpm/agents/INSTRUCTIONS.md

@@ -156,6 +156,29 @@ Context:
 4. **Workload Balancing**: Distribute tasks across agents when possible
 5. **Specialization Depth**: Prefer specialist over generalist for complex tasks
 
+### Task Tool Agent Name Format
+The Task tool accepts agent names in **both** formats for flexibility:
+
+**TodoWrite Format (Capitalized)** → **Task Tool Format (lowercase-hyphenated)**
+- `"Research"` → `"research"`
+- `"Engineer"` → `"engineer"`
+- `"QA"` → `"qa"`
+- `"Documentation"` → `"documentation"`
+- `"Security"` → `"security"`
+- `"Ops"` → `"ops"`
+- `"Version Control"` → `"version-control"`
+- `"Data Engineer"` → `"data-engineer"`
+
+**Both formats are valid** in the Task tool:
+- ✅ `Task(description="Analyze patterns", subagent_type="Research")` 
+- ✅ `Task(description="Analyze patterns", subagent_type="research")`
+- ✅ `Task(description="Update docs", subagent_type="Documentation")`
+- ✅ `Task(description="Update docs", subagent_type="documentation")`
+- ✅ `Task(description="Git operations", subagent_type="Version Control")`
+- ✅ `Task(description="Git operations", subagent_type="version-control")`
+
+**Agent Name Normalization**: When you receive a Task tool call with capitalized format (matching TodoWrite prefixes), automatically normalize it to the lowercase-hyphenated format internally for delegation.
+
 ## Advanced Verification & Error Handling
 
 ### Output Quality Gates

claude_mpm/core/agent_name_normalizer.py

@@ -242,6 +242,55 @@ class AgentNameNormalizer:
             return False, f"Unknown agent '{agent}'. Valid agents: {', '.join(cls.CANONICAL_NAMES.values())}"
         
         return True, None
+    
+    @classmethod
+    def to_task_format(cls, agent_name: str) -> str:
+        """
+        Convert agent name from TodoWrite format to Task tool format.
+        
+        Args:
+            agent_name: The agent name in TodoWrite format (e.g., "Research", "Version Control")
+            
+        Returns:
+            The agent name in Task tool format (e.g., "research", "version-control")
+            
+        Examples:
+            "Research" → "research"
+            "Version Control" → "version-control" 
+            "Data Engineer" → "data-engineer"
+            "QA" → "qa"
+        """
+        # First normalize to canonical form
+        normalized = cls.normalize(agent_name)
+        # Convert to lowercase and replace spaces with hyphens
+        return normalized.lower().replace(" ", "-")
+    
+    @classmethod
+    def from_task_format(cls, task_format: str) -> str:
+        """
+        Convert agent name from Task tool format to TodoWrite format.
+        
+        Args:
+            task_format: The agent name in Task tool format (e.g., "research", "version-control")
+            
+        Returns:
+            The agent name in TodoWrite format (e.g., "Research", "Version Control")
+            
+        Examples:
+            "research" → "Research"
+            "version-control" → "Version Control"
+            "data-engineer" → "Data Engineer"
+            "qa" → "QA"
+        """
+        # Replace hyphens with underscores for lookup
+        lookup_key = task_format.replace("-", "_")
+        
+        # Check if it's a valid canonical key
+        if lookup_key in cls.CANONICAL_NAMES:
+            return cls.CANONICAL_NAMES[lookup_key]
+        
+        # Try normalizing as-is
+        return cls.normalize(task_format)
 
 
 # Global instance for easy access

claude_mpm/core/simple_runner.py

@@ -491,6 +491,13 @@ You have access to native subagents via the Task tool with subagent_type paramet
 
 Use these agents by calling: Task(description="task description", subagent_type="agent_name")
 
+IMPORTANT: The Task tool accepts both naming formats:
+- Capitalized format: "Research", "Engineer", "QA", "Version Control", "Data Engineer"
+- Lowercase format: "research", "engineer", "qa", "version-control", "data-engineer"
+
+Both formats work correctly. When you see capitalized names (matching TodoWrite prefixes), 
+automatically normalize them to lowercase-hyphenated format for the Task tool.
+
 Work efficiently and delegate appropriately to subagents when needed."""
 
 

claude_mpm/hooks/builtin/todo_agent_prefix_hook.py

@@ -141,10 +141,11 @@ class TodoAgentPrefixHook(BaseHook):
     
     def _has_agent_prefix(self, content: str) -> bool:
         """Check if content already has an agent prefix."""
+        import re
         content = content.strip()
-        # Check if content has a valid agent prefix
-        agent = agent_name_normalizer.extract_from_todo(content)
-        return agent is not None
+        # Only check for [Agent] prefix at the beginning, not agent mentions in content
+        match = re.match(r'^\[([^\]]+)\]', content)
+        return match is not None
     
     def _suggest_agent(self, content: str) -> Optional[str]:
         """Suggest an appropriate agent based on content analysis."""
@@ -158,13 +159,13 @@ class TodoAgentPrefixHook(BaseHook):
         
         # Default suggestions based on common keywords
         if any(word in content_lower for word in ['code', 'implement', 'fix', 'bug']):
-            return 'engineer'
+            return agent_name_normalizer.normalize('engineer')
         elif any(word in content_lower for word in ['test', 'validate', 'check']):
-            return 'qa'
+            return agent_name_normalizer.normalize('qa')
         elif any(word in content_lower for word in ['doc', 'readme', 'guide']):
-            return 'documentation'
+            return agent_name_normalizer.normalize('documentation')
         elif any(word in content_lower for word in ['research', 'investigate']):
-            return 'research'
+            return agent_name_normalizer.normalize('research')
         
         return None
     

claude_mpm/services/framework_claude_md_generator/section_generators/todo_task_tools.py

@@ -25,31 +25,56 @@ class TodoTaskToolsGenerator(BaseSectionGenerator):
 ### Agent Name Prefix System
 
 **Standard TodoWrite Entry Format:**
-- **Research tasks** → `Researcher: [task description]`
-- **Documentation tasks** → `Documentater: [task description]`
-- **Changelog tasks** → `Documentater: [changelog description]`
-- **QA tasks** → `QA: [task description]`
-- **DevOps tasks** → `Ops: [task description]`
-- **Security tasks** → `Security: [task description]`
-- **Version Control tasks** → `Versioner: [task description]`
-- **Version Management tasks** → `Versioner: [version management description]`
-- **Code Implementation tasks** → `Engineer: [implementation description]`
-- **Data Operations tasks** → `Data Engineer: [data management description]`
+- **Research tasks** → `[Research] Analyze patterns and investigate implementation`
+- **Documentation tasks** → `[Documentation] Update API reference and user guide`
+- **Changelog tasks** → `[Documentation] Generate changelog for version 2.0`
+- **QA tasks** → `[QA] Execute test suite and validate functionality`
+- **DevOps tasks** → `[Ops] Configure deployment pipeline`
+- **Security tasks** → `[Security] Perform vulnerability assessment`
+- **Version Control tasks** → `[Version Control] Create feature branch and manage tags`
+- **Version Management tasks** → `[Version Control] Apply semantic version bump`
+- **Code Implementation tasks** → `[Engineer] Implement authentication system`
+- **Data Operations tasks** → `[Data Engineer] Optimize database queries`
 
 ### Task Tool Subprocess Naming Conventions
 
-**Template Pattern:**
+**Task Tool Usage Pattern:**
 ```
-**[Agent Nickname]**: [Specific task description with clear deliverables]
+Task(description="[task description]", subagent_type="[agent-type]")
 ```
 
-**Examples of Proper Naming:**
-- ✅ **Documentationer**: Update framework/CLAUDE.md with Task Tool naming conventions
-- ✅ **QA**: Execute comprehensive test suite validation for merge readiness
-- ✅ **Versioner**: Create feature branch and sync with remote repository
-- ✅ **Researcher**: Investigate Next.js 14 performance optimization patterns
-- ✅ **Engineer**: Implement user authentication system with JWT tokens
-- ✅ **Data Engineer**: Configure PostgreSQL database and optimize query performance
+**Valid subagent_type values (both formats accepted):**
+
+**Lowercase-hyphenated format (traditional):**
+- `subagent_type="research"` - For investigation and analysis
+- `subagent_type="engineer"` - For coding and implementation
+- `subagent_type="qa"` - For testing and quality assurance
+- `subagent_type="documentation"` - For docs and guides
+- `subagent_type="security"` - For security assessments
+- `subagent_type="ops"` - For deployment and infrastructure
+- `subagent_type="version-control"` - For git and version management
+- `subagent_type="data-engineer"` - For data processing and APIs
+
+**Capitalized format (matching TodoWrite prefixes - also accepted):**
+- `subagent_type="Research"` - For investigation and analysis
+- `subagent_type="Engineer"` - For coding and implementation
+- `subagent_type="QA"` - For testing and quality assurance
+- `subagent_type="Documentation"` - For docs and guides
+- `subagent_type="Security"` - For security assessments
+- `subagent_type="Ops"` - For deployment and infrastructure
+- `subagent_type="Version Control"` - For git and version management
+- `subagent_type="Data Engineer"` - For data processing and APIs
+
+**Examples of Proper Task Tool Usage (both formats work):**
+- ✅ `Task(description="Update framework documentation", subagent_type="documentation")`
+- ✅ `Task(description="Execute test suite validation", subagent_type="qa")`
+- ✅ `Task(description="Create feature branch and sync", subagent_type="version-control")`
+- ✅ `Task(description="Investigate performance patterns", subagent_type="research")`
+- ✅ `Task(description="Implement authentication system", subagent_type="engineer")`
+- ✅ `Task(description="Configure database and optimize queries", subagent_type="data-engineer")`
+- ✅ `Task(description="Analyze code patterns", subagent_type="Research")` (capitalized format)
+- ✅ `Task(description="Update API docs", subagent_type="Documentation")` (capitalized format)
+- ✅ `Task(description="Create release tags", subagent_type="Version Control")` (capitalized format)
 
 ### 🚨 MANDATORY: THREE SHORTCUT COMMANDS
 
@@ -72,18 +97,19 @@ class TodoTaskToolsGenerator(BaseSectionGenerator):
 
 **Example Integration:**
 ```
-TodoWrite: Create prefixed todos for "Push release"
-- ☐ Documentation Agent: Generate changelog and analyze version impact
-- ☐ QA Agent: Execute full test suite and quality validation
-- ☐ Data Engineer Agent: Validate data integrity and verify API connectivity
-- ☐ Version Control Agent: Apply semantic version bump and create release tags
-
-Task Tool → Documentation Agent: Generate changelog and analyze version impact
-Task Tool → QA Agent: Execute full test suite and quality validation
-Task Tool → Data Engineer Agent: Validate data integrity and verify API connectivity
-Task Tool → Version Control Agent: Apply semantic version bump and create release tags
-
-Update TodoWrite status based on agent completions
+# TodoWrite entries with proper agent prefixes:
+- ☐ [Documentation] Generate changelog and analyze version impact
+- ☐ [QA] Execute full test suite and quality validation
+- ☐ [Data Engineer] Validate data integrity and verify API connectivity
+- ☐ [Version Control] Apply semantic version bump and create release tags
+
+# Corresponding Task Tool delegations:
+Task(description="Generate changelog and analyze version impact", subagent_type="documentation")
+Task(description="Execute full test suite and quality validation", subagent_type="qa")
+Task(description="Validate data integrity and verify API connectivity", subagent_type="data-engineer")
+Task(description="Apply semantic version bump and create release tags", subagent_type="version-control")
+
+# Update TodoWrite status based on agent completions
 ```
 
 ---"""

{claude_mpm-0.3.0.dist-info → claude_mpm-1.0.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: claude-mpm
-Version: 0.3.0
+Version: 1.0.0
 Summary: Claude Multi-agent Project Manager - Clean orchestration with ticket management
 Home-page: https://github.com/bobmatnyc/claude-mpm
 Author: Claude MPM Team

{claude_mpm-0.3.0.dist-info → claude_mpm-1.0.0.dist-info}/RECORD

@@ -6,7 +6,7 @@ claude_mpm/cli_main.py,sha256=KCAe-ws73NrIg5qmFhPdZ1a4uoiaEZ-lldYzQ6KfnJg,306
 claude_mpm/constants.py,sha256=5AG5hgBxOC7gMNHDx0lAhS-FQ8gXhtGtqJ9Moj3S6ro,4044
 claude_mpm/init.py,sha256=gOreOf7BLXkT0_HrQk_As4Kz1OT_NJG_RG0i0hbY0z0,8088
 claude_mpm/agents/BASE_AGENT_TEMPLATE.md,sha256=TYgSd9jNBMWp4mAOBUl9dconX4RcGbvmMEScRy5uyko,3343
-claude_mpm/agents/INSTRUCTIONS.md,sha256=cBIYDYmoplY43N3lyf59-Zyl3hldcSla-SUtmY76jds,15430
+claude_mpm/agents/INSTRUCTIONS.md,sha256=FuLq0cBjUjqByA9rdi1H_3SCt8xSjsTWM_VvnIQz2fg,16578
 claude_mpm/agents/__init__.py,sha256=DxJswRx5DpgJVZEY5JlZm5VJNb_CakV5Ch231r7nWlo,3292
 claude_mpm/agents/agent_loader.py,sha256=RAAoIxM9DONMMIqyEhaU0nEiaZKYkEZpMP6humOBmU0,23669
 claude_mpm/agents/agent_loader_integration.py,sha256=z_DXxAIeuUD71HBYdxxvcFKoQYQxITLo8oAdN_M4LTA,7610
@@ -36,7 +36,7 @@ claude_mpm/cli_old/ticket_cli.py,sha256=oKIT2LR1tToHybwypRfsNdnYlwdRzjWyjlQN5lYw
 claude_mpm/config/__init__.py,sha256=p31JuaXLDHgIgoAbHApNvctN2IEZYq2MBkkXROdhbH8,105
 claude_mpm/config/hook_config.py,sha256=ehVAVHhn6ZBxrdWXqXB2M8jcAmqaWCnE9gVxuxR2UEs,1334
 claude_mpm/core/__init__.py,sha256=hE29BeE3qb8vC1-wiKjPh60WZebCwfo9UAUGM1zQnkc,1206
-claude_mpm/core/agent_name_normalizer.py,sha256=QLA4z7yt-xBvXzmgFOa0mBmaQY4d26jHXIhPewbyxoc,7520
+claude_mpm/core/agent_name_normalizer.py,sha256=-X68oz3_74t9BRbHA54NEGyjy0xjTsGp_sCUHDtKp1s,9269
 claude_mpm/core/agent_registry.py,sha256=4MAfc7xDlrYWWkHmDMRmWE8q32teuCmIcud9D0I0dLo,20496
 claude_mpm/core/agent_registry.py.bak,sha256=cXB0yqhonE1XsXmWcdwyNuvv8yddK_PyZILDCmwCZ_Q,10161
 claude_mpm/core/agent_session_manager.py,sha256=6alXQr4gnMR-unT4J1ryEtTxJqQolA0-NgPQN6X3lqY,11212
@@ -54,7 +54,7 @@ claude_mpm/core/minimal_framework_loader.py,sha256=liYS4IyuW_aFK7yhRDZwTwT-3q09f
 claude_mpm/core/mixins.py,sha256=rTEH-7FDpNiLB8oo6mSb0CLarJklv4fDJw1xM-gr5wI,5599
 claude_mpm/core/service_registry.py,sha256=rRJDidqVU3DmGRuEWcb3-hhK2gxVe7MCFDPNOh7XlbY,10790
 claude_mpm/core/session_manager.py,sha256=3rO4KGZp8Qd_cUw6OWv4jyxGCUaL_MNPgCCpnwQt12A,6581
-claude_mpm/core/simple_runner.py,sha256=c7oAftT5HHWhHP1cNIw3p81sxwprAPdVNwY-l_wegks,20515
+claude_mpm/core/simple_runner.py,sha256=cEaA5fzU8itTIcEF6Zy84S5ZBgKkkAd7IqPEC0YiP64,20914
 claude_mpm/core/tool_access_control.py,sha256=htZbDhC8s7D7BVqfmk0BwRrYJnlnUAk8_NeJKOaeNlg,6632
 claude_mpm/hooks/README.md,sha256=lsvGzw9g8Lf0VfRcqoGNGpAZEQSmpE0C8DksZ4nvDso,8030
 claude_mpm/hooks/__init__.py,sha256=Y3JJ_mEtvRP07r_gXkju4c0s18bjIXGH1uAbhSw1ES0,166
@@ -70,7 +70,7 @@ claude_mpm/hooks/builtin/post_delegation_hook_example.py,sha256=54OJKRgjdXH8A2LH
 claude_mpm/hooks/builtin/pre_delegation_hook_example.py,sha256=JOAdDm46be_ol7uSmnQaE0jQS8SsiuGei80Auj3sdL8,4692
 claude_mpm/hooks/builtin/submit_hook_example.py,sha256=x7-yIF_QYe9uwCezeVDA_HdDTLu6uQfbTgZ12pdC4xo,3431
 claude_mpm/hooks/builtin/ticket_extraction_hook_example.py,sha256=4wNhS2tFUXgdcvepefUvi818Tt8kKnPQQJVxqINGeys,9237
-claude_mpm/hooks/builtin/todo_agent_prefix_hook.py,sha256=RJDWZRvCvZWls93MmsPDaDMa7AIjzIC67Q0wtXV3fXc,10053
+claude_mpm/hooks/builtin/todo_agent_prefix_hook.py,sha256=v_4w2vcZIt0bkZxqdHmgtN79yHZ1gviuhhBws0FHpIQ,10226
 claude_mpm/hooks/builtin/workflow_start_hook.py,sha256=EQrtYD9qLMLSYPl3oQinEheZAJ2i5EO_h2jhhR8lmt0,7490
 claude_mpm/orchestration/SUBPROCESS_DESIGN.md,sha256=YwToiT1_NXblv1XIWhWPNc2uKzDvqY2E_Nix8qK7qk0,2136
 claude_mpm/orchestration/__init__.py,sha256=C-cwldtfBCgV19mKnJa5U1XiKw1rAZvx-kK61nIdcao,205
@@ -123,7 +123,7 @@ claude_mpm/services/framework_claude_md_generator/section_generators/header.py,s
 claude_mpm/services/framework_claude_md_generator/section_generators/orchestration_principles.py,sha256=fKdCMvu95m7kXx6SIDzz0d6z9uvOc8EWLCZCwHANNdA,1829
 claude_mpm/services/framework_claude_md_generator/section_generators/role_designation.py,sha256=aYBHykUbsgUz7XYUNR-J3nQjIevFHvUQNBO0L1GqlTw,1468
 claude_mpm/services/framework_claude_md_generator/section_generators/subprocess_validation.py,sha256=eqj2nNXtOZ8KkMyINpkU-JLDfXHY81MpKhf_qmnZdUc,4117
-claude_mpm/services/framework_claude_md_generator/section_generators/todo_task_tools.py,sha256=kLgudlwoL0p2pinHnladTP-uQthBao_KmR52duvtYJ4,3963
+claude_mpm/services/framework_claude_md_generator/section_generators/todo_task_tools.py,sha256=W6PaLGxCISqFQCku7yCIz-lN81FHZjSq4c2KnnO9AeI,5719
 claude_mpm/services/framework_claude_md_generator/section_generators/troubleshooting.py,sha256=o0oD7RuBSeLF4S8NCVH9lMLmQWQ57JrAm-j1BeTb0uM,1887
 claude_mpm/services/parent_directory_manager/README.md,sha256=VEdJXvxsoCA-kuBWJ_t-RZf-jU_oB43_7Inw9V6AFFk,2909
 claude_mpm/services/parent_directory_manager/__init__.py,sha256=IonvPwRV-JP58qHQGzuLxGHh83pB4SgLTzsRYbejSUQ,22889
@@ -152,8 +152,8 @@ claude_mpm/utils/import_migration_example.py,sha256=W4a4XH3FY_VBB00BB8Lae2aRPM02
 claude_mpm/utils/imports.py,sha256=wX-SOXUHbemx01MHRGQpVwajzXH6qYdQkYNFCIbb2mw,6851
 claude_mpm/utils/path_operations.py,sha256=6pLMnAWBVzHkgp6JyQHmHbGD-dWn-nX21yV4E_eT-kM,11614
 claude_mpm/utils/paths.py,sha256=Xv0SZWdZRkRjN9e6clBcA165ya00GNQxt7SwMz51tfA,10153
-claude_mpm-0.3.0.dist-info/METADATA,sha256=GPamifCu72Ep3mYGN47C3BR8BijeR7ojZbkN10O4OSQ,8792
-claude_mpm-0.3.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-claude_mpm-0.3.0.dist-info/entry_points.txt,sha256=PknO31um7d8bt6GjOiVeYpdJpjND0_C1z-LQfY6UfiU,142
-claude_mpm-0.3.0.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
-claude_mpm-0.3.0.dist-info/RECORD,,
+claude_mpm-1.0.0.dist-info/METADATA,sha256=s8VhjuHma1JWq9S1G6iq7eNfxD6__qDFbCF6aqZOw4c,8792
+claude_mpm-1.0.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+claude_mpm-1.0.0.dist-info/entry_points.txt,sha256=PknO31um7d8bt6GjOiVeYpdJpjND0_C1z-LQfY6UfiU,142
+claude_mpm-1.0.0.dist-info/top_level.txt,sha256=1nUg3FEaBySgm8t-s54jK5zoPnu3_eY6EP6IOlekyHA,11
+claude_mpm-1.0.0.dist-info/RECORD,,