[Feature] Актуализировать вики для дизайнеров

[Amiditin]

С чем связан запрос?

Токены темы теперь генерируются через ИИ, а текущая документация не отражает новый процесс.

Опиши план реализации

• подготовить краткий гайд для дизайнеров по созданию таблиц токенов
  (структура, нейминг, обязательные поля, пример таблицы)
• описать задачи и шаблоны промптов для ИИ:
  генерация темы, вариации, корректировка токенов, формат вывода
• обновить гайд для разработчиков:
  как использовать таблицы дизайнеров + ИИ, формат итоговых файлов токенов

Критерии готовности выполнения задачи

• вики содержит обновлённый гайд для дизайнеров
• задокументированы задачи и промпты для ИИ
• гайд для разработчиков дополнён разделом про генерацию токенов через ИИ
• есть один сквозной пример: таблица → промпт → итоговые токены

[Amiditin]

@luna-vision-space как обсуждалось возьмем за основу таблицы из ui pathfinder, и нужно отдельный файл в фигме создать для примеров, хотя возможно такой уже есть, можешь проверить?

[luna-vision-space]

@Amiditin судя по тому, то есть в Фигма, есть только шаблон структуры проектов. Отдельного шаблона не нашла, в каждои проекте компоненты, материалы, фрагменты, типография, колористика — выполнены в разных вариациях.

1. Пример из Оракла
2. Пример из ФФ
3. Пример из Ревертикс
4. Объясни чуть подробнее про ИИ пожалуйста. Шаблоны промтов для ИИ для чего???

описать задачи и шаблоны промптов для ИИ:
генерация темы, вариации, корректировка токенов, формат вывода

• этот пункт не совсем понимаю.

5. Правильно понимаю, что мне все это нужно будет собрать на этой странице с полным апдейтом инфы, которую ты написал в криетриях готовности?
6. Созданный проект в Фигме мы же можем использовать в качестве примеров для Вики?
7. Какой формат нейминга является стандартом для команды? (camelCase, kebab-case, semantic groups...)
8. Какой ИИ используется для генерации токенов?
9. Пока я мало понимаю в токенах, но какой формат у финальных токенов нашей команды? И наскольно это важный момент, или не имеет значение формат?
10. таблица → промпт → итоговые токены должны быть прямо с реального проекта, или можно абстрактный пример?

[luna-vision-space]

@TorinAsakura

1. Еще раз хотим убедиться, что шаблона сборки действительно нет. Мы могли бы собрать исходя из того, что есть — универсальную, или взять за основу киты крупных проектов типа Google/Microsoft?
2. Есть ли стиль-гайд для структуры Вики/Фигма, или делаем в том же формате., который уже имеется? Нужен ли раздел для новых сотрудников или делаем для всех? И какую тему использовать (темную, светлую)? Могу ли все собрать в этом файле Structure?

[TorinAsakura]

@TorinAsakura

1. Еще раз хотим убедиться, что шаблона сборки действительно нет. Мы могли бы собрать исходя из того, что есть — универсальную, или взять за основу киты крупных проектов типа Google/Microsoft?

• какого шаблона? какой ещё сборки? о чём ты вообще?

2. Есть ли стиль-гайд для структуры Вики/Фигма, или делаем в том же формате., который уже имеется? Нужен ли раздел для новых сотрудников или делаем для всех? И какую тему использовать (темную, светлую)? Могу ли все собрать в этом файле Structure?

• это ваша задача его спроектировать, то что есть я делал на коленке, это пойдёт вам за прототип, теперь вы должны сделать из него продакшн-релиз

[luna-vision-space]

@TorinAsakura общий шаблон, по которому мы собираем к каждому проекту Typography, colors, и тд.. кажется это называется дизайн-система, для передачи разработчикам. Стоило конкретней мне написать про шаблон. Просто в разных проектах он отличается. Думаю, вторым ответом вы дали на это ответ. Беру ваш проект структура за прототип. Все сделаем! Какой дедлайн? Хотя бы ориентировочный.

[TorinAsakura]

@TorinAsakura общий шаблон, по которому мы собираем к каждому проекту Typography, colors, и тд.. кажется это называется дизайн-система, для передачи разработчикам. Стоило конкретней мне написать про шаблон. Просто в разных проектах он отличается. Думаю, вторым ответом вы дали на это ответ. Беру ваш проект структура за прототип. Все сделаем! Какой дедлайн? Хотя бы ориентировочный.

Не надо пытаться всё сделать за раз, делайте по необходимости. Есть например куски с которыми сейчас команда работает - делаете. Остальные куски готовите по требованию, или по наличию свободного времени

[Amiditin]

@Amiditin судя по тому, то есть в Фигма, есть только шаблон структуры проектов. Отдельного шаблона не нашла, в каждои проекте компоненты, материалы, фрагменты, типография, колористика — выполнены в разных вариациях.

@luna-vision-space думаю можно в будет в этот файл добавить странички colors/typography/tokens

4. Объясни чуть подробнее про ИИ пожалуйста. Шаблоны промтов для ИИ для чего???

описать задачи и шаблоны промптов для ИИ:
генерация темы, вариации, корректировка токенов, формат вывода

Просто описываем задачу, которую должен будет выполнить ии, когда мы это захотим и как мы это захотим. Это нужно чтобы каждый раз не писать одни и те же промпты для генерации токенов из фигмы.

5. Правильно понимаю, что мне все это нужно будет собрать на этой странице с полным апдейтом инфы, которую ты написал в критериях готовности

У нас задача общая, и да отредактируем текущую wiki. Я вообще предполагал, что мы определимся с неймингом, и ты в фигне создашь шаблоны табличек с токенами, на которых протестируем ии генерацию. Потом определимся с критериями и добавим гайд для дизов на вики, после я добавлю остальное: шаблоны промптов для ИИ и гайд для разработчиков

7. Какой формат нейминга является стандартом для команды?

Зависит от языка, в мобилке camelCase, фронт использует скорее kebab-case

8. Какой ИИ используется для генерации токенов?

Любой, который сможет смотреть в фигму, у нас это gpt codex и copilot

9. Пока я мало понимаю в токенах, но какой формат у финальных токенов нашей команды? И наскольно это важный момент, или не имеет значение формат?

Думаю в pathfinder и revertix форматы окей, можно их использовать, размеры указывать как sm md xl 2xl, цвета по значению text.main text.secondary text.muted

10. таблица → промпт → итоговые токены должны быть прямо с реального проекта, или можно абстрактный пример?

Думаю с абстрактного, или если и с реального, то брать принадлежащий atls, тот же atls shop

[luna-vision-space]

Что сделано:

• Сделаны шаблоны для Токенов: colors, typography, icons, elevation.

Что дальше:

• @Amiditin Посмотри как тебе такой формат, я собрала из разных проектов разные варианты, и объединила (обощила?) визуально. Можешь в комментариях написать, какие места неудобны при разработке? Что бы хотелось улучшить. С неймингами тоже можем определиться.

Артефакты:

• Figma проект