Skill aura-design: дизайн-система AURA для личных проектов (#17) #18

Open
aep wants to merge 1 commits from feat/17-aura-design-skill into main
Owner

Issue: #17

Скилл aura-design переносится из ~/.claude/skills/aura-design (собран и проверен 22.10.2026) в репозиторий обвязки, установка — через install.sh.

Что в PR

  • skills/aura-design/:
    • SKILL.md — когда применять, как подключить к проекту на React + TS + Vite (или только CSS), обязательные правила, частые ошибки.
    • reference/foundations.md — цветовые роли светлой и тёмной темы, типографика (Mulish / IBM Plex Mono), геометрия.
    • reference/components.md — API компонентов набора и контракты AURA, которых в наборе нет (плитки выбора, загрузка файла, шаги, панель действия).
    • reference/layout-ux.md — оболочка, шаблоны экранов (список с фильтрами, форма, окно, карточка), состояния (просрочка, пусто, ошибки), тема, доступность, проверка перед сдачей.
    • kit/ — styles/ (tokens.css, base.css, tokens.test.ts), ui/ (Button, IconButton, Segmented, ThemeSwitch, Field, inputs, Badge, Chip, Notice, Panel, PageHeader, Dialog, Confirm, Dropdown/Menu, иконки, ui.css), shell/ (AppShell + shell.css), test-setup.ts, примеры main.example.tsx и index.example.html.
  • install.sh ставит скилл в ~/.claude/skills/aura-design, --check его видит.
  • tests/test-aura-design.sh проверяет frontmatter, наличие справочников и файлов набора, отсутствие литералов цвета вне tokens.css и одинаковые имена --color-* во всех трёх блоках тем. tests/test-install.sh проверяет установку и --check.
  • README, CLAUDE.md (архитектура) и CHANGELOG (Unreleased).

Как проверял скилл (до переноса)

  • Без скилла. Агент собрал «Учёт подписок»: синий акцент, Inter, радиусы 8 и 12 px, контролы 40 px, символы вместо иконок, нижние вкладки на телефоне, красная заливка строк.
  • Со скиллом. Два агента собрали «Учёт подписок» и «Домашнюю библиотеку». Скилл нашёлся и без слова «AURA». tsc, vitest и vite build зелёные.
  • Скриншоты. Смотрел 1440 и 390 px в обеих темах: окно с ошибками, выезжающую панель, подтверждение удаления.
  • Исправлено по прогонам:
    • на 390 px скрытый текст в таблице растягивал страницу;
    • липкая шапка таблицы закрывала первую строку внутри прокрутки;
    • длинное название приложения налезало на кнопку свёртки.
  • Добавлено по прогонам: Confirm, классы формы, строки фильтров, таблицы и пустого состояния, --table-min, td.actions, test-setup.ts.

Проверки

bash tests/run.sh → passed 499, failed 0.

После merge

git pull && bash install.sh на машине владельца.

Важно: сейчас в ~/.claude стоит обвязка 0.2.0, а install.sh из main поставит 0.4.0 целиком. Это значит:

  • сжатый глобальный CLAUDE.md;
  • роли;
  • новые хуки по цели записи;
  • архив OpenSpec только отдельным PR.

До запуска install.sh скилл продолжает работать из нынешней копии в ~/.claude/skills/aura-design: её содержимое совпадает с PR.

Rulings I made

  • R-1. Задача bounded: дизайн в чате, без OpenSpec change. Скилл — markdown и файлы набора, поведение обвязки не меняется. Цена ошибки низкая.
  • R-2. install.sh ставит скилл копией (rm -rf + cp -R), как harness-doctor; правки по месту в ~/.claude перезапишутся при следующей установке. Цена ошибки низкая.
  • R-3. Инварианты набора проверяются в bash-тесте через python3 stdlib, без node. Тест повторяет kit/styles/tokens.test.ts, чтобы набор тестов пакета остался без зависимостей. Цена ошибки: два места с одним правилом.

🤖 Generated with Claude Code

Issue: #17 Скилл `aura-design` переносится из `~/.claude/skills/aura-design` (собран и проверен 22.10.2026) в репозиторий обвязки, установка — через `install.sh`. ## Что в PR - `skills/aura-design/`: - `SKILL.md` — когда применять, как подключить к проекту на React + TS + Vite (или только CSS), обязательные правила, частые ошибки. - `reference/foundations.md` — цветовые роли светлой и тёмной темы, типографика (Mulish / IBM Plex Mono), геометрия. - `reference/components.md` — API компонентов набора и контракты AURA, которых в наборе нет (плитки выбора, загрузка файла, шаги, панель действия). - `reference/layout-ux.md` — оболочка, шаблоны экранов (список с фильтрами, форма, окно, карточка), состояния (просрочка, пусто, ошибки), тема, доступность, проверка перед сдачей. - `kit/` — `styles/` (tokens.css, base.css, tokens.test.ts), `ui/` (Button, IconButton, Segmented, ThemeSwitch, Field, inputs, Badge, Chip, Notice, Panel, PageHeader, Dialog, Confirm, Dropdown/Menu, иконки, ui.css), `shell/` (AppShell + shell.css), `test-setup.ts`, примеры `main.example.tsx` и `index.example.html`. - `install.sh` ставит скилл в `~/.claude/skills/aura-design`, `--check` его видит. - `tests/test-aura-design.sh` проверяет frontmatter, наличие справочников и файлов набора, отсутствие литералов цвета вне `tokens.css` и одинаковые имена `--color-*` во всех трёх блоках тем. `tests/test-install.sh` проверяет установку и `--check`. - README, CLAUDE.md (архитектура) и CHANGELOG (Unreleased). ## Как проверял скилл (до переноса) - **Без скилла.** Агент собрал «Учёт подписок»: синий акцент, Inter, радиусы 8 и 12 px, контролы 40 px, символы вместо иконок, нижние вкладки на телефоне, красная заливка строк. - **Со скиллом.** Два агента собрали «Учёт подписок» и «Домашнюю библиотеку». Скилл нашёлся и без слова «AURA». tsc, vitest и vite build зелёные. - **Скриншоты.** Смотрел 1440 и 390 px в обеих темах: окно с ошибками, выезжающую панель, подтверждение удаления. - **Исправлено по прогонам:** - на 390 px скрытый текст в таблице растягивал страницу; - липкая шапка таблицы закрывала первую строку внутри прокрутки; - длинное название приложения налезало на кнопку свёртки. - **Добавлено по прогонам:** `Confirm`, классы формы, строки фильтров, таблицы и пустого состояния, `--table-min`, `td.actions`, `test-setup.ts`. ## Проверки `bash tests/run.sh` → passed 499, failed 0. ## После merge `git pull && bash install.sh` на машине владельца. **Важно:** сейчас в `~/.claude` стоит обвязка 0.2.0, а `install.sh` из `main` поставит 0.4.0 целиком. Это значит: - сжатый глобальный CLAUDE.md; - роли; - новые хуки по цели записи; - архив OpenSpec только отдельным PR. До запуска `install.sh` скилл продолжает работать из нынешней копии в `~/.claude/skills/aura-design`: её содержимое совпадает с PR. ## Rulings I made - **R-1.** Задача bounded: дизайн в чате, без OpenSpec change. Скилл — markdown и файлы набора, поведение обвязки не меняется. Цена ошибки низкая. - **R-2.** `install.sh` ставит скилл копией (`rm -rf` + `cp -R`), как `harness-doctor`; правки по месту в `~/.claude` перезапишутся при следующей установке. Цена ошибки низкая. - **R-3.** Инварианты набора проверяются в bash-тесте через python3 stdlib, без node. Тест повторяет `kit/styles/tokens.test.ts`, чтобы набор тестов пакета остался без зависимостей. Цена ошибки: два места с одним правилом. 🤖 Generated with [Claude Code](https://claude.com/claude-code)
aep added 1 commit 2026-10-22 11:10:56 +03:00
Скилл переносится из ~/.claude/skills/aura-design в репозиторий обвязки:
SKILL.md, справочники reference/ и набор kit/ (токены, base.css, компоненты
React, оболочка AppShell, тест токенов, test-setup, примеры входа).
install.sh ставит его в ~/.claude/skills/aura-design, --check его видит.
tests/test-aura-design.sh проверяет структуру и инварианты набора.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This pull request has changes conflicting with the target branch.
  • CHANGELOG.md
  • CLAUDE.md
  • install.sh

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u origin feat/17-aura-design-skill:feat/17-aura-design-skill
git checkout feat/17-aura-design-skill
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: aep/claude-harness#18
No description provided.