| name | discovery-validate-artifacts |
| description | Canonical validation-gate mechanics for the discovery workflow. Use when running the per-artifact discovery validators after each stage and the completion gate at the end, interpreting the empty-error-list pass semantics, and routing any validator error back to the owning stage skill. Seventh and final stage. |
| allowed-tools | Bash Read |
Discovery Validate Artifacts
Owns the canonical validation-gate mechanics for the discovery and
parity-definition workflow. Each discovery artifact is validated against its
schema by a dev.discovery.validate-* console script after its owning stage,
and dev.discovery.validate-all runs as the workflow completion gate. This skill
is the single canonical location for the pass/fail semantics; stage skills defer
to it by name.
When to Use This Skill
- A stage has produced an artifact and you need to validate it before the next
stage proceeds.
- You have completed all stages and need to run the workflow completion gate.
- A validator reported errors and you need the routing rule back to the owning
stage skill.
Prerequisites
- The relevant discovery artifacts exist under the profile's artifact root.
- The validator console scripts are available (registry in
discovery-workflow).
Pass/Fail Semantics
Every dev.discovery.validate-* invocation yields a list[str] of error
messages. An empty list is a pass; a non-empty list is a failure whose entries
name the exact problems. The validators never mutate the artifacts they check.
Per-Stage Validators
Run each validator after its owning stage produces its artifact. On a non-empty
error list, return to the named owning stage skill, correct the artifact, and
re-run the validator until the list is empty.
