PRD→PR is a local engineering orchestrator. Its primary input is a PRD. The normal workflow is:

prdpr path/to/PRD.md

The engine validates that PRD, creates or locates a project, and drives implementation through a phase graph until the work is verified and delivered. You do not need to run a separate validation command first.

The Go engine is the source of truth. Cursor is an implementation actor. Cursor saying “done” is not verification.

PRD path
→ validate
→ determine project
→ bootstrap
→ graph
→ implement
→ verify
→ repair
→ deliver
→ runtime

This repository is a working V1. Capabilities are not equally complete. See docs/PHASES.md for P0–P13 status (IMPLEMENTED, PARTIAL, PLANNED, OUT OF SCOPE).

Default tests do not call paid LLM APIs or live Cursor.

Released binaries (normal users). Current published release: v0.1.1. Download the artifact for your OS and architecture, verify it against prdpr_0.1.1_checksums.txt, install it as prdpr on your PATH, then run prdpr version (expect 0.1.1) and prdpr doctor. Full steps: docs/USER_GUIDE.md.

From source (contributors / developers):

Requires Go (version in go.mod) and Git.

git clone https://github.com/lanternfold/prd-pr
cd prd-pr
go install ./cmd/prdpr

go install puts the prdpr binary in $GOBIN if set, otherwise $GOPATH/bin, which defaults to $HOME/go/bin. If the shell cannot find prdpr, add that directory to PATH. A checkout install (go install ./cmd/prdpr) reports version dev. A tagged module install (go install github.com/lanternfold/prd-pr/cmd/prdpr@v0.1.1) and GitHub Release binaries report 0.1.1.

Local contributor binary (does not install to PATH):

git clone https://github.com/lanternfold/prd-pr
cd prd-pr
go test ./...
go build -o dist/prdpr ./cmd/prdpr
./dist/prdpr doctor

See docs/DEVELOPER_GUIDE.md. The Cursor plugin does not use dist/prdpr; it requires prdpr on PATH.

1. Install so prdpr is on your PATH (released v0.1.1 for normal users; see above).
2. Check the environment:

prdpr doctor

doctor reports OS, architecture, Go, Git, Cursor editor, Cursor Agent, and GitHub CLI. Missing Git is an error. Missing Cursor or gh is informational.

3. Write a PRD. See docs/PRD_AUTHORING_CONTRACT.md.
4. Run the product:

prdpr path/to/PRD.md

That is the intended entry point: a PRD path. The engine contract-validates the PRD as part of this command, places a Studio project when needed, then prepares the next READY phase.

Optional explicit validation (no project mutation; useful when authoring or debugging a PRD):

prdpr validate-prd path/to/PRD.md

Interactive Cursor: install released prdpr on PATH, load the thin plugin in prdpr-cursor/, then run /prdpr. That is the plugin-first path. CLI-first is prdpr path/to/PRD.md in a shell, then open product_root and implement the packet (or /prdpr there). Headless: prdpr phase (uses cursor-agent). Do not mix interactive and headless paths in one session. validate-prd is optional.

Full walkthrough: docs/USER_GUIDE.md.

Design intent and accepted ADRs remain in ARCHITECTURE.md and ADR/. That document is not a substitute for the implemented flow in docs/FLOW.md.

Report undisclosed vulnerabilities privately. See SECURITY.md. Do not file public GitHub issues for them.

Licensed under the Apache License, Version 2.0. See LICENSE. The Go module path is github.com/lanternfold/prd-pr.