Lean verification

Use the narrowest verification tier that can disprove the current change. The scripts capture full output under tmp/agent-logs/; successful runs return a two-line status, while failures return a bounded excerpt and the log path.

Verification tiers

# Red/green loop: pass one or more workspace-relative test paths.
npm run test:file -- libs/example/src/Foo.spec.ts

# Completed task or vertical slice: affected projects only.
npm run verify:changed

# Final pre-merge gate: full, non-mutating verification.
npm run verify:full

• test:file is the default during implementation. It groups paths by their nearest Vite/Vitest config and runs only those files.
• test:changed and verify:changed use Nx's affected project graph with origin/development as the base.
• verify:affected remains available as an explicit affected verification alias.
• verify:full uses lint:check, never the mutating npm run lint command.
• build:quiet builds affected projects when the change can affect bundling.

This workspace contains many Nx projects, so affected verification narrows typecheck, lint, test, and build work to the changed projects and their affected dependents. Prefer exact tests for the mid-task loop; reserve project-level affected checks for a completed slice. A successful affected run may execute no task when only docs or agent configuration changed, so it is not a substitute for the final full gate.

Verifying in a git worktree

A worktree that shares the main checkout's node_modules through a junction or symlink verifies the wrong tree unless you point Nx at it:

• Set NX_WORKSPACE_ROOT_PATH to the worktree (and NX_DAEMON=false) for every Nx command. An inherited value runs lint, tests and typecheck against the main checkout, which can be on another branch, and still reports success. Confirm that the Vitest RUN line shows the worktree path.
• Through the shared node_modules, @nx/dependency-checks, import/order, "The workspace is out of sync" and bare tsc (which resolves @epam/* into the main checkout) report errors that are not in the change. Do not run nx sync and do not "fix" them: lint the changed files with node node_modules/eslint/bin/eslint.js <files>, run the affected specs, and leave the full typecheck to CI.
• Before removing the worktree, remove the link first (cmd /c rmdir <worktree>\node_modules on Windows, rm <worktree>/node_modules elsewhere), then git worktree remove. git worktree remove --force and rm -rf follow the link and empty the main checkout's node_modules.

Verification cadence

Batch related edits for one task-list item before re-verifying. Do not rerun a suite after each individual edit. OpenSpec tasks should name their exact test files so the red/green loop does not require rediscovery.

Failure handling

Use the printed failure excerpt first. Search or read only the relevant portion of the saved log if that excerpt is insufficient; do not load the whole log or rerun with a verbose reporter by default. Keep --reporter=minimal so passing test logs do not enter the conversation.