verification-planning

Plans evidence paths for verifying non-trivial code changes before implementation.

Updated Feb 25, 2026
One-click install
npx skills add https://github.com/voiddreamz/dotfiles --skill verification-planning-voiddreamz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verification-planning
Source: https://github.com/voiddreamz/dotfiles/tree/main/.config/opencode/skills/verification-planning
Command: npx skills add https://github.com/voiddreamz/dotfiles --skill verification-planning-voiddreamz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-trivial code changes often ship without a credible way to prove they work, leaving teams guessing whether a feature, bug fix, or refactor actually behaves as claimed. This Skill structures the upfront planning of how a change will be verified, so conclusions rest on evidence rather than assumption. ## Core Features & Use Cases - Evidence Path Design: Frames the claim being made, then derives project-specific ways to establish, limit, or refute it using the system's inputs, outputs, state transitions, and boundaries. - Verification Budgeting: Assigns one owner per distinct claim and selects the minimum non-duplicative evidence that covers claims and important boundaries. - Verification Affordances: Defines the smallest capability (hooks, test fixtures, diagnostic surfaces) needed to make relevant state controllable, observable, and repeatable. - Use Case: Before refactoring a payment retry mechanism, use this Skill to define exactly which behaviors must stay true, what evidence will prove the retry logic still works, and what temporary instrumentation is needed to observe failures directly. ## Quick Start Ask the agent to plan a verification approach for your upcoming feature or refactor before writing any implementation code.

Frequently Asked Questions about verification-planning

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

FAQPage Schema
How do I plan verification before implementing a code change?▼

Start by framing the exact claim your change must make true, then derive evidence paths from the system's controllable inputs, observable effects, and state transitions. Choose the path that produces a trustworthy conclusion with proportionate cost before writing implementation code.

What is an evidence path in software verification?▼

An evidence path is a project-specific route from a claim about system behavior to evidence that can establish, limit, or refute it. It is derived from the system's boundaries, invariants, artifacts, and ability to repeat or reverse a scenario rather than from a familiar testing technique.

When should I use verification planning versus just running tests?▼

Use verification planning for non-trivial work like features, refactors, or cross-system changes where the right evidence is not obvious. Small mechanical changes can follow ordinary project checks directly without a dedicated planning step.

What is a verification affordance and when do I need one?▼

A verification affordance is the smallest capability that makes relevant system state controllable, observable, repeatable, and diagnosable. Create one when the existing system leaves the decisive truth too indirect or ambiguous, and decide deliberately whether it is temporary or durable.

How do I avoid over-testing or duplicating verification effort?▼

Set a verification budget: state the distinct claims, assign one owner per claim, and choose the minimum non-duplicative evidence covering claims and boundaries. Reuse evidence only while its relevant code, inputs, environment, and state remain valid.