three-stage-eval

Evaluate artifacts against seed specifications with mechanical, semantic, and consensus checks.

23|4|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/marlandoj/zouroboros --skill three-stage-eval
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: three-stage-eval
Source: https://github.com/marlandoj/zouroboros/tree/main/packages/workflow/docs/three-stage-eval
Command: npx skills add https://github.com/marlandoj/zouroboros --skill three-stage-eval

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Ensures implemented artifacts meet their seed specifications by providing a repeatable, gated evaluation pipeline that catches mechanical issues, semantic mismatches, and unresolved high-stakes disagreements before merge or deployment.

Core Features & Use Cases

  • Mechanical Verification: Run syntax, lint, test, and coverage checks to catch immediate build and quality failures.
  • Semantic Evaluation: Map artifact outputs to acceptance criteria, gather evidence, compute AC compliance and an overall score, and quantify drift.
  • Consensus Review: Trigger a multi-perspective deliberation (Proposer, Devil's Advocate, Synthesizer) when scores are borderline or drift is high to reach a 2/3 decision.
  • Use Case: Pre-merge gate for libraries, infrastructure configs, or agent skills to prevent regressions and ensure alignment with spec-first seeds.

Quick Start

Use the three-stage-eval skill to evaluate /path/to/implementation against /path/to/seed.yaml and save the resulting evaluation report to the workspace.

Frequently Asked Questions about three-stage-eval

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

FAQPage Schema
How does a three-stage evaluation pipeline verify code against a seed specification?

A three-stage evaluation pipeline verifies code against a seed specification by running mechanical syntax checks, mapping outputs to acceptance criteria for semantic scoring, and triggering multi-perspective consensus review on borderline scores.

How do I enforce pre-merge verification for infrastructure configurations and documentation?

To enforce pre-merge verification for infrastructure configurations, evaluate the implemented artifacts against a seed specification file to generate deterministic mechanical PASS/FAIL results and quantitative semantic drift metrics before deployment.

What is semantic drift evaluation in the context of release gating?

Semantic drift evaluation in release gating quantifies how far artifact outputs deviate from acceptance criteria. It computes compliance scores and triggers a multi-perspective consensus review when drift metrics are high.

Can I use consensus review for high-stakes code reviews when evaluation scores are borderline?

Yes, you can use consensus review for high-stakes code reviews. When semantic evaluation scores are borderline, it triggers a multi-perspective deliberation involving a Proposer, Devil's Advocate, and Synthesizer to reach a 2/3 decision.

What are the limitations of using mechanical checks for agent output evaluation?

Mechanical checks for agent output evaluation are limited to deterministic syntax, lint, test, and coverage validation. They cannot detect semantic mismatches or resolve high-stakes disagreements, requiring subsequent semantic and consensus stages.

Does the three-stage-eval approach support gap audits for software engineering artifacts?

Yes, the three-stage-eval approach supports gap audits for software engineering artifacts by enforcing coverage thresholds and schema validation during mechanical checks, then mapping outputs to acceptance criteria to quantify semantic drift.