Generated banner for Experiment Design
Generated logo for Experiment Design

Experiment Design

MicrosoftOfficialPublished by Microsoft

  • Skill
  • Guidelines
  • Agent tooling
  • CC-BY-4.0
  • No issues found

From the author

Experiment design reference for problem-class framing, Minimum Viable Experiment coaching, hypothesis formation, vetting and red flags, and experiment readiness. Use when translating a stated business outcome into candidate data-science problem classes, or when framing, vetting, scoping, or evaluating an experiment of any kind, including data feasibility, architecture, LLM, performance, use-case, UX, prototyping, and hardware experiments.
— the description by Microsoft

AutoGineer summary

Written by AutoGineer from the skill’s own files, not by the author

The experiment-design skill provides a structured framework for end-to-end experiment management. It helps teams translate business outcomes into specific problem classes, identify and prioritize risks, and design testable, falsifiable hypotheses. By distinguishing between problem-class framing and experiment execution, it ensures that teams focus on resolving critical unknowns rather than building premature solutions. The pack covers various experiment types, including data feasibility, architecture, LLM, and UX, while emphasizing reproducibility and decision-ready outcomes.

What it does

  • Translates business outcomes into candidate data-science problem classes.
  • Provides criteria for vetting hypotheses and identifying red flags.
  • Facilitates risk-based prioritization of experiments.
  • Guides the design of Minimum Viable Experiments (MVEs).
  • Ensures experiment results are reproducible and comparable.
  • Separates problem-class framing from experiment design.

When to use it

  • When you need to translate a business goal into a technical problem class.
  • When you have competing unknowns and need to prioritize which to test first.
  • When you need to validate assumptions before committing to full-scale production.
  • When you need to design a test that is falsifiable and decision-ready.
  • When you need to distinguish between a genuine experiment and a demo.

Advantages

  • Reduces project risk by validating assumptions early.
  • Prevents wasted effort on demos disguised as experiments.
  • Provides a clear, repeatable process for experiment design.
  • Ensures experiments are tied to actionable business decisions.
  • Promotes knowledge transfer and independent ownership in collaborative teams.

Usage examples

“I have a business goal to reduce customer churn. How do I frame this as a data science problem?”
The agent will use the problem-framing reference to identify candidate problem classes, such as classification or regression, while documenting the reasoning and any gaps without selecting a specific model.
“We are unsure if our current architecture can handle the expected load. How should we test this?”
The agent will guide you through forming a falsifiable hypothesis, vetting it against MVE criteria, and designing an architectural feasibility experiment to resolve the uncertainty.

Install

  1. Download the skill as a ZIP:

    https://mp-staging.autogineer.com/agent-skills/microsoft/experiment-design/download
  2. Unzip it into the cross-client skills folder of your project:

    mkdir -p .agents/skills && unzip experiment-design.zip -d .agents/skills

Documentation by Microsoft

Experiment Design Reference Pack

Goal

Support experiment work end to end: turning unknowns into testable hypotheses, screening out work that is not a real experiment, and scoping it so the result is comparable and decision-ready.

Support the step that precedes it as well: translating a stated business outcome into candidate data-science problem classes with the reasoning that produced them, so a practitioner knows what kind of problem is on the table before deciding what to test.

The two concerns stay distinct. Problem-class framing exposes candidates and never selects one. Experiment work assumes a candidate direction already exists and concludes by selecting an experiment with the team.

This pack is general purpose. It applies to data feasibility, architecture, LLM, performance, use-case, UX, prototyping, and hardware experiments, not to data science alone.

Inputs

  • The problem statement, customer context, and business driver

  • The stated business outcome, when the active concern is problem-class framing

  • Known unknowns, assumptions, and risks

  • The decision the experiment is meant to unblock

  • Prior experiment results, when a sequence of experiments is in flight

Reference index

Read only the reference that matches the active concern.

ReferenceRead this when
problem-framing.mdTranslating a stated business outcome into candidate data-science problem classes, applying per-paradigm entry tests, ordering discriminating questions, or recording assignable gaps
mve-coaching.mdFraming an MVE, forming or sharpening hypotheses, applying vetting criteria and red flags, designing the experiment, evaluating results, or producing session and backlog-bridge artifacts
experiment-readiness.mdDeciding which experiment to run at all: turning a risk landscape into candidates, prioritizing among competing unknowns, comparing options with evidence, or re-prioritizing mid-flight
rpi-research-preparation.mdPreparing an experiment with bounded prior-art or current-constraint Research while keeping validation and experiment verdicts with their current owners
provenance.mdConfirming what is upstream guidance, what is HVE Core derivation or repository convention, and where upstream is silent

A confirmed problem-class framing request reads problem-framing.md only. Experiment requests read mve-coaching.md or experiment-readiness.md by concern.

Success criteria

  • Problem-class framing returns the surviving candidate problem classes with the entry-test reasoning that kept or discarded each one, and never returns a selection, a ranking, or a confidence score.

  • Every framing claim is visibly either a cited entry test or repository-original routing, and no claim implies that a universal external standard governs cross-paradigm routing.

  • An unanswered framing question becomes a recorded gap with an answer holder and a coordinator, and the remaining analysis continues.

  • Each hypothesis is testable, specific, falsifiable, and tied to a stated rationale.

  • The experiment selected is the one whose result changes the most downstream work, chosen from a candidate list rather than from the first idea proposed.

  • Work that is a demo, a mini-MVP, or an already-answered question is named as such rather than run as an experiment.

  • Every input that could change the result is recorded precisely enough that another person could repeat the experiment and get a comparable answer. An identifier without a version is a label, not a reproducible reference.

  • Experiment scope stays minimum-but-sufficient, and experiment code is treated as disposable.

Constraints

  • Reproduce only the minimum text necessary for a specific technical point, and paraphrase everything else. Attribute every reference and describe accurately what each reference reproduces.

  • Label repository conventions as substitutions rather than upstream recommendations.

  • Keep experiment framing separate from experiment infrastructure. This pack decides whether and how an experiment is worth running; it does not stand up tooling.

  • Keep problem-class framing separate from experiment framing. Problem-class framing asks what kind of problem this is; experiment framing asks what to test about a direction already chosen. Do not apply experiment vetting criteria, red flags, or readiness prioritization to a confirmed problem-class framing request.

  • Never rank, score, threshold, or recommend a candidate problem class. The practitioner is the subject-matter expert who chooses.

Ownership boundaries

ConcernOwner
Candidate problem classes for a stated business outcome, entry-test reasoning, discriminating questions, and assignable framing gapsThis pack, through problem-framing.md
Whether a proposed outcome is achievable with available data and evidencefeasibility, the evidence-led feasibility study reference
MVE session directory, artifact filenames, placement, and tracking-file hygieneexperiment-designer.instructions.md, applied automatically to MVE tracking paths
Phase order, gates, session writes, and coaching flowThe consuming experiment agent
ML environments, reproducibility, tracking, model evaluation, abstractions, and readinessml-experimentation, the ML-specific experimentation reference
Pipeline mechanics, data tiering, replay, validation, and DS/MLOps test techniquedataops, the DataOps and testing reference
Metric names, instruments, units, cardinality, and PII-safe telemetrytelemetry-foundations, the OpenTelemetry-aligned instrumentation skill
Data sensitivity classification and DPIA thresholdsprivacy-standards, the privacy classification reference

Stop rules

  • For a confirmed problem-class framing request, an unstated business outcome is the sole stop before candidate analysis. problem-framing.md owns that stop and its job-specific exceptions. The experiment stop rules below govern experiment requests only.

  • Stop and name the red flag when the request is a demo, a scaled-down product build, or a question already answered elsewhere. Then offer either the falsifiable hypothesis hiding underneath it or an explicit non-experiment path, rather than halting on the refusal.

  • Stop and separate concerns when the request is production implementation rather than experiment design.

  • Stop and state the gap when the request depends on guidance this pack does not provide, such as a universal framework, tool, or metric choice made without project context.

Attribution

This pack declares CC-BY-4.0.

mve-coaching.md is repository-original content under CC BY 4.0. It is not derived from any upstream source and cites no upstream URL.

problem-framing.md layers three source treatments. Its machine-learning entry tests are informed by Google for Developers machine-learning guidance, licensed CC BY 4.0; that material is paraphrased and reorganized, both upstream URLs are cited, and changes are stated. It points readers to the NEOS Guide for optimization problem types as a citation only, and states no NEOS classification of its own. Its cross-paradigm routing, the broader analytical-fit judgement, and the gap and output contract are repository-original.

experiment-readiness.md is HVE Core guidance informed by two Microsoft CSE Code With Engineering Playbook documentation pages, which are licensed CC BY 4.0. It paraphrases rather than reproduces, generalizes the upstream practices beyond engagement-shaped engineering work, cites both upstream URLs, and states that changes were made.

See provenance.md for the consolidated source map and derivation labels.

Files

references/problem-framing.md


title: Problem-class framing description: Translating a stated business outcome into candidate data-science problem classes using cited entry tests, discriminating questions, and assignable gaps, without selecting a framing for the practitioner

Sources

The machine-learning entry tests below are informed by those two pages and have been changed: they are paraphrased, reorganized into per-paradigm entry tests, restated in this repository's vocabulary, and placed inside a cross-paradigm procedure the upstream pages do not describe. THIRD-PARTY-NOTICES carries the attribution CC BY 4.0 requires.

The NEOS Guide is an authority a reader can consult for optimization problem types, including Optimization Problem Types, Linear Programming, Integer Programming, and Nonlinear Constrained Optimization. Its terms reserve rights, so it is cited only. No NEOS text, taxonomy, classification, diagram, or derivative of them is reproduced or paraphrased here.

No external standard adjudicates across paradigms. Every cross-paradigm routing judgement, the broader analytical-fit disposition, the gap contract, and the output contract below are repository-original.

Read this when

A practitioner has a business outcome and does not yet know what kind of data-science problem it is. This file produces the candidate problem classes and the reasoning behind them. It does not decide which one to pursue, estimate whether it is achievable, or design an experiment.

Provenance labels

Carry these labels into the output so the practitioner can see what is grounded and what is judgement.

LabelMeaning
[G]Grounded in a cited source named in this file
[O]Repository-original routing judgement; no external source adjudicates
[A]Assumed from the conversation and not verified against data

The one stop before analysis

A stated business outcome is required before candidate analysis begins. It is the only stop this procedure applies before producing candidates.

  1. Coach for it first. Lead with the decision or change the framing should enable, then follow up on who acts on it and what would be different if it worked.

  2. If the outcome is stated, proceed to the procedure.

  3. If it stays unstated, do not analyze candidates and do not treat defining it as an experiment. Complete the invocation with a single outcome-definition gap carrying an answer holder and a coordinator, and record explicitly that no candidate analysis was performed.

Experiment vetting criteria, experiment red flags, the unclear-problem-as-experiment fallback in mve-coaching.md, and readiness prioritization in experiment-readiness.md govern experiment requests. None of them applies to a confirmed problem-class framing request.

Procedure

  1. Restate the outcome for framing purposes and mark the restatement [O]. Name any ambiguity the restatement exposes; that ambiguity is usually the highest-power question in step 3.

  2. Apply the entry test for every candidate problem class. Keep a class when its entry test passes or cannot yet be evaluated. Discard a class only when its entry test plainly fails, and record the failure reason rather than dropping it silently.

  3. Order the unresolved questions by discriminating power: how many candidates the answer eliminates, not how easy it is to answer.

  4. Work the questions in that order. Ask the practitioner for each value before recording it as unknown.

  5. When elicitation does not produce a value, mark it unknown, record the gap, and continue with the remaining questions. An unanswered question never terminates the run.

  6. Produce the output contract. Present the surviving candidates, the entry-test reasoning for each, the discriminating questions with their current state, the gap list, and any terminal disposition.

Candidate problem classes and entry tests

Candidate classEntry testLabel
Supervised classificationA categorical outcome is labelled for past cases, and the features exist at the moment the prediction must be made[G]
Supervised regressionThe same conditions hold with a continuous target rather than a categorical one[G]
Time-to-event analysisThe outcome is when something happens rather than whether it happened, and some observations are still in progress rather than negative[O]
ForecastingThe target is time ordered, past behavior is a plausible basis for extrapolation, and the forecast itself does not materially change the outcome[O]
Causal inferenceThe question is what happens if an input is set to a value, not what has historically co-occurred with that value[O]
Constrained optimizationThe task is choosing decision variables against a stated objective under stated constraints, rather than estimating an unknown quantity[O]
Reinforcement learningAn agent acts repeatedly in an environment, observes a reward, and has enough interaction volume for a policy to be learned[O]
Generative modellingThe required output is new content conditioned on context, and quality is judged against an evaluation rubric rather than a labelled target[O]
Not a modelling problemThe population is too small to support inference, or the value lies in shared understanding rather than a fitted model[O]
Machine learning versus a non-machine-learning approach

Before committing to any modelling class, compare the machine-learning approach against a non-machine-learning baseline on the value it adds, its cost and ongoing maintenance, and the resources it requires. A predictive machine-learning framing additionally requires data that carries usable predictive signal and a prediction someone can act on. Starting with a heuristic and moving to machine learning only once that heuristic becomes hard to maintain is a defensible path [G].

This test decides machine learning versus not machine learning. It does not decide whether the problem is a data problem at all. Statistics, optimization, and decision analysis are outside its scope, and no cited source adjudicates them; the broader analytical-fit judgement is [O] and must be presented as such.

Optimization structure

When a constrained-optimization framing survives, its mathematical structure narrows the work further. This procedure does not classify that structure. Record the structural question as a discriminating question with its own gap [O], and point the practitioner to the NEOS Guide pages cited above.

Gaps

Every unanswered question becomes a gap. A gap is a coordinator handoff, not a practitioner to-do list.

FieldContent
Needed factThe specific value or definition required
Why it mattersWhich candidates the answer keeps or eliminates
Answer holderThe person or role who holds the fact, or unassigned when none is known
CoordinatorThe person who will obtain it, often not the answer holder, or unassigned
Statusunknown until a value is supplied

Record unassigned rather than a guess whenever an answer holder or a coordinator is not known, and name the unassigned ownership in the completion evidence. An unowned gap is a finding, not an omission, and it does not prevent the invocation from completing.

Output contract

A completed framing invocation returns:

  • The restated outcome, labelled [O].

  • The surviving candidate classes, each with its entry test, its provenance label, and its current status.

  • Discarded classes with the entry-test failure that removed them.

  • The discriminating questions in power order, with current answers or unknown.

  • The gap table.

  • Any terminal disposition, such as a non-machine-learning [G] or a not-a-modelling-problem [O] result.

An invocation stopped for an unstated business outcome returns the outcome-definition gap and an explicit statement that no candidate analysis was performed.

What this procedure never does

  • It never selects, ranks, scores, or confidence-thresholds a candidate. The practitioner is the subject-matter expert and makes that call.

  • It never estimates feasibility. feasibility owns whether a proposed outcome is achievable with the available data and evidence.

  • It never designs or scopes an experiment. That begins after a framing direction is chosen.

  • It never invents a missing fact. Unknowns are labelled and assigned.

  • It never presents an original routing judgement as though a standard supports it.

Requirements and compatibility

Written for: GitHub Copilot, Claude Code

Works with: Claude Code, Claude apps, OpenAI Codex, GitHub Copilot, Cursor, Gemini CLI, Kiro, OpenCode, Goose, Amp, Roo Code, JetBrains Junie, Factory Droid, Devin (ex-Windsurf), Mistral Vibe, OpenHands, Letta

“Works with” means the tool reads the open Agent Skills format; a skill written for one tool may use features others lack.

Needs: Claude Code frontmatter

Security

No issues found by our static scan· No issues found

A static scan is not a guarantee. Skills are third-party content: review a skill before you let an agent use it.

Attribution and licence

Published by
Microsoft
Publisher
Microsoft (Official)
Source
microsoft/hve-core · .github/skills/project-planning/experiment-design · commit f425e94
Licence
Creative Commons Attribution 4.0 International (redistribution allowed)
  • LICENSE (written by AutoGineer)
  • ATTRIBUTION.md (written by AutoGineer)
Synced

AutoGineer is not affiliated with or endorsed by Microsoft.

Download ZIP

The ZIP holds the skill’s files, its licence files and an ATTRIBUTION.md. Download experiment-design.zip