name	code-change-verification
description	Run the mandatory verification stack when changes affect runtime code, tests, or build/test behavior in the OpenAI Agents JS monorepo.

Code Change Verification

Overview

Ensure work is only marked complete after installing dependencies, building, linting, type checking (including generated declarations), and tests pass. Use this skill when changes affect runtime code, tests, or build/test configuration.

Quick start

Keep this skill at ./.agents/skills/code-change-verification so it loads automatically for the repository.
Run the skill in the user's selected checkout without changing worktrees or branches.
macOS/Linux: bash .agents/skills/code-change-verification/scripts/run.sh.
Windows: powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1.
If any command fails, fix the issue, rerun the script, and report the failing output.
Confirm completion only when all commands succeed with no remaining issues.

Manual workflow

Run from the repository root in these phases: pnpm i --frozen-lockfile, pnpm build, then pnpm -r build-check, pnpm -r -F "@openai/*" dist:check, pnpm lint, pnpm test, and pnpm format:check:changed.
The skill may execute the final validation phase in parallel, but every step above must still pass.
Do not skip steps; stop and fix issues immediately when any step fails.
Re-run the full stack after applying fixes so the commands execute with the same barriers and coverage.
The install intentionally runs without forcing CI or prompt-confirmation settings. If pnpm reports incompatible node_modules, stop and diagnose the configuration mismatch instead of silently recreating dependencies.

Resources

scripts/run.sh

Executes the full verification sequence (including declaration checks) with fail-fast semantics.
Keeps pnpm i --frozen-lockfile and pnpm build as barriers, then delegates independent validation steps to concurrently.
Prefer this entry point to ensure the commands always run from the repo root with the expected fail-fast behavior.

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.

Code Change Verification

Overview

Quick start

Keep this skill at ./.agents/skills/code-change-verification so it loads automatically for the repository.

Run the skill in the user's selected checkout without changing worktrees or branches.

macOS/Linux: bash .agents/skills/code-change-verification/scripts/run.sh.

Windows: powershell -ExecutionPolicy Bypass -File .agents/skills/code-change-verification/scripts/run.ps1.

If any command fails, fix the issue, rerun the script, and report the failing output.

Confirm completion only when all commands succeed with no remaining issues.

Manual workflow

Run from the repository root in these phases: pnpm i --frozen-lockfile, pnpm build, then pnpm -r build-check, pnpm -r -F "@openai/*" dist:check, pnpm lint, pnpm test, and pnpm format:check:changed.

The skill may execute the final validation phase in parallel, but every step above must still pass.

Do not skip steps; stop and fix issues immediately when any step fails.

Re-run the full stack after applying fixes so the commands execute with the same barriers and coverage.

The install intentionally runs without forcing CI or prompt-confirmation settings. If pnpm reports incompatible node_modules, stop and diagnose the configuration mismatch instead of silently recreating dependencies.

Resources

scripts/run.sh

Executes the full verification sequence (including declaration checks) with fail-fast semantics.

Keeps pnpm i --frozen-lockfile and pnpm build as barriers, then delegates independent validation steps to concurrently.

Prefer this entry point to ensure the commands always run from the repo root with the expected fail-fast behavior.

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.

code-change-verification