pi-adaptive-dev

A Pi package that bundles the pi-superpowers workflow skills with the Stage-1-validated right-sizing instruction.

You get the full toolkit — 13 workflow skills plus the plan tracker — and one instruction, appended to the system prompt on every agent start, that keeps the toolkit sized to the task:

Right-size the process to the task. Prototype/exploratory work needs only the smallest convincing implementation plus named limitations. Ordinary maintainable changes need targeted tests and fresh verification, not full production ceremony. Reserve comprehensive hardening for consequential or production-facing work. Skip heavyweight workflow phases the delivery claim doesn't need.

Before claiming completion, run the relevant checks and cite fresh evidence.

In a preregistered head-to-head evaluation, superpowers + this instruction matched both the bare-superpowers and full adaptive-architecture arms on every preregistered operand, while halving superpowers' median token burn (182k→104k) — the instruction suppresses package over-compliance. Verdicts and limitations: spikes/eval/stage1/RESULTS.md.

Install

pi install npm:pi-adaptive-dev

Try it without installing:

pi -e npm:pi-adaptive-dev

Or load from a checkout:

pi -e ./path/to/pi-adaptive-dev-rig

Behavior

• extensions/right-sizing.ts uses the documented before_agent_start hook; appends the instruction to the chained system prompt. Idempotent within a prompt chain; no persisted messages, no conversation mutation.
• pi-superpowers is bundled (MIT) and pinned at commit c339ba2. v0.3.0 tunes the core without a broad fork: 11 upstream skills load (writing-skills — 84K of meta-material — and dispatching-parallel-agents — redundant with the pi-subagents package — are excluded in the manifest); brainstorming is vendored in-tree with its always-on description reworded from "You MUST use this before any creative work" to a conditional trigger, so it no longer fights the right-sizing instruction on every prompt. plan-tracker stays in. Update = change the pinned ref and republish.
• Installing this package replaces installing pi-superpowers separately.

Verify

# package contents: extensions/ + bundled node_modules/pi-superpowers
npm pack --dry-run

# loads under Pi with no model spend (control: bogus path exits nonzero)
pi -e . --offline --no-session --mode rpc </dev/null

Licenses

Apache-2.0 (this package) and MIT (pi-superpowers, bundled under node_modules/pi-superpowers/ with its LICENSE).

Repository layout

The npm package is the repo root. Research, decisions, and evaluation corpora live in spikes/ and are not published.