reality-verification

Reproduce and validate software fixes by capturing BEFORE and AFTER states.

432|40|Updated Jan 11, 2026
One-click install
npx skills add https://github.com/tzachbon/smart-ralph --skill reality-verification
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reality-verification
Source: https://github.com/tzachbon/smart-ralph/tree/main/plugins/ralph-specum/skills/reality-verification
Command: npx skills add https://github.com/tzachbon/smart-ralph --skill reality-verification

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Reproduce and validate software fixes by capturing BEFORE and AFTER states and documenting the verification steps to ensure changes resolve the issue without introducing regressions.

Core Features & Use Cases

  • Guided diagnosis and failure reproduction for bug fixes and feature changes.
  • BEFORE/AFTER state documentation in a standardized .progress.md file to support audit trails.
  • VF Task format scaffolding to structure verification steps, evidence, and completion criteria.

Quick Start

Use the reality-verification skill to verify a fix by logging BEFORE state, applying the change, and validating AFTER results with automated or manual checks.

Frequently Asked Questions about reality-verification

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

FAQPage Schema
How do I verify a software fix by capturing before and after states?

To verify a software fix, capture the BEFORE state, apply the change, and validate the AFTER results using automated or manual checks. This BEFORE/AFTER comparison confirms the issue is resolved without introducing regressions.

What is the best way to document bug fix reproduction steps for an audit trail?

Document bug fix reproduction steps and verification evidence in a standardized .progress.md file. This records the BEFORE/AFTER states and VF task formats to ensure changes are verifiable and auditable across QA pipelines.

How do I structure regression verification tasks for CI pipelines?

Structure regression verification tasks using the VF task format, which scaffolds verification steps, evidence collection, and completion criteria. This ensures changes are validated consistently across CI pipelines and feature validations.

Can I use this approach for both automated checks and manual QA validations?

Yes, this approach supports both automated checks and manual QA validations. You log the BEFORE state, apply the fix, and then validate the AFTER results using whichever testing method suits the regression verification scenario.

When do I need to use VF task formats for issue diagnosis?

You need VF task formats for issue diagnosis when you require guided failure reproduction and standardized evidence documentation. This ensures verifiable, auditable verification for bug fixes and feature changes.

Why should I use before-after state documentation instead of standard testing logs?

Before-after state documentation provides a structured audit trail in a .progress.md file, whereas standard testing logs may lack context. This method explicitly maps failure reproduction to resolution, ensuring verifiable regression verification.