Empirical Validation

Enforce empirical proof with documented evidence before marking changes complete.

Updated Aug 7, 2025
One-click install
npx skills add https://github.com/hGriff0n/velopitt --skill empirical-validation-hgriff0n
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Empirical Validation
Source: https://github.com/hGriff0n/velopitt/tree/main/.agent/skills/empirical-validation
Command: npx skills add https://github.com/hGriff0n/velopitt --skill empirical-validation-hgriff0n

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Validation without evidence leads to risk; this Skill enforces empirical proof before task completion.

Core Features & Use Cases

  • Validation Methods by Change Type: UI Changes require Screenshot showing expected visual state, API Endpoints require Command showing correct response, Build/Config require Successful build or test output, Data Changes require Query showing expected data state, File Operations require File listing or content verification.

Quick Start

Run the empirical validation workflow and append the evidence to .agent/state/JOURNAL.md.

Frequently Asked Questions about Empirical Validation

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

FAQPage Schema
How do I require empirical proof before marking a code change as complete?

To require empirical proof, enforce a validation protocol that mandates documented evidence before task completion. You must capture screenshots, command outputs, or query results and append them to a state journal file to verify changes.

What validation evidence do I need for different types of software changes?

Validation evidence varies by change type: UI changes require screenshots, API endpoints require command responses, build updates require successful test output, data edits require query results, and file operations require listing or content verification.

How do I document verification evidence for quality assurance?

Document verification evidence by running the validation workflow and appending captured outputs directly to a state journal file. This establishes a chronological record of empirical proof, satisfying quality assurance requirements for task completion.

Does empirical validation work for both frontend UI and backend API updates?

Empirical validation works for both frontend and backend updates. It enforces screenshots showing expected visual states for UI changes and commands showing correct responses for API endpoints, ensuring comprehensive coverage across your stack.

When should I use enforced validation protocols in my development workflow?

Use enforced validation protocols when completing changes across UI, API, build, data, or file operations to mitigate risk. It prevents marking tasks complete without empirical proof, ensuring every modification has documented evidence.