Discovery Workshop

by johnkmcleod9

designdocument

Guide synthesis of Action Mapping workshop outputs into structured discovery documents. Use when processing workshop notes, creating needs analysis, building learner personas, summarizing discovery sessions, or preparing design briefs from stakeholder meetings.

Skill Details

Repository Files

8 files in this skill directory


name: discovery-workshop description: Guide synthesis of Action Mapping workshop outputs into structured discovery documents. Use when processing workshop notes, creating needs analysis, building learner personas, summarizing discovery sessions, or preparing design briefs from stakeholder meetings. allowed-tools: Read, Write, Edit, Grep, Glob, AskUserQuestion model: claude-opus-4-5-20251101 user-invocable: true

Discovery Workshop Synthesis

Transform your Action Mapping workshop outputs into all four key discovery documents through a guided interview process.

What This Skill Does

After you've facilitated a discovery workshop with stakeholders and SMEs, this skill helps you:

  1. Synthesize raw workshop notes into structured insights
  2. Generate four key deliverables:
    • Meeting Summary
    • Formal Needs Analysis
    • Action Map Summary
    • Design Brief
  3. Create Learner Persona(s)
  4. Ensure all documents align with your adapted Action Mapping methodology

Your Adapted Action Mapping Process

This skill follows your team's adapted methodology:

1. Content Audit → Review existing training/content BEFORE stakeholder sessions
2. Business Goal → Define measurable business outcome with stakeholders
3. Behaviors + Obstacles → Map both what people should do AND why they're not doing it
4. Practice Activities → Design realistic scenarios for behavior change
5. Knowledge Pull → Identify what info learners need during activities

For detailed methodology reference, see adapted-action-mapping.md


How to Use This Skill

Option 1: Full Guided Process

Say: "Help me process my discovery workshop outputs" or invoke /discovery-workshop

I will interview you through each phase:

  1. Content audit findings
  2. Business goal identification
  3. Behaviors and obstacles mapping
  4. Target audience insights
  5. Document generation

Option 2: Specific Document

If you only need one output:

  • "Create a needs analysis from my workshop notes"
  • "Generate a design brief for this project"
  • "Build a learner persona for [audience]"
  • "Summarize my workshop into a meeting summary"

Option 3: Process Raw Notes

Paste your workshop notes and say: "Synthesize these into discovery documents"


Interview Process

I'll guide you through these questions:

Phase 1: Content Audit

  • What existing training or content did you review before the workshop?
  • What were the key findings? (What's good? What's outdated? What's missing?)
  • Is any existing content reusable?

Phase 2: Business Goal

  • What business problem are we trying to solve?
  • How is this problem currently measured?
  • What does success look like? What metrics will change?
  • Who requested this training and why now?

Phase 3: Behaviors + Obstacles

  • What specific actions should people be doing on the job?
  • Which behaviors have the highest impact on the business goal?
  • Why aren't people performing these behaviors now?
    • Knowledge gaps?
    • Skill gaps?
    • Environmental barriers?
    • Motivation issues?

Phase 4: Target Audience

  • Who exactly needs this training?
  • What do they already know?
  • What's their attitude toward this training?
  • What constraints do they have (time, technology, environment)?

Phase 5: Constraints & Context

  • What's the timeline?
  • What technology/platform will be used?
  • Are there compliance or accessibility requirements?
  • Who are the key stakeholders?

Output Documents

1. Meeting Summary

Quick reference document capturing:

  • Key decisions made
  • Action items with owners
  • Open questions
  • Notable quotes and insights

Template: meeting-summary-template.md

2. Formal Needs Analysis

Comprehensive discovery document including:

  • Business goal and success metrics
  • Current vs. desired state gap analysis
  • Target audience profile
  • Key behaviors and obstacles
  • Content requirements
  • Constraints and considerations
  • Recommended solution

Template: needs-analysis-template.md

3. Action Map Summary

Text representation of your action map:

  • Business goal at center
  • Priority behaviors listed
  • Obstacles mapped to each behavior
  • Practice activity ideas

Template: action-map-template.md

4. Design Brief

Concise document for handoff to design phase:

  • One-sentence project summary
  • Business goal
  • Target audience summary
  • Key behaviors to address
  • Proposed solution overview
  • Success metrics
  • Constraints

Template: design-brief-template.md

5. Learner Persona(s)

Detailed fictional profiles:

  • Demographics and background
  • Goals and motivations
  • Challenges and pain points
  • Learning preferences
  • Technology profile
  • Design implications

Template: learner-persona-template.md


Tips for Better Discovery

Before the Workshop

  • Review existing content/training first
  • Prepare a clear agenda
  • Identify who needs to be in the room

During the Workshop

  • Focus on behaviors, not content
  • Capture specific examples and quotes
  • Challenge assumptions ("How do you know that?")
  • Note disagreements—they reveal important tensions

After the Workshop

  • Process notes within 24-48 hours while fresh
  • Send meeting summary for validation
  • Flag open questions that need follow-up

Examples

See examples/sample-discovery-outputs.md for sample outputs from a completed discovery process.


Related Commands

  • /objectives - Generate learning objectives from behaviors
  • /synthesize-notes - Quick note synthesis without full workflow
  • /learner-persona - Generate a single persona quickly
  • /bloom-verbs - Reference for objective writing

Getting Started

Ready to process your workshop? Tell me:

  1. What project is this for? (client/project name)
  2. Do you have raw notes to share? (paste them or reference a file)
  3. Which outputs do you need? (all four, or specific documents)

Or just paste your workshop notes and I'll guide you through the process.

Related Skills

Team Composition Analysis

This skill should be used when the user asks to "plan team structure", "determine hiring needs", "design org chart", "calculate compensation", "plan equity allocation", or requests organizational design and headcount planning for a startup.

artdesign

Kpi Dashboard Design

Design effective KPI dashboards with metrics selection, visualization best practices, and real-time monitoring patterns. Use when building business dashboards, selecting metrics, or designing data visualization layouts.

designdata

Dbt Transformation Patterns

Master dbt (data build tool) for analytics engineering with model organization, testing, documentation, and incremental strategies. Use when building data transformations, creating data models, or implementing analytics engineering best practices.

testingdocumenttool

Sql Optimization Patterns

Master SQL query optimization, indexing strategies, and EXPLAIN analysis to dramatically improve database performance and eliminate slow queries. Use when debugging slow queries, designing database schemas, or optimizing application performance.

designdata

Clinical Decision Support

Generate professional clinical decision support (CDS) documents for pharmaceutical and clinical research settings, including patient cohort analyses (biomarker-stratified with outcomes) and treatment recommendation reports (evidence-based guidelines with decision algorithms). Supports GRADE evidence grading, statistical analysis (hazard ratios, survival curves, waterfall plots), biomarker integration, and regulatory compliance. Outputs publication-ready LaTeX/PDF format optimized for drug develo

developmentdocumentcli

Senior Data Scientist

World-class data science skill for statistical modeling, experimentation, causal inference, and advanced analytics. Expertise in Python (NumPy, Pandas, Scikit-learn), R, SQL, statistical methods, A/B testing, time series, and business intelligence. Includes experiment design, feature engineering, model evaluation, and stakeholder communication. Use when designing experiments, building predictive models, performing causal analysis, or driving data-driven decisions.

designtestingdata

Scientific Schematics

Create publication-quality scientific diagrams using Nano Banana Pro AI with smart iterative refinement. Uses Gemini 3 Pro for quality review. Only regenerates if quality is below threshold for your document type. Specialized in neural network architectures, system diagrams, flowcharts, biological pathways, and complex scientific visualizations.

artdocument

Mermaid Diagrams

Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts,

artdesigncode

Ux Researcher Designer

UX research and design toolkit for Senior UX Designer/Researcher including data-driven persona generation, journey mapping, usability testing frameworks, and research synthesis. Use for user research, persona creation, journey mapping, and design validation.

designtestingtool

Supabase Postgres Best Practices

Postgres performance optimization and best practices from Supabase. Use this skill when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.

designdata

Skill Information

Category:Creative
Allowed Tools:Read, Write, Edit, Grep, Glob, AskUserQuestion
Last Updated:1/26/2026