Skill definition
hi-cross-artifact-validation
Validate consistency across discovery outputs (use-case, API, data-model, behavior, command-spec) by checking stable ID resolution, actor/auth alignment, state-transition lifecycle matches, schema compatibility, and cross-domain evidence coherence. Use after leaf discovery skills complete, before refinement.
SKILL.md
Cross-Artifact Validation
Read shared/leaf-contract.md. Validate cross-domain consistency without modifying source artifacts. Operate as a read-only validation leaf.
Inputs
Require output_root containing validated leaf manifests and artifacts from at least two discovery domains. Accept domains list to limit scope (default: all present domains), strict flag (default false), and output_dir (default cross-validation).
Block when fewer than two domain manifests are available.
Validation Checks
| Check | Domains | Rule |
|---|---|---|
| Stable ID resolution | all | Every stable ID referenced across domains resolves to one entity; flag orphaned or ambiguous IDs |
| Actor/auth alignment | use-case + API | Use-case actors match API auth matrix entries; flag actors without auth or auth without actors |
| State lifecycle | behavior + data-model | Behavior state transitions match data-model lifecycle states; flag unmapped transitions |
| Schema compatibility | command-spec + API | Command-spec fields align with API request/response schemas; flag type mismatches |
| Evidence coherence | all | Evidence status across domains is consistent; flag verified-contradicted conflicts |
| Dependency coverage | all | Cross-domain dependencies cited in one artifact exist in the target domain |
Workflow
- Load all available domain manifests and validate their hashes.
- Build a unified stable-ID index from all domain artifacts.
- Run each applicable validation check from the table above.
- Classify findings as
error(blocks consistency),warning(potential issue), orinfo(observation). - Write
cross-validation-report.mdwith findings grouped by check,cross-validation-results.jsonper validation-contract.md, andartifact-manifest.json.
When strict=true, any error finding forces blocked status. When strict=false, errors are warning-level and status is partial.
Completion
Complete when all applicable checks run, every finding has severity/domain/evidence/affected-IDs, the report is navigable from the index, and the manifest validates. No source artifacts are modified.
Continue exploring