К основному содержанию
команда CX Codex

ux-workshop — слэш-команда для Claude Code: воркшоп и установка

Команда ux-workshop проводит команду через пять этапов дизайн-мышления и заканчивает планом действий с MVP, владельцем и контрольной датой. Запускайте для исследования новой продуктовой возможности.

MIT ★ 110 обновлён 2026-11-02

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add Laith0003/ux-skill
/plugin install ux@ux-skill
Открыть на GitHub

Что делает ux-workshop

Команда ведёт воркшоп от сбора наблюдений до конкретного плана. Сначала участники выделяют проблемы и возможности, затем ранжируют идеи по влиянию и реализуемости, составляют карту заинтересованных сторон и описывают желаемое будущее. Каждый этап заканчивается артефактом: например, тепловой картой или списком критериев успеха.

На финальном этапе команда выбирает возможность для MVP, назначает ответственного, определяет первые шаги и критерий остановки. Воркшоп требует темы, ролей участников и общего времени; расписание этапов объявляется заранее. Пропускать этапы нельзя, а блокерам из карты заинтересованных сторон нужен план снижения риска. Результат сохраняется в .ux/last-workshop.json. Если у участников нет общей темы или времени на сессию, эта команда не сможет задать рамки работы.

Какие задачи решает

  • собрать наблюдения участников в группы тем
  • расставить приоритеты между продуктовыми возможностями
  • нанести заинтересованные стороны на карту влияния и интереса
  • сформировать MVP-план с ответственным и критериями остановки

Примеры запросов агенту

  • Проведи воркшоп по новой возможности: тема — упрощение регистрации, участники — роли команды, время — 60 минут.
  • Помоги провести исследовательскую сессию и завершить её планом MVP для новой функции.

Как установить ux-workshop

1Через маркетплейс плагинов

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

2Вручную: положить файлы

.claude/commands/ux-workshop.md

Вызов — /ux-workshop. Для всех проектов — ~/.claude/commands/

Вопросы об ux-workshop

Как установить ux-workshop в Claude Code?

Выполните команды по порядку: /plugin marketplace add Laith0003/ux-skill, затем /plugin install ux@ux-skill.

Что делает ux-workshop?

Проводит сессию дизайн-мышления из пяти последовательных этапов: от исследования проблем до плана действий с MVP, владельцем и критериями остановки.

Что нужно подготовить для воркшопа?

Задайте тему, роли участников и общее время. Команда рассчитывает расписание по пяти этапам и сохраняет результат в .ux/last-workshop.json.

Исходный текст

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

Похожие слэш-команды

Все слэш-команды по теме «Дизайн» →
workshop-facilitation deanpeters Скилл workshop-facilitation для Claude Code ведёт воркшоп по шагам и отмечает прогресс. Он подключается, когда интерактивной сессии нужны вопросы, варианты выбора и обработка пауз. CX Codex +1 2 400установок business-kickoff-workshop thedesignproject Скилл business-kickoff-workshop для Claude Code готовит бизнес-воркшоп по Business Model Canvas и оформляет результаты после встречи. Запускается по запросу о kickoff-встрече, вопросах для нового клиента или заполнении Canvas. CX Codex +1 ★ 107звёзд репо workshop-program-design Samuel Berthe Скилл workshop-program-design помогает спланировать технический воркшоп: рассчитать число ассистентов, требования к ноутбукам и действия при сбое Wi-Fi. CX Codex +1 6 700установок customer-journey-mapping-workshop deanpeters Скилл customer-journey-mapping-workshop ведёт воркшоп по карте пути клиента: задаёт вопросы по персоне и сценарию и собирает этапы, эмоции, боли и точки роста. CX Codex +1 2 800установок fiction-workshop rhavekost Скилл fiction-workshop ведёт рукопись в три этапа: Story Bible, работа над главами и проверка на свежем читателе. Для романов и сборников рассказов. CX Codex +1 2 200установок premise-workshop danjdewhurst Скилл premise-workshop помогает превратить задумку в проверенную основу книги: от what-if и логлайна до формы, ставок и краткого брифа для story init. CX Codex +1 491установок

Из того же набора31

Весь набор →
ux-image-to-code Команда ux-image-to-code перенаправляет вызовы извлечения UI из скриншотов в команду /ux-design. Запускает обработку макетов с параметрами --extract-only --from-image. CX Codex +1 ★ 110звёзд репо ux-frame /ux-frame запускает режим frame для UX-исследования через команду /ux-discover --frame. В версии 4.0 это алиас; в 4.1 его удалят. CX Codex +1 ★ 110звёзд репо motion-engineer Субагент motion-engineer переносит анимацию в продакшн-код: Framer Motion, GSAP, CSS-переходы. Отвечает за длительности, кривые плавности, спрингы и откат при reduced-motion. CX Codex ★ 110звёзд репо ux-research Команда ux-research планирует пользовательские исследования, генерирует сценарии интервью и синтезирует собранные заметки в продуктовые выводы. CX Codex +1 ★ 110звёзд репо ux-system Команда ux-system для Claude Code собирает стартовую дизайн-систему: токены, foundations, контракты компонентов и тёмную тему. Задаёт общие правила перед началом вёрстки. CX Codex +1 ★ 110звёзд репо copy-writer Субагент copy-writer пишет интерфейсный микротекст под голос продукта: ошибки, пустые экраны, кнопки, подсказки и тосты. Запускается напрямую или через команды /ux-copy --fix и /ux-design. CX Codex ★ 110звёзд репо research-synthesizer Субагент research-synthesizer сводит интервью, аналитику, тесты, сайты конкурентов и тикеты в темы, доказательства и рекомендации для дизайн-решений. CX Codex ★ 110звёзд репо ux-component Слэш-команда ux-component из плагина ux, которая перенаправляет вызов на /ux-design --component для генерации одного UI-компонента. Это временный алиас: в версии 4.1 его уберут. CX Codex +1 ★ 110звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой