drmoisan 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.
| Validator | Validates schema | Owning stage skill |
|---|---|---|
dev.discovery.validate-profile |
(domain profile) | discovery-repo-inventory |
dev.discovery.validate-evidence-reference |
schemas/discovery/v1/evidence-reference.schema.json |
discovery-repo-inventory, discovery-runtime-characterization |
dev.discovery.validate-feature-contract |
schemas/discovery/v1/feature-contract.schema.json |
discovery-coverage-ledger |
dev.discovery.validate-coverage-ledger |
schemas/discovery/v1/coverage-ledger.schema.json |
discovery-coverage-ledger |
dev.discovery.validate-runtime-scenario |
schemas/discovery/v1/runtime-characterization-scenario.schema.json |
discovery-runtime-characterization |
dev.discovery.validate-parity-matrix |
schemas/discovery/v1/parity-matrix.schema.json |
discovery-parity-matrix |
dev.discovery.validate-unspecified-behavior |
schemas/discovery/v1/unspecified-behavior-record.schema.json |
discovery-behavior-reconciliation |
dev.discovery.validate-product-decision |
schemas/discovery/v1/product-decision-record.schema.json |
discovery-behavior-reconciliation |
Completion Gate
After all stages pass their per-stage validators, run
dev.discovery.validate-all as the workflow completion gate. It validates the
full artifact set across all seven schemas under schemas/discovery/v1/:
schemas/discovery/v1/feature-contract.schema.jsonschemas/discovery/v1/coverage-ledger.schema.jsonschemas/discovery/v1/runtime-characterization-scenario.schema.jsonschemas/discovery/v1/parity-matrix.schema.jsonschemas/discovery/v1/unspecified-behavior-record.schema.jsonschemas/discovery/v1/product-decision-record.schema.jsonschemas/discovery/v1/evidence-reference.schema.json
An empty error list from dev.discovery.validate-all means the workflow is
complete. A non-empty list names the exact artifact and problem; route each entry
back to its owning stage skill using the per-stage table above, correct the
artifact, and re-run the gate.
Referenced Skills
discovery-workflow— stage order and the canonical Referenced Contracts registry (analyzer command, agent slugs, schema paths, validators).
Notes
- This skill names no domain-specific identifier; artifact locations are read from the domain profile at runtime.