Codex

provenance-validate

Validate provenance records and chains for completeness and consistency

104 stars

Best use case

provenance-validate is best used when you need a repeatable AI agent workflow instead of a one-off prompt.

It is a strong fit for teams already working in Codex.

Validate provenance records and chains for completeness and consistency

Teams using provenance-validate should expect a more consistent output, faster repeated execution, less prompt rewriting.

When to use this skill

  • You want a reusable workflow that can be run more than once with consistent structure.

When not to use this skill

  • You only need a quick one-off answer and do not need a reusable workflow.
  • You cannot install or maintain the underlying files, dependencies, or repository context.

Installation

Claude Code / Cursor / Codex

$curl -o ~/.claude/skills/provenance-validate/SKILL.md --create-dirs "https://raw.githubusercontent.com/jmagly/aiwg/main/.agents/skills/provenance-validate/SKILL.md"

Manual Installation

  1. Download SKILL.md from GitHub
  2. Place it in .claude/skills/provenance-validate/SKILL.md inside your project
  3. Restart your AI agent — it will auto-discover the skill

How provenance-validate Compares

Feature / Agentprovenance-validateStandard Approach
Platform SupportCodexLimited / Varies
Context Awareness High Baseline
Installation ComplexityUnknownN/A

Frequently Asked Questions

What does this skill do?

Validate provenance records and chains for completeness and consistency

Which AI agents support this skill?

This skill is designed for Codex.

Where can I find the source code?

You can find the source code on GitHub using the link provided at the top of the page.

Related Guides

SKILL.md Source

# Provenance Validate Command

Validate provenance records against the PROV schema and verify chain integrity.

## Instructions

When invoked, validate provenance:

1. **Load records**
   - Scan `.aiwg/research/provenance/records/` for all `.prov.yaml` files
   - If specific path provided, validate only that record

2. **Schema validation**
   - Validate each record against `@$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/provenance/prov-record.yaml`
   - Check required fields: entity.id, activity.id, agent.id
   - Verify URN format compliance
   - Verify timestamps are valid ISO-8601

3. **Entity resolution**
   - For each entity URN, verify the referenced file exists
   - Flag orphaned records (file deleted but provenance remains)
   - Detect untracked artifacts (files in tracked directories without provenance)

4. **Chain integrity**
   - Verify wasDerivedFrom sources exist and have their own provenance
   - Check bidirectional links (forward references have matching back-references)
   - Detect broken chains (missing intermediate records)

5. **Completeness check**
   - Scan `.aiwg/` directories for artifacts without provenance records
   - Calculate coverage percentage
   - List untracked artifacts

6. **Fix mode (--fix)**
   - Remove orphaned provenance records
   - Create stub records for untracked artifacts
   - Add missing bidirectional references

7. **Report**
   - Display validation results table
   - Show pass/fail/warning counts
   - List specific issues with remediation steps

## Arguments

- `[path]` - Specific record or directory to validate (default: all records)
- `--all` - Validate all records and check completeness
- `--strict` - Treat warnings as errors
- `--fix` - Auto-fix issues where possible
- `--report [path]` - Save validation report to file

## References

- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/agents/provenance-manager.md - Provenance Manager agent
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/provenance/prov-record.yaml - PROV record schema
- @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/provenance-tracking.md - Provenance tracking rules

Related Skills

Provenance Tracking

104
from jmagly/aiwg

W3C PROV-O patterns for tracking media derivation chains and production history

validate-metadata

104
from jmagly/aiwg

Validate AIWG extension definitions against the metadata schema and report errors with field names, line numbers, and remediation hints

Codex

validate-component

104
from jmagly/aiwg

Validate a single AIWG component (skill, agent, or command) for completeness and correctness

Codex

validate-addon

104
from jmagly/aiwg

Validate an entire AIWG addon package for completeness and release readiness

Codex

soul-validate

104
from jmagly/aiwg

Validate a SOUL.md file against community best practices and quality criteria

Codex

setup-validate

104
from jmagly/aiwg

Validate a `setup.aiwg.io/v1` SetupManifest file against the schema and run cons

Codex

research-provenance

104
from jmagly/aiwg

Query provenance chains and artifact relationships

Codex

reproducibility-validate

104
from jmagly/aiwg

Run a workflow multiple times and compare outputs to produce a similarity score and pass/fail verdict

Codex

provenance-report

104
from jmagly/aiwg

Generate provenance coverage dashboard and statistics

Codex

provenance-query

104
from jmagly/aiwg

Query provenance chains to trace artifact derivation and impact

Codex

provenance-create

104
from jmagly/aiwg

Create a W3C PROV-compliant provenance record for an artifact

Codex

prose-validate

104
from jmagly/aiwg

Validate an OpenProse program file against Prose contract grammar without executing it — checks frontmatter, contract structure, service references, and strategy syntax

Codex