pds

Portable Development System

A Claude Code plugin. Skills for consistency. Agents for scale. Install once, works across all projects.

PDS is deployed as a Claude Code plugin — skills, agents, hooks, and security settings. Install it to ~/.claude/plugins/pds/. Claude reads it, follows it, improves it.

---

Quick Start

Install via marketplace (recommended)

Inside Claude Code:

/plugin marketplace add rmzi/portable-dev-system
/plugin install pds@pds-marketplace

Restart Claude Code. PDS skills and agents are now available across all projects.

Install via script

curl -sfL https://raw.githubusercontent.com/rmzi/portable-dev-system/main/install.sh | bash

Installs the plugin to ~/.claude/plugins/pds/ and security settings to ~/.claude/settings.json.

Upgrading from v3.x?

Clean up old project-level files:

cd ~/your-project
curl -sfL https://raw.githubusercontent.com/rmzi/portable-dev-system/main/install.sh | bash -s -- --cleanup

See Migration Guide for details.

Requirements

• Claude Code (CLI, desktop, or IDE extension)
• jq — used by hooks and pattern detection (brew install jq / apt install jq)
• python3 — used by install script and hook scripts for JSON processing (brew install python3 / apt install python3)

Dev mode

git clone https://github.com/rmzi/portable-dev-system.git
cd portable-dev-system
make install    # symlinks this checkout as the plugin

---

Skills (15)

Skill	Purpose
/pds:swarm	Multi-agent team workflow (6-phase SDLC, lite/med/heavy tiers, branch merging)
/pds:team	Agent roster, coordination, and dispatch modes
/pds:grill	Requirement interrogation
/pds:verify	Completion self-check
/pds:finish	Branch completion protocol (includes quick ship)
/pds:worktree	Git worktree workflow
/pds:contribute	Contributing to PDS itself
/pds:bugfix	Test-first bug fix loop
/pds:bump	Version and changelog
/pds:eval	Skill evaluation and testing
/pds:rebase	Focused branch rebase
/pds:pr-review	Address PR review comments
/pds:pause	Save session state, WIP commit, resume later
/pds:triage	Triage insights into GitHub issues across repos
/pds:explore	Structural codebase queries via codebase-memory-mcp index (falls back to Grep)

---

Agents (8)

Agent	Role	Model	Mode
orchestrator	Coordination — plans, decomposes, dispatches	opus	default
researcher	Deep codebase exploration	sonnet	plan
worker	Implementation in isolated worktrees	sonnet	acceptEdits
validator	Merge, test, verify acceptance criteria	sonnet	acceptEdits
reviewer	Code review — quality, security	sonnet	plan
documenter	Documentation updates	sonnet	acceptEdits
scout	PDS meta-improvements	haiku	acceptEdits
auditor	Codebase quality -> GitHub issues	sonnet	plan

Full agent docs ->

---

Plugin Structure

portable-dev-system/
├── .claude-plugin/plugin.json     # Plugin manifest
├── agents/                        # 8 agent definitions + shared-rules.md
├── skills/                        # 15 skills (dir/SKILL.md format)
│   ├── swarm/SKILL.md
│   ├── team/SKILL.md
│   └── ...
├── hooks/hooks.json               # Hook event handlers (see below)
├── hooks/scripts/                 # Hook implementation scripts
├── scripts/                       # Utility scripts (detect-patterns, efficiency-chart)
├── docs/                          # Philosophy, whitepaper, team setup, source analysis
├── .claude/settings.json          # Security settings (installed separately)
├── install.sh                     # Plugin installer
├── Makefile                       # make install
├── VERSION
└── CHANGELOG.md

Hook Events

PDS registers handlers for the following Claude Code hook events: