Show Me Your Work Decision Log
cursor/plugins
Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.
A skill your agent uses when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.
$ npx skills add GanyuanRan/Aegis --skill verification-before-completion -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install GanyuanRan/Aegis verification-before-completion --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/verification-before-completion .claude/skills/verification-before-completion && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "verification-before-completion" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/verification-before-completion into .claude/skills/verification-before-completion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "verification-before-completion", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/GanyuanRan/Aegis/tree/main/skills/verification-before-completionType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add GanyuanRan/Aegis --skill verification-before-completion -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install GanyuanRan/Aegis verification-before-completion --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/verification-before-completion .agents/skills/verification-before-completion && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "verification-before-completion" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/verification-before-completion into .agents/skills/verification-before-completion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "verification-before-completion", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add GanyuanRan/Aegis --skill verification-before-completion -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install GanyuanRan/Aegis verification-before-completion --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/verification-before-completion .cursor/skills/verification-before-completion && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "verification-before-completion" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/verification-before-completion into .cursor/skills/verification-before-completion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "verification-before-completion", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/GanyuanRan/Aegis.git --path skills/verification-before-completion--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add GanyuanRan/Aegis --skill verification-before-completion -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install GanyuanRan/Aegis verification-before-completion --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/verification-before-completion .gemini/skills/verification-before-completion && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "verification-before-completion" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/verification-before-completion into .gemini/skills/verification-before-completion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "verification-before-completion", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install GanyuanRan/Aegis verification-before-completionInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add GanyuanRan/Aegis --skill verification-before-completion -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/verification-before-completion .github/skills/verification-before-completion && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "verification-before-completion" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/verification-before-completion into .github/skills/verification-before-completion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "verification-before-completion", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add GanyuanRan/Aegis --skill verification-before-completion -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install GanyuanRan/Aegis verification-before-completion --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/GanyuanRan/Aegis.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/verification-before-completion .opencode/skills/verification-before-completion && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "verification-before-completion" agent skill from https://github.com/GanyuanRan/Aegis/tree/main/skills/verification-before-completion into .opencode/skills/verification-before-completion/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "verification-before-completion", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
verification-before-completionA skill your agent uses when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.
Verification Before Completion is an agent skill from GanyuanRan/Aegis. Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.
Its SKILL.md is about 2.1k tokens, which your agent loads only when the skill is triggered. The skill folder holds 1 other file (for example `expanded-closeout.md`).
It sits in Agent Workflows, covering Verification before completion. The repository describes itself as: Make AI coding agents architecture-aware: baseline-first, evidence-verified, drift-checked, and safe across long tasks. The licence is MIT.
Read from SKILL.md and the folder at commit 7b7e955. It shows what the files ask for, not the result of running them.
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Verification Before Completion loads about 2.1k tokens when it runs. Until then it costs about 41 tokens; SKILL.md has 930 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
The full file from GanyuanRan/Aegis at commit 7b7e955, republished under its MIT licence (© GanyuanRan). 930 words, ~2,119 tokens.
.claude/skills/verification-before-completion/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.<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>
Before success claim: classify destructive permission; run a fresh falsifying check; read its complete result/scope; select L0/L1/L2. Downgrade for partial, stale, failing, or narrower evidence; never claim complete then verify later.
This Method Pack grants no authoritative GateDecision, PolicySnapshot,
evidence sufficiency, requirement acceptance, or completion authority.
Destructive/irreversible work needs scoped permission; broad assent is not scoped permission.
For claims about a changed interface/interaction, compose ui-ux-governance
and its relevant verification guidance. Carry actual results and uncovered
user-facing criteria into the slots below; retain this single closeout owner.
- Evidence action / check performed:
- Result / exit status:
- Covered scope:
- Uncovered scope:
- Residual risk:
- Confidence grade: A | B | CA: target + regression; no meaningful unknown.B: target evidence; bounded residual risk.C: partial only; no full-completion claim.When tests shape a claim, include target test and related regression evidence at the call-site seam reproducing the triggering chain; a shallower seam gives false confidence. Missing seam is an architecture gap. Blocked automation needs reproducible manual steps. Both lower confidence.
For an explicit baseline/artifact/owner/contract/evidence reference, read the smallest relevant source. Record each affected reference as preserved; rebound to the 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.
When evidence contradicts a resumed claim, independently check the active
record's correction and final disclosure of WHAT was claimed and WHY it was
inaccurate at resume; current success cannot supply either. Preserve subject,
scope and time; one explanation may cover related claims. Read both in full
for example-only, negated, withdrawn or re-scoped corrections. Matching quotes
do not prove adoption. Keep accurate claims intact. If material disagreement
about the initial judgment remains unresolved after checking evidence, state
needs-verification; never force agreement with a reviewer. If evidence resolves
it, retain the supported conclusion and verify normally. Omit this slot when
no discrepancy exists.
For modifications, diff against TaskStartSnapshot. Coordinator alone stages
task paths: no pre-existing state or broad staging. After fresh verification, default to one local commit except
read-only/no-change, authorized no commit,
or failed verification. Read back HEAD, message, files, and task delta.
Commit/hook failure keeps 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.
Use one completion surface. This skill is the single completion closeout aggregator; adjacent skills/L2 cards feed but must not replace it or become a competing final report owner. Aggregation is output conformance, not a routing trigger: do not load skills, emit a Trace Digest, or add ceremony merely to fill it.
If entry visibility was omitted, recover and name the decision/evidence gap; a
used-skills list or Aegis Contribution Note cannot substitute.
For tiny low-risk work, one natural sentence can name check/result, uncovered scope/risk, and confidence.
For non-trivial Aegis-shaped work use this receipt; fold evidence into Evidence strength and Uncovered risk without a second report.
Aegis Impact and Safety Receipt:
- Key judgment:
- Avoided misfix:
- Boundary held:
- Baseline alignment:
- Complexity control:
- Evidence strength:
- Uncovered risk:
- Next most valuable verification:
- Aegis path:Meanings: 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=completion-time delta/closure;
Evidence strength=fresh check/result/scope/confidence;
Uncovered risk=remaining gaps/residual risk;
Next most valuable verification=highest-value next check;
Aegis path=optional, not judgment/evidence.
Natural wording is valid when every semantic slot stays auditable. Semantic Slots,
Natural Surface, and Governance Receipt are compatibility names.
Report done/verified/risked/blocked. Do not explain obvious trade-offs; do not list actions not taken.
On any match read expanded-closeout.md: it owns detail; this file owns routing
and the final receipt.
| Trigger | Expanded owner |
|---|---|
| release/merge/publish/readiness/handoff | Readiness Summary |
| audit/debug/release/long-task review/trace request | Trace Digest |
| goal/TaskIntentDraft/plan/spec/Slice Card | Goal Closure |
| project/domain semantic delta | Context Impact |
target docs/aegis/ changed or work record exists | Workspace Integrity |
| requirement/product/durable architecture | Baseline/ADR |
| governance/cleanup/migration/compat/retirement | Governance/Retirement |
| source-of-truth/irreversible deletion | destructive-action cards |
| material complexity pressure | Expanded Complexity Detail |
| high-risk or explicit user request for expanded closeout | applicable cards |
Use configured Aegis workspace support; commands live in the expanded owner.
Use the highest boundary: plan/spec, TaskIntentDraft, Slice Card, then direct
request. Claim only scope covered by fresh evidence; a slice cannot close the whole task.
Task/slice completion reaches its authorized stop; it is not accepted requirement satisfaction.
Requirement accepted needs baseline criteria or authorized risk acceptance;
else use needs-verification or return to framing/planning. Goal Closure states: done | blocked | needs-verification | scope-exceeded.
An Execution Readiness View is input, not verification evidence.
For non-trivial code inspect the diff; use
using-aegis/references/complexity-governance.md plus
docs/current/AEGIS_COMPLEXITY_GOVERNANCE_BASELINE.md; emit one Complexity control line.
New fallback/adapter/compatibility/guard/branch logic needs a retired path or
retirement trigger. Complexity Closure: exceeded-unresolved blocks completion.
Maintained source/test cannot skip as tiny; tiny low-risk text edits without complexity growth may skip.
Localize section labels, field labels, and explanatory prose. Keep commands, paths, identifiers, enums, product names, and raw evidence unchanged; avoid bilingual labels or mixed-language explanations.
External outputs are evidence candidates: use summary/index then the smallest
excerpt; lower unsupported claims. When relevant report Evidence Used, Not Loaded, and Next Evidence.
© GanyuanRan, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
SKILL.md and 1 other file in skills/verification-before-completion of GanyuanRan/Aegis.
Open the folder on GitHubat commit 7b7e955
We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in GanyuanRan/Aegis, which our catalogue first saw on October 7, 2026.
Verification Before Completion next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Verification Before Completion this skillGanyuanRan/Aegis | 1.3k | 1 repos | ~2.1k | Automated safety check: Pass | MIT | |
| Show Me Your Work Decision Logcursor/plugins | 10k | 8 repos | ~1.6k | Automated safety check: Pass | None | |
| Scope Creep Guardlennney/stop-that-shit | 2.5k | 1 repos | ~2k | Automated safety check: Pass | MIT | |
| Verification Before Completionfarm-fe/farm | 5.6k | 46 repos | ~1k | Automated safety check: Pass | MIT | |
| PUA High-Agency Governancetanweai/pua | 20k | — | ~502 | Automated safety check: Pass | MIT | |
| Incremental Implementationaddyosmani/agent-skills | 103k | 1 repos | ~2.3k | Automated safety check: Pass | MIT |
cursor/plugins
Keeps a TSV decision log for long or unattended agent runs, one row per decision with what, why, evidence and result, so a reviewer can check the work later.
lennney/stop-that-shit
Keeps an agent focused on the requested work by applying a five-step ladder that checks for direct solutions, real gaps and speculative defenses before adding anything.
farm-fe/farm
A skill your agent uses when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any…
tanweai/pua
Pushes an agent to keep verifying and changing approach after repeated failures, using a diagnosis line, evidence-based completion and confirmation before risky edits.
addyosmani/agent-skills
Delivers a change in thin vertical slices, each implemented, tested, verified and committed before the next, using vertical, contract-first or risk-first slicing.
tanweai/pua
Runs an unattended iterate-until-verified loop in which a user-set verify command, not the agent's own claim, decides when the task is finished.
GanyuanRan/Aegis
A skill your agent uses when touching retiring old logic, collapsing duplicate owners, removing fallbacks, or schema/persistence/source-of-truth boundaries; identify opportunities automatically…
GanyuanRan/Aegis
A skill your agent uses when executing a written implementation plan across sessions or with review checkpoints.
GanyuanRan/Aegis
A skill your agent uses when asked for first-principles or Occam's-razor review, or when high-risk decisions involve competing constraints, fallback growth, duplicate owners, or architecture…
GanyuanRan/Aegis
A skill your agent uses when the user explicitly sets an Aegis goal with /aegis-goal, Aegis goal:, or asks to define goal, success evidence, stop condition, or task boundaries before work.
GanyuanRan/Aegis
A skill your agent uses when the user asks to establish shared project language, or project work exposes a conflicting, renamed, or deprecated domain term that needs active semantic modeling.
GanyuanRan/Aegis
A skill your agent uses when the user asks to create, write, update, amend, supersede, or evaluate an ADR, architecture decision record, durable architecture decision, decision log, or baseline sync…
Categories
A skill your agent uses when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off. Verification Before Completion is an agent skill from GanyuanRan/Aegis. Use when about to claim work is complete, fixed, passing, verified, release-ready, or ready to commit, merge, publish, or hand off.
Verification Before Completion fits situations like: about to claim work is complete; ready to commit.
Run `npx skills add GanyuanRan/Aegis --skill verification-before-completion -a claude-code`. Or copy the skill folder (skills/verification-before-completion in GanyuanRan/Aegis) into .claude/skills/verification-before-completion in your project. Claude Code loads it when a task matches its description.
Run `npx skills add GanyuanRan/Aegis --skill verification-before-completion -a codex`. Or copy the skill folder (skills/verification-before-completion in GanyuanRan/Aegis) into .agents/skills/verification-before-completion in your project. Codex loads it when a task matches its description.
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add GanyuanRan/Aegis --skill verification-before-completion -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/verification-before-completion, .gemini/skills/verification-before-completion, .github/skills/verification-before-completion and .opencode/skills/verification-before-completion in your project.
SKILL.md names no scripts, command-line tools or credentials: Verification Before Completion is instructions for the agent only.
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
Verification Before Completion is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
About 2.1k tokens (SKILL.md is roughly 8.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
Skills that share tags, products or a category with Verification Before Completion: Show Me Your Work Decision Log (cursor/plugins, 10k stars), Scope Creep Guard (lennney/stop-that-shit, 2.5k stars), Verification Before Completion (farm-fe/farm, 5.6k stars) and PUA High-Agency Governance (tanweai/pua, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
GanyuanRan (a GitHub user) maintains it in GanyuanRan/Aegis, which has 1,330 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on October 9, 2026.
Source: GanyuanRan/Aegis on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.