Use this before submission when the empirical story is not yet locked. ICSME reviewers are maintenance and evolution empiricists, and because the venue has no revision round, the evaluation must be complete on submission — you cannot promise a missing analysis and add it later. The organizing principle is evidence proportional to the claim, tested on real systems with real change history, not on synthetic snapshots.
| Maintenance/evolution claim | Matching evidence | Reject pattern avoided |
|---|---|---|
| "Technique reduces change impact" | Real change sets from history, set-size deltas with CIs vs. tuned baseline | "Evaluated on synthetic edits only" |
| "Refactoring preserves behaviour" | Test outcomes / regression evidence across applications on real code | "Assumed safe, never checked" |
| "Debt predicts future defects" | Longitudinal link from debt measure to later real defects, with survivorship handled | "Cross-sectional correlation claimed causal" |
| "Improves comprehension" | Human study with tasks, accuracy/time, effect sizes | "Tool complexity mistaken for understanding" |
| "Finding holds across systems" | Diverse, dated sample + explicit external-validity limits | "One ecosystem, claimed universal" |
| "The model adds the value" | Ablation removing the model vs. lexical/heuristic features | "Model's marginal contribution never isolated" |
[Corpus] pin repository SHAs; record extraction date and the time window studied;
archive the *extracted* dataset, not just the query
[Selection] state inclusion/exclusion criteria and resulting N; ship the filtering script
[Hygiene] document fork/duplicate/bot handling; report how merges and renames were resolved
[Unit] state whether the unit is commit, PR, release, or file, and defend it for the claim
[History] address survivorship and left-truncation of the change history explicitly
When an LLM is in the loop (increasingly common for comprehension, summarization, and repair):
[Contamination] are subject systems plausibly in the model's training data? report model cutoff
vs. project/commit dates; prefer post-cutoff or held-out systems
[Determinism] fix temperature/seed where possible; report the sampling settings
[Caching] store raw prompts and raw responses in the artifact; a live-API study re-samples
rather than reproduces
[Versioning] record exact model identifiers and access dates; models drift under a name
[Ablation] isolate the model's marginal value against a non-LLM maintenance baseline
Suppose the paper claims a technique predicts change-impact sets more precisely than a prior tool. The matching plan: draw real change sets from dated release histories of several evolving systems; run both tools with an equal, documented budget; report precision/recall with confidence intervals and an effect size; manually inspect a sample of predicted impacts for spurious inclusion; handle survivorship by stating which systems' histories are truncated; and bound external validity (languages, domains) as a threat — every number traceable to a logged run in the artifact.
[Evaluation readiness] strong / adequate / weak
[Claim -> evidence map] <claim: systems/history-window/metric/statistic>
[Mining provenance] <SHAs / extraction date / selection / fork-bot hygiene handled? yes/no>
[Baseline fairness] <baseline -> tuned? equal budget? documented?>
[Confounds by design] <survivorship / unit-of-analysis / contamination -> how bounded>
[Decision-critical gap] <the one thing that must be complete before submission — no revision round>