name: research-synthesis
# description: routing-facing summary of when this skill activates and what it covers.
description: "Use when turning raw qualitative research output (interview transcripts, field notes, diary entries, observation logs) into themes, patterns, insight statements, and design-ready artifacts via affinity mapping, empathy maps, and jobs-to-be-done framing. Do NOT use for collecting new research, quantitative analysis, statistical inference, or summarizing a single document — synthesis specifically operates on a corpus of qualitative evidence."
# license: SPDX-compatible license identifier for the skill content.
license: CC-BY-4.0
# metadata: Skill Metadata Protocol fields encoded under Agent Skills-compatible frontmatter.
metadata:
# === v8 Classification (subject + public; polyhierarchy via subjects[]) — see ADR-0017 ===
# subject: primary browse shelf — what the skill teaches. One of twelve closed values:
# backend-engineering / frontend-engineering / software-architecture / data-engineering / agent-ops / ai-engineering /
# quality-assurance / design / reasoning-strategy / software-engineering-method / knowledge-organization / product-domain.
subject: design
# public: publishability/private-data gate. Boolean.
# true = publishable/shareable; false = private and excluded from public export.
# Project anchoring is carried separately by non-empty `project[]` plus `grounding`.
public: true
# scope: free-text PRD-style statement of what the skill teaches and what it excludes.
# (v8 required; not an enum). Mirrors Coverage + Do NOT Use When at frontmatter level.
scope: "Turning raw qualitative research output (interview transcripts, field notes, diary entries, observation logs) into themes, patterns, insight statements, and design-ready artifacts via affinity mapping, empathy maps, and jobs-to-be-done framing. Portable across any qualitative-research effort; principle-grounded, not repo-bound. Excludes collecting new research (user-research), quantitative analysis and statistical inference, and summarizing a single document (synthesis operates on a corpus of qualitative evidence)."
# stability: lifecycle marker. One of:
# experimental (active development) / stable (production-ready) /
# frozen (no further changes expected) / deprecated.
# When `deprecated`, schema's allOf REQUIRES `superseded_by: <real-skill-name>`.
stability: experimental
# keywords: semantic phrases for fuzzy router activation. v8 cap: max 10.
# Keep terms a user would actually type when starting a task in this skill's domain.
keywords: ["affinity mapping","empathy map","insight statement","theme clustering","jobs to be done synthesis","qualitative coding","research wall","downloading research","say think do feel","persona drafting"]
# triggers: explicit-match activation phrases the router fires on literally.
# Use when label-based routing is intended; usually keywords + examples are enough.
triggers: ["synthesize research","affinity map","empathy map","find themes in interviews","insight statements"]
# examples: 2-5 realistic user prompts the skill SHOULD activate for.
# Written in the user's voice. Improves retrieval recall beyond keywords alone.
examples: ["Cluster these 14 interview transcripts into themes using affinity mapping.","Build an empathy map for the 'first-time buyer' segment from these field notes.","Turn this set of observations into three insight statements I can take into ideation.","Draft a jobs-to-be-done statement from this user research corpus."]
# anti_examples: near-miss prompts that should route ELSEWHERE.
# Pair with relations.suppresses (or legacy boundary alias) to name the confusable territory's owner.
anti_examples: ["Run more interviews with five additional participants.","Calculate the response rate of the survey.","Summarize this single PDF document."]
# relations: typed graph edges to sibling skills. Current fields:
# related (adjacency for browse / co-routing expansion) /
# suppresses (exclude listed skills from co-routing when THIS skill wins; write reason
# as "I own this exclusively over X", not "use X instead") /
# boundary (DEPRECATED alias of suppresses, retained for unmigrated skills) /
# verify_with (cross-check; co-loaded as one-hop expansion) /
# depends_on (composition; transitive — A→B→C loads all three) /
# broader / narrower (SKOS-style generalization) /
# disjoint_with (mutual exclusion for incompatible ownership).
relations: "{\"related\":[\"user-research\",\"journey-mapping\",\"problem-framing\",\"design-thinking\",\"conceptual-modeling\"],\"suppresses\":[{\"skill\":\"user-research\",\"reason\":\"research-synthesis owns transforming a corpus of collected qualitative evidence into themes and insights; user-research owns collecting the primary data in the first place. Both are needed, in that order.\"}],\"verify_with\":[\"usability-testing\"]}"
# === Understanding fields (when comprehension_state: present) ===
# mental_model: the primitives of the concept and how they relate. One paragraph.
mental_model: |
Synthesis is a layered distillation from evidence to action, and each layer must be earned by the one below it. Raw observations are first "downloaded" — lifted off transcripts onto a shared surface as atomic, attributable units, one observation per card in the participant's own words. Those cards are clustered bottom-up by proximity (affinity mapping / the KJ method) without imposing pre-existing categories, and a cluster is named only after its shape is undeniable. The named clusters are descriptive themes (what we heard); interpreting them yields insights (what it means); committing to act on an insight yields a point-of-view statement (what we will do). Specialized lenses — empathy maps, jobs-to-be-done, personas — are framings applied on top of clustered evidence, never substitutes for the clustering. The whole point is that every conclusion traces back to specific cards, so themes are defensible rather than impression-based.
# purpose: the problem this concept solves and why the field exists. One paragraph.
purpose: |
Without disciplined synthesis, qualitative research quietly fails: a researcher reads transcripts, forms an impression, and writes a summary that reproduces their own priors rather than the participants' patterns. Impression-based summaries are unfalsifiable and tend to confirm what the team already believed. Synthesis exists to make insight evidentiary and traceable — to force the slow, physical act of moving and clustering atomic observations so that the patterns that emerge come from the data, not from memory or comfort. The output is a small, actionable set of insight statements (observation + interpretation + implication) that feed directly into problem framing and ideation, and that anyone can check against the raw evidence.
# concept_boundary: what this concept is NOT. Distinguishes from adjacent skills by naming
# the MECHANISM that differs, not just the label. Canonical replacement for top-level `boundary`.
concept_boundary: |
This is NOT collecting new data (user-research owns interviews, contextual inquiry, diary studies), NOT quantitative analysis or statistical inference (counts, rates, significance), NOT summarizing a single document or a small internal artifact (synthesis is built for cross-session pattern extraction across a corpus), NOT modeling an engineering domain of entities and events (conceptual-modeling, event-storming), NOT building a temporal cross-touchpoint experience map (journey-mapping — synthesize first, then map), and NOT validating one hypothesis against a known artifact (usability-testing). It owns turning a corpus of qualitative evidence into themes, insights, and design-ready artifacts.
# analogy: one-sentence metaphor preserving the core mechanism.
analogy: "Research synthesis is to raw transcripts what sorting a shuffled deck into suits is to a hand of cards — you do not decide the suits in advance and force cards into them; you lay every card face up, group what genuinely belongs together by looking at it, and only then name the groups, so the categories are discovered in the evidence rather than imposed on it."
# misconception: the wrong mental model people bring; corrected explicitly.
misconception: |
The wrong mental model is "read the research, get the gist, write up the takeaways" — treating synthesis as fast summarization driven by the researcher's intuition. The corrected model: the gist is exactly the danger, because a comfortable label named too early ("users want simplicity") becomes a magnet that pulls unrelated observations into it and fossilizes the team's existing assumptions. Real synthesis is deliberately slow and physical, delays naming as long as possible, and treats every theme as a claim that must trace back to at least two specific, attributable cards. Speed and confidence are not signs of good synthesis; traceability and at least one uncomfortable, belief-contradicting insight are.
Research synthesis is the discipline of turning a corpus of raw qualitative material — interview transcripts, field notes, diary entries, observation logs — into a small, defensible set of themes, insights, and design-ready artifacts a team can act on. It works as a layered distillation: observations are first "downloaded" off the source material onto a shared surface as atomic, attributable units (one observation per card, in the participant's words), then clustered bottom-up by proximity using affinity mapping (Jiro Kawakita's KJ method) so themes emerge from the evidence rather than from imposed categories. Each clustered theme (what we heard) is then interpreted into an insight (what it means) and, where the team commits, into a point-of-view statement (what we will do). Lenses such as empathy maps, jobs-to-be-done, and personas are applied on top of clustered evidence, never as shortcuts around it. The defining commitment is traceability: every theme traces back to at least two specific cards attributable to specific sessions, which is what separates synthesis from impression-based summary. The method is deliberately slow and wary of premature abstraction, because a label named too early quietly pulls unrelated observations under it and reproduces the team's priors instead of the participants' patterns.
Research synthesis covers the methods that turn raw qualitative material into structured insight a team can act on. The canonical technique is affinity mapping (Jiro Kawakita's KJ method), where individual observations are written on cards or sticky notes, posted on a wall, and clustered bottom-up into emergent themes — without imposing pre-existing categories. Adjacent methods include empathy mapping (XPLANE / Dave Gray, "Say / Think / Do / Feel" quadrants), insight statement writing (a tension or surprise condensed into one sentence), jobs-to-be-done synthesis (extracting the functional, emotional, and social jobs a user is hiring a product to do), and persona drafting when patterns are stable enough to warrant archetypes.
Synthesis is where qualitative research either pays off or quietly fails. The temptation is to read transcripts, form an impression, and write a summary — but impression-based summaries reproduce the researcher's priors rather than the participants' patterns. Affinity mapping is deliberately slow and physical because the act of moving cards forces the researcher to keep evaluating whether two observations actually belong together, instead of subsuming them under a comfortable label.
The discipline is wary of premature abstraction. A theme named too early ("users want simplicity") becomes a magnet that pulls unrelated observations into it. The IDEO field guide and the Stanford d.school bootleg both teach delaying naming as long as possible — clustering by proximity first, naming only when the cluster's shape is undeniable. The same caution applies to personas: a persona built before patterns have stabilized fossilizes a guess, then teams optimize for a fictional user instead of real ones.