pw

Parallel Workflow Plugin

A Claude Code plugin for parallel development environments using Git worktree and tmux.

Overview

Maximizes development efficiency by decomposing large development tasks into multiple independent subtasks and executing them in parallel.

Key Features

• Issue-Driven Design: Automatically generate implementation designs from GitHub Issues
• Task Decomposition: Split large tasks into parallelizable subtasks
• Parallel Worker Management: Provide independent work environments with Git worktree and tmux
• Integrated Review: Support for PR review, merge, and cleanup
• Fast Exploration: High-speed code exploration via Haiku model subagents

Installation

1. Place the Plugin

Clone from GitHub. The plugin can be placed in any directory:

# Clone to any directory
cd /path/to/any-directory
git clone https://github.com/ken2403/claude-paralell-dev-plugin.git

Example layout:

/opt/claude-plugins/
└── claude-paralell-dev-plugin/   # This plugin

2. Set the Environment Variable

Add PW_PLUGIN_DIR to your shell profile so that plugin scripts (e.g. base branch detection) are always discoverable:

# Add to ~/.zshrc (or ~/.bashrc)
echo 'export PW_PLUGIN_DIR="/path/to/any-directory/claude-paralell-dev-plugin"' >> ~/.zshrc
source ~/.zshrc

3. Enable the Plugin in Claude Code

Method A: Register as Marketplace (Recommended)

Registering the plugin as a Marketplace makes it available in any project:

# Add the plugin as a Marketplace
claude plugin marketplace add /path/to/any-directory/claude-paralell-dev-plugin

# Install the plugin
claude plugin install pw@claude-parallel-dev-plugin

Method B: Specify at Launch

To use only in a specific session, launch Claude Code with the --plugin-dir option:

cd your-project
claude --plugin-dir /path/to/any-directory/claude-paralell-dev-plugin

4. Place CLAUDE.md in Your Project (Recommended)

cp ../claude-paralell-dev-plugin/examples/CLAUDE.project-template.md ./CLAUDE.md
# Edit to fit your project

Usage

Workflow

This plugin supports three workflows:

A. Parallel Execution Workflow (For Large Tasks)

Receive spec → Design (with decomposition) → Parallel execution → Review → Merge → Cleanup

Use this when decomposing into multiple subtasks and executing in parallel with tmux.

B. Worktree Job Workflow (For Independent Tasks)

Issue/Task → wt-j → (Autonomous implementation) → Review → Merge → Cleanup

Use this when autonomously implementing independent tasks in an isolated environment.

C. Agent Teams Workflow (Experimental)

Issue/Task → at-design → at-j → at-rv → at-fix → at-resolve-conflicts → merge → wt-clean

Or for quick in-place implementation without worktree:

Task → at-impl → (review changes) → commit

Uses Claude Code's experimental Agent Teams feature for multi-agent parallel execution. Requires CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1.

Command List

Command	Description	Arguments
/pw:design	Create design and decompose tasks from spec	#issue-number / @file-reference / "text"
/pw:orchestrate	Launch parallel workers	List of branch names
/pw:worker	Execute worker task	Task description
/pw:wt-j	Autonomous implementation in isolated worktree (parallel for 3+ files)	#issue-number / "task description" [--feature|--fix]
/pw:wt-clean	Clean up wt-j environment	job-name / --all
/pw:status	Check progress	(Optional) session name
/pw:precheck	Pre-check before PR creation	Branch name or HEAD
/pw:rv	Review PR (critical)	PR number
/pw:fix	Fix review feedback (parallel for 3+ files)	Feedback content
/pw:merge	Merge PR	PR number [--skip]
/pw:cleanup	Clean up environment	List of branch names
/pw:resolve-conflicts	Resolve conflicts (parallel for 3+ files)	Branch name
/pw:at-design	Agent team spec discussion and task decomposition	#issue-number / @file-reference / "text"
/pw:at-j	Agent team implementation in isolated worktree	#issue-number / "task description" [--feature|--fix]
/pw:at-rv	Agent team parallel PR review (3 specialists)	PR number
/pw:at-fix	Agent team parallel review feedback fixes	PR number
/pw:at-impl	Agent team implementation in current directory	#issue-number / @design-document / "task description"
/pw:at-resolve-conflicts	Agent team parallel conflict resolution	Branch name

Examples

1. Implement from GitHub Issue

# Design (includes task decomposition)
/pw:design #123

# Launch parallel workers
/pw:orchestrate feature/auth feature/api feature/tests

# Check progress
/pw:status

# PR review
/pw:rv 45

# Merge
/pw:merge 45