# PM-Kit

**Product Management AI Toolkit** - A suite of specialized AI agents and integration tools for modern Product Managers.

PM-Kit connects your AI (Claude Desktop) with your product management stack (Linear, Slack, Google Drive) using the Model Context Protocol (MCP).

## 🚀 Active Tools

### 🛠️ Core PM Agents
These agents use a built-in knowledge base of product management best practices.

| Tool Name | Agent Role | Use Case |
|-----------|------------|----------|
| `pm_discover` | Discovery | User research, problem analysis, interviews |
| `pm_strategy` | Strategy | PRDs, vision docs, risk assessment |
| `pm_prioritize` | Prioritization | RICE scoring, backlog refinement |
| `pm_roadmap` | Roadmap | Milestone planning, release timelines |
| `pm_mvp` | MVP Scoping | Scoping minimum viable features |
| `pm_metrics` | Metrics | Defining KPIs and success criteria |
| `pm_consult` | Handbook | Consult the handbook to pick the right agent |

### 📋 Agent Cheat Sheet (Natural Language)
You can trigger these agents in Claude using natural language.

| Agent | Command Trigger | Use Case |
|-------|-----------------|----------|
| **Product Discovery** | "Discover...", "Research..." | Analyzing user problems, interviews |
| **Strategy** | "Create strategy...", "Vision..." | Drafting PRDs, strategy docs |
| **Prioritization** | "Prioritize...", "Rank backlog..." | RICE scoring, ordering tasks |
| **Roadmap** | "Create roadmap...", "Plan Q1..." | Timeline planning |
| **MVP Scoping** | "Define MVP...", "Scope..." | Defining minimum viable features |
| **Metrics** | "Define metrics...", "KPIs..." | Success criteria |

### 🔌 Integration Tools
Direct actions for your workspace.

| Tool Name | Integration | Description |
|-----------|-------------|-------------|
| `linear_create_issue` | Linear | Create tickets/issues directly |
| `linear_update_issue` | Linear | Update title, description, or priority |
| `linear_delete_issue` | Linear | Permanently remove an issue |
| `linear_get_projects` | Linear | List all active projects |
| `linear_create_project` | Linear | Start a new project with description |
| `linear_update_project` | Linear | Update project name or description |
| `linear_delete_project` | Linear | Archive a project |
| `linear_get_documents` | Linear | List all workspace documents |
| `slack_send_message` | Slack | Post messages to any channel |
| `slack_get_channels` | Slack | List available public channels |

---

## 🛠️ Setup Guide (Local Mode)

The most stable way to run PM-Kit is locally on your machine.

### 1. Requirements
- **Node.js**: v18+ (verified on v22)
- **Claude Desktop**

### 2. Integration API Keys

#### Linear API Key
1. Go to [linear.app/settings](https://linear.app/settings) → **Security & access**
2. Create a **"Personal API key"**.

#### Slack Bot Token
1. Go to [api.slack.com/apps](https://api.slack.com/apps) → Create an App → From Scratch.
2. In **"OAuth & Permissions"**, add `chat:write` and `channels:read` scopes.
3. Install to workspace and copy the **"Bot User OAuth Token"** (`xoxb-`).

### 3. Claude Desktop Configuration

Open your Claude Desktop config file:
- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
- **Mac**: `~/Library/Application Support/Claude/claude_desktop_config.json`

Add the following (update the path to match your local installation):

```json
{
  "mcpServers": {
    "pm-kit": {
      "command": "c:/Visual Code Projects/PM-kit/run_local.bat",
      "args": [],
      "env": {
        "LINEAR_KEY": "lin_api_YOUR_LINEAR_KEY",
        "SLACK_TOKEN": "xoxb-YOUR_SLACK_TOKEN"
      }
    }
  }
}
```

### 4. Apply Changes
1. **Quit Claude Desktop** (Right-click in system tray → Quit).
2. **Restart** Claude Desktop.
3. You should now see the `pm-kit` tools in the bottom bar!

---

## 🏗️ Development

### Local Build
```bash
npm install
npm run build
```

### Test Scripts
```bash
# Verify connection to Linear/Slack
npm run test:integrations
```

---

## 📄 License
MIT