micro-artifact-evaluation
GitHub指导作者为MICRO会议准备可复现性评估的工件。涵盖ACM徽章目标、解决长仿真时间问题的分层测试策略、打包清单及许可证处理，确保 evaluator 能高效验证结果。
Trigger Scenarios
Install
npx skills add brycewang-stanford/Awesome-Journal-Skills --skill micro-artifact-evaluation -g -y
SKILL.md
Frontmatter
{
"name": "micro-artifact-evaluation",
"description": "Use when preparing a MICRO artifact for post-acceptance evaluation — packaging simulators, configs, traces, and scripts so evaluators can regenerate the paper's figures, targeting the ACM Available\/Functional\/Reproducible badges, handling licensed workloads and long simulations, and earning the optional artifact appendix."
}
MICRO Artifact Evaluation
MICRO runs artifact evaluation after acceptance: authors of accepted papers are
invited to submit artifacts, an Artifact Evaluation Committee reviews them, and
successful papers carry ACM badges in the proceedings. Anchors here are the MICRO
2025 AE pages (micro58/submit/artifacts.php, verified 2026-07-08); the 2026
edition's AE page and calendar are 待核实 — expect the same architecture, verify
the dates.
Badge targets and what each demands
| Badge (ACM) | Bar | Microarchitecture-specific gotcha |
|---|---|---|
| Artifact Available | Deposited on a public archival repository — Zenodo, FigShare, Dryad named in 2025 | A GitHub repo alone fails; it is not archival. Deposit a tagged snapshot, keep GitHub as the living mirror |
| Artifact Functional | Documented, complete, exercisable | Simulator builds on a clean machine — your decade of dotfiles is not in the package |
| Results Reproducible | Evaluators regenerate the paper's main claims | Simulation time is the enemy: full SPEC runs take days-weeks; provide a subset path |
Papers passing AE also earned, in 2025, the right to a two-page artifact appendix in the camera-ready, free of charge — reproduction instructions published with the paper.
The time-budget problem is the design problem
A MICRO artifact's hardest constraint is that cycle-level simulation is slow and evaluators have finite weeks. Design three nested entry points:
make smoke # ~30 min: one workload region, one config — proves the plumbing
make key # ~1 day: the headline figure (Fig. 3) on a representative subset
make full # ~1 week: every figure, every sweep — for the determined evaluator
Document expected runtime and disk for each. State which paper claims each tier
supports. An evaluator who finishes make key in a day and sees Fig. 3 appear is
an evaluator who awards the badge.
Package inventory
- Top-level README: paper title, badge targets, the three entry points, a
figure-to-command map ("Fig. 5 ⇐
make fig5, ~6 h"), hardware/software requirements (the 2025 process asked for these to route artifacts to suitable evaluators). - Environment capture: container image or pinned build script for the simulator toolchain; host assumptions stated (cores, RAM — parallel sims are memory-hungry).
- Everything
micro-reproducibilitypinned: simulator commit + patches, config files for baseline/mechanism/ablations, manifests, plotting scripts. - Raw stats for the paper's figures, so evaluators can verify plots even before re-simulating — this alone often satisfies partial reproduction.
Licensed and unshippable inputs
- SPEC CPU binaries/inputs cannot be redistributed. Ship the trace-generation recipe (tool version, SimPoint parameters, flags) plus, where licensing allows, the derived traces; otherwise document how an evaluator with a SPEC license regenerates them, and rest the Reproducible claim on shippable workloads.
- Proprietary RTL or PDK data (synthesis libraries are NDA'd): report the flow and constraints, mark the RTL numbers as not independently reproducible, and scope the badge request to the simulation results. Honest scoping beats a failed evaluation.
- FPGA/silicon dependencies: offer remote access if institutionally possible, or pre-recorded measurement logs with the analysis scripts.
Common failure modes, ranked by frequency of pain
| Failure | Root cause | Prevention |
|---|---|---|
| Build breaks on evaluator machine | Undeclared host dependency (library, kernel version, python package) | Container or lockfile; test in a fresh VM |
| Numbers regenerate but differ slightly | Simulator nondeterminism or a config drifted after paper freeze | Determinism check + tagged commit at submission (micro-reproducibility) |
| Evaluator cannot find which command makes which figure | README written for the authors, not strangers | Figure-to-command map, tested by a labmate who did not build the artifact |
| Full run exceeds the AE window | No tiering | smoke/key/full entry points with honest runtime labels |
| Licensed inputs block everything | SPEC traces shipped nowhere, no fallback | Shippable-workload subset carrying the Reproducible claim |
A dry run fixes four of the five: hand the package to someone outside the project with only the README, and watch — silently — where they stall.
Working with evaluators
AE is collaborative, not adversarial: expect questions, fix breakage fast, and
keep a changelog of package updates during the window. Budget author-time in
August–September (the window overlaps the September 11 camera-ready in the 2026
calendar — plan both, see micro-camera-ready). The final deposit that carries
the Available badge must be the fixed package, re-uploaded to the archival
repository with a new version DOI.
Minimal artifact layout that evaluators navigate well
artifact/
├── README.md # badges sought, 3 entry points, figure-to-command map
├── Dockerfile # or install.sh with pinned versions
├── Makefile # smoke / key / full targets
├── configs/ # baseline.json, mechanism.json, ablations/
├── manifests/ # one YAML per experiment batch (micro-reproducibility)
├── stats-paper/ # the raw stats behind every published figure
├── plots/ # scripts: stats -> exact paper figures
├── traces/RECIPE.md # how to regenerate licensed traces (nothing licensed inside)
└── LIMITS.md # known fidelity gaps; claims stay inside them
Two conventions matter more than the tree itself: the README's first screen must
answer "what do I run first and how long will it take," and nothing an evaluator
needs may require reading source code to discover. If the paper linked an
anonymized repo at submission (micro-supplementary), this layout should already
exist — AE prep is then a de-anonymization pass plus the archival deposit.
Output format
[Badge plan] Available: deposit target · Functional: yes/no · Reproducible: scoped to <claims>
[Entry points] smoke/key/full runtimes measured on clean machine: <times>
[Figure map] figures with regenerate-commands: N/M
[Unshippables] licensed inputs + documented workaround each
[Environment] container/build-script tested from scratch: yes / no
[Calendar] AE dates vs camera-ready overlap plan (2026 dates 待核实)
Version History
- 9f86f09 Current 2026-07-19 16:58
