pm-sutra

PM Sutra

Spec. Sign. Ship.

What it is

A product's truth is usually scattered — across chat threads, slide decks, tickets, and people's memory — and none of it can be verified later. PM Sutra is an open-source, PM-run product harness that fixes this by keeping one governed, git-native written record of your product. You, the product manager, own that record. AI does the drafting; you make every product call and sign off on it. Because the record is a git repository, every change has an author, a time, and a history you can read.

Spec. Sign. Ship. — write the spec, sign the decision, ship the product, all against a record you can trust.

This is version 0.0.1, the foundation release. It ships the record core: one command that creates a product's record repository. The work loop — specs, reviews, signatures, and releases — is being built in the open and is not here yet.

Quickstart

Requires Node.js version 20 or newer, and Git.

Once PM Sutra is published to npm you will be able to run it directly:

npx pm-sutra new-product \
  --dir ./my-product-record \
  --name "Acme Notes" \
  --description "A note-taking app for busy teams" \
  --pm "Ada Lovelace" \
  --qa no

Until it is published, install it from a local tarball first — see Install the command for Claude Code for the steps.

new-product takes these options:

pm-sutra new-product
  --dir <path>            where the product record will live (required)
  --name <text>           product name (required)
  --description <text>    what the product is and who it serves (required)
  --pm <name>             product manager; repeatable; at least one (required)
  --qa <yes|no>           whether a QA team exists (required)
  [--arbiter <name>]      optional; must match one --pm name; defaults to the PM
                          when exactly one is given; omitted otherwise
  [--module <name>]       optional, repeatable; flat modules under product/

You get a standalone git repository, already committed on branch main, holding your product's profile, its product tree, and its holdings — ready to grow. See the tutorial for a full walk-through.

Repository map

• engine/ — the portable core and its tests.
• surface/ — the authored activities, agents, playbooks, and templates.
• installer/ — per-runtime adapters that wire PM Sutra into a host, Claude Code first.
• hooks/ — hooks that run around the work.
• evals/ — end-to-end checks that prove the shipped command works; a first-class quality signal, kept top-level.
• docs/ — tutorials, how-to guides, reference, and explanation.
• examples/ — worked examples.

Documentation

• Tutorials — start with Create your first product record.
• How-to guides — get a specific job done.
• Reference — the precise details of every command.
• Explanation — how PM Sutra fits together, and the decisions behind it.

Status

0.0.1 is the foundation release: the record core only. It creates the product record and nothing more. The work loop — specs, reviews, signatures, and releases — is being built in the open and will arrive in later releases.

License

MIT.