PM33 CLI installer

Install PM33 in one command

Drops PM33's harness agents, the gauntlet-review skill, the long-running-agent framework, and a starter CLAUDE.md into your local Claude Code. Idempotent — re-run anytime to update.

your shell
curl -fsSL https://pm-33.com/install/pm33-init.sh | bash

Tested on macOS and Linux. Requires curl and tar. The script writes only to ~/.claude/ and ~/pm33-frameworks/ — never root, never sudo.

Prefer to clone + inspect first? Browse the public repo on GitHub — git-clone + ./install.sh is an equivalent path.

How the skills compound

Each bundled skill is a load-bearing checkpoint — skipping any one is how harnesses fail. The workflow runs end-to-end:prep→ plan→ review→ coordinate→ execute.

The lower band of the diagram lists, per skill, the failure mode when it's skipped. Click to enlarge; switch site theme to see the dark/light variant.

What gets installed

Three directories. ~50 KB total. The bundle is hosted at pm-33.com/install/pm33-bundle.tar.gz — feel free to inspect it before piping the script to bash.

~/.claude/agents/ · PM33 harness roles
  • harness-coordinator.md
    Orchestrates multi-session harness work. Delegates to specialists; never writes code.
  • harness-planner-agent.md
    Breaks 16+ hour projects into phased tasks with TDD plans.
~/.claude/agents/ · Specialist agents (from wshobson/agents, MIT)
  • ai-engineer.md
    Production LLM apps, advanced RAG, multimodal AI, agent orchestration.
  • api-documenter.md
    OpenAPI 3.1, AI-powered docs, SDK generation, developer portals.
  • backend-architect.md
    Scalable APIs, microservices, REST/GraphQL/gRPC, distributed systems.
  • code-reviewer.md
    AI-assisted code review, security vulnerabilities, performance, production reliability.
  • database-admin.md
    PostgreSQL ops, schema design, RLS policies, performance tuning.
  • frontend-developer.md
    React 19, Next.js 15, accessibility, responsive layouts, state management.
  • performance-engineer.md
    OpenTelemetry, load testing, Core Web Vitals, multi-tier caching.
  • security-auditor.md
    OWASP, OAuth2/OIDC, threat modeling, GDPR/HIPAA/SOC2 compliance.
  • test-automator.md
    AI-powered test automation, self-healing tests, CI/CD integration.
  • ui-ux-designer.md
    Design systems, wireframes, design tokens, inclusive design.
~/.claude/skills/
  • pm33-mcp/
    PM33 MCP tool conventions — load before any pm33_* call. Tool routing, the 9 known gaps (5000-char description cap, score_alignment is keyword-only, MCP intermittent disconnect), batch-creation patterns, queue-and-execute fallback.
  • harness-prep/ ★ Phase 0
    Orchestrator entry point. Sequences discovery + brainstorming (always) + bounded research (conditional) into one enriched doc that harness-planner consumes. Skipping this is the root cause of 5-10x over-estimates. Requires the superpowers plugin for the brainstorming pass.
  • harness-discovery/
    Internal-audit pass — what already exists in the codebase that the plan can reuse?
  • harness-research/
    Bounded external research (1+3 search budget, hard cap 2+6). Use only when scoping requires outside-codebase context. Decay-tags findings so stale citations don't cargo-cult into future plans.
  • harness-planner/
    Plans the harness from the prepared discovery doc.
  • harness-coordinator/
    Coordinator workflow rules + progress.json patterns.
  • harness-discipline/
    TDD discipline for specialist agents. RED → GREEN → REFACTOR → DELIVERY.
  • gauntlet-review/
    Multi-specialist adversarial spec review (backend, security, performance, AI engineer, etc.) before implementation.
  • feature-enhancements/
    Pending-feature triage + readiness assessment workflow.
~/pm33-frameworks/
  • HARNESS_PROJECT_TEMPLATE.md
    Section-by-section template for a new harness project.
  • LONG_RUNNING_AGENT_FRAMEWORK.md
    The full framework reference (long read).
  • HARNESS_TASK_DEFINITION_TEMPLATE.json
    Per-task JSON skeleton.
  • CLAUDE.md.starter
    Starter PM33-aware CLAUDE.md fragment for your project root.

After install — 4 steps

~5 minutes from install to running your first harness-planned project.

  1. 1
    Restart Claude Code

    Newly installed agents and skills load on the next session start.

  2. 2
    Install the superpowers plugin

    Required for harness-prep's brainstorming pass. In Claude Code: /plugin marketplace add anthropics/claude-plugins-official then /plugin install superpowers. Without it, harness-prep skips brainstorming and warns — usable but degraded.

  3. 3
    Connect the PM33 MCP server

    Type /mcp in Claude Code → pick "claude.ai PM33" → complete the OAuth flow in your browser. The mcp__pm33-staging__pm33_* tools become available immediately. Before your first pm33_* call in any session, say "load the pm33-mcp skill" — that loads the conventions (tool routing, known gaps, queue-and-execute fallback).

  4. 4
    Copy the starter CLAUDE.md into your project

    cp ~/pm33-frameworks/CLAUDE.md.starter ./CLAUDE.md, then edit. Adds PM33 conventions (harness discipline, gauntlet review, MCP tracking) to every session in that project.

  5. 5
    Try the harness flow

    On a non-trivial project: say "prep a harness for this" — harness-prep sequences discovery + brainstorming + (conditional) research. Then "plan the harness" — harness-planner consumes the prep doc. For multi-session execution, say "resume as coordinator".

Before you pipe to bash

Inspect the script first (recommended)

Open it in your browser, read the source, then run it once you're happy.

pm-33.com/install/pm33-init.sh

Inspect the bundle contents

Download and list before extracting:

curl -fsSLO https://pm-33.com/install/pm33-bundle.tar.gz
tar -tzf pm33-bundle.tar.gz

Uninstall

rm -rf ~/.claude/agents/{harness-coordinator,harness-planner-agent,ai-engineer,api-documenter,backend-architect,code-reviewer,database-admin,frontend-developer,performance-engineer,security-auditor,test-automator,ui-ux-designer}.md \
       ~/.claude/agents/LICENSE.wshobson \
       ~/.claude/skills/{pm33-mcp,harness-prep,harness-research,harness-coordinator,harness-discipline,harness-discovery,harness-planner,gauntlet-review,feature-enhancements} \
       ~/pm33-frameworks

New to the PM33 harness framework? Read the 25-minute walkthrough in the curriculum.