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.