sdd-validate

Validates an implemented development cycle against its tasks, scenarios, and runtime evidence.

1|Updated Jul 26, 2026
One-click install
npx skills add https://github.com/AngeloResplandes/harness-sdd --skill sdd-validate-angeloresplandes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: sdd-validate
Source: https://github.com/AngeloResplandes/harness-sdd/tree/main/sdd-validate
Command: npx skills add https://github.com/AngeloResplandes/harness-sdd --skill sdd-validate-angeloresplandes

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes assets (resource) components.

What problem does it solve? It prevents unverified or incomplete work from being promoted into the canonical spec by acting as an independent checkpoint that judges claims against actual evidence rather than trusting checked boxes or code that merely looks right. ## Core Features & Use Cases - Evidence-based validation: Judges each scenario in scenarios.feature against verification.md, automated tests, or confirmed manual checks, marking anything unproven as NÃO VERIFICADO. - Test discipline audit: Detects deleted, skipped, or loosened tests via git diff, verifies scenario-to-test coverage, and checks TDD ordering when the plan requires it. - Actionable fail loop: On failure, writes concrete correction tasks into tasks.md with an incremented attempt counter so implementation can resume without deadlock. - Use Case: After a cycle's tasks are all checked and verification.md exists, run validation to produce validation.md with a pass/fail result before promoting the spec. ## Quick Start Ask the assistant to validate the current cycle by saying "valida o ciclo" once all tasks except the promote task are checked and verification.md exists.

Frequently Asked Questions about sdd-validate

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

FAQPage Schema
How do I validate a development cycle before promoting its spec?

Run the validation phase once every task in tasks.md is checked except the final promote task and verification.md exists. It judges each scenario against runtime evidence and writes validation.md with a pass or fail result.

What happens when cycle validation fails?

A fail writes the gaps as a new Corrections section in tasks.md, unchecks any tasks that were not truly complete, and hands the cycle back to implementation. The cycle never moves forward to promotion on a fail.

Can validation run without a verification.md file?

No. A missing verification.md means the cycle was never observed running, so the verification phase must run first. Validation judges evidence and never starts servers or drives browsers itself.

How does validation detect skipped or weakened tests?

It compares the cycle against its branch point using git diff, looking for deleted test files, added skip or only markers, and removed assertions. Any hit is recorded as a gap regardless of the original justification.

What are the limitations of the validation phase?

It never writes inside the spec directory, never fixes the failures it finds, and never re-runs browsers or servers to close evidence gaps. Those actions belong to the promote, implement, and verify phases respectively.