ship-spec

Automate PRD generation and draft PR creation by triggering a spec scaffolding pipeline that generates prd.md and prd.json from a feature description. It enforces required file contracts, runs dual critics for risk assessment, and gates PR readiness via evaluation and audit.

Spec scaffolding is the process of automatically structuring formal feature plans into required file contracts and PRD artifacts. You need it when a feature requires formal planning, critique, and wiki alignment before opening a draft PR.

Run a critique loop on a feature spec by applying dual critics that surface risks and alignment issues. The pipeline orchestrates a Ralph loop and gates readiness through evaluation and a pr-audit before transitioning the PR from draft to ready.

Ship-spec integrates with git-workflow and tmux to manage the end-to-end PR pipeline. It leverages these dependencies to orchestrate wiki alignment checks, DeepWiki comparison, and the undraft to ready flow after gated evaluation passes.

You can enforce wiki alignment checks during PRD scaffolding. The pipeline orchestrates wiki alignment and DeepWiki comparison alongside dual critics to ensure the generated prd.md and prd.json match existing documentation before drafting a PR.