Skip to content

[Extension]: Add Verify Review Ship #3429

Description

@cadugevaerd

Extension ID

verify-review-ship

Extension Name

Verify Review Ship

Version

0.1.0

Description

Adds post-implementation verify, review, and ship readiness gates to Spec Kit workflows.

Author

Carlos Eduardo Gevaerd Araujo

Repository URL

https://github.com/cadugevaerd/spec-kit-verify-review-ship

Download URL

https://github.com/cadugevaerd/spec-kit-verify-review-ship/archive/refs/tags/v0.1.0.zip

License

MIT

Homepage (optional)

https://github.com/cadugevaerd/spec-kit-verify-review-ship

Documentation URL (optional)

https://github.com/cadugevaerd/spec-kit-verify-review-ship/blob/main/README.md

Changelog URL (optional)

https://github.com/cadugevaerd/spec-kit-verify-review-ship/blob/main/CHANGELOG.md

Required Spec Kit Version

=0.1.0

Required Tools (optional)

None. The extension contains Markdown command prompts, one optional lifecycle hook, and a configuration template.

Number of Commands

3

Number of Hooks (optional)

1

Tags

quality, review, shipping, workflow, testing

Key Features

  • /speckit.verify-review-ship.verify: verifies implementation completeness against Spec Kit artifacts and project gates after /speckit.implement.
  • /speckit.verify-review-ship.review: runs a structured five-axis review covering correctness, readability, architecture, security, and performance.
  • /speckit.verify-review-ship.ship: synthesizes verification and review evidence into a GO/NO-GO readiness decision with rollback planning.
  • Optional after_implement hook prompts users to run the verify gate after implementation.
  • Config template supports project-specific gate commands and policy defaults.

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

Tested on:

  • Linux container with Spec Kit installed via uvx --from git+https://github.com/github/spec-kit.git
  • Spec Kit initialized with Hermes integration
  • Release archive URL: https://github.com/cadugevaerd/spec-kit-verify-review-ship/archive/refs/tags/v0.1.0.zip

Test project:

  • Temporary throwaway Spec Kit project under /tmp/spec-kit-vrs-remote-test

Test scenarios:

  1. Initialized a fresh Spec Kit project with:
    uvx --from git+https://github.com/github/spec-kit.git specify init . --integration hermes --ignore-agent-tools --script sh
  2. Installed the extension from the release archive with:
    specify extension add verify-review-ship --from https://github.com/cadugevaerd/spec-kit-verify-review-ship/archive/refs/tags/v0.1.0.zip
  3. Confirmed .specify/extensions/.registry registered version 0.1.0.
  4. Confirmed all commands and aliases were registered for the Hermes integration:
    • speckit.verify-review-ship.verify
    • speckit.verify-review-ship.v
    • speckit.verify-review-ship.review
    • speckit.verify-review-ship.r
    • speckit.verify-review-ship.ship
    • speckit.verify-review-ship.s
  5. Verified the remote raw extension.yml is accessible.
  6. Downloaded the GitHub release archive and computed SHA-256:
    08af97697c6d73b1c1b927ded8cd77869e40a7379a50a5e1ea8e253e9da57bb4
  7. Ran a local secret-pattern scan over extension source files. Hits were only documentation/prompt text references to secrets; no credentials or hardcoded tokens were found.

Example Usage

# Install extension from release archive
specify extension add verify-review-ship \
  --from https://github.com/cadugevaerd/spec-kit-verify-review-ship/archive/refs/tags/v0.1.0.zip

# Typical Spec Kit flow
/speckit.implement
/speckit.verify-review-ship.verify
/speckit.verify-review-ship.review
/speckit.verify-review-ship.ship

Proposed Catalog Entry

{
  "verify-review-ship": {
    "name": "Verify Review Ship",
    "id": "verify-review-ship",
    "description": "Adds post-implementation verify, review, and ship readiness gates to Spec Kit workflows.",
    "author": "Carlos Eduardo Gevaerd Araujo",
    "version": "0.1.0",
    "download_url": "https://github.com/cadugevaerd/spec-kit-verify-review-ship/archive/refs/tags/v0.1.0.zip",
    "sha256": "08af97697c6d73b1c1b927ded8cd77869e40a7379a50a5e1ea8e253e9da57bb4",
    "repository": "https://github.com/cadugevaerd/spec-kit-verify-review-ship",
    "homepage": "https://github.com/cadugevaerd/spec-kit-verify-review-ship",
    "documentation": "https://github.com/cadugevaerd/spec-kit-verify-review-ship/blob/main/README.md",
    "changelog": "https://github.com/cadugevaerd/spec-kit-verify-review-ship/blob/main/CHANGELOG.md",
    "license": "MIT",
    "requires": {
      "speckit_version": ">=0.1.0"
    },
    "provides": {
      "commands": 3,
      "hooks": 1
    },
    "tags": [
      "quality",
      "review",
      "shipping",
      "workflow",
      "testing"
    ],
    "verified": false,
    "downloads": 0,
    "stars": 0,
    "created_at": "2026-07-09T00:00:00Z",
    "updated_at": "2026-07-09T00:00:00Z"
  }
}

Additional Context

This extension is inspired by Addy Osmani's agent-skills Verify/Review/Ship workflow concepts and adapts them to the Spec Kit extension system using only broadly supported primitives: Markdown command files, extension.yml, an optional after_implement hook, and a config template.

It does not depend on any external subagent registry. If an agent supports subagents/tools, the ship command can ask it to run review/security/test passes in parallel; otherwise the command instructs the agent to perform those passes sequentially and label each report.

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions