harness-completion-gate

Validates code changes against five engineering quality pillars before task sign-off.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Teams often declare implementation tasks complete without a consistent quality check, letting reliability, security, or observability issues slip into production. This Skill enforces a mandatory five-pillar verification gate (Reliability, Scalability, Security, Observability, Maintainability) on every code change before sign-off. ## Core Features & Use Cases - Automated Gate Script: Run npm run harness:gate to evaluate the git diff against the five pillars, producing a JSON report with exit codes 0 (pass), 1 (fail), or 2 (concerns). - Canonical Pillar Checklist: A single source of truth in references/harness-pillars.md defines PASS / CONCERN / FAIL criteria shared with code-review and process-verification-gate workflows. - Sprint Contract Awareness: Cross-checks diffs against active sprint contracts, tagging findings with criterion IDs like REL-01 or SEC-02. - Use Case: After finishing a feature branch, an engineer runs the gate, fixes all blocking findings, documents concerns in the turn summary, and includes the harnessVerdict map in the agent turn summary before routing to QA. ## Quick Start Ask the agent to run the harness completion gate on the current changes and report the five-pillar verdict before marking the task done.

Frequently Asked Questions about harness-completion-gate

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

FAQPage Schema
How do I run a pre-ship quality check on code changes?▼

Run `npm run harness:gate` to evaluate the current git diff against five pillars: reliability, scalability, security, observability, and maintainability. The script outputs a JSON report and exits 0 for pass, 1 for blocking failures, or 2 for non-blocking concerns.

What are the 5 pillars of the Harness Engineering Framework?▼

The five pillars are Reliability, Scalability, Security, Observability, and Maintainability / Architecture Fit. Each pillar has a checklist in references/harness-pillars.md, and every pillar is evaluated as PASS, CONCERN, or FAIL, with any FAIL blocking completion.

When should the harness completion gate not be used?▼

Skip the gate for purely research or planning tasks with no code changes, and during pre-implementation phases where sprint contract evaluation is the appropriate tool instead. The gate is designed specifically for verifying finished implementation work.

How does the gate handle non-blocking concerns?▼

Concerns produce exit code 2 and never hard-fail the gate or auto-eval, but they must be documented in the turn summary with a mitigation plan. In auto-eval, a concern verdict maps to a module pass with the concern surfaced as a minor finding.

Can the gate check changes against a sprint contract?▼

Yes. If a sprint contract exists at .git/.orchestration/sprints/sprint-contract.{taskId}.md, the gate cross-checks the diff against the contract's pillar criteria and tags findings with criterion IDs such as REL-01 or SEC-02.