ship-checklist

name	ship-checklist
description	Pre-push checklist — write tests for changes, run full suite, verify docs, push. Use before every git push.
disable-model-invocation	true
allowed-tools	Bash(npx vitest *) Bash(npx tsc *) Bash(python3 -m pytest *) Bash(python3 -c *) Bash(gh release view *) Bash(git *)

Ship Checklist

Run through every item below before pushing. Do NOT push until all steps pass.

1. Write tests for changes

Run /write-tests to analyze all code changes and generate tests in the judgement-tests repo. Every change — feature, fix, refactor, even a one-liner — must have tests. Do NOT skip this step.

2. Run full test suite

Run /test-suite to run all smoke tests + suite tests + TypeScript checks. Do NOT proceed until it reports "All tests passed — safe to push."

3. README

Check if the change affects any of:

• Feature list or descriptions
• Test counts (currently backend + frontend totals)
• Download links (verify actual artifact names with gh release view --json assets)
• Variant count
• Documented behavior or commands

If yes, update README.md accordingly. Read it and verify links are correct.

4. RELEASE_NOTES.md

Add an entry under the Unreleased section (or the current version section if tagging a release). Categorize as Added / Changed / Fixed / Security.

5. LEARNINGS.md

If anything was missed, caught late, or required a fix after the fact during this session, add an entry to LEARNINGS.md under the Mistakes & Fixes section. Format:

### Short title
What went wrong and the fix so we don't repeat it.

6. Commit and push

Only after all above steps pass:

• Stage relevant files (not git add -A)
• Write a concise commit message
• Push

Report the final test counts and any doc updates made.