aidd-eval

Automate AIDD evaluation harness execution and generate audit reports.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/GrinRus/ai_driven_dev_v2 --skill aidd-eval
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aidd-eval
Source: https://github.com/GrinRus/ai_driven_dev_v2/tree/main/.agents/skills/aidd-eval
Command: npx skills add https://github.com/GrinRus/ai_driven_dev_v2 --skill aidd-eval

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Manually running evaluation scenarios for ai_driven_dev_v2 (AIDD) is time-consuming, error-prone, and often produces inconsistent, non-inspectable audit records. This Skill eliminates that overhead by providing a standardized, governed workflow for executing eval harnesses, validating stage outputs against document contracts, and producing durable, reproducible audit artifacts for both deterministic and manual eval lanes.

Core Features & Use Cases

  • Standardized Eval Execution: Run deterministic fixture-seed scenarios in CI or manual environments, and manual live authored-task-pool scenarios for real-world runtime testing.
  • Document Contract Validation: Automatically check all AIDD stage output Markdown files against predefined contracts to catch formatting, content, and structural errors before they propagate.
  • Comprehensive Evidence Capture: Preserve raw runtime logs, normalized events, validator reports, repair history, and question/answer events for full auditability of every eval run.
  • Use Case Example: If your team is testing AIDD's self-repair behavior after validator failures, use this Skill to run the scenario, capture all runtime evidence, and generate a standardized audit report with a clear execution verdict without manual data collection.

Quick Start

Use the aidd-eval skill to run the sqlite-utils live E2E scenario against the OpenCode runtime and generate a full audit report with validator outcomes and failure analysis.

Frequently Asked Questions about aidd-eval

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

FAQPage Schema
How do I automate AIDD evaluation harness execution and stage validation?

Automate AIDD evaluation harness execution by running standardized workflows that validate stage outputs against document contracts. This eliminates manual test orchestration and ensures consistent artifact collection across both deterministic fixture-seed and manual live authored-task-pool eval lanes.

What is the best way to validate document contracts in ai_driven_dev_v2 stage outputs?

Validate document contracts by automatically checking all AIDD stage output Markdown files against predefined rules. This process catches formatting, content, and structural errors before they propagate, ensuring stage outputs strictly comply with the framework's specified contracts.

How does runtime log capture work for AIDD self-repair behavior testing?

Runtime log capture works by preserving raw logs, normalized events, validator reports, and repair history during eval runs. This comprehensive evidence capture ensures full auditability of self-repair behaviors by separating infrastructure failures from model or document contract violations.

Can I use aidd-eval for both deterministic fixture-seed scenarios and manual live tasks?

Yes, you can use it for both deterministic fixture-seed scenarios in CI environments and manual live authored-task-pool scenarios for real-world runtime testing. It supports all AIDD runtimes, providing standardized execution verdicts and failure analysis across both eval lane types.

Why do I need durable audit artifacts for AI software delivery framework evaluations?

Durable audit artifacts are needed to separate infrastructure failures from model or document contract violations during analysis. They provide reproducible, inspectable evidence including runtime logs and validator outcomes, replacing inconsistent manual data collection with a standardized execution verdict taxonomy.