Run the mandatory verification stack when changes affect runtime code, tests, or build/test behavior in the OpenAI Agents Python repository.
code-change-verification follows the SKILL.md standard. Use the install command to add it to your agent stack.
--- name: code-change-verification description: Run the mandatory verification stack when changes affect runtime code, tests, or build/test behavior in the OpenAI Agents Python repository. --- # Code Change Verification ## Overview Ensure work is only marked complete after formatting, linting, type checking, and tests pass. Use this skill when changes affect runtime code, tests, or build/test configuration. You can skip it for docs-only or repository metadata unless a user asks for the full stack. ## Quick start 1. Keep this skill at `./.codex/skills/code-change-verification` so it loads automatically for the repository. 2. macOS/Linux: `bash .codex/skills/code-change-verification/scripts/run.sh`. 3. Windows: `powershell -ExecutionPolicy Bypass -File .codex/skills/code-change-verification/scripts/run.ps1`. 4. If any command fails, fix the issue, rerun the script, and report the failing output. 5. Confirm completion only when all commands succeed with no remaining issues. ## Manual workflow - If dependencies are not installed or have changed, run `make sync` first to install dev requirements via `uv`. - Run from the repository root in this order: `make format`, `make lint`, `make mypy`, `make tests`. - Do not skip steps; stop and fix issues immediately when a command fails. - Re-run the full stack after applying fixes so the commands execute in the required order. ## Resources ### scripts/run.sh - Executes the full verification sequence with fail-fast semantics from the repository root. Prefer this entry point to ensure the required commands run in the correct order. ### scripts/run.ps1 - Windows-friendly wrapper that runs the same verification sequence with fail-fast semantics. Use from PowerShell with execution policy bypass if required by your environment.