Skip to main content
AI/MLjmagly

provenance-query

Query provenance chains to trace artifact derivation and impact

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

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

Provenance Query Command

Query provenance chains to understand artifact derivation, impact, and attribution.

Instructions

When invoked, query provenance graph:

  1. Load provenance graph

    • Read all records from .aiwg/research/provenance/records/
    • Build in-memory graph of entity relationships
    • Index by entity URN for fast lookup

  2. Execute query (based on subcommand)

    trace - Full derivation chain for an artifact:

    • Follow wasDerivedFrom relationships backward to root sources
    • Display as indented tree showing derivation types
    • Include depth limiting with --depth

    impact - What depends on this artifact:

    • Follow wasDerivedFrom relationships forward
    • Show all artifacts that derive from the queried artifact
    • Useful for understanding change impact

    orphans - Find artifacts without provenance:

    • Scan .aiwg/ and src/ for files
    • Compare against provenance records
    • List untracked artifacts

    agents - Show agent attribution:

    • Group provenance records by agent
    • Show what each agent created/modified
    • Include activity counts and timestamps

  3. Format output

    • Default: indented tree
    • --format table: Markdown table
    • --format mermaid: Mermaid diagram
    • --format json: Raw JSON

  4. Display results

    • Show query results
    • Include summary statistics

Subcommands

  • trace [path] - Full derivation chain for artifact
  • impact [path] - What depends on this artifact
  • orphans - Find artifacts without provenance
  • agents - Show agent attribution summary

Arguments

  • [artifact-path] - Path to artifact (required for trace/impact)
  • --direction [forward|backward|both] - Traversal direction (default: both)
  • --depth [n] - Maximum traversal depth (default: unlimited)
  • --format [tree|table|mermaid|json] - Output format (default: tree)

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/schemas/provenance/prov-query.yaml - Query schema
  • @$AIWG_ROOT/agentic/code/frameworks/sdlc-complete/rules/provenance-tracking.md - Provenance tracking rules