example-mapping

Run example-mapping sessions to produce four-card outputs with ready-or-not verdicts.

1|Updated Nov 29, 2025
One-click install
npx skills add https://github.com/SSiertsema/claude-code-plugins --skill example-mapping
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: example-mapping
Source: https://github.com/SSiertsema/claude-code-plugins/tree/main/example-mapping/skills/example-mapping
Command: npx skills add https://github.com/SSiertsema/claude-code-plugins --skill example-mapping

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Example mapping helps teams refine user stories before development by surfacing the four card types—Yellow (story), Blue (rules / acceptance criteria), Green (examples), Red (questions)—to create a clear shared understanding and a ready-to-implement artifact.

Core Features & Use Cases

  • Four card types: 🟨 Yellow (story), 🟦 Blue (rules / acceptance criteria), 🟩 Green (examples), 🟥 Red (questions).
  • Each blue rule should have at least one green example to ensure concrete validation.
  • Ready-or-not verdict tells whether a story is ready for development or requires further refinement.
  • Time-boxed sessions (typically 25–30 minutes) to maintain focus and momentum.

Quick Start

Run an example-mapping session for a user story to generate the four-card output, including the ready-or-not verdict and any open questions.

Frequently Asked Questions about example-mapping

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What is example mapping and how does it help with user story refinement?

Example mapping is a collaborative story refinement technique that structures discussions using four card types—story, rules, examples, and questions—to create a shared understanding and a ready-to-implement artifact before development begins.

How do I facilitate an example mapping session for agile requirements?

To facilitate example mapping, run a time-boxed 25–30 minute session to surface the story, its acceptance criteria rules, concrete examples for each rule, and any open questions, ultimately producing a structured artifact with a ready-or-not verdict.

When do I need example mapping for product discovery?

You need example mapping during product discovery and requirement refinement when a user story lacks clarity, helping your team surface concrete validation examples and open questions to determine if the story is ready for development.

Does example mapping require an example for every acceptance criteria rule?

Yes, in example mapping, each blue rule representing acceptance criteria should have at least one green example to ensure concrete validation and shared understanding before the story is deemed ready for development.

What is the best way to determine if a user story is ready for development?

The best way to determine readiness is through example mapping, which produces a ready-or-not verdict by surfacing open questions and validating that every acceptance criteria rule has at least one concrete example.

What are the limitations of example mapping for agile story refinement?

Example mapping is constrained by its 25–30 minute time-box to maintain focus, meaning highly complex user stories with extensive acceptance criteria might require multiple sessions to fully resolve all open questions and reach a ready state.