plan-collab

# Plan-Collab: Collaborative Plan Review

A web interface for reviewing and commenting on Claude's implementation plans. Users can select text and add inline comments (like Google Docs), answer questions in a dedicated panel, and track plan versions.

## When to Use

Use this skill when:
- Entering plan mode to create detailed implementation plans
- User wants to review and comment on plans
- You need structured user feedback on implementation approaches
- Creating complex multi-step plans that benefit from user review

## Quick Start

### 1. Start Server and Open Plan

```bash
# Start the web server (finds available port automatically)
cd ~/.claude/skills/plan-collab/scripts
node cli.js start-server

# Open a plan in the browser
node cli.js open-plan ~/.claude/plans/my-feature.md
```

### 2. Get User Feedback

After user has reviewed and added comments:

```bash
# Fetch pending comments and answers
node cli.js get-feedback
```

Output:
```json
{
  "planPath": "~/.claude/plans/my-feature.md",
  "planName": "my-feature",
  "pending": {
    "comments": [
      {
        "selectedText": "use Redis for caching",
        "comment": "Can we use Memcached instead?",
        "status": "OPEN"
      }
    ],
    "answers": []
  },
  "summary": {
    "totalComments": 1,
    "openComments": 1,
    "pendingComments": 1
  }
}
```

### 3. Check Status

```bash
node cli.js status
```

## Server Management

### IMPORTANT: Always Check Status First

Before starting the server, ALWAYS check if it's already running:

```bash
node cli.js status
```

**If server is running** (response shows `"running": true`):
- DO NOT run `start-server` - use the existing instance
- Note the URL from the response (e.g., `http://localhost:3847`)
- Proceed directly to `open-plan`

**If server is not running** (response shows `"running": false`):
- Run `node cli.js start-server`

> **Note:** The `start-server` command is idempotent - if the server is already running, it returns `{"status": "already_running