verification-planning

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

1|Updated Mar 15, 2025
One-click install
npx skills add https://github.com/adikpb/dotfiles --skill verification-planning-adikpb
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: verification-planning
Source: https://github.com/adikpb/dotfiles/tree/main/.config/opencode/skills/verification-planning
Command: npx skills add https://github.com/adikpb/dotfiles --skill verification-planning-adikpb

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Non-trivial code changes often ship with unverified assumptions because teams default to familiar tests instead of asking how the system itself can prove a claim. This Skill structures the planning of a credible, project-specific evidence path before implementation begins. ## Core Features & Use Cases - Claim Framing: States the behavior that must become true, its meaningful uncertainty, and its important failure modes before any code changes. - Evidence Path Design: Derives verification routes from the system's controllable inputs, observable effects, state transitions, invariants, and boundaries, with alternatives and a verification budget. - Verification Affordances: Defines the smallest capability that makes relevant state controllable, observable, repeatable, and diagnosable when existing surfaces are too indirect. - Use Case: Before refactoring a cross-system payment flow, use this Skill to frame the behavioral claim, choose a proportionate evidence path, budget verification across distinct claims, and close the loop by interpreting evidence after implementation. ## Quick Start Ask the agent to build a verification plan for the 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 for a non-trivial code change?▼

Start by framing the behavioral claim, its uncertainty, and its important failure modes. Then derive evidence paths from the system's controllable inputs, observable effects, and boundaries, choosing the path that gives a trustworthy conclusion at proportionate cost.

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 own inputs, state transitions, invariants, and artifacts rather than from a familiar testing technique.

When should I use verification planning instead of just writing tests?▼

Use it before features, bug fixes, refactors, or cross-system changes where a confident conclusion could be wrong. Small mechanical changes can follow ordinary project checks directly without this planning step.

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

A verification affordance is the smallest capability that makes relevant state controllable, observable, repeatable, and diagnosable. Create one only 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 duplicate 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 code, inputs, environment, and state remain valid.