# Validate Image Updates

> Enforces the mandatory sequential validation workflow when a new workstation image is built or the codebase is modified.

- Skill: `googlecloudplatform/validate-image-updates` (Agent Skill, multi-file: 8 files)
- Install (CLI): `npx skillmds@latest add googlecloudplatform/validate-image-updates`
- Raw SKILL.md: https://api.skillmd.com/api/skills/googlecloudplatform/validate-image-updates/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Productivity
- License: Apache-2.0
- Author: GoogleCloudPlatform (https://skillmd.com/u/googlecloudplatform)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/googlecloudplatform/validate-image-updates

---


# Validate Image Updates

This skill provides the authoritative 6-step workflow for ensuring system integrity during image updates.

## Mandatory Sequential Workflow

When a new image build is triggered or the codebase is modified, agents MUST follow this sequence:

1.  **Stop Workstation**: Ensure the target instance is in `STATE_STOPPED` to prevent hot-patching drift.
2.  **Run Local Tests**: Execute `./scripts/run_local_tests.sh` from the skill directory. This runs linters, unit tests, and frontend build checks.
3.  **Monitor Build**: If local tests pass, wait for the Cloud Build to reach `SUCCESS`.
4.  **Start Workstation**: Only after a successful build.
5.  **Run Integration Tests**: Execute `./scripts/run_integration_tests.sh` on the live instance to verify service orchestration.
6.  **Persona Reviews**: Conduct in-depth reviews (UX, SEC, SRE, etc.) once the system is live.

## Technical Health Check

Technical health is verified by ensuring all tests in the `validate-image-updates` suite pass before starting the workstation.

## Integration Dependencies

This skill depends on the correct configuration of the `gcloud` CLI and access to the Cloud Workstations API.