Compound Engineering for Pi

Compound Engineering adapted for Pi. This package keeps Pi users close to the evolving Compound Engineering workflow while preserving Pi-native runtime behavior where Claude Code assumptions do not map 1:1.

Install

pi install npm:compound-engineering-pi -l

Reload your session, then you're ready:

/reload

Quick start

Open Pi in your repo and use either Pi-native colon commands or latest upstream CE hyphen commands:

• /ce:brainstorm or /ce-brainstorm
• /ce:plan or /ce-plan
• /ce:work or /ce-work
• /ce:review, /ce-review, or /ce-code-review
• /ce:compound or /ce-compound

Legacy workflows:* aliases remain available for compatibility.

What's included

Canonical CE commands for Pi

• /ce:ideate
• /ce:brainstorm
• /ce:plan
• /ce:work
• /ce:review
• /ce:compound
• /ce:compound-refresh
• /deepen-plan
• /test-browser / /ce-test-browser
• /feature-video / /ce-demo-reel
• /todo-resolve
• /todo-triage
• /resolve-pr-feedback / /ce-resolve-pr-feedback
• /reproduce-bug
• /report-bug-ce / /ce-report-bug
• /onboarding
• /ce:changelog / /ce-release-notes
• /git-commit / /ce-commit
• /git-commit-push-pr / /ce-commit-push-pr
• /test-xcode / /ce-test-xcode
• /lfg
• /slfg

Synced specialist skills and agents

This package tracks upstream Compound Engineering 3.11.1 content, currently bundling generated Pi skills plus generated Pi subagent definitions for review, research, design, workflow automation, git workflows, and more. A few Pi compatibility skills and Pi-owned reviewer agents remain for local compatibility and enhanced Pi review coverage.

Pi compatibility layer

The package ships Pi-specific compatibility tools for migrated CE flows:

• ask_user_question
• subagent
• mcporter_list
• mcporter_call
• mcpb_inspect
• mcpb_import
• mcpb_export

Pi-native runtime behavior

This repo intentionally keeps some behavior package-owned instead of relying only on converted prompts:

• canonical /ce:* command routing inside Pi
• Pi-native review target resolution and todo handling
• workflow provenance and handoff context
• reproducible subagent wrapper generation for Pi environments
• latest upstream ce-* naming while keeping Pi-friendly /ce:* aliases

Optional: MCP support via MCPorter and MCPB

For MCP runtime interoperability, install MCPorter:

npm i -g mcporter

For MCP bundle packing/validation, install the MCPB CLI when you need mcpb_export packing:

npm i -g @anthropic-ai/mcpb

mcpb_import does not run imported servers automatically; it unpacks into ~/.pi/agent/mcpb/ and writes a MCPorter config entry for later verification with mcporter_list.

Community contribution

This repo is not trying to fork Compound Engineering philosophically. The goal is narrower and more useful:

• keep Pi users close to the latest upstream Compound Engineering skill graph
• preserve Pi-native runtime behavior where Claude Code assumptions do not map 1:1
• make canonical /ce:* commands feel first-class inside Pi
• keep subagent aliases and wrapper generation reproducible instead of hand-maintained

Keeping this repo current

Typical refresh flow:

1. Sync upstream CE Pi-target skills and agents into skills/ and agents/
2. Keep Pi-owned runtime files current:
   • extensions/workflow-commands.ts
   • extensions/review-runtime.ts
   • extensions/workflow-context.ts
   • src/workflow-context.ts
   • scripts/generate-agent-wrappers.mjs
3. Regenerate global wrappers:
   • npm run agents:generate
4. Verify wrapper aliases are current:
   • npm run agents:check
   • This must keep bare reviewer names such as security-sentinel, performance-oracle, agent-native-reviewer, and learnings-researcher available for the Pi review runtime.
5. Smoke test interactively in Pi:
   • /ce:brainstorm
   • /ce:plan
   • /ce:review

Credits

Built on the Compound Engineering plugin by Every and Kieran Klaassen. Read the original writeup.

License

MIT