One-click install
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill ship-release
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ship-release
Source: https://github.com/CleanExpo/Pi-Dev-Ops/tree/main/skills/ship-release
Command: npx skills add https://github.com/CleanExpo/Pi-Dev-Ops --skill ship-release

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill prevents incomplete or low-quality pipeline outcomes from being shipped by enforcing required build artifacts and a non-negotiable review score threshold.

Core Features & Use Cases

  • Release gating with a hard quality threshold: blocks shipping unless review-score.json reports overall_score >= 8.
  • Pre-ship validation across pipeline phases: verifies spec.md, plan.md, build completion via session_id.txt, passing tests via test-results.json, and that the plan contains no open blockers.
  • Auditable ship-log output: generates a structured success/failure JSON payload and produces a deterministic rollback reference for git reverts.
  • Operational closure: updates the Linear ticket to Done, appends a ship pattern entry to .harness/lessons.jsonl, and records the ship item in the next board meeting agenda.

Quick Start

Run the ship-release Skill for a pipeline id (for example RA-548) and stop shipping when the review score is below 8/10.

Frequently Asked Questions about ship-release

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I block a CI/CD pipeline from shipping code with a low review score?

To block a CI/CD pipeline from shipping code with a low review score, use a release gating mechanism that checks for a non-negotiable score threshold. This Skill halts deployment unless the review score is 8 or higher and all required pipeline artifacts are validated.

What is release gating in continuous delivery and how does it validate pipeline outputs?

Release gating in continuous delivery is a safeguard that validates required pipeline outputs before allowing deployment. It verifies the presence of spec, plan, build session, and test result files, explicitly failing the release if any required artifact is missing or incomplete.

How do I generate an auditable rollback command and ship-log for a failed release gate?

To generate an auditable rollback command and ship-log for a failed release gate, the release process emits a structured JSON payload upon failure. This output includes a deterministic rollback reference for git reverts and metadata for updating the Linear ticket.

Can I automatically update a Linear ticket to Done only after passing tests and pipeline validation?

Yes, you can automatically update a Linear ticket to Done after passing tests and pipeline validation. The release process verifies test-results.json and build completion, then updates the ticket status to Done and appends a ship pattern entry to lessons.jsonl upon success.

Does release gating work without checking for open blockers in the plan?

No, release gating does not work without checking for open blockers in the plan. A core validation requirement ensures the plan.md file contains no open blockers before shipping, failing the pipeline gate if any unresolved blockers are detected.

What happens when a continuous delivery pipeline fails the review score threshold?

When a continuous delivery pipeline fails the review score threshold, the process stops shipping and outputs an explicit gate failure JSON. This structured failure payload provides the necessary audit trail and prevents the deployment from proceeding.