Дополнение Design-system

Даёт репозиторию с пользовательской поверхностью интерфейса DESIGN.md — Markdown-файл дизайн-системы, который любой кодовый агент читает, чтобы генерировать интерфейсный вывод, согласованный с собственными соглашениями репозитория, вместо нестилизованных, статистически распространённых значений по умолчанию, к которым агент прибегает без указаний. Четвёртое опциональное дополнение Deep Work Plan.

«Поверхность интерфейса» — понятие множественное: отрисовываемый визуальный UI, стилизованный вывод CLI и диалоговая поверхность (продукт общается в чате или по почте) — каждая считается отдельно. Дополнение обнаруживает каждую из них независимо как профиль, и принятые профили складываются в один и тот же единственный DESIGN.md.

Что оно добавляет

DESIGN.md по пути docs/DESIGN.md (рядом с прочими спецификациями репозитория; в корне репозитория — только когда дерева docs/ нет), на который ссылается AGENTS.md, чтобы агенты обнаруживали его так же, как остальную документацию. Один репозиторий — один файл, никогда не отдельные файлы на каждую поверхность.
Профиль visual-ui — канонические визуальные разделы: обзор/атмосфера, цветовая палитра и роли (светлая + тёмная), типографика, раскладка и отступы, возвышение и глубина, формы, компоненты, адаптивное поведение, что делать и чего избегать (включая правила доступности репозитория).
Профиль cli-output — стилизованные терминальные интерфейсы: голос вывода, семантические цвета и стили (success/error/warning/info/dim, сопоставленные с реальной темой), компоненты вывода (панели, таблицы, спиннеры, интерактивные подсказки — названные по реальным хелперам репозитория), соглашения о раскладке и правила деградации (TTY против конвейера, NO_COLOR, дисциплина stdout/stderr, коды выхода).
Профиль conversational — поверхность обмена сообщениями продукта: голос и регистр (тон, краткость, правила именования бренда), анатомия сообщения (личное сообщение, пост в канале, ответ в треде, правка на месте) и рендеринг по платформам (Slack mrkdwn, Discord markdown, адаптивные карточки Teams, email) с резервными вариантами в простом тексте.
Общее руководство по промптам для агента, а также шаг валидации, который проверяет целостность каждого профиля: задокументированный контраст текста удовлетворяет WCAG AA (визуальный), цвет никогда не является единственным носителем смысла (CLI), богатые отрисовки указывают резервные варианты в простом тексте (диалоговый), и ссылки на токены разрешаются.

Поведение

Рассуждай, не копируй. Каждое значение выводится из реального источника дизайна репозитория — его таблицы стилей, пользовательских CSS-свойств, конфигурации Tailwind, файлов токенов, стилей компонентов, его модуля отображения/темы CLI или его хелперов композиции сообщений. Оно никогда не вставляет DESIGN.md стороннего бренда и не импортирует соглашения другого продукта целиком; справочные каталоги — это вдохновение для структуры, но никогда для содержимого.
Согласовывай, не затирай. Существующие DESIGN.md или источник токенов согласовываются аддитивно, никогда не перезаписываются; добавление нового принятого профиля дописывает его разделы без переписывания остального; разрушительные изменения требуют одобрения.
Обнаружение по ссылке. Где бы ни находился DESIGN.md, AGENTS.md (и CLAUDE.md) ссылается на него — именно указатель, а не физическое расположение гарантирует, что агенты загрузят его.
Прагматично, без жёсткой привязки. Оно ссылается на формирующееся соглашение DESIGN.md как на форму, которой стоит следовать, расширяет его на невизуальные поверхности и остаётся Markdown-первичным, не привязываясь ни к одной схеме токенов.

Ограничено интерфейсом, с собственной силой рекомендации у каждого профиля

Это дополнение предназначено для репозиториев хотя бы с одной реальной поверхностью интерфейса; оно никогда не предлагается для репозитория без таковых (чистая библиотека, headless-сервис, репозиторий только с инфраструктурой). Каждый профиль несёт собственную силу рекомендации:

visual-ui включён по умолчанию при обнаружении — таблица стилей с пользовательскими CSS-свойствами, конфигурация Tailwind или блок @theme, UI-компоненты либо руководство по бренду/стилю. Онбординг применяет его в режиме доверия и настоятельно рекомендует в направляемом режиме.
cli-output и conversational рекомендуются при обнаружении — и о них всегда спрашивают, они никогда не применяются автоматически, даже в режиме доверия. О первом сигнализирует библиотека отрисовки CLI вместе с осознанным слоем отображения; о втором — SDK чат-платформы или слой композиции сообщений. Голый парсер аргументов с сырыми выводами не подходит.

Оно никогда не обязательно — репозиторий с нулём дополнений полностью соответствует стандарту, и вы всегда можете отказаться от любого профиля или от всего дополнения. DESIGN.md, созданный до появления профилей, — это валидный визуальный файл с одним профилем: никакой миграции.

Опциональная команда

При принятии дополнение может установить делегатор /design-system в .agents/commands/ репозитория, чтобы позже перегенерировать или обновить DESIGN.md. Установка команды опциональна; отклонённое дополнение не устанавливает ничего.

Связь с дизайн-документами для отдельных фич

Это репозиторного уровня, постоянный файл дизайн-системы — в отличие от технического дизайн-документа для отдельной фичи (design.md цикла «требования → дизайн → задачи» в spec-driven-процессах, привязанных к инструменту). Deep Work Plan намеренно не поставляет отдельного архетипа дизайн-документа для фич: README плана, критерии приёмки каждой задачи и validation gates уже покрывают эту роль. Это дополнение закрывает единственный пробел, который эта роль не покрывает: устойчивый, нативный для репозитория контекст дизайна интерфейса.