experiment-writeup

name	experiment-writeup
description	Help PMs write up experiment results. Use when documenting A/B test outcomes, feature experiment learnings, or sharing results with stakeholders.

Experiment Writeup

Help PMs document experiment results in a structured format. Turns raw data into clear narratives with hypothesis, methodology, results, learnings, and decision.

When to Use

• Documenting A/B test outcomes
• Writing up feature experiment results
• Sharing experiment learnings with stakeholders
• Creating a record for future reference
• When asked "help me write up the results"

Process / Template

1. Gather the Data

• Hypothesis (original statement)
• Experiment design (variants, duration, sample size)
• Primary, secondary, and guardrail metric results
• Statistical significance (p-values, confidence intervals)
• Any qualitative feedback or observations

2. Structure the Writeup

Hypothesis

• Restate the original hypothesis
• Brief context on why we ran this

Methodology

• Variants tested (control vs. treatment)
• Duration and sample size
• Target segment
• Any caveats (traffic issues, external events)

Results

• Primary metric — direction, magnitude, significance
• Secondary metrics — supporting or conflicting signals
• Guardrail metrics — did anything regress?

Learnings

• What did we learn? (beyond the numbers)
• Surprises or unexpected findings
• Implications for future work

Decision

• Ship / Iterate / Kill
• Rationale for the decision
• Next steps (if iterating)

3. Write Clearly

• Lead with the decision and key takeaway
• Use plain language; avoid jargon
• Include numbers with context (e.g., "+12% vs. control")
• Call out statistical significance explicitly

Output

A structured Experiment Writeup suitable for:

• Stakeholder sharing (Slack, email)
• Internal documentation
• Experimentation platform notes
• Retrospectives and planning

Format: concise, scannable, decision-oriented. Typically 1–2 pages or equivalent in markdown.