Skip to main content
command CX Codex

ux-workshop — Claude Code command: workshop and setup

ux-workshop guides a team through five design-thinking phases, ending with an MVP plan, an owner, and a checkpoint. Use it to explore a new product opportunity.

MIT ★ 110 updated 2026-11-02

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill
Open on GitHub

What ux-workshop does

The command takes a workshop from gathering observations to a concrete action plan. Participants surface problems and opportunities, rank ideas by impact and feasibility, map stakeholders, then describe a desired future state. Each phase produces an artifact, such as a heat map or a set of success markers.

In the final phase, the group chooses an opportunity to test with an MVP, assigns an owner, lists first steps, and sets a kill criterion. The session needs a topic, participant roles, and a total time budget; its schedule is shared upfront. Phases must run in order, and blockers identified in the stakeholder map need a mitigation plan. Results are saved to .ux/last-workshop.json. Without a shared topic and time budget, the session has no clear frame.

What it helps with

  • group participant observations into themes
  • rank product opportunities by impact and feasibility
  • map stakeholders by influence and interest
  • turn a selected opportunity into an MVP plan with an owner

Example prompts for the agent

  • Run a workshop on simplifying signup with product, design, and engineering roles; we have 60 minutes.
  • Facilitate a discovery session for our new feature and finish with an MVP plan.

How to install ux-workshop

1Plugin marketplace

/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill

2Manually: put the files in place

.claude/commands/ux-workshop.md

Call it with /ux-workshop. For all projects use ~/.claude/commands/

Questions about ux-workshop

How do I install ux-workshop in Claude Code?

Run these commands in order: /plugin marketplace add Laith0003/ux-skill, then /plugin install ux@ux-skill.

What does ux-workshop do?

It facilitates five sequential design-thinking phases, from exploring problems to setting out an MVP plan with an owner and a kill criterion.

What do I need before starting a workshop?

Provide a topic, participant roles, and the total time available. The command schedules the five phases and saves the result to .ux/last-workshop.json.

Source text

ux-workshop.md · MIT
---
description: Run a design thinking workshop / discovery session. Five sequential phases ending in a concrete Game Plan. Triggers on "run a workshop", "facilitate a discovery", "let's do a design thinking session". Use when running a discovery workshop, facilitating a design thinking session, exploring a problem space, running an exploration to heat map to stakeholder map to game plan flow, scoping a new product opportunity. Skip when the brief is already clear and scoped (use ux-design), the user just wants to design a single component, the team is mid-execution rather than in discovery.
allowed-tools: Read, Write, Edit, Bash(ls:*), Bash(cat:*), Bash(find:*), Bash(mkdir:*), Glob, Grep, Task
disable-model-invocation: false
---

# /ux-workshop

You are running the `/ux-workshop` command from the `ux` plugin. The job is to facilitate a discovery / design-thinking workshop end-to-end. Five sequential phases. Time-boxed. Concrete artifacts per phase. Decision at the end, not "interesting findings."

## When to use

Triggers: "run a workshop", "facilitate a discovery", "let's do a design thinking session", "I have stakeholders for an hour, what do we do", "we need to align on this opportunity", "kick off the project". Use when there's a real question and real participants, not as a solo brainstorm (use `/ux-design` or `/ux-discover --frame` for that).

## Input

Required:
- **Topic**: the question the workshop is converging on
- **Participants**: roles (not names) — eg. "2 PMs, 1 designer, 1 eng lead, 1 customer rep"
- **Time budget**: total minutes available

Ask once if missing: *"Topic, participant roles, and total minutes?"*

## Process

### 1. Read the references

Read before starting:
- `references/process/design-thinking-apphaus.md` — the canonical 5-phase structure
- `references/styles/anti-slop.md` — for any visual artifacts produced

### 2. Compute the time-box

Default split (adapt to total budget):
- Phase 1: Exploration Exercise (25%)
- Phase 2: Heat Map (15%)
- Phase 3: Stakeholder Mapping (15%)
- Phase 4: Remember the Future (20%)
- Phase 5: Game Plan (25%)

State the schedule upfront so participants know the pace.

### 3. Run the phases sequentially

#### Phase 1: Exploration Exercise

Goal: collect insights, identify barriers, find opportunities.

Facilitate:
- Ask participants to silently brainstorm for 5 minutes: what's working, what's broken, who's stuck, who's underserved
- Each person shares top 3 — one at a time, no debate
- Cluster the raw output into themes
- Tag each cluster: barrier / opportunity / insight / unknown

Artifact: clustered theme map with tags.

#### Phase 2: Heat Map

Goal: prioritize opportunities by impact × feasibility × strategic fit.

Facilitate:
- Pull the opportunities from Phase 1 onto a 2-axis grid: impact (y) × feasibility (x)
- Each participant places dots on the 3 they care most about
- Cluster dots reveal the heat
- Strategic-fit overlay: kill anything that conflicts with stated company direction

Artifact: heat-mapped grid with the 3-5 hot opportunities ranked.

If `research-synthesizer` is needed between phases (raw notes piling up, themes need digestion), dispatch it before continuing.

#### Phase 3: Stakeholder Mapping

Goal: who's affected by this; map influence × interest.

Facilitate:
- List every party affected by the top opportunities — users, internal teams, partners, regulators, competitors
- Place on a 2x2: influence (x) × interest (y)
- Identify champions (high influence + high interest), passengers (low/low), blockers (high influence + low interest), advocates (low influence + high interest)
- Name the blockers explicitly — they need a plan

Artifact: stakeholder grid with named parties + champion/blocker calls.

#### Phase 4: Remember the Future

Goal: imagine successful future state in detail.

Facilitate:
- Frame: "It's 12 months from now and this initiative worked. What changed?"
- Each participant writes 3-5 specific observations about the future state — user behavior, business metrics, internal capabilities, market position
- Share and cluster
- Pull out the 5 most concrete future-state markers — these become success metrics

Artifact: future-state narrative + 5 concrete success markers.

#### Phase 5: Game Plan

Goal: concrete action plan with owners + dates + first MVP.

Facilitate:
- From Phase 2 heat map, pick the #1 opportunity (or top 2 if time allows)
- For each: define the MVP — smallest version that tests the opportunity
- Assign owner (from participants)
- Set first-checkpoint date (within 30 days)
- Identify the first 3 concrete steps
- Name what would kill the initiative early (the kill criteria)

Artifact: 1-page Game Plan summary.

### 4. Format the output

```
─── workshop summary ───
Topic:        <topic>
Participants: <roles>
Time:         <total minutes>
Schedule:     <phase 1: m> / <phase 2: m> / <phase 3: m> / <phase 4: m> / <phase 5: m>

─── phase 1 — exploration ───
<clustered themes with barrier/opportunity/insight/unknown tags>

─── phase 2 — heat map ───
<top 3-5 ranked opportunities with impact × feasibility scores>

─── phase 3 — stakeholder map ───
<grid with champions / passengers / blockers / advocates named>

─── phase 4 — remember the future ───
<future-state narrative + 5 success markers>

─── phase 5 — game plan ───
Opportunity:    <#1 from heat map>
MVP:            <smallest testable version>
Owner:          <participant role>
First checkpoint: <date>
First 3 steps:  <ordered list>
Kill criteria:  <what would end the initiative>

─── next ───
Recommended: /ux-design     (start designing the MVP)
Other moves: /ux-research   (if Game Plan reveals research gaps)
             /ux-discover --frame  (lock the brief from the Game Plan)
             /ux-next       (let me decide)
```

### 5. Persist state

Write to `.ux/last-workshop.json`:

```json
{
  "command": "ux-workshop",
  "timestamp": "<ISO8601>",
  "topic": "<topic>",
  "participants": ["<roles>"],
  "total_minutes": <n>,
  "phases": {
    "exploration": { "themes": [], "tags": [] },
    "heat_map": { "top_opportunities": [] },
    "stakeholder_map": { "champions": [], "blockers": [] },
    "remember_the_future": { "success_markers": [] },
    "game_plan": {
      "opportunity": "",
      "mvp": "",
      "owner": "",
      "first_checkpoint": "",
      "first_steps": [],
      "kill_criteria": ""
    }
  }
}
```

## Hard rules

- Time-box every phase. Running over on one phase = compressing another. No skipping phases.
- Outputs are concrete artifacts (clustered themes, grids, narratives, plans) — not "let's discuss."
- End with a decision: the Game Plan IS the decision. "Interesting findings" is failure.
- Phase 5 has a named owner, a date, and a kill criterion. Anything less is not a Game Plan.
- Blockers from Phase 3 must have a mitigation plan named in Phase 5. Don't ignore them.
- No emojis in any artifact.
- Sequential — do not jump ahead. Phase 3 needs Phase 2's output; Phase 5 needs everything.

## Failure modes

- **Phase bleed**: Phase 1 runs long, Phase 5 gets 5 minutes. Reject — time-box is non-negotiable, even if it means truncating Phase 1.
- **No decision at the end**: workshop ends with "let's reconvene." Reject — force a Game Plan even if imperfect.
- **Blockers ignored**: Phase 3 names a high-influence blocker, Phase 5 doesn't address them. Reject.
- **MVP too big**: Phase 5 MVP is a 6-month build. Reject — split into a smaller test or fake-door first.
- **No kill criteria**: every Game Plan needs an explicit "what would tell us to stop." Without it, the initiative will live forever.

## Error Handling

| Error condition | Recovery |
|---|---|
| Participants not provided | Ask for roles (not names) — e.g., "2 PMs, 1 designer, 1 eng lead, 1 customer rep" |
| Time budget vague or missing | Propose 90-minute / 180-minute / half-day options; pick one before continuing |
| Phases blending in real time (Phase 1 runs into Phase 2) | Re-time-box, truncate the over-running phase, hold the rest of the schedule |
| Phase 3 surfaces blockers but Phase 5 ignores them | Reject the Game Plan as incomplete; require explicit blocker mitigation |
| Phase 5 MVP is a 6-month build | Reject; split into a smaller test or fake-door first |
| Raw notes pile up between phases | Dispatch `research-synthesizer` before continuing |

For path issues: see references/process/discovery-protocol.md for state file location (.ux/ in project root). Report bugs at https://github.com/Laith0003/ux-skill/issues.

## Next prompt

After `/ux-workshop`:
- `/ux-design` — start designing the MVP
- `/ux-research` — if Game Plan reveals research gaps
- `/ux-discover --frame`: lock the brief from the Game Plan
- `/ux-next` — let the conductor pick

---

## v2 Python integration

The workshop orchestrates discovery + recommend + critique in one flow. Python wires it together.

### Workshop sequence

```bash
# Phase 1 — Discovery (interactive 10-field intake)
python3 -m engine.cli.main discover --save=.ux/last-discovery.json

# Phase 2 — Generate recommendation
python3 -m engine.cli.main --no-pretty recommend --brief-file=.ux/last-discovery.json > .ux/last-recommendation.json

# Phase 3 — Show the merged system to workshop participants
python3 -c "
import json
r = json.load(open('.ux/last-recommendation.json'))
print('=' * 60)
print(' STYLE:    ', (r.get('style') or {}).get('name'))
print(' PALETTE:  ', (r.get('palette') or {}).get('name'))
print(' TYPE:     ', (r.get('type_pair') or {}).get('name'))
print(' BRANDS:   ', ', '.join(b.get('name', '?') for b in r.get('brand_exemplars', [])[:3]))
print(' GUARDS:   ', len(r.get('guardrails', [])), 'anti-patterns active')
print('=' * 60)
for line in r.get('rationale', []):
    print('  -', line)
"

# Phase 4 — Workshop critique (LLM-side; gather participant feedback)
# Phase 5 — Update the brief if critique demands, re-run recommend, iterate
```

### After the workshop

Save the final agreed brief as `.ux/workshop-final.json` for posterity. The recommendation can be re-derived from it any time.

© Laith Aljunaidy · MIT · Laith0003/ux-skill

Similar slash commands

All slash commands for Design →

From the same set31

The whole set →
ux-image-to-code ux-image-to-code redirects image extraction calls to /ux-design --extract-only --from-image. Keeps existing image-to-UI workflows working during migration to release 4.1. CX Codex +1 ★ 110repo stars ux-frame /ux-frame forwards UX framing work to /ux-discover --frame. It remains an alias in version 4.0 and is removed in 4.1. CX Codex +1 ★ 110repo stars motion-engineer motion-engineer turns a motion brief into production frontend code with Framer Motion, GSAP or CSS. Handles durations, easing curves, spring configs and reduced-motion fallbacks. CX Codex ★ 110repo stars ux-research ux-research plans user research studies, drafts interview guides and surveys, and synthesizes raw field notes into product decisions. CX Codex +1 ★ 110repo stars ux-system ux-system builds a starter design system for a project that has none: tokens, foundations, component contracts and a dark theme. Useful before the first component gets written. CX Codex +1 ★ 110repo stars copy-writer copy-writer drafts production UI microcopy aligned with your voice profile, handling errors, empty screens, CTAs, and toasts. Runs standalone or through /ux-copy --fix and /ux-design. CX Codex ★ 110repo stars research-synthesizer research-synthesizer turns interviews, analytics, competitor research, experiments, and support tickets into evidence-backed design recommendations. CX Codex ★ 110repo stars ux-component ux-component — a slash command from the ux plugin that forwards the call to /ux-design --component to generate a single UI component. It is a temporary alias, removed in 4.1. CX Codex +1 ★ 110repo stars

Project sponsors

Companies that keep this analytics open