What problem does it solve? Pull requests often go out with non-compliant titles, missing spec or plan references, no traceability to requirements, and no review verdict, making them unverifiable and hard to audit. This Skill enforces a gated, step-by-step PR creation workflow so every PR is spec-linked, plan-linked, commit-msg compliant, and review-verified before it reaches GitHub. ## Core Features & Use Cases - Pre-flight Gates: Verifies a clean working tree, up-to-date branch, passing build and tests, and commit-msg.sh compliant commits before proceeding. - Spec and Plan Enforcement: Blocks PR creation unless a spec file with a valid spec_id and a plan file are provided, then auto-extracts requirement IDs and the north-star metric. - Auto-Traceability: Greps the diff for @spec_id and @req_id annotations, builds a traceability table, and flags missing annotations as gaps that force a draft PR. - Review Verdict Consumption: Reads the review summary written by the finishing-a-development-branch workflow and maps MERGE READY, NEEDS WORK, or BLOCKED verdicts to ready, draft, or stop outcomes. - Use Case: After finishing a feature branch, run the Skill to generate a compliant title and WHY-focused body, validate them against commit-msg.sh, assign CODEOWNERS-based reviewers, and create the PR with gh pr create as draft or ready. ## Quick Start Create a pull request for my current branch using the pr-creator workflow, linking it to the spec and plan in the .ai directory.
