ganyuanran avatar

Verification Before Completion

This is the discipline that stops you from typing "done" before you've actually verified anything works. It forces a specific sequence: identify the command that would prove your claim, run it fresh and complete, read the actual output, then state your claim with evidence or admit it's not ready. The skill includes structured slots for what you checked, what you didn't, residual risk, and a confidence grade. It's surprisingly hard to follow when you're tired and just want the task over, which is exactly when you need it most. The paranoia extends to goal closure, workspace integrity checks, and explicit accounting of covered versus uncovered scope. If you've ever pushed code assuming the tests passed, this is the guardrail you were missing.

GitHub stars
492
last updated
Jun 11, 2026

Install

$ npx -y skills add ganyuanran/aegis --skill verification-before-completion --agent claude-code

Installs into .claude/skills of the current project.

Files

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.

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.

Sponsors

Details

Repository
github.com/ganyuanran/aegis
License
MIT
First seen
Jun 11, 2026

More from ganyuanran/aegis

All 22

Recommended

1juliusbrussee avatarcavemanjuliusbrussee/cavemanUltra-compressed communication mode. Cuts output tokens 65% (measured) by speaking like caveman while keeping full technical accuracy. Supports intensity levels618.3Kskills.sh installs
2mattpocock avatargrill-memattpocock/skillsA relentless interview to sharpen a plan or design.1.5Mskills.sh installs
3shadcn avatarimproveshadcn/improveSurvey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on s40Kskills.sh installs
4obra avatarsystematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixes326.7Kskills.sh installs
5forrestchang avatarkarpathy-guidelinesforrestchang/andrej-karpathy-skillsBehavioral guidelines to reduce common LLM coding mistakes through explicit assumptions, simplicity, and verifiable success criteria.17.9Kskills.sh installs
6vercel-labs avatarfind-skillsvercel-labs/skillsHelps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express int4.3Mskills.sh installs