pi-shipshape

Pi package for the Shipshape context-isolated spec-driven development workflow.

Packages

Package details

extension

Install pi-shipshape from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-shipshape
Package
pi-shipshape
Version
0.2.0
Published
Jun 17, 2026
Downloads
1,383/mo · 1,383/wk
Author
dk
License
0BSD
Types
extension
Size
12.6 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./adapters/pi-extension.ts"
  ]
}

Security note

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

README

Estelle

A Shipshape-native coding agent CLI that runs Pi with Shipshape skills, context controls, model policy, and extension wiring.

What Estelle does

  • Runs as a Pi extension inside normal conversational Pi chat
  • Starts in Captain mode — the only role that talks to the user
  • Automatically transitions to QM/Crew/Bosun with enforced context isolation
  • Constrains role tool permissions (Captain can't edit code, QM can't edit specs, etc.)
  • Installs Shipshape skills and a subagent extension so QM can spawn Crew
  • Provides init and doctor CLI commands for setup and health checks

Quick start

npx estelle init --yes --json
npx estelle

Shipshape workflow

Estelle implements the Shipshape spec-driven development workflow:

  1. Captain — human-facing discovery, durable specs, and role transitions
  2. QM — fresh-context verification from specs only (no Captain chat leakage)
  3. Crew — focused implementation of one failing target
  4. Bosun — repo hygiene, verification recheck, local commit custody

Only Captain talks to the user. Internal roles run automatically with constrained tools and isolated context.

Configuration

npx estelle init creates:

  • .estelle/config.json
  • .estelle/context-policy.json
  • .estelle/model-policy.json
  • .estelle/extensions.json

License

BSD Zero Clause License (0BSD)