Документ для команды: как устроена фабрика промо (игры, ленды, сайты) с единым местом согласования и разными форматами сдачи.
Инструмент разработки с ИИ: Claude Code (не IDE-агент другого вендора).
https://showcase.test.ru/content/<unique-id>/.| Роль | Зона |
|---|---|
| Дизайнер | Figma/AE → Claude Code (прототип) → Publish ссылки клиенту |
| Фронт | Панель Nuxt, шаблоны типов, скиллы Claude Code, после ОК — deliver и BE |
| Delivery (devops) | GitLab, сервер, DNS/TLS, образ панели, worker — см. 02-devops-tz.md |
Единая панель показа ≠ единый стек проектов.
| 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
Ветки:
prototype — зона дизайнера + Claude Code (визуал, моки).main — зона фронта (логика, deliver, BE) после visual-approved.| Что | URL |
|---|---|
| Панель команды (пароль) | https://showcase.test.ru/ |
| Превью / согласование | https://showcase.test.ru/content/<unique-id>/ |
unique-id (версии не затирают друг друга).Статусы карточки: building → ready / failed → draft → published → visual-approved → in-delivery → done.
assets/.prototype.build:deliver / BE.Единый репо команды: 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 |
designer-prototype — из макета/ассетов → работающий preview, без deliver/BE.designer-assets-from-figma — куда класть экспорт, naming.designer-motion-lottie — AE → Lottie/видео в прототип.front-showcase-panel — разработка Nuxt-панели.front-showcase-json — контракт манифеста и worker.front-twig-embed-adapter — мок ↔ index.twig + S3.front-handoff-from-prototype — visual-approved → архитектура/API.front-project-template — правка шаблонов типов.Дизайнеру не ставить скиллы deliver/twig/API — чтобы агент не уводил в сдачу.
| Репо | Назначение |
|---|---|
agency-tooling/showcase-panel |
Nuxt-панель + worker (код фронта, деплой — delivery) |
agency-tooling/claude-skills |
Скиллы и шпаргалки Claude Code |
agency-templates/* |
Шаблоны типов проектов |
clients/* |
Боевые проекты клиентов |
twig-embed, static-promo.build:deliver пока скриптом у фронта; кнопка в панели — фаза 2.