Document

Когда использовать

Запустите /impeccable document, когда у вас достаточно визуальной системы для документирования: цвета, типографика, хотя бы кнопка и карточка. Команда сканирует вашу кодовую базу, извлекает найденные токены и паттерны компонентов и создаёт DESIGN.md в корне проекта, следующий формату Google Stitch DESIGN.md, шесть секций в фиксированном порядке, совместимый с каждым другим DESIGN.md-осведомлённым инструментом.

Обращайтесь к нему, когда:

• Вы только что запустили /impeccable teach и PRODUCT.md уже существует. Document — соответствующий визуальный файл.
• Команда подтолкнула вас к нему. Live, craft и polish читают DESIGN.md. Если он отсутствует, навык предлагает запустить document первым.
• Дизайн дрейфовал от старого DESIGN.md, и файл больше не описывает живую систему.
• Перед масштабным редизайном, чтобы зафиксировать текущее состояние как референс для следующего направления.

Для проектов без кода (свежий запуск teach, ничего не создано), есть режим посева: /impeccable document --seed задаёт пять быстрых стратегических вопросов (цветовая стратегия, типографическое направление, энергия анимации, референсы, антиреференсы) и создаёт каркас. Перезапустите в режиме сканирования, когда появится код.

Как это работает

Проход сканирования находит дизайнерские ассеты в порядке приоритета: CSS custom properties, конфигурация Tailwind, CSS-in-JS темы, файлы дизайн-токенов, исходный код компонентов, глобальная таблица стилей и наконец вычисленные стили из живого рендера, если доступен браузер. Он автоматически извлекает всё, что может, затем задаёт один сгруппированный вопрос для частей, требующих творческого ввода: Creative North Star (единственная именованная метафора для всей системы, например «Редакционное убежище»), описательные имена цветов, философия возвышения и характер компонентов.

Результат — DESIGN.md ровно с шестью секциями: Overview, Colors, Typography, Elevation, Components, Do’s and Don’ts. Заголовки фиксированы посимвольно, чтобы файл был разбираем другими инструментами. Рядом записывается DESIGN.json как машиночитаемый вкладыш. Этот вкладыш использует панель дизайна live-mode для рендера данного проекта — реальных кнопок, полей ввода, навигации и карточек вместо универсальной аппроксимации.

Каждая другая команда читает DESIGN.md при вызове. Варианты, полировки, аудиты и новые функции наследуют визуальную систему без инструкций.

Попробуйте

/impeccable document

На проекте с уже определёнными токенами это занимает около двух минут: сканирование находит вашу палитру и стек шрифтов, вы выбираете North Star из 2–3 вариантов, подтверждаете описательные имена цветов («Глубокий приглушённый сине-зелёный», а не «blue-800»), и файл появляется в корне проекта.

На новом проекте:

/impeccable document --seed

Пять вопросов, около пяти минут. Файл — каркас, помеченный комментарием <!-- SEED -->, чтобы честно отражать свою природу. Перезапустите без флага, когда реализуете токены.

Подводные камни

• Слишком ранний запуск. На проекте без реализованных токенов подходит режим seed. Не фабрикуйте полную спецификацию, которую код не может подтвердить. Фейковый DESIGN.md хуже, чем никакого DESIGN.md.
• Восприятие DESIGN.md как документации только для людей. Он в первую очередь для ИИ. Каждая другая команда его читает. Категоричность формата («никогда», «всегда», именованные правила) намеренна.
• Добавление секции Layout / Motion / Responsive верхнего уровня. Спецификация содержит шесть секций в фиксированном порядке с фиксированными именами. Вложите контент о макете или анимации в Overview (правила философского уровня) или Components (поведение на уровне компонента).
• Перезапись существующего DESIGN.md без предупреждения. Document всегда подтверждает сначала. Если хотите начать заново, переименуйте существующий файл или явно скажите навыку перезаписать.