experiment-plan

Turn a refined research proposal or method idea into a detailed, claim-driven experiment roadmap. Use after `research-refine`, or when the user asks for a detailed experiment plan, ablation matrix, evaluation protocol, run order, compute budget, or paper-ready validation that supports the core probl

By wanshuiyin · 435 installs

npx skills add wanshuiyin/auto-claude-code-research-in-sleep --skill experiment-plan

Source repository · Upstream listing

Experiment Plan: Claim Driven, Paper Oriented Validation Refine and concretize: $ARGUMENTS Overview Use this skill after the method is stable enough that the next question becomes: what exact experiments should we run, in what order, to defend the paper? If the user wants the full chain in one request, prefer /research refine pipeline . The goal is not to generate a giant benchmark wishlist. The goal is to turn a proposal into a claim evidence run order roadmap that supports four things: 1. the method actually solves the anchored problem 2. the dominant contribution is real and focused 3. the method is elegant enough that extra complexity is unnecessary 4. any frontier model era component is genuinely useful, not decorative Constants OUTPUT DIR = refine logs/ — Default destination for experiment planning artifacts. MAX PRIMARY CLAIMS = 2 — Prefer one dominant claim plus one supporting claim. MAX CORE BLOCKS = 5 — Keep the must run experimental story compact. MAX BASELINE FAMILIES = 3 — Prefer a few strong baselines over many weak ones. DEFAULT SEEDS = 3 — Use 3 seeds when stochastic variance matters and budget allows. Workflow Phase 0: Load the Proposal Context Read the most relevant existing files first if they exist: refine logs/FINAL PROPOSAL.md refine logs/REVIEW SUMMARY.md refine logs/REFINEMENT REPORT.md Extract: Problem Anchor Dominant contribution Optional supporting contribution Critical reviewer concerns Data / compute / timeline constraints Which frontier primitive is central, if any If these files do not exist, derive the same information from the user's prompt. Phase 1: Freeze the Paper Claims Before proposing experiments, write down the claims that must be defended. Use this structure: Primary claim : the main mechanism level contribution Supporting claim : optional, only if it directly strengthens the main paper story Anti claim to rule out : e.g. "the gain only comes from more parameters," "the gain only comes from a larger search space," or "the modern component is just decoration" Minimum convincing evidence : what would make each claim believable to a strong reviewer? Do not exceed MAX PRIMARY CLAIMS unless the paper truly has multiple inseparable claims. Phase 2: Build the Experimental Storyline Design the paper around a compact set of experiment blocks. Default to the following blocks and delete any that are not needed: 1. Main anchor result — does the method solve the actual bottleneck? 2. Novelty isolation — does the dominant contribution itself matter? 3. Simplicity / elegance check — can a bigger or more fragmented version be avoided? 4. Frontier necessity check — if an LLM / VLM / Diffusion / RL era component is central, is it actually the right tool? 5. Failure analysis or qualitative diagnosis — what does the method still miss? For each block, decide whether it belongs in: Main paper — essential to defend the core claims Appendix — useful but non blocking Cut — interesting, but not worth the paper budget Prefer one strong baseline family over many weak baselines. If a stronger modern baseline exists, use it instead of padding the list. Phase 3: Specify Each Experiment Block For every kept block, fully specify: Claim tested Why this block exists Dataset / split / task Compared systems : strongest baselines, ablations, and variants only Metrics : decisive metrics first, secondary metrics second Setup details : backbone, frozen vs trainable parts, key hyperparameters, training budget, seeds Success criterion : what outcome would count as convincing evidence? Failure interpretation : if the result is negative, what does it mean? Table / figure target : where this result should appear in the paper Special rules: A simplicity check should usually compare the final method against either an overbuilt variant or a tempting extra component that the paper intentionally rejects. A frontier necessity check should usually compare the chosen modern primitive against the strongest plausible simpler or older alternative. If the proposal is intentionally non frontier, say so explicitly and skip the frontier block instead of forcing one. Phase 4: Turn the Plan Into an Execution Order Build a realistic run order so the user knows what to do first. Use this milestone structure: 1. Sanity stage — data pipeline, metric correctness, one quick overfit or toy split 2. Baseline stage — reproduce the strongest baseline(s) 3. Main method stage — run the final method on the primary setting 4. Decision stage — run the decisive ablations for novelty, simplicity, and frontier necessity 5. Polish stage — robustness, qualitative figures, appendix extras For each milestone, estimate: compute cost expected turnaround time stop / go decision gate risk and mitigation Separate must run from nice to have experiments. Phase 5: Write the Outputs Step 5.1: Write refine logs/EXPERIMENT PLAN.md Use this structure: Step 5.2: Write refine logs/EXPERIMENT TRACKER.md Use this structure: Keep the tracker compact and execution oriented. Step 5.3: Present a Brief Summary to the User Output Protocols Follow these shared protocols for all output files: [Output Versioning Protocol](../shared references/output versioning.md) — write timestamped file first, then copy to fixed name [Output Manifest Protocol](../shared references/output manifest.md) — log every output to MANIFEST.md [Output Language Protocol](../shared references/output language.md) — respect the project's language setting Key Rules Large file handling : If the Write tool fails due to file size, immediately retry using Bash ( cat << 'EOF' file ) to write in chunks. Do NOT ask the user for permission — just do it silently. Every experiment must defend a claim. If it does not change a reviewer belief, cut it. Prefer a compact paper story. Design the main table first, then add only the ablations that defend it. Defend simplicity explicitly. If complexity is a concern, include a deletion study or a stronger but bloated variant comparison. Defend frontier choices explicitly. If a modern primitive is central, prove why it is better than the strongest simpler alternative. Prefer strong baselines over long baseline lists. A short, credible comparison set is better than a padded one. Separate must run from nice to have. Do not let appendix ideas delay the core paper evidence. Reuse proposal constraints. Do not invent unrealistic budgets or data assumptions. Do not fabricate results. Plan evidence; do not claim evidence. Composing with Other Skills