Showcase — общая схема

Документ для команды: как устроена фабрика промо (игры, ленды, сайты) с единым местом согласования и разными форматами сдачи.

Инструмент разработки с ИИ: Claude Code (не IDE-агент другого вендора).


Задача


Роли (кратко)

Роль Зона
Дизайнер Figma/AE → Claude Code (прототип) → Publish ссылки клиенту
Фронт Панель Nuxt, шаблоны типов, скиллы Claude Code, после ОК — deliver и BE
Delivery (devops) GitLab, сервер, DNS/TLS, образ панели, worker — см. 02-devops-tz.md

Главный принцип

Единая панель показа ≠ единый стек проектов.

[Diagram]

Типы проектов (шаблоны GitLab)

type Когда Preview (согласование) Deliver (сдача)
twig-embed Клиент: только index.twig, ассеты в S3, huge JS-объект данных на старте HTML/SPA + мок того же объекта index.twig + дерево под S3
vue-pixi Public Vue + PixiJS SPA dist Public / dist
static-promo Ленд, рулетка, email-заявка static zip / dist
site Визитка static static
fullstack Кликер, призы, ЛК фронт + mock API интеграция с реальным BE

MVP шаблонов: сначала twig-embed и static-promo.


Контракт репозитория: showcase.json

В корне каждого проекта:

{
  "name": "mts-ny-wheel",
  "type": "twig-embed",
  "client": "mts",
  "preview": {
    "install": "npm ci",
    "build": "npm run build:preview",
    "outDir": "dist/preview",
    "runtime": "static"
  },
  "deliver": {
    "build": "npm run build:deliver",
    "outDir": "dist/deliver",
    "artifacts": ["index.twig", "s3/**"]
  }
}

Worker панели читает манифест и выполняет только preview. Стек Vue/Twig/Pixi панели не важен.


Структура типичного проекта

project/
  showcase.json
  CLAUDE.md                 # контекст для Claude Code (команда)
  .claude/skills/           # проектные скиллы (из шаблона)
  assets/                   # Figma / AE
  src/
  mocks/                    # данные preview (в т.ч. huge gameData)
  adapters/
    preview/
    deliver/
  README-designer.md
  README-deliver.md

Ветки:


URL

Что URL
Панель команды (пароль) https://showcase.test.ru/
Превью / согласование https://showcase.test.ru/content/<unique-id>/

Статусы карточки: building → ready / failed → draft → published → visual-approved → in-delivery → done.


Поток работы

[Diagram]
  1. Дизайнер готовит макет/моушн, экспортирует в assets/.
  2. В Claude Code со скиллами прототипа собирает кликабельный preview, пушит prototype.
  3. В панели: Deploy → внутренняя проверка → Publish → ссылка клиенту.
  4. После ОК: фронт в Claude Code доводит архитектуру и build:deliver / BE.
  5. Для twig-клиента согласование идёт на моке; боевой twig-сервер клиента на этапе показа не нужен.

Claude Code: где скиллы и правила

Единый репо команды: agency-tooling/claude-skills (или cursor-skills переименовать в claude-skills).

Уровень Путь Кто
Командные скиллы (источник правды) GitLab agency-tooling/claude-skills Фронт пишет, все ставят
Личные скиллы ~/.claude/skills/<name>/SKILL.md Дизайнер / фронт на своей машине
Проект CLAUDE.md + .claude/skills/ в шаблоне репо Попадает при Create from template

Скиллы дизайнера (минимум)

Скиллы фронта (минимум)

Дизайнеру не ставить скиллы deliver/twig/API — чтобы агент не уводил в сдачу.


Репозитории tooling

Репо Назначение
agency-tooling/showcase-panel Nuxt-панель + worker (код фронта, деплой — delivery)
agency-tooling/claude-skills Скиллы и шпаргалки Claude Code
agency-templates/* Шаблоны типов проектов
clients/* Боевые проекты клиентов

MVP

  1. GitLab + сервер + панель (см. devops-ТЗ).
  2. Два шаблона: twig-embed, static-promo.
  3. Claude Code + скиллы дизайнера/фронта.
  4. Deploy preview + Publish + unique URL.
  5. build:deliver пока скриптом у фронта; кнопка в панели — фаза 2.

Чего не делать


Критерий успеха