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

ux-case-study — команда для Claude Code: что делает и как установить

Команда ux-case-study генерирует строгий монохромный кейс-стади проекта с секциями от A до G. Помогает оформить итоги работы после релиза или завершения майлстоуна.

MIT ★ 110 обновлён 2026-10-25

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

Что делает ux-case-study

Команда собирает финальный отчёт по проекту без маркетинговой шелухи. Сведения берутся из файлов состояния в каталоге .ux/, включая .ux/last-frame.json, заметки воркшопов и спецификации дизайна. Если фактов не хватает, Claude Code запрашивает недостающее за один круг вопросов.

Результат верстается строго в монохроме и делится на семь обязательных блоков: от описания проблемы и рынка до итогов и целевой аудитории. Доступны три формата на выбор: автономный HTML со встроенными стилями, шаблон Blade или чистый Markdown.

Главное ограничение — запрет на выдуманные метрики и декоративные цветные плашки. Без подтверждённых цифр команда оставляет только качественные наблюдения, а ширину строки ограничивает 65 символами.

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

  • сформировать готовый отчёт по проекту после релиза
  • собрать факты из файлов состояния .ux в единый документ
  • сверстать публикацию в монохромной типографике без маркетинговой воды
  • экспортировать кейс-стади в HTML, Blade или Markdown

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

  • /ux-case-study
  • Сделай кейс-стади проекта в формате HTML по файлам из .ux/
  • Подготовь итоговый документ по завершённому майлстоуну

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

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

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

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

.claude/commands/ux-case-study.md

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

Вопросы об ux-case-study

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

Добавьте каталог плагина командой /plugin marketplace add Laith0003/ux-skill, затем выполните /plugin install ux@ux-skill.

В каких форматах сохраняется готовый кейс?

Поддерживаются HTML, Blade и чистый Markdown. По умолчанию создаётся один независимый HTML-файл со стилями внутри по пути case-studies/<slug>.html.

Какая структура у создаваемого отчёта?

Документ содержит ровно семь секций: (A) About, (B) Mission, (C) Outcomes, (D) Impact, (E) Market, (F) Chance и (G) Target Audience.

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

ux-case-study.md · MIT
---
description: Generate a project case study in pure-monochrome editorial format. Triggers on "write a case study", "case study this project", "do the wrap-up doc". Use when writing a project case study, shipping a publishable monochrome editorial document, ending a project with a case-study artifact, producing the (A)–(G) section format in pure monochrome. Skip when the project lacks the data to populate (A)–(G) sections, the user wants a marketing landing not a case study (use ux-design).
allowed-tools: Read, Write, Edit, Bash(ls:*), Bash(cat:*), Bash(find:*), Bash(mkdir:*), Glob, Grep, Task
disable-model-invocation: false
---

# /ux-case-study

You are running the `/ux-case-study` command from the `ux` plugin. The job is to produce a project case study as a finished, publishable artifact — pure monochrome editorial typography, hairline separators, numbered section codes, bilingual-safe layout. Not a marketing brochure. A document.

## When to use

Triggers: "write a case study", "case study this project", "do the wrap-up doc", "publish this work", "post-launch retrospective", "portfolio piece". Use after a project ships or after a discrete milestone is hit.

## Input

Required:
- **Project facts** — audience, problem, solution, outcomes, impact, market, target. Pull from `.ux/last-frame.json` and any other `.ux/last-*.json` that contain relevant signal. Ask the user for any facts not in state.
- **Output format**: HTML / Blade / Markdown. Default: HTML.
- **Output path**: default `case-studies/<slug>.<ext>` in the project root.

Ask once if missing: *"Format (HTML / Blade / Markdown) and output path? Or 'defaults' and I'll pick."*

## Process

### 1. Gather facts

Walk through state in priority order:
1. `.ux/last-frame.json` — audience, problem, brand voice
2. `.ux/last-workshop.json` — the Game Plan if a workshop fed this work
3. `.ux/last-research.json` — research findings and decisions
4. `.ux/last-design.json` / `.ux/last-component.json` / `.ux/last-dashboard.json` — what was built
5. `.ux/last-a11y.json` / `.ux/last-polish.json` — quality signals

For anything missing, ask the user in a single round of questions — never piecemeal.

### 2. Read the style reference

Read `references/output/case-study-style.md` before writing. Internalize: pure monochrome, numbered section codes A-G, editorial type, hairline separators, two-tone body emphasis, RTL-safe layout.

### 3. Build the seven sections

Use these exact section codes and headers:

- **(A) About** — what is this project, in two sentences. Plain, declarative.
- **(B) Mission** — the problem and the position. Why this project exists.
- **(C) Outcomes** — what shipped. Specific, dated, with concrete artifacts.
- **(D) Impact** — measured change. Numbers if you have them; qualitative observations if not. Never invent metrics.
- **(E) Market** — the context. Competitors, adjacent solutions, why the moment is right.
- **(F) Chance** — the opportunity that remains. What's next, what's not yet solved.
- **(G) Target Audience** — who this is for. Not demographics — behaviors, needs, contexts.

### 4. Write the document

Direct, declarative voice. Short paragraphs. No marketing inflation. No "delight," "best-in-class," "robust," "leverage," "synergy," "innovative." If a sentence can be deleted without losing meaning, delete it.

Layout:
- Numbered section code (eg. "A") as a small caps prefix to the section header
- Hairline `border-top` between sections — never cards, never shaded boxes
- Body text in a single column, max 65 characters per line
- Two-tone emphasis: primary body in near-black, secondary observations in mid-gray (~50% luminance)
- Pull-quotes in editorial display type, larger than body, no quote marks needed
- Numbers in `font-mono` with tabular figures

### 5. Apply format-specific output

**HTML** (default):
- Single self-contained file with inline `<style>`
- Class names: `.cs-section`, `.cs-code`, `.cs-header`, `.cs-body`, `.cs-aside`, `.cs-quote`, `.cs-rule`
- `dir="ltr"` default; document the RTL swap in a comment
- Web fonts via Google Fonts or system stack; no JavaScript

**Blade**:
- Use the project's existing layout if a Dot-style DS is detected — pull `tokens.css` + `components.css` references
- Wrap in `@extends('layouts.app')` if applicable
- Use real DS classes where they exist; create case-study-specific classes only when DS has no match

**Markdown**:
- Pure markdown, no HTML embedding
- Section codes as `## A — About` etc.
- Pull-quotes as blockquotes
- Numbers and metrics in inline backticks for monospace rendering

### 6. Format the meta-output

```
─── case study brief ───
Project:    <name>
Format:     <HTML | Blade | Markdown>
Output:     <path>
Sections:   A, B, C, D, E, F, G

─── facts assembled ───
Audience:   <one line>
Problem:    <one line>
Solution:   <one line>
Outcomes:   <one line>
Impact:     <one line — or "qualitative only">
Market:     <one line>
Chance:     <one line>
Target:     <one line>

─── document written ───
<path>

─── self-review ───
Voice:           direct / declarative — no marketing inflation
Color:           pure monochrome — no accents
Typography:      editorial — pull-quotes in display, body in serif/sans pairing
RTL-safe:        confirmed
Numbers:         tabular monospace

─── next ───
Recommended: /ux-expert      (share / promote — if the user wants to)
Other moves: /ux-next        (let me decide)
             done            (this is the wrap-up)
```

### 7. Persist state

Write to `.ux/last-case-study.json`:

```json
{
  "command": "ux-case-study",
  "timestamp": "<ISO8601>",
  "project": "<name>",
  "format": "<HTML|Blade|Markdown>",
  "output_path": "<path>",
  "sections": ["A", "B", "C", "D", "E", "F", "G"],
  "facts": {
    "audience": "",
    "problem": "",
    "solution": "",
    "outcomes": "",
    "impact": "",
    "market": "",
    "chance": "",
    "target": ""
  }
}
```

## Hard rules

- **PURE MONOCHROME**. No brand accent on the case study — this is the one place the rule is absolute. Even a brand mark renders monochrome in this format.
- Hairline separators between sections — never cards, never shaded boxes, never colored panels.
- Two-tone body emphasis only: near-black primary, mid-gray secondary.
- Numbers in `font-mono` with tabular figures.
- Bilingual-ready: RTL-safe layout, no directional assumptions in CSS (use `inline-start` / `inline-end`).
- No emojis.
- No marketing inflation language ("delight," "best-in-class," "robust," "synergy," "innovative," "cutting-edge," "leverage").
- No invented metrics. If a number isn't real, don't include it.
- Section codes A-G in order, exact letters.
- Max 65 characters per line in body text.
- Pull-quotes are editorial display type, no quote marks.

## Failure modes

- **Marketing voice creep**: "We delivered a robust, best-in-class solution." Reject and rewrite in declarative voice.
- **Invented metrics**: "Engagement up 47%" with no source. Reject — only real numbers, qualitative if none.
- **Color slip**: a colored CTA button or accent rule appears. Reject — pure monochrome is non-negotiable.
- **Cards reappear**: a section gets a shaded background box. Reject — hairlines only.
- **Section codes out of order or skipped**: reject — A through G, in sequence.
- **DS not respected (Blade format)**: case study written with generic Tailwind when project has a Dot-style DS. Reject — pull tokens + classes.

## Error Handling

| Error condition | Recovery |
|---|---|
| Section (A)–(G) data missing from `.ux/` state and the user can't supply it | Fill placeholders with `{TODO_FILL}` and warn the user that the document is a draft until those fields are populated |
| Impact metrics requested but none are real | Use qualitative observations only; never invent numbers |
| `.ux/last-frame.json` absent and project facts unclear | Ask the user in a single round for the missing fields; never piecemeal |
| Format ambiguous (HTML / Blade / Markdown) | Default to HTML; surface the choice in the meta-output for the user to override |
| Output path collides with existing file | Stop and ask the user; never silently overwrite |
| Blade format requested but no Dot-style DS detected | Fall back to project layout if applicable; otherwise use case-study-specific classes |

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-case-study`:
- `/ux-expert` — share / promote the work, surface contact info
- `/ux-next` — let the conductor pick
- Done — this is the wrap-up artifact

---

## v2 Python integration

Case studies are storytelling, but the spine of the story is the deterministic data: what brief was given, what the engine recommended, what was generated, what the linter caught, what was fixed.

### Step 1 — Load the chain of state

```bash
python3 -c "
import json, os
files = {
    'brief':          '.ux/last-discovery.json',
    'recommendation': '.ux/last-recommendation.json',
    'generated':      '.ux/generated/manifest.json',
}
loaded = {}
for k, f in files.items():
    if os.path.exists(f):
        loaded[k] = json.load(open(f))
    else:
        loaded[k] = None
        print(f'WARN: {f} missing — case study will have gaps')
print()
print('STATE CHAIN:')
for k, v in loaded.items():
    print(f'  {k}: {\"present\" if v else \"missing\"}')
"
```

### Step 2 — Mine the chain for case-study sections

The case study sections write themselves from the structured data:

- **Brief** -> from `.ux/last-discovery.json` (project, audience, goal, tone, constraints)
- **Approach** -> from `.ux/last-recommendation.json` rationale (style picked, palette picked, type picked, brands referenced as exemplars, guardrails active)
- **Execution** -> from `.ux/generated/manifest.json` (which components were emitted)
- **Lint pass** -> from `/tmp/ux-lint-report.json` if present (findings before/after)

```bash
python3 -c "
import json, os
sections = []
if os.path.exists('.ux/last-discovery.json'):
    d = json.load(open('.ux/last-discovery.json'))['answers']
    sections.append(('Brief', d))
if os.path.exists('.ux/last-recommendation.json'):
    r = json.load(open('.ux/last-recommendation.json'))
    sections.append(('Recommendation', {
        'style': (r.get('style') or {}).get('name'),
        'palette': (r.get('palette') or {}).get('name'),
        'rationale': r.get('rationale', []),
    }))
for name, content in sections:
    print(f'--- {name} ---')
    print(json.dumps(content, indent=2))
    print()
" 2>/dev/null || echo "No state files yet — case study will need user-supplied content"
```

### Step 3 — Write with structure

Use a fixed case-study structure: Context -> Brief -> Constraints -> Approach -> Execution -> Linter findings -> Resolution -> Outcome. The Brief and Approach come from the loaded state; Context, Constraints, Resolution, Outcome are LLM-narrated.

### Fallback

If `.ux/` state is empty, the case study has to be retrospective: ask the user for the brief, approach, and outcome in chat, then structure the prose.

© Laith Aljunaidy · MIT · Laith0003/ux-skill

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

Все слэш-команды по теме «Тексты и документация» →
case-study Owl-Listener Скилл case-study для Claude Code и Codex помогает составить дизайн-кейс для портфолио с описанием процесса, метрик и результатов, чтобы рассказать о проекте внешней аудитории. CX Codex +1 2 600установок developer-case-study Samuel Berthe Скилл developer-case-study превращает разговор с клиентом и его метрики в технический кейс, которому поверят инженеры: с числами, схемой до и после и разделом ограничений. CX Codex +1 13 500установок k2f-case-study suzheng Скилл k2f-case-study структурирует кейсы для портфолио или клиентов из заметок и резюме, оформляя черновик для движка K2F с разделением фактов, решений и метрик. CX Codex +1 653установок case-study-writing 101-skills Скилл case-study-writing помогает писать B2B-кейсы по модели STAR с акцентом на измеримые метрики, клиентские цитаты и графики до/после. CX Codex +1 242установок exam-study-guide ZeKaiNie Скилл exam-study-guide собирает пройденную главу в типизированный учебный конспект и компилирует его в самодостаточный HTML с читаемыми формулами и видимыми картинками. CX Codex +1 ★ 399звёзд репо portfolio-case-study-writer Paramchoudhary Скилл portfolio-case-study-writer разворачивает пункты резюме в подробные кейсы для портфолио: структура, процесс, результаты. Пригодится при сборке сайта с проектами. CX Codex +1 11 100установок

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

Весь набор →
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звёзд репо ux-dashboard ux-dashboard запускает режим дашборда команды /ux-design, передавая ей те же аргументы. Это прежнее имя команды, которое удалят в версии 4.1. CX Codex +1 ★ 110звёзд репо ux-copy Команда ux-copy для Claude Code проверяет все пользовательские строки интерфейса по рубрике голоса и выдаёт таблицу до/после с уровнем критичности. CX Codex +1 ★ 110звёзд репо ux-critique Команда ux-critique выдаёт субъективную оценку интерфейса от лица дизайнера в виде трёх удач, трёх промахов и одного стратегического шага. Анализирует код, макеты и скриншоты. CX Codex +1 ★ 110звёзд репо ux-audit Команда ux-audit для Claude Code проверяет существующую страницу или другой интерфейс по шести направлениям UX. Она запускается на запросы об аудите, проблемах и качестве интерфейса. CX Codex +1 ★ 110звёзд репо

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

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