Skip to main content
AI/MLjmagly

provenance-create

Create a W3C PROV-compliant provenance record for an artifact

Stars
141
Source
jmagly/aiwg
Updated
2026-05-31
Slug
jmagly--aiwg--provenance-create
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-create/SKILL.md -o .claude/skills/provenance-create.md

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

Provenance Create Command

Create a provenance record for a new or existing artifact, establishing its Entity-Activity-Agent chain.

Instructions

When invoked, create provenance record:

  1. Read artifact

    • Load file at specified path
    • Compute SHA-256 content hash
    • Extract @-mentions for derivation sources

  2. Determine metadata

    • Activity type: generation (new) or modification (existing)
    • Agent: from --agent flag or infer from context
    • Derivation sources: from @-mentions or --derived-from flags

  3. Generate URN identifiers

    • Entity: urn:aiwg:artifact:<relative-path>
    • Activity: urn:aiwg:activity:<type>:<name>:<sequence>
    • Agent: urn:aiwg:agent:<agent-name>

  4. Create provenance record

    • Generate YAML conforming to @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/schemas/provenance/prov-record.yaml
    • Include entity, activity, agent, and relationships
    • Include timestamps and content hash

  5. Validate record

    • Verify schema compliance
    • Check all referenced entities exist
    • Verify derivation sources are valid paths

  6. Save record

    • Write to .aiwg/research/provenance/records/<artifact-name>.prov.yaml
    • Update provenance index if it exists

  7. Report

    • Display created record summary
    • Show derivation chain

Arguments

  • [artifact-path] - Path to artifact (required)
  • --derived-from [paths...] - Explicit derivation sources
  • --activity [type] - Activity type: generation, modification, refactoring, testing, review, derivation (default: generation)
  • --agent [name] - Agent that created the artifact (default: inferred)
  • --output [path] - Custom output path for provenance record
  • --no-validate - Skip schema validation

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/research/provenance/docs/provenance-guide.md - Provenance guide
  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/provenance-tracking.md - Provenance tracking rules

Storage Routing (#934, #968)

This skill's persistence flows through resolveStorage('provenance'). On the default fs backend provenance records live at .aiwg/provenance/. To redirect into Obsidian, Logseq, Fortemi, or another backend, configure roots.provenance or backends.provenance in .aiwg/storage.config (#934).

aiwg provenance path                                # resolved root
aiwg provenance list --prefix activities/
aiwg provenance get activities/2026-04-28-deploy.json
echo '{"@context":"...","activity":"..."}' | aiwg provenance put activities/x.json