harness-engineering-deliberation

Orchestrates multi-agent deliberation to pre-validate engineering decisions against five quality pillars.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? High-stakes engineering changes—core engine modifications, breaking API contracts, cross-workspace refactors—often ship without rigorous pre-validation against reliability, scalability, security, observability, and maintainability, leading to production incidents and costly rework. ## Core Features & Use Cases - PGE Iterative Refinement: A Planner-Generator-Evaluator loop produces and critiques architectural proposals against a Sprint Contract with explicit acceptance criteria, capped at 3 iterations. - Council Mode with Harness Delegates: Three isolated delegates (Alpha for Reliability, Beta for Scalability, Gamma for Security/Observability) submit proposals, conduct anonymous peer review, debate disagreements, and reach ACK-ALL consensus with veto and override rules. - Harness Verification Gate: An explicit five-pillar checklist (reliability, scalability, security, observability, maintainability) must pass before final output, with transcripts persisted to .git/.orchestration/harness/. - Token Ring Mode: For ambiguous requirements, a token circulates among delegates until a full cycle produces no changes, signaling emergent consensus. - Use Case: When asked to "harness the best approach for real-time state sync," the skill runs the pge-council pipeline: Alpha proposes a WebSocket/polling hybrid, Beta challenges concurrency at scale, Gamma mandates per-room trace logging, and the gate confirms all five pillars pass before delivery. ## Quick Start Ask the assistant to run a harness deliberation on your proposed architecture for a core engine change, such as "harness this new matching algorithm design before I implement it."

Frequently Asked Questions about harness-engineering-deliberation

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

FAQPage Schema
How do I run a multi-agent engineering design review before implementation?▼

Trigger the deliberation with phrases like "harness this" or "engineering quality gate" alongside your design task. The protocol spawns three isolated delegates covering reliability, scalability, and security/observability, then runs peer review, debate, and consensus before producing a final plan.

What is the difference between pge-council, council-only, and token-ring modes?▼

pge-council runs a Planner-Generator-Evaluator refinement loop before the council phase and is the default. council-only skips the PGE loop for well-defined tasks. token-ring circulates a shared state among delegates when requirements are too ambiguous to form a Sprint Contract.

When should I not use a full deliberation protocol for code changes?▼

Skip it for single-domain bug fixes under 50 lines, copy or styling changes, documentation-only updates, and tasks one specialist clearly owns with no pillar risk. The protocol is designed for high-blast-radius or novel changes, not routine edits.

How does the Harness Verification Gate handle a failing pillar?▼

Any CONCERN or FAIL on the five-pillar checklist sends the proposal back to the debate phase with that pillar as the topic. A delegate veto can only be overridden with 2/3 consensus, written justification, risk acceptance, and a documented mitigation.

What happens if delegates cannot reach consensus during deliberation?▼

If any delegate responds NACK during the consensus poll, the objection becomes a new debate topic and the process loops back. Persistent disagreement escalates to a human with dissents documented in the transcript, and token-ring mode caps at 5 cycles before escalating.