verification-planning

Plans project-specific evidence paths to verify non-trivial code changes.

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

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 verification planning so every change has a concrete, project-specific evidence path before implementation begins. ## Core Features & Use Cases - Evidence Path Design: Frames the claim being made, derives candidate evidence paths from the system's inputs, outputs, state transitions, and boundaries, then selects a proportionate path with known limitations. - Verification Affordances: Defines the smallest capability needed to make behavior controllable, observable, repeatable, and diagnosable when the existing system cannot reveal the truth directly. - Verification Budgeting: Assigns one owner per distinct claim and chooses the minimum non-duplicative evidence covering claims and important boundaries. - Use Case: Before refactoring a payment retry flow, use this Skill to define the claim (retries are idempotent), design a repeatable test scenario from a known state, and close the loop by interpreting the resulting evidence after implementation. ## Quick Start Ask the agent to build a verification plan for the upcoming feature or bug fix 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 for a code change before implementing it?▼

Start by framing the claim: state the behavior that must become true and the conditions that could make a confident conclusion wrong. Then derive evidence paths from the system's controllable inputs, observable effects, and state transitions, and pick the path with proportionate cost and trustworthiness.

What is a verification affordance in software testing?▼

A verification affordance is the smallest capability that makes relevant system state controllable, observable, repeatable, and diagnosable for an agent. It is added only when the existing system leaves the decisive truth too indirect, and its lifecycle as temporary or durable is decided deliberately.

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

Use verification planning for non-trivial work such as features, bug fixes, refactors, and cross-system changes where the evidence path is unclear. Small mechanical changes can follow ordinary project checks directly without a dedicated planning step.

How do I avoid duplicate or excessive test evidence?▼

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.

What are the limitations of evidence-based verification planning?▼

The approach depends on the system exposing controllable inputs and observable effects; when it does not, an affordance must be built first. It also cannot eliminate uncertainty, so results must distinguish established facts from remaining unknowns.