Skip to content
Skill

fse-experiments

by brycewang-stanford

AI Summary

Use this before submission when the empirical story is not yet locked. FSE reviewers are SE empiricists; the evaluation is where a good idea is won or lost. The organizing principle is on subjects and baselines a skeptic would accept.

Install

Copy this and paste it into Claude Code, Cursor, or any AI assistant:

I want to install the "fse-experiments" skill in my project.

Please run this command in my terminal:
# Install skill into your project
mkdir -p .claude/skills/fse-experiments && curl --retry 3 --retry-delay 2 --retry-all-errors -o .claude/skills/fse-experiments/SKILL.md "https://raw.githubusercontent.com/brycewang-stanford/Awesome-Journal-Skills/main/FSE-Skills/skills/fse-experiments/SKILL.md"

Then restart Claude Code (or reload the window in Cursor) so the skill is picked up.

Description

Use when designing or auditing ESEC/FSE empirical evaluations, covering real subject systems, fair baselines, SE-standard statistics and effect sizes, qualitative and mixed-methods rigor, contamination-aware LLM ablations, provenance for mining studies, and matching evidence to the shape of each software-engineering claim.

FSE Experiments

Use this before submission when the empirical story is not yet locked. FSE reviewers are SE empiricists; the evaluation is where a good idea is won or lost. The organizing principle is evidence proportional to the claim — the study must test the thing the paper actually asserts, on subjects and baselines a skeptic would accept.

Evaluation audit

• Match evidence to the claim shape. A claim about developer behavior needs behavior data; a claim about detection needs a labeled ground truth; a claim about scalability needs runtime on realistically sized inputs. Accuracy against a proxy label is not evidence for a practice claim. • Use real subject systems, sampled by a stated criterion, and list them in the artifact. Toy benchmarks invite the "does this hold on real code?" reject. • Choose fair baselines, including the strongest prior technique and a simple-but-reasonable alternative, tuned with a documented, equal budget. An untuned baseline is a scored weakness. • Report SE-standard statistics: effect sizes (not just p-values), confidence intervals, appropriate tests, and corrections for multiple comparisons. Say what variance and how many runs. • Hold qualitative work to method: coding schemes, inter-rater agreement, saturation, and an audit trail — mixed-methods rigor is native to FSE, not a second-class option. • Pin provenance for mining and LLM studies (see the code block) so the evaluation reproduces rather than re-samples. • Design threats in, not on: know before you run which confounds and generalization limits the study will have, and instrument to bound them.

Claim-to-evidence design table

| SE claim | Matching evidence | Reject pattern avoided | |---|---|---| | "Technique detects more real defects" | Labeled real faults, precision/recall with CIs vs. tuned baseline | "Evaluated on injected/toy faults only" | | "Developers act on the output" | Behavioral outcome data on real projects | "Plausibility rating stands in for usefulness" | | "Scales to large systems" | Runtime/memory across realistic sizes | "Only small inputs tested" | | "Finding generalizes" | Diverse subject 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" |

Contamination-aware LLM evaluation

When an LLM is in the loop, the reviewer's first questions are about leakage and reproducibility: `text [Contamination] are test subjects plausibly in the model's training data? report cutoff vs. project dates; prefer post-cutoff or held-out subjects [Determinism] fix temperature/seed where possible; report the sampling settings [Caching] store raw prompts and raw responses in the artifact; a live-API-only study cannot be reproduced, only re-sampled [Versioning] record exact model identifiers and access dates; models change under a name [Ablation] isolate the model's marginal value against a non-LLM baseline `

Discussion

0/2000
Loading comments...

Health Signals

MaintenanceCommitted 1mo ago
Active
Adoption100+ stars on GitHub
895 ★ · Growing
DocsREADME + description
Well-documented

GitHub Signals

Stars895
Forks111
Issues3
Updated1mo ago
View on GitHub
MIT License

My Fox Den

Community Rating

Sign in to rate this booster

Works With

Claude Code