Skip to main content
AI/MLjmagly

discovery-log

Record the source-tracking `discovery` block on a research-corpus citation sidecar — where/how a paper was found (surface, via, curator). Runs via `aiwg corpus discovery-log`.

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

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

Discovery Log

Record how a paper was discovered — the optional discovery: block in a citation sidecar's frontmatter (SOURCE-TRACKING schema). The read views by-source / by-curator (#1492) consume this.

How to run

aiwg corpus discovery-log --ref REF-640 --surface x-account --via "x.com/@askalphaxiv" --curator PROF-S-askalphaxiv          # dry-run (prints the block)
aiwg corpus discovery-log --ref REF-640 --surface x-account --via "x.com/@askalphaxiv" --curator PROF-S-askalphaxiv --write  # splice into the sidecar
aiwg corpus discovery-log --ref REF-641 --surface x-search --write    # surface only, no curator
  • Adds or replaces the discovery: block in the sidecar frontmatter, preserving the rest of the file. Dry-run unless --write.
  • --surface (required) vocab: x-account | x-search | x-bookmarks | x-foryou | x-following | rss | newsletter | web | referral | direct.
  • --curator (optional) is a PROF-S- id; set it only when the source came through a named, repeatable curator. Omit for direct/search-found papers (curator-id: null). The block is OPTIONAL by design — absence is never an error.

Distinct from radar sources-searched (surfaces queried during a freshness refresh): discovery records where a paper was originally found.

Triggers

  • "log how we found REF-XXX"
  • "record the discovery source for this paper"
  • "set the curator for REF-XXX"
  • /discovery-log

References

  • @$AIWG_ROOT/src/artifacts/corpus-tools/discovery-log.ts — implementation
  • curator-status / curator-init skills; @$AIWG_ROOT/agentic/code/frameworks/research-complete/docs/source-tracking.md — schema