validation-first

Installation
SKILL.md

Validation-First Design

Core Principle: If an Agent Cannot Validate It, It Will Not Be Met

Every spec requirement must include testable acceptance criteria that an agent can automatically verify. This is not optional — it is the foundation that makes SDD work.

Why? AI agents are non-deterministic. Without automated validation, there is no way to know whether an agent's output is correct. Validation gates turn "the agent generated some code" into "the agent generated code that provably meets the specification."

The validation-first rule applies at every level:

  • Spec requirements must have testable acceptance criteria
  • Plans must define which gates verify each task
  • Implementation must pass all applicable gates before being considered complete
  • Iterations must show measurable progress through gates

The Validation Gate Sequence

Every implementation must pass through six ordered checkpoints. Each successive gate is more expensive to run, so catching failures early saves significant time.

Related skills
Installs
14
GitHub Stars
891
First Seen
Apr 9, 2026