slack-mpm 0.1.1__tar.gz

slack_mpm-0.1.1/.claude/agents/.dependency_cache

@@ -0,0 +1,13 @@
+{
+  "08a4fa62924b8abea138e19e96516bc7": {
+    "timestamp": 1772776360.875742,
+    "results": {
+      "agents": {},
+      "summary": {
+        "total_agents": 0
+      }
+    },
+    "deployment_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+    "context": {}
+  }
+}

slack_mpm-0.1.1/.claude/agents/.mpm_deployment_state

@@ -0,0 +1,11 @@
+{
+  "deployment_hash": "e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855",
+  "last_check_time": 1772776360.875825,
+  "last_check_results": {
+    "agents": {},
+    "summary": {
+      "total_agents": 0
+    }
+  },
+  "agent_count": 0
+}

slack_mpm-0.1.1/.claude/settings.local.json

@@ -0,0 +1,128 @@
+{
+  "permissions": {
+    "allow": []
+  },
+  "enableAllProjectMcpServers": true,
+  "hooks": {
+    "PreToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "PostToolUse": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "Stop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "SubagentStop": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "WorktreeCreate": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "WorktreeRemove": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "TeammateIdle": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "TaskCompleted": [
+      {
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "SessionStart": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "UserPromptSubmit": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ],
+    "ConfigChange": [
+      {
+        "matcher": "*",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "/Users/masa/.local/share/uv/tools/claude-mpm/lib/python3.12/site-packages/claude_mpm/scripts/claude-hook-fast.sh"
+          }
+        ]
+      }
+    ]
+  },
+  "enabledMcpjsonServers": [
+    "mcp-skillset",
+    "github",
+    "filesystem"
+  ]
+}

slack_mpm-0.1.1/.claude/skills/mpm/SKILL.md

@@ -0,0 +1,147 @@
+---
+name: mpm
+description: Access Claude MPM functionality and manage multi-agent orchestration
+user-invocable: true
+version: "2.0.0"
+category: mpm-command
+tags: [mpm-command, system, pm-required, framework]
+---
+
+# /mpm - Claude MPM Framework Guide
+
+## What is Claude MPM?
+
+Claude MPM (Multi-Agent Project Manager) extends Claude Code with multi-agent orchestration, project-specific PM instructions, persistent agent memory, real-time monitoring via a WebSocket dashboard, and automation hooks. A **PM agent** coordinates specialized agents to complete work through structured delegation using the Task tool. MPM manages skills deployment, agent selection, session continuity, and cross-project messaging.
+
+## How Delegation Works
+
+The PM receives user requests and delegates to specialized agents via the **Task tool**:
+
+```
+Task(description="[what to do]", subagent_type="[agent-type]")
+```
+
+- PM analyzes the request, breaks it into subtasks, and selects the right agent for each
+- Each agent focuses on its specialty and returns results to PM
+- **Parallel execution** when tasks are independent (e.g., frontend + backend simultaneously)
+- **Sequential execution** when tasks depend on each other (e.g., implement, then test, then deploy)
+- Agents should focus on their delegated task and return clear results -- PM handles orchestration
+- If an agent needs help from another specialty, it reports back to PM rather than self-delegating
+
+**Typical workflow**: Research -> Engineer -> Ops (deploy) -> Ops (verify) -> QA -> Documentation
+
+## Available Agents
+
+### Core Agents (always deployed)
+
+| Agent | subagent_type | Role |
+|-------|---------------|------|
+| Engineer | `engineer` | Code implementation, refactoring, debugging |
+| Research | `Research` | Investigation, analysis, codebase exploration |
+| QA | `qa` | Testing, validation, quality assurance |
+| Documentation | `documentation` | Docs generation, API specs, guides |
+| Ops | `ops` | Deployment, infrastructure, operations |
+| Security | `security` | Vulnerability assessment, security review |
+| Ticketing | `ticketing` | Ticket tracking and workflow management |
+
+### Extended Agents (deployed per project)
+
+| Agent | subagent_type | Role |
+|-------|---------------|------|
+| Version Control | `version-control` | Git operations, PR management, tagging |
+| Code Analyzer | `code-analyzer` | Codebase analysis, architecture review |
+| Code Review | `code-review` | PR review, semantic analysis |
+| Data Engineer | `data-engineer` | Database management, API integrations |
+| Product Owner | `product-owner` | Requirements, user stories, prioritization |
+
+### Language-Specific Engineers
+
+Deployed automatically based on project toolchain detection:
+
+`python-engineer`, `typescript-engineer`, `javascript-engineer`, `golang-engineer`, `rust-engineer`, `java-engineer`, `ruby-engineer`, `php-engineer`, `dart-engineer`
+
+**Framework specialists**: `nextjs-engineer`, `react-engineer`, `svelte-engineer`, `tauri-engineer`, `phoenix-engineer`
+
+### Platform Ops
+
+`local-ops` (local dev, PM2, Docker), `vercel-ops`, `gcp-ops`, `digitalocean-ops`, `clerk-ops`, `railway-ops`
+
+### Specialized Agents
+
+`api-qa`, `web-qa`, `code-review`, `code-analyzer`, `refactoring-engineer`, `prompt-engineer`, `content-agent`, `imagemagick`, `memory-manager`
+
+## Skills System
+
+**Skills** are markdown files deployed to `.claude/skills/{name}/SKILL.md` that provide agents with specialized knowledge and procedures.
+
+- **User-invocable skills** respond to `/skill-name` slash commands (e.g., `/mpm`, `/mpm-help`)
+- **Non-invocable skills** activate automatically based on context triggers
+- Skills have **frontmatter** with: `name`, `description`, `user-invocable`, `version`, `category`, `tags`
+- **Categories**: `mpm-command`, `pm-workflow`, `pm-reference`, `toolchains-*`, `universal-*`
+- **Progressive disclosure**: Metadata loads first; full content loads on trigger
+- Skills can include `references/` subdirectories for detailed supplementary content
+
+## Memory System
+
+Agent memories provide persistent context across sessions.
+
+- **Storage**: `.claude-mpm/memories/{agent_id}_memories.md`
+- PM manages memory files directly (read, consolidate, save)
+- Each agent has domain-specific memory categories
+- **Trigger phrases**: "remember", "don't forget", "always", "never", "going forward"
+- **Size limit**: 80KB per file (~20k tokens)
+- **Routing**: Keyword-based routing sends memories to the appropriate agent
+- Memories are automatically loaded when an agent is delegated work
+
+## Hooks and Dashboard
+
+Claude Code hooks capture tool usage, responses, and agent activity in real-time.
+
+**Event flow**: Hook -> Connection Manager -> Monitor Server -> Dashboard
+
+**Dashboard** at `http://localhost:8765/` shows:
+- Tools being used and files being read/written
+- Agent delegations and completions
+- Session timeline and activity feed
+
+**Monitor commands**: `/mpm-monitor start`, `/mpm-monitor stop`, `/mpm-monitor status`
+
+## Available Commands
+
+| Command | Description |
+|---------|-------------|
+| `/mpm` | This guide -- MPM overview and framework reference |
+| `/mpm-help` | Detailed help for MPM commands |
+| `/mpm-init` | Initialize or update a project for MPM |
+| `/mpm-status` | System health and status |
+| `/mpm-doctor` | Run diagnostic checks |
+| `/mpm-config` | Manage configuration |
+| `/mpm-monitor` | Control monitoring server and dashboard |
+| `/mpm-version` | Version information |
+| `/mpm-message` | Cross-project messaging |
+| `/mpm-organize` | Intelligent file consolidation |
+| `/mpm-ticket-view` | Ticketing workflow management |
+| `/mpm-session-pause` | Save session state for later |
+| `/mpm-session-resume` | Resume from paused session |
+| `/mpm-postmortem` | Analyze session errors |
+
+## Cross-Project Messaging
+
+`/mpm-message` sends asynchronous messages between Claude MPM instances running in different projects on the same machine.
+
+- Messages stored in a shared SQLite database at `~/.claude-mpm/messaging.db`
+- Checked periodically: on session start, every 10 commands, every 30 minutes
+- Message types: `task`, `request`, `notification`, `reply`
+- Always use the `MessageService` API or `claude-mpm message` CLI -- never query the database directly
+
+## For Agents: How to Work Within MPM
+
+When you receive a delegated task from PM:
+
+1. **Focus on your delegated task** -- PM handles orchestration and coordination
+2. **Return clear results with evidence**: file paths created/modified, test counts and pass rates, URLs, error details
+3. **Your agent memory is loaded automatically** -- reference it for project-specific conventions and past decisions
+4. **If you need another specialty**, report back to PM with what you need rather than self-delegating
+5. **Track files you create or modify** -- PM will handle git operations and file tracking
+6. **Follow project patterns** -- check your memory and existing code conventions before implementing
+7. **Escalate blockers immediately** -- do not silently fail or produce partial results without explanation

slack_mpm-0.1.1/.claude/skills/mpm-agent-update-workflow/SKILL.md

@@ -0,0 +1,75 @@
+# PM Skill: Agent Update Workflow
+
+## Trigger Patterns
+- "update agent", "fix agent", "improve agent", "modify agent"
+- "change {agent-name} agent", "edit agent instructions"
+- Any request to modify agent behavior
+
+## FUNDAMENTAL RULE: Official vs Custom Agents
+
+### Official MPM Agents (NEVER edit deployed copies)
+**Source**: `~/.claude-mpm/cache/agents/` (from bobmatnyc/claude-mpm-agents repo)
+**Deployed**: `.claude/agents/` - READ-ONLY for official agents
+
+**Detection**: Check if agent exists in `~/.claude-mpm/cache/agents/`
+- If YES → Official agent → Follow Official Agent Workflow
+- If NO → Custom agent → Can edit `.claude/agents/` directly
+
+### Custom/Localized Agents
+- Created specifically for project
+- Can be edited directly in `.claude/agents/`
+- Not part of official MPM agent set
+
+## Official Agent Update Workflow
+
+### Step 1: Identify Agent Source
+```bash
+ls ~/.claude-mpm/cache/agents/  # Find the source file
+```
+
+### Step 2: Update Source
+Edit the agent source in `~/.claude-mpm/cache/agents/{agent-name}.md`
+(or appropriate path based on agent structure)
+
+### Step 3: Rebuild and Redeploy
+Use MPM deployment tools:
+```bash
+# Redeploy specific agent
+mpm agents deploy {agent-name}
+
+# Or redeploy all agents
+mpm agents deploy --all
+```
+
+### Step 4: Validate (claude-mpm project only)
+When working in the claude-mpm project itself:
+```bash
+# Run deepeval against deployed agent instructions
+deepeval test --agent {agent-name}
+```
+
+## Circuit Breaker
+
+**BLOCK** if attempting to edit `.claude/agents/{official-agent}.md` directly:
+- Official agents in deployed location are BUILD OUTPUTS
+- Must update source → rebuild → redeploy
+- Violation = architectural breach
+
+## Examples
+
+### ❌ WRONG (Editing deployed official agent)
+```
+Edit: .claude/agents/web-qa.md  # VIOLATION - this is a built output
+```
+
+### ✅ CORRECT (Updating source and redeploying)
+```
+1. Edit: ~/.claude-mpm/cache/agents/web-qa.md  # Update source
+2. Run: mpm agents deploy web-qa                # Rebuild/redeploy
+3. Validate: deepeval test --agent web-qa       # (in claude-mpm project)
+```
+
+### ✅ CORRECT (Custom agent - can edit directly)
+```
+Edit: .claude/agents/my-custom-agent.md  # OK - not an official agent
+```

slack_mpm-0.1.1/.claude/skills/mpm-bug-reporting/SKILL.md

@@ -0,0 +1,269 @@
+---
+name: pm-bug-reporting
+version: "1.0.0"
+description: Bug reporting protocol for PM and agents to file GitHub issues
+when_to_use: Framework bugs, agent errors, skill content errors detected
+category: pm-workflow
+tags: [bug-reporting, github, issues, pm-required]
+---
+
+# PM Bug Reporting Protocol
+
+## When to Report Bugs
+
+Report bugs when you encounter:
+- **PM instruction errors** or missing guidance
+- **Agent malfunction** or incorrect behavior
+- **Skill content errors** or outdated information
+- **Framework crashes** or unexpected behavior
+- **Missing or incorrect documentation**
+- **Configuration errors** or invalid defaults
+
+## GitHub Repositories
+
+Route bugs to the correct repository:
+
+| Bug Type | Repository | Owner/Repo |
+|----------|------------|------------|
+| Core MPM (CLI, startup, config, orchestration) | claude-mpm | bobmatnyc/claude-mpm |
+| Agent bugs (wrong behavior, errors, missing capabilities) | claude-mpm-agents | bobmatnyc/claude-mpm-agents |
+| Skill bugs (wrong info, outdated, missing content) | claude-mpm-skills | bobmatnyc/claude-mpm-skills |
+
+### External System Bug Routing
+
+**Decision tree:**
+- Bug in MPM startup/config/delegation → `bobmatnyc/claude-mpm`
+- Bug in agent behavior → `bobmatnyc/claude-mpm-agents`
+- Bug in skill content → `bobmatnyc/claude-mpm-skills`
+- Bug in external system (installed via setup) → That system's GitHub repo
+
+**External systems installed via `claude-mpm setup`:**
+- `kuzu-memory` → File issue at kuzu-memory's GitHub
+- `mcp-vector-search` → File issue at mcp-vector-search's GitHub
+- `slack-user-proxy` → File issue at slack-user-proxy's GitHub
+- `google-workspace-mpm` → File issue at google-workspace-mpm's GitHub
+- Other MCP servers → Check their GitHub repos
+
+**Examples:**
+- "Vector search returns no results" → mcp-vector-search repo
+- "Kuzu memory fails to persist" → kuzu-memory repo
+- "PM fails to delegate" → claude-mpm repo
+- "Research agent crashes" → claude-mpm-agents repo
+
+## Bug Report Template
+
+When creating an issue, include:
+
+### Title
+Brief, descriptive title (50 chars max)
+- ✅ "PM delegates to non-existent agent"
+- ✅ "Research skill missing web search examples"
+- ❌ "Bug in system"
+- ❌ "Fix this"
+
+### Labels
+Always include:
+- `bug` (required)
+- `agent-reported` (required)
+- Additional context labels:
+  - `high-priority` - Critical functionality broken
+  - `documentation` - Documentation error
+  - `agent-error` - Agent-specific issue
+  - `skill-error` - Skill content issue
+
+### Body Structure
+```markdown
+## What Happened
+[Clear description of the bug]
+
+## Expected Behavior
+[What should have happened]
+
+## Steps to Reproduce
+1. [First step]
+2. [Second step]
+3. [Third step]
+
+## Context
+- Agent: [agent name if applicable]
+- Skill: [skill name if applicable]
+- Error Message: [full error if available]
+- Version: [MPM version if known]
+
+## Impact
+[How this affects users/workflow]
+```
+
+## Using gh CLI
+
+### Prerequisites Check
+```bash
+gh auth status
+```
+
+If not authenticated:
+```bash
+gh auth login
+```
+
+### Creating Issues
+
+**Delegate to ticketing agent** with:
+```
+Task:
+  agent: ticketing
+  task: Create GitHub issue for [bug type]
+  context: |
+    Repository: bobmatnyc/claude-mpm[-agents|-skills]
+    Title: [brief title]
+    Labels: bug, agent-reported
+    Body: |
+      ## What Happened
+      [description]
+
+      ## Expected Behavior
+      [expected]
+
+      ## Steps to Reproduce
+      1. [step 1]
+      2. [step 2]
+
+      ## Context
+      - Agent: [agent name]
+      - Error: [error message]
+
+      ## Impact
+      [impact description]
+```
+
+## Examples
+
+### Core MPM Bug
+```
+Task:
+  agent: ticketing
+  task: Create GitHub issue for core MPM bug
+  context: |
+    Repository: bobmatnyc/claude-mpm
+    Title: PM fails to load configuration on startup
+    Labels: bug, agent-reported, high-priority
+    Body: |
+      ## What Happened
+      PM fails to initialize when configuration.yaml contains invalid syntax.
+      No clear error message shown to user.
+
+      ## Expected Behavior
+      PM should display clear YAML syntax error with line number and fix suggestion.
+
+      ## Steps to Reproduce
+      1. Add invalid YAML to .claude-mpm/configuration.yaml
+      2. Run `mpm`
+      3. Observe generic error without details
+
+      ## Context
+      - Component: Configuration loader
+      - Error: "Failed to load configuration"
+      - Version: 5.4.x
+
+      ## Impact
+      Users cannot diagnose configuration errors, requiring manual YAML validation.
+```
+
+### Agent Bug
+```
+Task:
+  agent: ticketing
+  task: Create GitHub issue for agent bug
+  context: |
+    Repository: bobmatnyc/claude-mpm-agents
+    Title: Research agent fails to search with special characters
+    Labels: bug, agent-reported, agent-error
+    Body: |
+      ## What Happened
+      Research agent throws error when search query contains quotes or special chars.
+
+      ## Expected Behavior
+      Search queries should be properly escaped and executed.
+
+      ## Steps to Reproduce
+      1. Delegate to research: "Search for 'React hooks'"
+      2. Research agent attempts search
+      3. Error: "Invalid search query"
+
+      ## Context
+      - Agent: research
+      - Error: grep command fails with unescaped quotes
+
+      ## Impact
+      Cannot search for quoted phrases or technical terms with special characters.
+```
+
+### Skill Bug
+```
+Task:
+  agent: ticketing
+  task: Create GitHub issue for skill content error
+  context: |
+    Repository: bobmatnyc/claude-mpm-skills
+    Title: Git workflow skill contains outdated branch strategy
+    Labels: bug, agent-reported, documentation, skill-error
+    Body: |
+      ## What Happened
+      Skill recommends `git flow` branching model, which project no longer uses.
+      Current standard is trunk-based development.
+
+      ## Expected Behavior
+      Skill should document current trunk-based workflow.
+
+      ## Context
+      - Skill: git-workflow.md
+      - Section: "Branching Strategy"
+      - Line: 45-60
+
+      ## Impact
+      Agents follow outdated branching model, creating workflow friction.
+```
+
+## Escalation Path
+
+When ticketing agent is unavailable or gh CLI fails:
+
+1. **Log locally** for manual reporting:
+   ```
+   echo "[BUG] $(date): [description]" >> .claude-mpm/logs/bugs.log
+   ```
+
+2. **Report to PM** for alternative action:
+   ```
+   PM should create ticket in primary ticketing system (Linear/JIRA)
+   with note to create GitHub issue once available
+   ```
+
+3. **User notification**:
+   ```
+   "Bug detected: [description]. Logged for manual GitHub issue creation."
+   ```
+
+## Success Criteria
+
+Bug reporting successful when:
+- ✅ Issue created in correct repository
+- ✅ All required labels applied (`bug`, `agent-reported`)
+- ✅ Body follows template structure
+- ✅ Title is clear and concise
+- ✅ Context includes agent/skill name if applicable
+- ✅ Issue URL returned for tracking
+
+## PM Enforcement
+
+PM MUST:
+- Detect bugs during agent interactions
+- Delegate bug reporting to ticketing agent
+- NOT attempt to create GitHub issues directly
+- Follow escalation path if ticketing unavailable
+- Log all bug reports for audit trail
+
+## Related Skills
+- [pm-ticketing-integration.md](pm-ticketing-integration.md) - Ticket delegation patterns
+- [pm-delegation-patterns.md](pm-delegation-patterns.md) - General delegation guidance
+- [ticketing-examples.md](ticketing-examples.md) - Ticketing delegation examples