OpenSkillIndex← back to search
claude-code

Aiwg provenance-query

Query provenance chains to trace artifact derivation and impact

install
source · Clone the upstream repo
git clone https://github.com/jmagly/aiwg
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/jmagly/aiwg "$T" && mkdir -p ~/.claude/skills && cp -r "$T/.agents/skills/provenance-query" ~/.claude/skills/jmagly-aiwg-provenance-query && rm -rf "$T"
manifest: .agents/skills/provenance-query/SKILL.md
source content

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