AIKraft/Skills/frontend-dev-guidelines

frontend-dev-guidelines

Senior frontend engineer, применяющий строгие архитектурные и производительные стандарты. Используйте при создании компонентов, страниц, добавлении новых функций или при получении и изменении данных.

sickn33 official Разработка ★ 47.3k

Что делает навык

Набор строгих архитектурных и производительных стандартов для создания масштабируемых и поддерживаемых React-приложений с использованием TypeScript. Определяет обязательные паттерны разработки, включая Suspense-first подход, feature-based организацию кода и строгую типизацию.

Когда применять

  • Создание новых компонентов или страниц с соблюдением архитектурных норм
  • Добавление новых функций (features) с изоляцией логики и API
  • Извлечение и изменение данных с использованием Suspense и TanStack Query
  • Настройка роутинга с использованием TanStack Router
  • Рефакторинг или код-ревью для устранения антипаттернов и улучшения производительности

Как работает

  1. Оценить сложность задачи через индекс FFCI (Frontend Feasibility & Complexity Index) для определения допустимости реализации
  2. Организовать код по принципу feature-based: доменная логика в features/, переиспользуемые примитивы в components/
  3. Использовать useSuspenseQuery для получения данных, полностью исключая состояния isLoading и ранние возвраты со спиннерами
  4. Применять ленивую загрузку (lazy loading) для тяжелых компонентов, роутов и модальных окон, оборачивая их в SuspenseLoader
  5. Соблюдать строгие стандарты TypeScript (без any, явные типы) и использовать MUI v7 с типобезопасным доступом к теме
  6. Изолировать API-вызовы в слое api/ внутри каждой фичи, запрещая inline-запросы внутри компонентов

Примеры запросов агенту

Создай компонент страницы профиля пользователя, используя Suspense-first подход и feature-based организацию
Рефактори текущий компонент: убери ранние возвраты при загрузке, замени fetch на useSuspenseQuery и добавь ленивую загрузку
Настрой роутинг для новой фичи 'analytics' с использованием TanStack Router и изолированным API-слоем

Что понадобится

  • Среда разработки с поддержкой React, TypeScript, TanStack Router и MUI v7
  • Наличие библиотеки TanStack Query для реализации Suspense-first паттерна
  • Структура проекта, соответствующая canonical file structure (src/features, src/components, src/routes)

Описание составлено по SKILL.md навыка, сверено 08.10.2026.

Как подключить

1Скачать навык
# возьмите папку навыка «frontend-dev-guidelines» из репозитория: # https://github.com/sickn33/agentic-awesome-skills
2Положить папку с SKILL.md к навыкам ассистента
# положите папку навыка туда, где ассистент ищет skills: cp -r frontend-dev-guidelines/ ~/.claude/skills/frontend-dev-guidelines/

Навык — папка с файлом SKILL.md (описание + инструкции) и опциональными скриптами. Ассистент (Claude, Claude Code и совместимые) подхватывает его по описанию и следует шагам.