gsd-validation
Automated post-phase validation workflow for GSD phases.
Purpose
Run a deterministic verification pipeline after implementation:
- verify work
- analyze flow gaps
- apply HITL decision gate when gaps exist
- execute runtime test stack (servers, browser, logs)
- emit final report artifacts
Triggers
Use this skill when the request includes:
- validating a finished phase end-to-end
- combining
/gsd-auto-validateand/gsd-analyze-flow - automated browser + server log validation
- safe teardown requirements in shared/swarm environments
Workflow
- Parse phase id and execution mode (
quick|full) - Run
/gsd-auto-validate <phase> - Run
/gsd-analyze-flow <phase> - If gaps exist, enforce HITL gate using
references/gate-policy.md - If approved for tests, execute runtime tools in this order:
gsd-run-creategsd-server-startgsd-server-wait-readygsd-playwright-executegsd-logs-collectgsd-server-stop-ownedgsd-run-finalize
- Render final report from
references/report-template.md
Runtime Tool Contract Expectations
gsd-run-create: creates run workspace and returnsrunIdgsd-server-start: starts tracked process and records ownership metadatagsd-server-wait-ready: verifies readiness with probe evidencegsd-playwright-execute: runs browser tests and stores artifactsgsd-logs-collect: produces structured issues with severitygsd-server-stop-owned: terminates only validated run-owned processesgsd-run-finalize: emitsFINAL-VALIDATION.mdandFINAL-VALIDATION.json
Failure Handling
- On verify or flow-analysis failure: finalize run as
failed - On gap gate stop or fix-plan path: finalize run as
blocked - On runtime tool failure: continue teardown, then finalize run as
failed - On teardown safety skip: include warnings in final report, never force kill unknown processes
Modes
| Mode | Behavior |
|---|---|
| quick | smoke-level test depth, minimal artifacts |
| full | complete flow checks, visual evidence, extended logs |
Safety Rules
- never kill processes not proven as run-owned
- never bypass gap gate without explicit user decision
- always preserve run artifacts even on partial failure
References
references/gate-policy.mdreferences/report-template.md