pr

vworkflow-v2.4.0

Generate or update pull requests from Spec Kit artifacts, enforce installed QA and User Manual freshness policies, then process review feedback through an approval-gated fix and reply workflow.

Community extension — Independently maintained. Use at your own discretion. Learn more

Pull requests (pr)

Purpose: write a feature changelog and a plain-English explanation with diagrams, then create or update the branch's pull request. It also processes review feedback through an approval step.

Lifecycle phaseAfter implement; after review
HooksOne optional after_implement hook (hooks)
Commandsgenerate, review-feedback (reference)
RequiresIllustrate 2.x, enforced by deps.py ensure; Python 3.11 or later; uses Assure and User Manual when installed
StandaloneYes
LicenseMIT

Setup

specify extension add illustrate
specify extension add pr

Git and a signed-in gh are needed to push and to open the pull request.

Example

/speckit-pr-generate --feature specs/412-refund-approval Update the existing PR with behavior, verified checks and readable diagrams.
/speckit-pr-review-feedback example-org/booking-app#438 Classify unresolved feedback and present the fix and reply plan for approval.

Generate writes docs/<feature-slug>/CHANGELOG.md, a feature explanation and diagrams, then updates a marked section of the PR description. Add --no-pr to write the documents only. Two scripts do the fixed parts: pr_changelog.py seeds the changelog from tasks, commits, progress and evidence, and pr_publish.py writes the exact body, lints its closing references, publishes it with gh and prints the receipt fields Workflow checks.

How it runs

PR sequence: pr.generate, or managed Finalize, validates fresh QA and manual evidence and then updates the PR or writes documents only; pr.review-feedback inspects unresolved review comments, you approve a concrete plan, and only then are fixes applied, verified and pushed.

Before it touches the PR, Generate checks QA and manual freshness for the extensions you installed. Review Feedback shows a plan and waits for your approval before it edits, replies, commits, pushes or resolves threads. It posts replies and resolves threads only from the approved plan file, and resolves none until the PR head contains the pushed fixes. In the managed Workflow, Finalize runs Generate. Editable source.

Limits

  • Without git, gh, authentication or a remote, Generate still writes the documents and reports why it skipped the PR.
  • Image checks record how they were done: api on every host, browser when the host has a browser tool.
  • In the managed Workflow, the guard hook refuses a gh pr publish whose body has no matching lint file, and gh pr create from the default branch.
  • The old pr-review extension is retired. Use review-feedback.

Package details: PR README.

Stats

0 stars

Version

workflow-v2.4.0release
Updated 14 days ago

Install

Using the Specify CLI

specify extension add pr --from https://github.com/samykabu/sanduq/releases/download/pr-v4.7.6/pr.zip

Owners

License

MIT