# gsd-ui-researcher

Субагент gsd-ui-researcher, который читает требования и контекст проекта, обнаруживает состояние дизайн-системы и выпускает UI-SPEC.md — документ-контракт для фронтенд-фаз. Запускается из оркестратора /gsd:ui-phase.

- субагент · `type=agent` · Claude Code, Cursor, Codex · ★ 3785 у репозитория
- Автор: davepoon
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/gsd/agents/gsd-ui-researcher.md
- Обновлён: 2026-10-25
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/gsd-ui-researcher

## Что делает

gsd-ui-researcher автоматизирует подготовку дизайн-контракта для каждой фазы разработки интерфейса. Субагент читает REQUIREMENTS.md, CONTEXT.md и RESEARCH.md, сканирует кодовую базу на предмет существующих токенов и компонентов (shadcn, tailwind, компоненты React), определяет, какие решения уже приняты, и задаёт только оставшиеся вопросы о спейсинге, типографике, цветах и интерактивных состояниях.

Процесс включает проверку дизайн-системы: если components.json не найден в проекте на React/Next.js/Vite, субагент предложит инициализировать shadcn. Для разрешения вопросов о компонентах и стилях используются Context7 MCP (если доступен) или CLI-фоллбэк через npm. Результат — предписывающий, а не исследовательский документ (например, «16px боди-текст при 1.5 line-height», а не «рассмотрите 14–16px»).

Произведённый UI-SPEC.md становится источником истины для gsd-ui-checker (валидация), gsd-planner (дизайн-токены и компонентная опись) и gsd-executor (реализация). Субагент входит в состав GSD-оркестратора (гибридная система планирования для фронтенда) и требует наличия инструментов Read, Write, Bash, Grep, Glob; опционально использует WebSearch, WebFetch и MCP-серверы Context7, Firecrawl, Exa.

## Установка

### Claude Code (родная платформа)

**Вручную: положить файлы**
- Файл: `.claude/agents/gsd-ui-researcher.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/gsd-ui-researcher.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/gsd-ui-researcher.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/davepoon/buildwithclaude/tree/HEAD/plugins/gsd/agents/gsd-ui-researcher.md

## Когда брать
- составить дизайн-контракт для фазы разработки без переспроса уже принятых решений
- обнаружить существующие дизайн-токены, компоненты и паттерны в кодовой базе
- инициализировать shadcn и читать состояние дизайн-системы проекта
- подготовить предписывающий документ UI-SPEC.md для проверки и реализации

## Примеры запросов агенту
- Запустить субагент через /gsd:ui-phase orchestrator, он проведёт исследование и создаст UI-SPEC.md
- Прочитать REQUIREMENTS.md и CONTEXT.md, подтвердить дизайн-решения или переопределить их
- Использовать UI-SPEC.md как источник истины в gsd-ui-checker, gsd-planner и gsd-executor

## Похожие
- [Visily UI Design](https://affpapa.org/nevibecode/mcp/visily-ui-design.md) — MCP-сервер · ★ 6 у репозитория
- [Vlak](https://affpapa.org/nevibecode/mcp/vlak.md) — MCP-сервер · ★ 34 у репозитория
- [shadcn-ui](https://affpapa.org/nevibecode/skills/nexu-io-shadcn-ui.md) — скилл · 3100 установок
- [gsd-sketch](https://affpapa.org/nevibecode/skills/gsd-sketch.md) — скилл · 581 установка
- [ui-design](https://affpapa.org/nevibecode/skills/ui-design.md) — скилл · 1800 установок
- [qt-ui-design](https://affpapa.org/nevibecode/skills/qt-ui-design.md) — скилл · 1300 установок

Из того же набора: [davepoon/buildwithclaude](https://affpapa.org/nevibecode/by/davepoon/buildwithclaude.md) — 235 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
