Skip to content

Add a Claude Code skill for SPHEREx data-release notebook updates - #402

Draft
jkrick wants to merge 4 commits into
Caltech-IPAC:mainfrom
jkrick:spherex-release-skill
Draft

jkrick wants to merge 4 commits into
Caltech-IPAC:mainfrom
jkrick:spherex-release-skill

Conversation

@jkrick

@jkrick jkrick commented Oct 30, 2026 •

Copy link
Copy Markdown
Contributor

Adds .claude/skills/spherex-data-release/, a Claude Code project skill that captures how the SPHEREx tutorials were updated for DR1 (#392, PR #401), so the next release (DR2, a new Quick Release, a reprocessing) can follow the same steps instead of rediscovering them.

What's in it

  • SKILL.md: the workflow. Keep a plan file, check what's live on the pre-release hosts, ask IRSA/SSDC early for what only they can provide (SIA collection names, DOI, Explanatory Supplement), make and test the changes, then the release-day steps.
  • references/touchpoints.md: every release-dependent spot in each SPHEREx notebook, with its DR1 value.
  • references/decisions.md: rules settled during DR1 (show only the newest release, which DOI to cite, which flags count as bad, who owns which notebook), gotchas that cost time, and DR1's release-day checklist.
  • scripts/check_release.sh <release>: reports what's live for a release on irsadev, irsatest and production (SIA, TAP, IBE, cloud_access), on S3, and the Explanatory Supplement.
  • scripts/run_sdt_release_test.py: executes the whole Source Discovery Tool notebook against a pre-release host (SIA, IBE in place of S3, that host's Firefly viewer) and prints a summary of what to check. Running every cell is what found the D4/D5 detector bug fixed in the DR1 PR.

Notes for reviewers

  • This is the first .claude/ directory in the repo. Claude Code picks up skills in .claude/skills/ automatically; nothing else uses them. The docs build (MyST, driven by toc.yml) and the notebook tests (which look only under tutorials/) ignore it.
  • No notebook changes. The skill describes the notebooks as they are after the DR1 PR, so it's easiest to review after that one.
  • It will get one more update after DR1 is released (2026-11-12) with anything release day teaches, so it should not merge before Update SPHEREx tutorials for DR1 #401
  • Both scripts were run against DR1 on IRSA's pre-release hosts on 2026-10-30.

🤖 Generated with Claude Code

jkrick and others added 4 commits October 29, 2026 12:21
Captures the DR1 update as a repeatable workflow: release-dependent spots
in each notebook, settled decisions and gotchas, a release-availability
check script, and a parameterized Source Discovery Tool test harness.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
run_sdt_release_test.py gains --sia-host to run the notebook's own SIA
cells against irsadev; decisions.md notes how to test SIA notebooks there.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
TAP's ivoa.obscore leaves cloud_access blank even where SIA fills it
(production QR3 included), so the script reported a false blank. Ask
SIA, as the notebooks do, at the position of one of the release's own
images.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The old test ran selected cells and stood in a 2MASS star for secs.
9-11, which hid sec. 6 picking a D5 image instead of D4 on DR1. The
script now executes every cell on a copy against the pre-release host
(SIA, IBE in place of S3, that host's Firefly viewer) and prints a
summary of what to check. Also record the DR1 gotchas: detector
selection by name, the hard-coded selected_ids source, Firefly and
MOST on pre-release hosts.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@jkrick jkrick self-assigned this Oct 30, 2026
@jkrick jkrick added infrastructure Infrastructure related issues/PRs. content: spherex Content related issues/PRs for notebooks with SPHEREx relevance labels Oct 30, 2026
@jkrick

jkrick commented Nov 4, 2026

Copy link
Copy Markdown
Contributor Author

@DeekshaMohanty as you are doing the final release, it would be super helpful if you (or your AI) could update this skill with any last minute items that are good to document about this workflow, that would help make this smoother for the next go around.

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

content: spherex Content related issues/PRs for notebooks with SPHEREx relevance infrastructure Infrastructure related issues/PRs.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant