test-verification-gate

name	test-verification-gate
description	Runtime test verification gate for Scenescape — image freshness checks, rebuild-before-test requirements, and retry policy.

AI Agent Skill: Test Verification Gate

Use this skill whenever a task adds or modifies tests.

Goal

Ensure runtime verification is completed and reported consistently.

Required Checklist

1. Identify the changed files and classify scope: unit, functional, ui or perf.
2. Select the narrowest pytest invocation that covers the modified tests:
   • Unit tests (no containers needed): pytest tests/sscape_tests/<test_file>.py
   • Functional/UI tests (containers needed): pytest tests/functional/<test_file>.py
3. If the test requires running containers and service code changed, rebuild the impacted service images before executing tests.
4. Execute the selected command.
5. If failures occur, confirm image freshness before code-level debugging:
   • Rebuild the impacted service runtime image if not rebuilt.
   • Rerun the same command once on fresh images.
6. If still failing, fix and rerun the same command.
7. Report exact command and concise pass/fail summary.

Image Freshness Mapping (Common)

• Changed controller/src/**, testing with pytest tests/functional/<test>.py:

  • make rebuild-controller
  • then run pytest tests/functional/<test>.py

• Changed manager/src/**, testing with pytest tests/functional/<test>.py:

  • make rebuild-manager
  • then run pytest tests/functional/<test>.py