Add-on дизайн-системи

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

«Інтерфейсна поверхня» — поняття множинне: відрендерений візуальний UI, стилізований вивід CLI та розмовна поверхня (продукт спілкується в чаті чи електронною поштою) — кожна з них рахується. Add-on виявляє кожну незалежно як профіль, і прийняті профілі складаються в той самий єдиний DESIGN.md.

Що він додає

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

Поведінка

Міркуй, не копіюй. Кожне значення виводиться з реального джерела дизайну репозиторію — його таблиці стилів, кастомних властивостей CSS, конфігурації Tailwind, файлів токенів, стилів компонентів, його модуля відображення/теми CLI чи хелперів компонування повідомлень. Він ніколи не вставляє DESIGN.md стороннього бренду й не імпортує домовленості іншого продукту цілком; еталонні каталоги — це натхнення для структури, ніколи для вмісту.
Узгоджуй, не затирай. Наявний DESIGN.md чи джерело токенів узгоджується додаванням, а не перезаписується; додавання щойно прийнятого профілю дописує його розділи без переписування решти; деструктивні зміни потребують схвалення.
Виявлення за посиланням. Хоч де живе DESIGN.md, AGENTS.md (та CLAUDE.md) посилається на нього — саме покажчик, а не фізичне розташування, гарантує, що агенти його завантажать.
Прагматичний, не жорстко привʼязаний. Він посилається на домовленість DESIGN.md, що формується, як на форму, якої варто дотримуватися, розширює її на невізуальні поверхні й лишається Markdown-first, не привʼязуючись до жодної окремої схеми токенів.

Обмежений інтерфейсом, із власною силою рекомендації для кожного профілю

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

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

Він ніколи не є обовʼязковим — репозиторій із нульовою кількістю add-on повністю відповідний, і ви завжди можете відмовитися від будь-якого профілю чи від add-on цілком. DESIGN.md, створений до появи профілів, — це валідний візуальний файл з одним профілем: жодної міграції.

Опціональна команда

Коли його прийнято, add-on може встановити делегатор /design-system у .agents/commands/ репозиторію, щоб згодом перегенерувати чи оновити DESIGN.md. Встановлення команди опціональне; відхилений add-on не встановлює жодної.

Звʼязок із дизайн-документами окремих функцій

Це файл дизайн-системи рівня репозиторію, стійкий — на відміну від технічного дизайн-документа окремої функції (design.md за схемою «вимоги → дизайн → завдання» спецдрайвен-процесів, привʼязаних до інструмента). Deep Work Plan свідомо не постачає окремого архетипу дизайн-документа для функцій: README плану, критерії приймання кожного завдання та валідаційні gate вже покривають цю роль. Цей add-on заповнює єдину прогалину, яку ця роль не покриває: стійкий, нативний для репозиторію контекст дизайну інтерфейсу.