PM Experiment to Readout
Use this skill after a prototype, experiment, pilot, usability check, rollout,
or AI evaluation has produced results. Keep what happened separate from what it
may mean and from the decision that follows. A good readout makes it harder to
move the goalposts after seeing the result.
When to use
Use it for:
- a product experiment with a primary metric and guardrail;
- a prototype or pilot with completion, failure, or recovery observations;
- an AI evaluation with a stated test set and known limitations;
- a usability session set with a small number of observed tasks;
- a rollout or feature flag readout that needs a continue, change, stop, or
hold decision.
Do not use it to:
- manufacture a denominator, baseline, statistical result, or causal claim;
- turn synthetic, fictional, or AI-generated results into user evidence;
- call a small test a launch decision without checking guardrails and scope;
- average away a guardrail failure because the primary metric improved;
- replace the raw result record or the owner of the final decision.
Guardrails
- Treat supplied result records as the evidence boundary. If a source, test
window, denominator, baseline, exposure, or outcome is absent, write
Not provided or Not verified.
- Keep four things separate: observed result, interpretation, decision, and
next validation. Do not let a polished readout upgrade one into another.
- Use the decision rule supplied with the test when one exists. If it was not
supplied, label a new rule
proposed; do not rewrite the rule to fit the
result.
- Preserve counts, rates, denominator, time window, control or baseline, and
stopping conditions. A rate without its denominator is
Not verified.
- Keep primary metrics and guardrails separate. A guardrail failure is a hold,
change, or stop signal unless the owner explicitly records why it is safe to
proceed.
- Qualitative observations describe the sessions or cases supplied. They do
not establish prevalence, preference, or adoption without an appropriate
sample and method.
- Treat an AI-generated summary as an artifact to inspect. Trace its material
lines to the underlying result record or mark them
Not verified.
- Remove names, private tickets, credentials, and sensitive customer detail
from the handoff unless the user supplied a safe public form.
Workflow
1. Frame the test
Write one sentence:
We tested ... for ... to learn ....
Record the change, audience or context, baseline or comparison, test window,
and status. If the test question is missing, say Test on the desk: Not provided and do not invent one.
2. Build the result ledger
Give each result source a stable ID such as R1, R2, or the ID already
present in the input. Record the source type, window, denominator, and a short
exact line when possible. Otherwise label a faithful paraphrase as a
paraphrase.
For every result, answer both questions:
- What was observed?
- What does this result not prove?
3. Read the metric and guardrail separately
Name the primary metric, guardrails, qualitative signals, and missing
measurement context. Keep source-backed, hypothesis, synthetic, and Not verified visible. Do not use a confidence score to hide a missing baseline or
small denominator.
4. Apply the decision rule
Choose one status:
continue: the supplied or proposed rule is met and guardrails are clear;
change: the test found a fixable issue or mixed result;
stop: the result or guardrail makes the direction unsafe or unhelpful;
hold: the evidence is too incomplete to make a responsible choice.
Explain which rule was used. If the evidence is fictional, synthetic, or too
thin, keep the decision narrow, such as continue the test, not launch.
5. Choose one smallest next action
Propose one reversible action that could change the decision. Specify:
- change: what will be different;
- audience or context: who will encounter it and where;
- primary metric: the one observable outcome;
- guardrail: what must not get worse;
- decision rule: what result changes the next step;
- owner or timebox: who or what window is proposed.
If the input does not justify a metric, use Proposed metric and explain what
would make it measurable.
6. Hand off for human review
End with Not covered and a short review ask. The reviewer should be able to
correct the result mapping, metric interpretation, guardrail, or decision rule
without rewriting the whole note.
Output contract
Return these sections in this order:
## Test on the desk
...
## Result ledger
| ID | Result/source | Window/denominator | Observed result | Does not prove |
|---|---|---|---|---|
## Metric and guardrail readout
| Measure | Observed | Evidence status | Limitation |
|---|---|---|---|
## Decision
- Status: continue / change / stop / hold
- Rule used:
- Rationale:
## Smallest next action
- Change:
- Audience or context:
- Primary metric:
- Guardrail:
- Decision rule:
- Owner or timebox:
## Not covered
- ...
## Review ask
...
Keep the readout short enough to review in one sitting. If the result set is
large, keep the main ledger focused and point to an appendix rather than hiding
denominator or guardrail detail in a long narrative.
Edge cases
- No baseline or control: preserve the result, mark comparison as
Not verified, and do not claim lift or causality.
- Missing denominator: keep the count, write
Denominator: Not provided,
and avoid turning it into a rate.
- Primary metric up, guardrail fails: show both signals and choose
hold,
change, or stop unless the supplied decision record explains the risk.
- Small sample: keep the observed cases, label the readout
directional,
and propose the smallest follow-up that could change the decision.
- Qualitative majority claim: keep the exact number and context; do not
write
most users unless the supplied method supports that wording.
- Synthetic or fictional result: label it in the ledger and never call it a
real-user, adoption, or production result.
- AI-generated summary: trace it to raw result sources and do not count it
as an independent observation.
- Conflicting result sources: show the conflict and make the next action
distinguish between the competing explanations.
- Stopped early: record the stopping condition and do not treat the partial
result as a completed test.
- No decision rule supplied: keep the status
hold or label any rule
proposed; do not present a new threshold as pre-registered.
Final check
Before returning the readout, confirm:
- every observed result has a source ID, window, denominator, or an explicit
missing-data label;
- primary metric, guardrails, qualitative signals, and unknowns are separate;
- no count or rate became a lift, causal claim, adoption claim, or launch proof;
- the decision status states which supplied or proposed rule was used;
- the next action has one primary metric, one guardrail, and a decision rule;
Not covered names the most important unresolved risk or measurement gap;
- no number, quote, user, outcome, or safety claim was added from guesswork.
For a ready-to-paste fictional first run, read examples/first-run.md. For a
full fictional output shape, read references/experiment-readout.md.
1---2name: pm-experiment-to-readout3description: Turn a bounded product test result into an evidence-aware PM readout with metric, guardrail, decision rule, limitations, and one next action. Use when a PM needs to decide whether to continue, change, stop, or hold after a prototype, experiment, pilot, or evaluation.4---56# PM Experiment to Readout78Use this skill after a prototype, experiment, pilot, usability check, rollout,9or AI evaluation has produced results. Keep what happened separate from what it10may mean and from the decision that follows. A good readout makes it harder to11move the goalposts after seeing the result.1213## When to use1415Use it for:1617- a product experiment with a primary metric and guardrail;18- a prototype or pilot with completion, failure, or recovery observations;19- an AI evaluation with a stated test set and known limitations;20- a usability session set with a small number of observed tasks;21- a rollout or feature flag readout that needs a continue, change, stop, or22 hold decision.2324Do not use it to:2526- manufacture a denominator, baseline, statistical result, or causal claim;27- turn synthetic, fictional, or AI-generated results into user evidence;28- call a small test a launch decision without checking guardrails and scope;29- average away a guardrail failure because the primary metric improved;30- replace the raw result record or the owner of the final decision.3132## Guardrails33341. Treat supplied result records as the evidence boundary. If a source, test35 window, denominator, baseline, exposure, or outcome is absent, write `Not36 provided` or `Not verified`.372. Keep four things separate: observed result, interpretation, decision, and38 next validation. Do not let a polished readout upgrade one into another.393. Use the decision rule supplied with the test when one exists. If it was not40 supplied, label a new rule `proposed`; do not rewrite the rule to fit the41 result.424. Preserve counts, rates, denominator, time window, control or baseline, and43 stopping conditions. A rate without its denominator is `Not verified`.445. Keep primary metrics and guardrails separate. A guardrail failure is a hold,45 change, or stop signal unless the owner explicitly records why it is safe to46 proceed.476. Qualitative observations describe the sessions or cases supplied. They do48 not establish prevalence, preference, or adoption without an appropriate49 sample and method.507. Treat an AI-generated summary as an artifact to inspect. Trace its material51 lines to the underlying result record or mark them `Not verified`.528. Remove names, private tickets, credentials, and sensitive customer detail53 from the handoff unless the user supplied a safe public form.5455## Workflow5657### 1. Frame the test5859Write one sentence:6061> We tested `...` for `...` to learn `...`.6263Record the change, audience or context, baseline or comparison, test window,64and status. If the test question is missing, say `Test on the desk: Not65provided` and do not invent one.6667### 2. Build the result ledger6869Give each result source a stable ID such as `R1`, `R2`, or the ID already70present in the input. Record the source type, window, denominator, and a short71exact line when possible. Otherwise label a faithful paraphrase as a72paraphrase.7374For every result, answer both questions:7576- What was observed?77- What does this result not prove?7879### 3. Read the metric and guardrail separately8081Name the primary metric, guardrails, qualitative signals, and missing82measurement context. Keep `source-backed`, `hypothesis`, `synthetic`, and `Not83verified` visible. Do not use a confidence score to hide a missing baseline or84small denominator.8586### 4. Apply the decision rule8788Choose one status:8990- `continue`: the supplied or proposed rule is met and guardrails are clear;91- `change`: the test found a fixable issue or mixed result;92- `stop`: the result or guardrail makes the direction unsafe or unhelpful;93- `hold`: the evidence is too incomplete to make a responsible choice.9495Explain which rule was used. If the evidence is fictional, synthetic, or too96thin, keep the decision narrow, such as `continue the test`, not `launch`.9798### 5. Choose one smallest next action99100Propose one reversible action that could change the decision. Specify:101102- change: what will be different;103- audience or context: who will encounter it and where;104- primary metric: the one observable outcome;105- guardrail: what must not get worse;106- decision rule: what result changes the next step;107- owner or timebox: who or what window is proposed.108109If the input does not justify a metric, use `Proposed metric` and explain what110would make it measurable.111112### 6. Hand off for human review113114End with `Not covered` and a short review ask. The reviewer should be able to115correct the result mapping, metric interpretation, guardrail, or decision rule116without rewriting the whole note.117118## Output contract119120Return these sections in this order:121122```markdown123## Test on the desk124...125126## Result ledger127| ID | Result/source | Window/denominator | Observed result | Does not prove |128|---|---|---|---|---|129130## Metric and guardrail readout131| Measure | Observed | Evidence status | Limitation |132|---|---|---|---|133134## Decision135- Status: continue / change / stop / hold136- Rule used:137- Rationale:138139## Smallest next action140- Change:141- Audience or context:142- Primary metric:143- Guardrail:144- Decision rule:145- Owner or timebox:146147## Not covered148- ...149150## Review ask151...152```153154Keep the readout short enough to review in one sitting. If the result set is155large, keep the main ledger focused and point to an appendix rather than hiding156denominator or guardrail detail in a long narrative.157158## Edge cases159160- **No baseline or control:** preserve the result, mark comparison as `Not161 verified`, and do not claim lift or causality.162- **Missing denominator:** keep the count, write `Denominator: Not provided`,163 and avoid turning it into a rate.164- **Primary metric up, guardrail fails:** show both signals and choose `hold`,165 `change`, or `stop` unless the supplied decision record explains the risk.166- **Small sample:** keep the observed cases, label the readout `directional`,167 and propose the smallest follow-up that could change the decision.168- **Qualitative majority claim:** keep the exact number and context; do not169 write `most users` unless the supplied method supports that wording.170- **Synthetic or fictional result:** label it in the ledger and never call it a171 real-user, adoption, or production result.172- **AI-generated summary:** trace it to raw result sources and do not count it173 as an independent observation.174- **Conflicting result sources:** show the conflict and make the next action175 distinguish between the competing explanations.176- **Stopped early:** record the stopping condition and do not treat the partial177 result as a completed test.178- **No decision rule supplied:** keep the status `hold` or label any rule179 `proposed`; do not present a new threshold as pre-registered.180181## Final check182183Before returning the readout, confirm:184185- every observed result has a source ID, window, denominator, or an explicit186 missing-data label;187- primary metric, guardrails, qualitative signals, and unknowns are separate;188- no count or rate became a lift, causal claim, adoption claim, or launch proof;189- the decision status states which supplied or proposed rule was used;190- the next action has one primary metric, one guardrail, and a decision rule;191- `Not covered` names the most important unresolved risk or measurement gap;192- no number, quote, user, outcome, or safety claim was added from guesswork.193194For a ready-to-paste fictional first run, read `examples/first-run.md`. For a195full fictional output shape, read `references/experiment-readout.md`.