process-verification-gate

Validates completed work against five engineering pillars before merging pull requests.

Updated Dec 24, 2025
One-click install
npx skills add https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1 --skill process-verification-gate-joyjoin-tech-limited
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: process-verification-gate
Source: https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1/tree/main/.github/skills/process-verification-gate
Command: npx skills add https://github.com/JoyJoin-Tech-Limited/JoyJoin_app_v0.1 --skill process-verification-gate-joyjoin-tech-limited

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams often ship code that "works on my machine" but fails in production due to unchecked reliability, security, or observability gaps. This Skill enforces a structured pre-merge verification so no task is marked done without passing explicit quality gates. ## Core Features & Use Cases - Five-Pillar Verification: Evaluates Reliability, Scalability, Security, Observability, and Maintainability with PASS / CONCERN / FAIL verdicts and one-line justifications. - Lane-Specific Validation: Adds tailored checks depending on the delivery lane used (HRC, DM, Kickoff, or Direct), such as Sprint Contract acceptance criteria or micro-plan-to-diff matching. - Ship / No-Ship Decision: Produces an explicit verdict — SHIP, SHIP WITH NOTE, or BLOCK — with escalation rules for failed checks. - Use Case: Before merging a PR that adds a refund webhook handler, run the gate to discover a missing idempotency key and retry policy, resulting in a BLOCK verdict until fixed. ## Quick Start Ask the AI to run the pre-ship verification gate on your current changes before merging the pull request.

Frequently Asked Questions about process-verification-gate

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

FAQPage Schema
How do I verify a pull request is ready to merge?

Run a structured pre-merge checklist that evaluates reliability, scalability, security, observability, and maintainability. Mark each pillar PASS, CONCERN, or FAIL with a one-line justification, then apply the ship or no-ship decision rules before merging.

What should a pre-ship checklist for software include?

A pre-ship checklist should cover the five engineering pillars: reliability, scalability, security, observability, and maintainability. It should also add lane-specific checks, such as acceptance criteria for contract-driven work or micro-plan-to-diff matching for direct delivery.

When should I skip the full verification checklist?

Skip the full gate only for trivial changes like a one-line typo fix that already passed guardrails and typecheck. For small direct-delivery tasks, you may evaluate only the pillars that touch the changed files and note N/A for the rest.

What happens when a verification check fails before merge?

Any FAIL verdict, or more than two CONCERNs, blocks the merge until the issue is fixed. If the work followed the HRC lane, the failure is escalated to the Harness Runtime Controller for re-evaluation before proceeding.

Can I merge with minor concerns found during verification?

Yes, if all pillars pass and only one or two minor CONCERNs exist, you can merge with a SHIP WITH NOTE verdict. Document each concern in the PR description and create a follow-up ticket for the mitigation.