edd

Runs eval-driven tests to validate agent context changes against behavioral assertions.

7|2|Updated Mar 5, 2026
One-click install
npx skills add https://github.com/AndurilCode/craftwork --skill edd-andurilcode
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: edd
Source: https://github.com/AndurilCode/craftwork/tree/main/skills/edd
Command: npx skills add https://github.com/AndurilCode/craftwork --skill edd-andurilcode

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

EDD (Eval-Driven Development) prevents regressions when you change an agent’s context by requiring evidence that the harness assertions improve outcomes, not just that things “seem better.”

Core Features & Use Cases

  • Behavioral regression assertions for context: Turn expectations about how the agent should act, stay safe, and produce structured output into pass/fail criteria.
  • Eval-driven iteration loop: Run a baseline, change one context variable, re-evaluate across representative cases, and block progress on regressions.
  • Stochasticity-aware scoring: Run multiple trials and use pass-rate thresholds to reduce noise from non-deterministic model outputs.
  • Simplification (deadwood pruning): Remove non-load-bearing instructions after green runs to lower token cost and improve signal.

Quick Start

Use edd when you are iterating on a prompt/harness that you expect to run repeatedly and you need to confirm whether your context change improved or regressed agent behavior.

Frequently Asked Questions about edd

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

FAQPage Schema
How do I prevent regressions when iterating on agent prompts and context?

Prevent regressions in agent context iteration by running an eval loop driven by pre-written assertions, establishing a baseline, and blocking progress whenever test cases fail. This requires evidence that harness modifications improve measurable behavior rather than just seeming better.

What is eval-driven development for agent harnesses?

Eval-driven development for agent harnesses is a validation process that runs an evaluation loop with pre-written assertions to prove context changes measurably improve agent behavior. It applies to iterative system prompt, tool definition, retrieval strategy, and instruction-structure modifications.

How do I handle stochasticity when evaluating non-deterministic agent outputs?

Handle stochasticity in agent evaluation by running multiple repeated trials and using pass-rate thresholds to reduce noise from non-deterministic model outputs. This stochasticity-aware scoring ensures your behavioral regression assertions remain reliable across representative test cases.

Can I simplify my system prompt after passing all behavioral regression assertions?

Yes, you can simplify your system prompt after passing behavioral regression assertions by pruning deadwood instructions. Removing non-load-bearing instructions after green runs lowers token cost and improves signal while maintaining the validated agent behavior.

Does eval-driven development work for testing retrieval strategy modifications?

Yes, eval-driven development works for testing retrieval strategy modifications by applying the eval loop to iterative changes in your agent context. It validates whether retrieval strategy updates improve outcomes across multiple representative test cases and repeated stochastic runs.

When should I not use eval-driven development for prompt engineering?

You should not use eval-driven development for prompt engineering when you are not iterating on a prompt or harness that you expect to run repeatedly. It requires defining discriminating assertions, establishing a baseline, and changing one variable at a time, making it unsuitable for rapid, non-repeated testing.