Skip to content
Development
Skill

/verification-before-completion

Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.

From plugin
aegis
1.4k23 skills3 commands1 hook

Claude Code

$ npx -y skills add GanyuanRan/Aegis --skill verification-before-completion --agent claude-code

SKILL.md

verification-before-completion.SKILL.md
name: verification-before-completion
description: "Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off."

<EXPLICIT-MODE-GATE> If `activation_mode = "explicit"` or `AEGIS_ACTIVATION_MODE=explicit` is visible and the request names neither Aegis nor this skill, return to the fast path without checklist/ceremony; otherwise continue. </EXPLICIT-MODE-GATE>

Execute

Before success claim: classify destructive permission; read sufficient current evidence and run a fresh falsifying check when it is missing or invalidated; read the complete result/scope; select L0/L1/L2. Downgrade for partial, stale, failing, or narrower evidence; never claim complete then verify later.

This pack grants no `GateDecision`, `PolicySnapshot`, evidence sufficiency, requirement acceptance, or completion authority.

Stop Signals

  • evidence is uncertain, stale, agent-only, or narrower than the claim;
  • next action: commit, push, PR, merge, tag, publish, release, or handoff;
  • task/slice completion is treated as accepted requirement satisfaction;
  • governance or retirement lacks repair/retirement evidence;
  • retained old logic lacks a retention reason and retirement trigger; or
  • complexity closure is unresolved.

Destructive/irreversible work needs scoped permission; broad assent is not scoped permission.

Required Evidence Slots

For changed interface/interaction claims, compose `ui-ux-governance` verification; carry results and uncovered user criteria here, keeping one closeout owner.

- Evidence action / check performed:
- Result / exit status:
- Covered scope:
- Uncovered scope:
- Residual risk:
- Confidence grade: A | B | C
  • `A`: target + regression; no meaningful unknown.
  • `B`: target evidence; bounded residual risk.
  • `C`: partial only; no full-completion claim.

For repairs/optimization, distinguish cause, closure and verified outcome. Check interactions and preserved behavior; investigate consequential unknowns.

Claims need target test and related regression evidence at the triggering seam. A missing seam is an architecture gap; blocked automation needs reproducible manual steps. Both limit confidence.

Read the smallest source for each explicit baseline/artifact/owner/contract/evidence reference. Mark it preserved, rebound to its canonical owner, retired with reason, or rejected for conflict. Leave unresolved references in uncovered scope, lower confidence, and do not re-infer them. Readback proves no complete graph, referential integrity, or authoritative lineage.

Check authorized transformations for omissions/unsupported additions; reuse sufficient evidence without exhaustive traces or another report.

Match claims to checked properties, objects and conditions. Resolve counterexamples or qualify results. At first material claim, attribute code, executed tests, runtime, documentation or inference and limits. Search misses prove no absence; code cannot override approved requirements. Parsing proves neither required fields nor semantics; success cannot dismiss warnings. Settings do not prove behavior; changed conditions limit causal comparisons. Check measurable requirements deterministically; claim only executed checks. Reuse review without extra calls/reports/criteria. Negative/qualified findings are not acceptance.

Inherited-Claim Closeout

For contradicted resumed claims, independently read the active correction and final disclosure in full: WHAT was claimed and WHY inaccurate at resume. Current success supplies neither. Preserve subject, scope and time; related claims may share an explanation. Check example-only, negated, withdrawn or re-scoped text; matching quotes do not prove adoption. Keep accurate claims. Unresolved material disagreement means `needs-verification`, not forced reviewer agreement; resolved evidence supports normal verification. Omit this slot without a discrepancy.

Task Git Closeout

Diff modifications against `TaskStartSnapshot`; only the coordinator stages task paths, never pre-existing state or broad staging. After fresh verification, create one local commit except read-only/no-change, authorized `no commit`, or failed verification. Read back `HEAD`, message, files and delta. Commit/hook failure preserves work and blocks clean claims; never bypass hooks.

Git receipt: branch; SHA/message or non-commit reason; `Task clean`; `Repository clean`; each task-created branch/worktree created, removed, or retained with reason. Task-clean never implies repo-clean; it is not external integration.

Classify commit scope: `business`, `process-only`, `mixed`, or `no-commit`. Failed-attempt telemetry is no commit reason. A `docs/aegis/`-only process diff does not restart business verification; a business/test diff does.

Aegis Visibility / Single Closeout

Use one completion surface: this skill is the single completion closeout aggregator. Adjacent skills/L2 cards must not replace it or become a competing final report owner. Aggregation is output conformance, not a routing trigger: no extra skills, Trace Digest or ceremony merely to fill it.

If entry visibility was omitted, recover and name the decision/evidence gap, not a used-skills list or `Aegis Contribution Note`.

L0 Fast-Path

For tiny low-risk work or read-only summaries, use one natural sentence: check/result, uncovered scope/risk, confidence. Require sufficient current evidence; attribute supplied evidence; invent no execution or extra report.

L1 Default Receipt

Fold evidence into `Evidence strength` and `Uncovered risk`.

`Aegis Impact and Safety Receipt` slots: `Key judgment`=owner/root cause/requirement/completion boundary; `Avoided misfix`=fallback/duplicate/test accommodation/scope growth; `Boundary held`=contract/owner/baseline/non-goal/data/runtime boundary; `Baseline alignment`=aligned/Design Defect/Implementation Drift/missing-authority/needs-clarification/not triggered; `Complexity control`=comple

Read more
@ganyuanran
Ships withaegis

Aegis Method Pack Make your AI coding agent trustworthy: fewer reworks, safer changes, proof before "done". English · 中文 · Fast-Track Playbook · 速通秘籍 Stop babysitting your agent.

Stars on GitHub

Momentum

stars in total
1.4k
Star history of GanyuanRan/Aegis on GitHub, a chart by star-history.com

Other skills on aegis.

anti-entropy-governance

anti-entropy-governanc…

Use when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or schema/persistence/source-of-truth…

@ganyuanran@ganyuanranInstall Skill
brainstorming

brainstorming

Use when defining ambiguous or high-complexity new features, product behavior, UI/component design, architecture choices,…

@ganyuanran@ganyuanranInstall Skill
communicating-concisely

communicating-concisel…

Use when the user asks for caveman mode, fewer tokens, brief responses, compressed communication, or otherwise explicitly…

@ganyuanran@ganyuanranInstall Skill
executing-plans

executing-plans

Use when executing a written implementation plan across sessions or with review checkpoints. Small or single-slice plans stay…

@ganyuanran@ganyuanranInstall Skill

More skills from other plugins.

brainstorming
Auto-invoked

brainstorming

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or…

@obra@obraInstall Skill
ask-matt

ask-matt

Ask which skill or flow fits your situation. A router over the skills in this repo.

skills2w309k
@mattpocock@mattpocockInstall Skill
accessibility
Auto-invoked

accessibility

Design, implement, and audit accessible UI to WCAG 2.2 Level AA across Web, iOS, and Android — semantic ARIA roles and labels,…

ecc2w293k
@affaan-m@affaan-mInstall Skill
compiler-commit

compiler-commit

Use when you want to verify compiler changes and commit with the correct convention. Runs tests, lint, and format, then commits…

react5d252k
@facebook@facebookInstall Skill

Questions about verification-before-completion.

Which coding agents can use verification-before-completion?
verification-before-completion installs in Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, OpenCode and Windsurf with the skills CLI, using each agent's flag shown on this page. Flowy's auto-invocation, which fires a skill when your prompt matches, runs in Claude Code only.