verification-planning

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

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

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 thinking needed to connect a behavioral claim to concrete, project-specific evidence before implementation begins. ## Core Features & Use Cases - Evidence Path Design: Derives verification routes from the system itself—controllable inputs, observable effects, state transitions, invariants, and boundaries—rather than defaulting to familiar techniques. - Verification Affordances: Guides creation of minimal capabilities that make relevant state controllable, observable, repeatable, and diagnosable when existing surfaces are too indirect. - Verification Budgeting: Assigns one owner per distinct claim and selects the minimum non-duplicative evidence covering claims and boundaries. - Use Case: Before refactoring a cross-system payment flow, use this Skill to frame the behavioral claim, design an evidence path with a fallback alternative, and close the loop after implementation by reporting what was established versus what remains uncertain. ## Quick Start Ask the agent to build a verification plan for the upcoming feature or bug fix, framing the claim and designing an evidence path before writing any 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?▼

Frame the behavioral claim and its failure modes first, then derive evidence paths from the system's controllable inputs, observable effects, and state transitions. Choose the path producing a trustworthy conclusion with proportionate cost, and keep a weaker or stronger alternative ready.

What is an evidence path in software verification?▼

An evidence path is a project-specific route from the claim being made to evidence that can establish, limit, or refute it. It is derived from the system's own inputs, outputs, invariants, boundaries, and ability to repeat or reverse a scenario.

When should I create a verification affordance?▼

Create one when the existing system leaves the decisive truth too indirect or ambiguous to observe. Build the smallest capability making the relevant state controllable, observable, repeatable, and diagnosable, and decide deliberately whether it is temporary or durable.

When is verification planning not needed?▼

Small mechanical changes can follow ordinary project checks directly without a formal evidence path. The skill is intended for non-trivial work such as features, bug fixes, refactors, and cross-system changes where confident conclusions could be wrong.

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

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