methodatlas
RunsheetAgile

Example Mapping

ComplexityLow
Time30-60 min
Participants3-7
FormatWorkshop
MaturityEstablished
01

Prerequisite

What needs to be finished first

Complete firstUser Storynot in catalog

A User Story or backlog item is available as a starting point, at least as an "As ... I want ... so that ..." sentence with owner.

Without: Without a concrete story, the mapping drifts into general feature discussion and does not produce verifiable acceptance criteria.
Complete firstThree Amigos

Product, Development, and QA are confirmed for the session, each with decision authority in their area.

Without: Without these three perspectives, examples come from one angle and the story remains ambiguous after the session.
02

Preparation

What needs to be ready before start

Materials

Whiteboard or Miro board with four colors of stickies (yellow story, blue rule, green example, red open question); timer; link to backlog item; known edge cases from support or logs.

People / roles

One facilitator (usually Product Owner or BA), one person from development, one person from QA or testing. Optionally a domain expert for corner cases. Maximum six people, otherwise discussion becomes slow.

Pre-read

Story title and draft acceptance criteria; current implementation of the closest flow; known edge cases from production; linked designs; estimated delivery slice.

Time needed

25-45 min per story

Setup

Place the story card in yellow in the center. Beneath it, horizontal bands for rules (blue). To the right, examples (green) per rule. Red stickies are collected and not answered immediately. Set timer to 30 min, then decide on extension or postponement.

03

Core question

The one question this method answers

Which concrete examples show this story is complete, and what rule connects them?

04

Flow

Marker: Minute

StepDurationActionHint
10-5 min
5 minRead the story aloud and place it on the yellow card. Define context, goal, and out-of-scope briefly. No solution discussion, only understanding questions.If implementation discussion starts this early, pause the timer and move back to value and user intent.
25-20 min
15 minCollect examples: concrete inputs and expected outputs with date, amount, status. Each example as a green card with clearly observable result.Examples like "normal case" are not usable. Ask for which user, which data, and what outcome. Explicitly request negative examples.
320-30 min
10 minDerive rules from examples: blue card over related examples. One rule per cluster of examples with the same behavior.If an example fits no rule, it is either an edge case (new rule) or out-of-scope (own story). Do not force it into an existing rule.
430-40 min
10 minReview red cards for open questions. For each question decide: clarify before implementation (owner and deadline) or document as assumption with risk.More than five red cards signal the story is not ready. Do not continue anyway, otherwise it returns through QA.
540-45 min
5 minReview story splitting: if a rule belongs clearly after release, extract it as a separate story and prioritize it.An example map with more than eight rules is often several stories. Splitting is not a failure of the method, it is its core value.
05

Artifact

What comes out at the end

Form

Example map as photo or Miro snapshot plus structured capture in backlog item: story, list of rules with examples in Given-When-Then, open questions with owner and response deadline.

Versioning / ownership

Store map snapshot with the session closing in the backlog item. Add late examples from test or production as an end edit with date and source. Create separate items for story split and link back to the origin.

Tool alternatives
  • Miro or Mural Example Mapping template
  • Cucumber feature file with scenarios per example
  • Markdown in repo under specs/<story-id>.md
  • Jira or Linear issue with structured body

example-mapping-working-template.md

Compact working template for Example Mapping with context, input, output artifacts, and next step.

Example Mapping Checklist

  • Goal and context clarified
  • Input material gathered
  • Participants and roles named
  • Execution prepared according to the runsheet
  • Output artifacts created
  • Example Map updated
  • Acceptance Criteria updated
  • Open Questions updated
  • Open questions documented
  • Next step set with owner and date
06

Example output

Concrete filled scenario, fictional example

example-mapping-beispiel.md

Concrete filled scenario, fictional example

Story

As a logged-in customer, I want to return a purchased item within 14 days, so I can reverse failed purchases.

Rule 1: 14-day return period from delivery date

  • Order 4711 delivered on 2026-05-01, return on 2026-05-14 -> accepted.
  • Order 4712 delivered on 2026-05-01, return on 2026-05-16 -> rejected with reason "deadline exceeded."

Rule 2: Personalized items excluded

  • Standard item SKU-123 -> returnable.
  • Engraved item SKU-987 -> non-returnable, note "personalized."

Open questions

  • How is partial return handled for multi-item orders? Owner: @lisa, response by 2026-05-20.
  • How does the deadline count for delivery to parcel locker? Owner: @ben, response by 2026-05-20.

Split decision

Rule "Return cost at value threshold" is moved to own story PRD-58.

07

Pitfalls

Recognize symptoms and steer against them

Trap

Examples stay abstract

Symptom

Green cards contain phrases like "normal case" or "error" without concrete data.

What to do

Require real values for each example: customer number, amount, status, date. If someone cannot formulate an example with data, they do not understand the rule.

Trap

Rules are predefined

Symptom

The facilitator writes rules first, then examples are searched to fit.

What to do

Enforce sequence: collect examples first, then derive rules from them. This exposes gaps and edge cases that are invisible in abstraction.

Trap

Red cards are solved immediately

Symptom

Session drifts into detail research, one open question consumes 20 min.

What to do

Park red cards. After 30 min decide: clarify (owner, deadline) or assume with risk note. Clarification happens outside the session.

Trap

Story is too large for the method

Symptom

Map has 10+ rules, examples explode, discussion does not end.

What to do

Split rather than continue. One sub-story per rule cluster. Keep original story as epic and restart mapping per sub-story.

Trap

QA is missing

Symptom

Negative examples and edge cases appear only in test, map remains optimistic.

What to do

Require at least one test-oriented person. Without QA the method becomes lightweight backlog refinement and misses core purpose.

Trap

Acceptance criteria are not transferred

Symptom

Map ends on whiteboard, ticket still contains old acceptance text.

What to do

Directly copy Given-When-Then from examples into ticket afterwards. Ticket status can move to ready only after transfer.

08

Stop criteria

Done signals checkable in under a minute

Story is not formulated or changes its user or value during the session.
More than eight open red cards after 30 min, story readiness is insufficient.
No QA or testing person available, critical edge-case perspective is missing.
Domain data or terms are unclear, examples remain hypothetical.
Story is architecture- or research-oriented without clear external behavior, examples cannot be formulated.
Map splits into more than two clearly separated topics; split is required before continuing.

Finished the runsheet?

Go to the profile for purpose, similar methods, and sources or continue to the next method in the catalog.