Codex

provenance-create

Create a W3C PROV-compliant provenance record for an artifact

104 stars

byjmagly

View on GitHub Installation ↓

Best use case

provenance-create 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.

Create a W3C PROV-compliant provenance record for an artifact

Teams using provenance-create 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-create/SKILL.md --create-dirs "https://raw.githubusercontent.com/jmagly/aiwg/main/.agents/skills/provenance-create/SKILL.md"

Manual Installation

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

How provenance-create Compares

Feature / Agent	provenance-create	Standard Approach
Platform Support	Codex	Limited / Varies
Context Awareness	High	Baseline
Installation Complexity	Unknown	N/A

Frequently Asked Questions

What does this skill do?

Create a W3C PROV-compliant provenance record for an artifact

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

Cursor vs Codex for AI Workflows

Compare Cursor and Codex for AI coding workflows, repository assistance, debugging, refactoring, and reusable developer skills.

AI Agents for Coding

Browse AI agent skills for coding, debugging, testing, refactoring, code review, and developer workflows across Claude, Cursor, and Codex.

AI Agents for Marketing

Discover AI agents for marketing workflows, from SEO and content production to campaign research, outreach, and analytics.

SKILL.md Source

# 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