isca-reproducibility

GitHub

用于确保ISCA论文实验结果可复现,通过固定模拟器版本、归档配置与工作量来源、记录随机种子及量化硬件运行差异,实现环境可恢复和结果生成链的完整性。

ISCA-Skills/skills/isca-reproducibility/SKILL.md brycewang-stanford/Awesome-Journal-Skills

Trigger Scenarios

需要重新生成论文中的图表数据 提交ISCA论文前的可复现性检查 归档实验配置以确保长期可访问

Install

npx skills add brycewang-stanford/Awesome-Journal-Skills --skill isca-reproducibility -g -y
More Options

Non-standard path

npx skills add https://github.com/brycewang-stanford/Awesome-Journal-Skills/tree/main/ISCA-Skills/skills/isca-reproducibility -g -y

Use without installing

npx skills use brycewang-stanford/Awesome-Journal-Skills@isca-reproducibility

指定 Agent (Claude Code)

npx skills add brycewang-stanford/Awesome-Journal-Skills --skill isca-reproducibility -a claude-code -g -y

安装 repo 全部 skill

npx skills add brycewang-stanford/Awesome-Journal-Skills --all -g -y

预览 repo 内 skill

npx skills add brycewang-stanford/Awesome-Journal-Skills --list

SKILL.md

Frontmatter
{
    "name": "isca-reproducibility",
    "description": "Use when making an ISCA paper's results regenerable — pinning simulator versions and local patches, archiving per-figure configuration manifests, recording workload provenance and sampling seeds, quantifying run-to-run variation on real hardware, and keeping the environment resurrectable through the February window."
}

ISCA Reproducibility

In architecture, "reproducible" means someone else — or you, three months later, mid-rebuttal — can regenerate every reported number from recorded state. Because most ISCA numbers come out of simulators, reproducibility here is largely configuration archaeology: the result is a function of tool commit, local patches, model parameters, workload build, region selection, and warm-up policy, and losing any one of those breaks the chain. The venue reinforces this culture with post-acceptance artifact evaluation under ACM badging (isca-artifact-evaluation); this skill covers the discipline that must exist before any AE form is filled.

The result chain, and what to pin at each link

Link What drifts silently Pin it by
Simulator Version-to-version behavior changes; forgotten local edits Exact commit hash + git diff of local patches archived with results
Machine model Config files edited during exploration One immutable config per experiment family; configs referenced by hash
Workloads Compiler/flags/inputs change binaries Archive binaries or lockfile the build; record input sets by checksum
Regions & warm-up Re-generated sampling points differ Store the region/checkpoint files themselves, plus the generator seed
Post-processing "Quick" notebook edits change aggregation Scripted stats path from raw output to figure, in the repo
Real-hardware runs Frequency scaling, thermal state, background load Record governor, SMT/turbo state, kernel; report dispersion over trials

One manifest per published number

Adopt the rule that every figure and table in the paper has a manifest and a regeneration command. This is the same manifest format isca-experiments specifies for methodology writing — one artifact serves both purposes.

results/
  f07-headline/
    manifest.ini          # instrument, model, measurement, workloads
    regen.sh              # rebuild -> run -> aggregate -> plot, no hands
    raw/                  # simulator stats as emitted (never edited)
    derived/f07.csv       # scripted aggregation output
    f07.pdf               # exactly the file included in the paper
# The submission-freeze ritual:
git tag isca27-submitted && \
  sha256sum results/*/f*.pdf paper/fig/*.pdf | sort | uniq -c -w64 | \
  awk '$1!=2 {print "FIGURE MISMATCH:", $0}'   # every paper figure must
                                               # hash-match a regenerated one

The freeze ritual catches the classic disaster: a figure in the PDF produced by a config that no longer exists because exploration continued after the plot was made.

Nondeterminism gets measured, not ignored

  • Deterministic simulators: verify determinism once (same commit + config + workload → bit-identical stats) and record that check; if a threading mode breaks it, either use the deterministic mode for reported numbers or report dispersion.
  • Real hardware: never a single trial. Report median and spread across ≥5 runs, with the machine-state record (governor, turbo, SMT, kernel, isolation measures). Reviewers increasingly ask; artifact evaluators always do.
  • Sampled simulation: the sampling procedure and seed are part of the result. Different SimPoint runs are different experiments — archive the chosen regions, don't regenerate them.

Paper-side reporting

The paper must let a skeptical reader reconstruct the setup without the artifact: a full configuration table (structures, sizes, latencies, DRAM timing), the workload list with inputs and build flags summarized, the region/ warm-up policy, and a variability statement wherever hardware was measured. Under double-blind rules the repository link, if given, must be fully anonymized (verified 2026 rule — see isca-submission); the common pattern is an anonymized-mirror link at submission, replaced by the real archival link in the camera-ready.

Resurrectability: the February requirement

The 2026 cycle's rebuttal/revision window (Feb 16 - Mar 6) arrived three months after submission. Teams whose environment had rotted — simulator tree no longer building, cluster images recycled, workload binaries lost — entered the window unable to run the experiments that would have saved the paper. Protocol:

  1. At submission: container or environment image built and stored; regen.sh for at least the headline figure verified from the image, not from a dev machine.
  2. Window-open minus one week (early February): resurrection drill — boot the image, regenerate one figure end to end, confirm hash match.
  3. Keep one team member's environment untouched between November and March; do not upgrade the shared toolchain mid-wait.

Habits that make all of this cheap

  • Results directories are append-only; a changed config is a new experiment ID, never an edit in place.
  • The plotting path takes experiment IDs, not file paths typed by hand.
  • A METHODS.md in the repo grows in real time — every methodological choice (why these regions, why this warm-up, why this DRAM model) written down when made, because November-you will not remember July-you's reasoning.
  • Weekly: regen.sh for the current headline figure runs green in CI or by hand. Regeneration that only works on deadline eve doesn't work.

Pre-submission reproducibility gate

  • Every paper figure hash-matches a scripted regeneration
  • Simulator commit + local patch diff archived alongside results
  • Workload binaries/inputs archived or deterministically rebuildable
  • Region/checkpoint files stored; sampling seeds recorded
  • Hardware numbers carry trial counts and dispersion
  • Environment image built, stored, and drill-tested
  • Anonymized artifact link (if any) resolves and contains no identity

Where each practice pays off later

Practice Pays off at...
Per-figure manifests + regen.sh Methodology section writing, rebuttal experiments, AE claims table
Submission-tag freeze ritual Camera-ready number verification, artifact snapshot selection
Environment image + drill The February window's first 48 hours
Hardware-state records Reviewer variance questions, Functional-badge documentation
METHODS.md running log Every "why did we choose X" question from reviewers and evaluators

Venue facts (AE program, badging, double-blind link rule) verified 2026-07-08 in ../../resources/official-source-map.md; the engineering protocol above is community best practice, applicable regardless of cycle.

Version History

  • 9f86f09 Current 2026-07-19 16:05

Same Skill Collection

AAAI-Skills/skills/aaai-artifact-evaluation/SKILL.md
AAAI-Skills/skills/aaai-author-response/SKILL.md
AAAI-Skills/skills/aaai-camera-ready/SKILL.md
AAAI-Skills/skills/aaai-experiments/SKILL.md
AAAI-Skills/skills/aaai-related-work/SKILL.md
AAAI-Skills/skills/aaai-reproducibility/SKILL.md
AAAI-Skills/skills/aaai-review-process/SKILL.md
AAAI-Skills/skills/aaai-submission/SKILL.md
AAAI-Skills/skills/aaai-supplementary/SKILL.md
AAAI-Skills/skills/aaai-topic-selection/SKILL.md
AAAI-Skills/skills/aaai-workflow/SKILL.md
AAAI-Skills/skills/aaai-writing-style/SKILL.md
AAMAS-Skills/skills/aamas-artifact-evaluation/SKILL.md
AAMAS-Skills/skills/aamas-author-response/SKILL.md
AAMAS-Skills/skills/aamas-camera-ready/SKILL.md
AAMAS-Skills/skills/aamas-experiments/SKILL.md
AAMAS-Skills/skills/aamas-related-work/SKILL.md
AAMAS-Skills/skills/aamas-reproducibility/SKILL.md
AAMAS-Skills/skills/aamas-review-process/SKILL.md
AAMAS-Skills/skills/aamas-submission/SKILL.md
AAMAS-Skills/skills/aamas-supplementary/SKILL.md
AAMAS-Skills/skills/aamas-topic-selection/SKILL.md
AAMAS-Skills/skills/aamas-workflow/SKILL.md
AAMAS-Skills/skills/aamas-writing-style/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-editor-strategy/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-evidence-standards/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-literature-synthesis/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-organizing-framework/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-proposal-framing/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-review-process/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-revision/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-submission/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-tables-figures/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-topic-selection/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-workflow/SKILL.md
Academy-of-Management-Annals-Skills/skills/amann-writing-style/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-contribution-framing/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-data-analysis/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-literature-positioning/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-methods/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-rebuttal/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-review-process/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-submission/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-tables-figures/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-theory-development/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-topic-selection/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-workflow/SKILL.md
Academy-of-Management-Journal-Skills/skills/amj-writing-style/SKILL.md
Academy-of-Management-Review-Skills/skills/amr-contribution-framing/SKILL.md
Academy-of-Management-Review-Skills/skills/amr-data-analysis/SKILL.md

Metadata

Files
0
Version
c82fe76
Hash
868c1c43
Indexed
2026-07-19 16:05

- 위키
Copyright © 2011-2026 iteam. Current version is 2.155.2. UTC+08:00, 2026-08-05 01:37
浙ICP备14020137号-1 $방문자$