[Extension]: Add Pull Request Workflow #5261

Extension ID

pr

Extension Name

Pull Request Workflow

Version

4.7.6

Description

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.

Author

Samy K. Abushanab

Repository URL

https://github.com/samykabu/sanduq

Download URL

https://github.com/samykabu/sanduq/releases/download/pr-v4.7.6/pr.zip

License

MIT

Homepage (optional)

https://github.com/samykabu/sanduq/tree/main/extensions/pr

Documentation URL (optional)

https://github.com/samykabu/sanduq/blob/main/docs/extensions/pr.md

Changelog URL (optional)

https://github.com/samykabu/sanduq/blob/main/extensions/pr/CHANGELOG.md

Required Spec Kit Version

=0.2.0

Required Tools (optional)

• git (optional)
• gh (optional)
• python >=3.11 (required)
  Extensions: illustrate >=2.0.0,<3.0.0, assure >=2.0.0,<3.0.0, user-manual >=1.0.0,<3.0.0 (all published in the same catalog, https://raw.githubusercontent.com/samykabu/sanduq/main/catalog.json)

Number of Commands

2

Number of Hooks (optional)

1

Tags

pull-request, github, code-review, documentation

Key Features

• Writes or updates the pull request description from the feature's spec, plan, tasks and recorded checks, with diagrams rendered inline.
• Checks that installed QA and User Manual documentation is current before it touches the PR.
• Works through review feedback: classifies unresolved comments, proposes a fix and reply plan, and applies it only after approval.

Testing Checklist

• Extension installs successfully via download URL
• All commands execute without errors
• Documentation is complete and accurate
• No security vulnerabilities identified
• Tested on at least one real project

Submission Requirements

• Valid extension.yml manifest included
• README.md with installation and usage instructions
• LICENSE file included
• GitHub release created with version tag
• All command files exist and are properly formatted
• Extension ID follows naming conventions (lowercase-with-hyphens)

Testing Details

Exercised through Sanduq Workflow live runs on Claude Code, each opening a pull request. Unit tests (52) run in CI. Codex has not been run end to end with it yet.

Example Usage

/speckit-pr-generate --feature specs/412-refund-approval Update the PR with behavior, verified checks and diagrams.
/speckit-pr-review-feedback example-org/booking-app#438 Classify the open feedback and show me the plan first.

Proposed Catalog Entry

{
  "pr": {
    "name": "Pull Request Workflow",
    "id": "pr",
    "version": "4.7.6",
    "description": "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.",
    "author": "Samy K. Abushanab",
    "repository": "https://github.com/samykabu/sanduq",
    "homepage": "https://github.com/samykabu/sanduq/tree/main/extensions/pr",
    "documentation": "https://github.com/samykabu/sanduq/blob/main/extensions/pr/README.md",
    "changelog": "https://github.com/samykabu/sanduq/blob/main/extensions/pr/CHANGELOG.md",
    "download_url": "https://github.com/samykabu/sanduq/releases/download/pr-v4.7.6/pr.zip",
    "license": "MIT",
    "category": "process",
    "effect": "read-write",
    "requires": {
      "speckit_version": ">=0.2.0",
      "extensions": [
        {
          "id": "illustrate",
          "version": ">=2.0.0,<3.0.0",
          "required": true
        },
        {
          "id": "assure",
          "version": ">=2.0.0,<3.0.0",
          "required": false
        },
        {
          "id": "user-manual",
          "version": ">=1.0.0,<3.0.0",
          "required": false
        }
      ],
      "tools": [
        {
          "name": "git",
          "required": false
        },
        {
          "name": "gh",
          "required": false
        },
        {
          "name": "python",
          "required": true,
          "version": ">=3.11"
        }
      ]
    },
    "provides": {
      "commands": 2,
      "hooks": 1
    },
    "tags": [
      "pr",
      "changelog",
      "documentation",
      "diagram",
      "sequence",
      "flowchart",
      "state-machine",
      "data-model",
      "review",
      "feedback",
      "code-review",
      "workflow"
    ],
    "verified": false,
    "created_at": "2026-07-09T20:26:15Z",
    "updated_at": "2026-10-31T00:31:18.471788+00:00",
    "sha256": "49f6748401af098d9c6d654e3deb0e8a7174a330c009133cf03864c1e5824681"
  }
}

Additional Context

One of the Sanduq extensions (https://github.com/samykabu/sanduq), all MIT. The full set is also published in its own catalog: https://raw.githubusercontent.com/samykabu/sanduq/main/catalog.json. The ids scope and memory from the same repository are not submitted because the community catalog already has unrelated extensions with those ids.