---

name: oe-release-readiness description: "Pre-merge/release readiness checklist for OpenEvent-AI. Use when preparing a PR for production: run the fastest validation lanes first (compile/import, smoke suite, deterministic site-visit trace), then escalate to full suites or integration checks as needed."

oe-release-readiness

Fast gates (run in this order)

1. Compile/import + refactor invariants:

   • python3 scripts/verify_refactor.py

2. Fast backend smoke suite (Step 1–7 core invariants):

   • ./scripts/test-smoke.sh

3. Agent-facing API regressions (manager approve path + tool parity):

   • pytest backend/tests/agents/ -q

4. Deterministic site-visit trace contract (no UI required):

   • python3 scripts/manual_ux_scenario_I.py > /tmp/ux_site_visit_I.json
   • python3 scripts/validate_manual_ux_run.py /tmp/ux_site_visit_I.json --require_site_visit

Full gates (only if the change touches workflow logic)

• Full test suite:
  • ./scripts/test-all.sh

Hygiene gates (quick checks that prevent “LLM-ish” regressions)

• No new debug prints in runtime code (allow scripts/tests only):
  • rg -n "print\\(" backend -g"*.py" | rg -v "/tests/|/scripts/|__init__\\.py"

Claude Code shortcut

• Keep .claude/commands/validate.md up to date and run /validate for a full-stack lane.