Post Work Review
Testing & Qualitypost-work-reviewPost Work Review is an Agent Skill for testing & quality published in the s4wave/spacewave repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.
Use after completing implementation work to catch AGENTS.md violations, dead code, and issues missed during development. Run before showing results to the user.
QUICK START
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Prompt to paste
Inspect the Agent Skill at https://github.com/s4wave/spacewave/blob/HEAD/.claude/skills/post-work-review/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/post-work-review, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
Post-Work Review
Review your diff against AGENTS.md rules and fix violations before presenting work.
Process
- Run
git diff HEAD(or appropriate base) to see all changes - Read
AGENTS.mdfully -- the rules section is authoritative - For each changed file, check every rule that applies
- Fix violations directly -- do not just report them
- Re-run type check (
npx tsc --noEmitorgo build ./...)
High-Signal Checks
These are the violations most commonly introduced under time pressure:
| Check | Rule | How to spot |
|---|---|---|
| Type casts | AVOID as statements | grep for as in diff |
| Any types | AVOID any type | grep for : any or as any |
| Let bindings | AVOID let statements | grep for let in diff |
| Else branches | DO NOT use else unless necessary | grep for } else |
| Dead code | Delete unused code when changing things | check if old code is still referenced |
| String interpolation | Use cn() not template literals for className | grep for className={` |
| Obvious comments | DO NOT use obvious comments | read comments -- are they saying what the code already says? |
| Disabled linters | DO NOT disable linter warnings unless necessary | grep for eslint-disable in new lines |
Quick Grep
# Run against staged/unstaged changes
git diff HEAD -U0 | grep -E '^\+.*\bas\b' | grep -v '^+++' | grep -v 'import.*as'
git diff HEAD -U0 | grep -E '^\+.*: any' | grep -v '^+++'
git diff HEAD -U0 | grep -E '^\+.*\blet\b ' | grep -v '^+++'
git diff HEAD -U0 | grep -E '^\+.*\} else' | grep -v '^+++'
git diff HEAD -U0 | grep -E '^\+.*eslint-disable' | grep -v '^+++'
Common Misses
- Casts introduced to satisfy a generic -- rethink the generic or type parameter instead
undefined as void--undefinedis assignable tovoiddirectlyletfor a variable reassigned once -- restructure to useconst- Dead imports -- after deleting code, check if its imports are still needed
- Comments describing the obvious --
// Release all resourcesabovereleaseAllResources()adds nothing