Skip to main content
AI/MLjmagly

provenance-validate

Validate provenance records and chains for completeness and consistency

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--provenance-validate
View on GitHubRaw SKILL.md

// install — copy + paste into any project

mkdir -p .claude/skills && curl -fsSL https://raw.githubusercontent.com/jmagly/aiwg/HEAD/agentic/code/frameworks/sdlc-complete/skills/provenance-validate/SKILL.md -o .claude/skills/provenance-validate.md

Drops the SKILL.md into .claude/skills/provenance-validate.md. Works with Claude Code, Cursor, and any agent that loads SKILL.md files from .claude/skills/.

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