verification-before-completion

Selects the smallest sufficient proof set for TypeScript backend closeout readiness verdicts.

1|1|Updated Apr 8, 2026
One-click install
npx skills add https://github.com/GonkaGate/opencode-setup --skill verification-before-completion-gonkagate
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: verification-before-completion
Source: https://github.com/GonkaGate/opencode-setup/tree/main/.agents/skills/verification-before-completion
Command: npx skills add https://github.com/GonkaGate/opencode-setup --skill verification-before-completion-gonkagate

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Backend changes often get declared done based on stale CI runs, typecheck passes, or vague manual smoke tests. This Skill turns a closeout question into a disciplined readiness verdict by mapping each changed claim to the smallest check that can actually falsify it. ## Core Features & Use Cases - Proof Obligation Mapping: Names the exact claims that need evidence across contract, Fastify runtime, Prisma/Postgres, Redis, workflow-state, and test-harness seams. - Smallest Honest Layer Selection: Chooses between typecheck, unit, route inject, contract diff, real Postgres/Redis integration, migration preflight, and targeted runtime proof instead of defaulting to the broadest suite. - Readiness Verdict Discipline: Classifies evidence as fresh direct, partial, stale, indirect, or missing, then issues verified ready, conditionally ready, or not yet verified verdicts with explicit residual risk. - Use Case: After changing a Fastify route with a new Prisma migration, ask whether the change is ready and receive a claim-by-claim proof plan naming the exact route inject test and migration preflight still required. ## Quick Start Ask the agent to verify whether your current TypeScript backend change is actually ready to close out and what proof is still missing.

Frequently Asked Questions about verification-before-completion

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

FAQPage Schema
How do I verify a backend change is ready before closing a task?

Name the exact claim being treated as ready, identify which seam owns it (contract, runtime, data, Redis, workflow), then pick the smallest check that could falsify that claim. Classify existing evidence as fresh direct, partial, stale, indirect, or missing before issuing a verdict.

What proof is enough for a Fastify route change?

Route-level app.inject() proof covers request validation, serialization, headers, and in-process HTTP behavior. It does not prove listen(), socket, shutdown, or stream lifecycle, which need a targeted real-runtime check instead.

Does a passing typecheck prove runtime behavior is correct?

No. Typecheck only proves the code compiles and static contracts fit together. Changed runtime, lifecycle, database, Redis, or workflow semantics require proof at the layer that actually exercises that seam.

When should I use real Postgres or Redis integration tests instead of mocks?

Use real infrastructure when the claim depends on actual semantics: constraints, transactions, migrations, TTL, Lua scripts, or guard patterns. Mocked proof overclaims when correctness depends on real database or Redis behavior.

Why is a green CI run not enough evidence for closeout?

CI from before the latest edits is stale evidence, and a broad suite pass may never exercise the changed boundary. Closeout requires fresh, direct evidence tied to the specific claim, not general historical reassurance.

When should this verification approach not be used?

Escalate when the design is still unsettled, the change portfolio needs a dedicated test-plan effort, or the real question is design review, test quality review, or root-cause debugging rather than closeout proof selection.