verification-plan
/verification-plan
Map every acceptance criterion to the specific evidence that proves it - which test, which manual check, which measurement - and surface the gap list of criteria with no verification at all. Use once implementation is underway, before claiming anything is done, before a release decision, or when someone asks "how do we know this works". Also use when a definition of done exists but nobody has said how each part will be checked. The main output is the gap list, not the coverage claim.
- Author
- rpraharaj ↗
- Repository
- forward-deployed-engineer ↗
- Licence
- MIT
- Last repository change
- 27.10.2026
Assessment and security
- Files in this package
- 1
- Scripts
- 0
- HTML comments
- 0
- URLs in SKILL.md
- 0
No signals detected. Repository changed on 27.10.2026, without references to retired models or APIs.
MIT, open: use and modify while retaining author attribution.
What it does and when to use it
Map every acceptance criterion to the specific evidence that proves it - which test, which manual check, which measurement - and surface the gap list of criteria with no verification at all. Use once implementation is underway, before claiming anything is done, before a release decision, or when someone asks "how do we know this works". Also use when a definition of done exists but nobody has said how each part will be checked. The main output is the gap list, not the coverage claim.
Triggers from the description
Original author description
Map every acceptance criterion to the specific evidence that proves it - which test, which manual check, which measurement - and surface the gap list of criteria with no verification at all. Use once implementation is underway, before claiming anything is done, before a release decision, or when someone asks "how do we know this works". Also use when a definition of done exists but nobody has said how each part will be checked. The main output is the gap list, not the coverage claim.
How it works
- Why this exists
- When this applies
- When it doesn't
- Prerequisites
- Procedure
- Output template
- Common traps
SKILL.md preview
--- name: verification-plan description: Map every acceptance criterion to the specific evidence that proves it - which test, which manual check, which measurement - and surface the gap list of criteria with no verification at all. Use once implementation is underway, before claiming anything is done, before a release decision, or when someone asks "how do we know this works". Also use when a definition of done exists but nobody has said how each part will be checked. The main output is the gap list, not the coverage claim. --- # Verification plan Connecting what was promised to what was proven. ## Why this exists "The tests pass" is not verification. It means the assertions someone wrote earlier still hold — which says nothing about whether the thing that was asked for actually works. The two diverge constantly, because tests are written against the implementation as built and acceptance criteria were written against the need as understood. The gap between them is where the awkward release conversations live: seven criteria agreed, five with automated tests, one checked manually by someone who has since moved teams, and one that nobody ever verified and nobody noticed. This skill's real output is not the coverage table. It's the **gap list** — the criteria with no evidence. That list is short, uncomfortable, and the most useful thing you can put in front of a release decision. ## When this applies - Implementation underway or complete - Before claiming a requirement is done - Feeding `release-readiness` - "How do we know this works?" - Done is defined but how it will be checked isn't ## When it doesn't - No acceptance criteria exist yet — run `requirements-to-spec` first, or you're verifying against nothing - Pure spike or throwaway work - Diagnosing a broken pipeline — that's `ci-forensics` *(fde-operate)* ## Prerequisites Resolve `<workspace>` before reading or writing artifacts: read `../_shared/workspace-conventions.md` and follow its location and header rules. All artifact paths below use that resolved workspace. Preserve existing sections when appending. - `<workspace>/03-requirements.md` — the criteria being verified. **Required.** Without it this skill has no input. - `<workspace>/03b-nfrs.md` — non-functionals, if they exist - `<workspace>/06-blast-radius-*.md` — the verification list it produced - `<workspace>/06b-change-log.md` — what actually shipped ## Procedure ### 1. Start from the criteria, never from the tests Direction matters enormously. Starting from the tests and asking "what do these prove?" produces a comfortable document that always looks complete, because every test verifies *something*. Starting from the criteria and asking "what proves this?" produces the gaps. List every acceptance criterion from the spec. Add the verification items from `blast-radius`, and every NFR. That's your row set, and it's fixed before you look at a single test. ### 2. For each row, name the specific evidence Not "unit tests" — the **named test**, the **named check**, the **named measurement**. | Evidence type | What makes it acceptable | |---|---| | Automated test | Named test that fails if the behavior regresses | | Manual check | Who did it, when, in which environment, what they observed | | Measurement | The metric, the value, where it was measured, against what target | | Inspection | Only for things genuinely not executable — a config value, a permission grant. Say who inspected it. | | **None** | The gap list | The test for whether evidence is real: **could someone else re-run it and get the same answer?** "It was tested" fails that. "`RefundServiceTest#eurRefundStoresCurrency`" passes it. Manual checks are legitimate — some things can't be automated economically. But they decay: a manual check performed once against a build three weeks ago proves very little about what's shipping today. Record the date and the revision. ### 3. Confirm the evidence actually verifies the claim A named test is not automatically proof. Two failure modes worth checking directly: **The test doesn't assert what you think.** A test named `shouldRejectInvalidCurrency` that asserts only "no exception thrown" verifies almost nothing. Read the assertions, not the name. **The test can't fail.** Over-mocked tests frequently assert on the mock rather than the code. If you're unsure, mutate the production code and confirm the test goes red — the same discipline as `characterization-tests` step 5. Where you haven't confirmed this, tag the row `[inferred]` rather than `[confirmed]`. ### 4. Check the regression surface, not just the new behavior Verification covers two questions: does the new thing work, and did anything else break? The second is answered by the blast-radius verification list. Each identified consumer needs a specific check — the full suite passing is necessary and rarely sufficient, particularly for consumers outside this repository, which the suite by definition cannot cover. ### 5. Cite NFR measurements — do not re-measure here If `03b-nfrs.md` exists, run `nfr-validation` (or cite its table if it already ran). Do not write a second NFR table into this file. An NFR verified by assertion isn't verified; that skill is what produces the numbers. Where a measurement is impossible, that is a **gap** in the validation table, not a pass here. `release-readiness` will surface it as residual risk. ### 6. Produce the gap list For model-backed behavior, cite `ai-evaluation` *(fde-ai)* and, where actions are possible, `agent-action-safety` *(fde-ai)* evidence when available. Keep ordinary functional/regression checks. A missing pack is not a pass: obtain equivalent evidence or record the applicable quality/control gap for release assessment. Extract every row with no evidence, or with evidence you couldn't confirm. For each: - What's unverified - Why — no environment, no data, no access, no time, not automatable - What it would take - **Is it detectable in production if wrong?** A failure that alerts within minutes is a very different risk from one that corrupts data silently for a month That last column matters more than the others. It converts the gap list from a list of anxieties into a ranked risk register, and it's what a release decision actually needs. ### 7. Say what "done" means now Close with a plain statement of the position: how many criteria have confirmed evidence, how many are gaps, and whether you'd call this verified. Resist rounding up. A feature with six of seven criteria verified is not "done" — it's six of seven, and the seventh is either acceptable or it isn't. Making that explicit is the skill's contribution. ## Output template Write to `<workspace>/07-verification.md`: ```markdown # Verification — <feature> **Engagement:** <name> **Author:** FDE **Date:** <YYYY-MM-DD> **Status:** draft **Source revision:** <repo>@<short SHA> **Confidence:** <how much evidence you confirmed vs. took on trust> ## Position **<n> of <m> criteria have confirmed evidence. <k> gaps, of which <j> would be silent in production.** <Two sentences. Would you call this verified?> ## Criteria → evidence | ID | Criterion | Evidence | Type | Runs in CI? | Confirmed | Date | |---|---|---|---|---|---|---| | AC-1 | EUR refund stores currency | `RefundServiceTest#eurRefundStoresCurrency` | automated | yes | ✅ | CI @ `a3f9c1` | | AC-2 | Unsupported currency rejected | `RefundServiceTest#unsupportedCurrencyRejected` | automated | yes | ✅ | CI @ `a3f9c1` | | AC-3 | Pre-migration orders still refundable | manual, staging, T. Nakamura | manual | n/a | ✅ | 03-19 | | AC-4 | Refund appears in daily report | **none** | — | — | ❌ | — | ## Regression surface | Consumer (from blast radius) | Check | Result | |---|---|---| | `billing-web` | contract test | ✅ | | Nightly warehouse sync | asked data team to confirm | ⏳ no response since 03-12 | ## Non-functional Cite `nfr-validation` — do not duplicate its table. If it has not run: "not yet measured — run `nfr-validation`." ## Gap list | # | Unverified | Why | To close | Detectable if wrong? | |---|---|---|---|---| | 1 | AC-4 — refund in daily report | Report runs nightly; no staging schedule | Trigger report manually in staging — 1h | **No** — silently wrong figures until month-end | | 2 | Prod-volume latency | No prod-scale load environment | Load test env, or staged rollout with monitoring | Yes — p95 dashboard, minutes | | 3 | Warehouse sync compatibility | Data team unresponsive | Escalate, or test in staging against a sync copy | **No** — fails next daily run | ## Evidence quality notes <Tests whose assertions are weaker than their names suggest; manual checks that are now stale.> ``` ## Common traps **Starting from the tests.** Produces a complete-looking document with the gaps invisible. Always start from the criteria. **"Unit tests" as evidence.** Name the test, or it isn't evidence. **Trusting a test by its name.** Read the assertions. `shouldRejectInvalidInput` that only asserts no-exception verifies nothing. **Counting a stale manual check.** Performed against a three-week-old build in an environment that has since changed, it proves very little. Record the date and revision. **Treating an unmeasurable NFR as a pass.** It's a gap. Record it and let the release decision weigh it. **Ignoring the regression surface.** Half of verification is "did anything else break," and the suite can't see cross-repo consumers. **Rounding up.** Six of seven is six of seven. **Burying the gap list.** It's the output. Put it where it will be read.
Versions
The database has no other skills named verification-plan.
Database snapshot: 13.11.2026 · package version dac6da592c8d (SHA-256 digest of the entire package)
Downloads in the last 30 days: 0 · ranking
Report a problem with this skill: harmful content, incorrect descriptions or an author’s removal request.
Similar skills
- 100write-acceptance-criteria
Use when the user asks to define acceptance criteria, write a spec for a task, clarify what "done" looks like, or translate a vague goal into testable requirements. Triggers on "acceptance criteria", "definition of done", "how will we know this works", "spec for". - 100criterion-verification-map
Transform acceptance criteria into plan-time runnable verification commands (behavioral, API, UI, error, performance, config, data, contract types) with expected evidence shapes and risk areas, then execute at verify time and assemble the evidence bundle with its mandatory… - 95wicked-garden-product-acceptance-criteria
Define testable acceptance criteria from requirements and design. Bridge product requirements with QE test scenarios. Use when: "define acceptance criteria", "how do we know it's done", "what should QE test", "definition of done - 100acceptance-criteria-writer
Write measurable acceptance criteria for requirements or user stories. Use when the user says "write acceptance criteria", "definition of done", "how do we test this", "fit criteria", "given when then", "Gherkin scenarios", "what does done look like", "testable conditions", "how… - 100tracing-requirements-to-verification
Use when work has multiple requirements, phases, acceptance criteria, implementation tasks, verification evidence, review findings, review governance, scope changes, delivery gaps, residual risks, or claims of completion that need traceable delivery decisions. - 90implementation-plan
Convert a plan, PRD, backlog item, or vague feature into ordered implementation work with acceptance criteria and verification. Use when the user asks to break down work, make an implementation plan, create tasks, plan execution, or use slice-plan.