OpenParable
Skip to content
← Back to skills

Post Work Review

Testing & Quality
post-work-review

Post 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.

View on GitHub ↗
QUICK START

How to use this skill

Bring this guide into your coding agent with a prompt tailored to the tool you use.

  1. Open your project in Codex.
  2. Copy and paste the prompt below.
  3. 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

  1. Run git diff HEAD (or appropriate base) to see all changes
  2. Read AGENTS.md fully -- the rules section is authoritative
  3. For each changed file, check every rule that applies
  4. Fix violations directly -- do not just report them
  5. Re-run type check (npx tsc --noEmit or go build ./...)

High-Signal Checks

These are the violations most commonly introduced under time pressure:

CheckRuleHow to spot
Type castsAVOID as statementsgrep for as in diff
Any typesAVOID any typegrep for : any or as any
Let bindingsAVOID let statementsgrep for let in diff
Else branchesDO NOT use else unless necessarygrep for } else
Dead codeDelete unused code when changing thingscheck if old code is still referenced
String interpolationUse cn() not template literals for classNamegrep for className={`
Obvious commentsDO NOT use obvious commentsread comments -- are they saying what the code already says?
Disabled lintersDO NOT disable linter warnings unless necessarygrep 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 -- undefined is assignable to void directly
  • let for a variable reassigned once -- restructure to use const
  • Dead imports -- after deleting code, check if its imports are still needed
  • Comments describing the obvious -- // Release all resources above releaseAllResources() adds nothing