К основному содержанию
команда CX Codex

devkit.react.code-review — команда для Claude Code

Команда devkit.react.code-review проводит ревью кода на React 19 и Tailwind CSS с проверкой серверных компонентов, хуков и архитектуры перед слиянием пуллреквестов.

MIT ★ 372 обновлён 2026-09-10

Установить в Claude Code · Через маркетплейс плагинов Все способы и платформы ↓
/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit-typescript@developer-kit
Открыть на GitHub

Что делает devkit.react.code-review

Команда анализирует проект под стандарты React 19 и Tailwind CSS. При запуске она считывает контекст Git: текущую ветку, статус изменений, последние пять коммитов и список файлов из git diff HEAD~1. Если в корне есть package.json, скрипт проверяет версии библиотек react и tailwindcss.

Проверка оценивает отказ от устаревших паттернов вроде forwardRef, переход на хуки useActionState, useFormStatus, useOptimistic и чтение промисов через use(). В фокусе также разделение границ "use client" и директивы "use server", композиция компонентов и правила хуков.

Для выполнения команда вызывает агента developer-kit-typescript:typescript-software-architect-review, а при его отсутствии переключается на developer-kit:general-code-reviewer. Поэтому перед запуском нужно установить плагин разработчика в проект.

Какие задачи решает

  • Проверить компоненты на корректное использование API React 19 перед мержем
  • Найти лишние вызовы useEffect и заменить их на хук use() с Suspense
  • Проконтролировать границы директив use client и use server в Server Actions
  • Выявить разрастание булевых пропсов и предложить композицию компонентов

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

  • /devkit.react.code-review full
  • /devkit.react.code-review hooks src/hooks/useCart.ts
  • /devkit.react.code-review styling src/components/Header.tsx

Как установить devkit.react.code-review

1Через маркетплейс плагинов

/plugin marketplace add giuseppe-trisciuoglio/developer-kit
/plugin install developer-kit-typescript@developer-kit

2Вручную: положить файлы

.claude/commands/devkit.react.code-review.md

Вызов — /devkit.react.code-review. Для всех проектов — ~/.claude/commands/

Вопросы о devkit.react.code-review

Как установить devkit.react.code-review в Claude Code?

Подключите маркетплейс командой /plugin marketplace add giuseppe-trisciuoglio/developer-kit, а затем установите плагин вызовом /plugin install developer-kit-typescript@developer-kit.

Какие типы проверок поддерживает команда?

В аргументах можно указать режим: full, components, hooks, performance, accessibility, styling, forms или testing, а вторым параметром передать путь к файлу.

Какой субагент выполняет анализ кода?

Основным исполнителем назначен developer-kit-typescript:typescript-software-architect-review, а запасным вариантом служит developer-kit:general-code-reviewer.

Исходный текст

devkit.react.code-review.md · MIT
---
allowed-tools: Read, Write, Bash, Edit, Grep, Glob
argument-hint: "[review-type] [file/directory-path] [options]"
description: Provides comprehensive React 19 + Tailwind CSS code review focusing on modern patterns, hooks, Server Components, Actions, performance, accessibility, and Tailwind best practices. Use when reviewing React code changes or before merging pull requests.
model: inherit
---

# React 19 + Tailwind CSS Code Review

## Overview

Provides comprehensive React 19 + Tailwind CSS code review focusing on modern patterns, hooks, Server Components,
Actions, performance, accessibility, and Tailwind best practices. Use when reviewing React code changes or before
merging pull requests.

## Usage

```
/devkit.react.code-review $ARGUMENTS
```

## Arguments

| Argument     | Description                              |
|--------------|------------------------------------------|
| `$ARGUMENTS` | Combined arguments passed to the command |

## Current Context

- **Current Git Branch**: !`git branch --show-current`
- **Git Status**: !`git status --porcelain`
- **Recent Commits**: !`git log --oneline -5`
- **Modified Files**: !`git diff --name-only HEAD~1`
- **React Version**: !
  `[ -f package.json ] && grep -o '"react":\s*"[^"]*"' package.json 2>/dev/null || echo "Not detected"`
- **Tailwind Version**: !
  `[ -f package.json ] && grep -o '"tailwindcss":\s*"[^"]*"' package.json 2>/dev/null || echo "Not detected"`

## Execution Instructions

**Agent Selection**: To execute this code review, use the following agent with fallback:

- Primary: `developer-kit-typescript:typescript-software-architect-review`
- Fallback: `developer-kit:general-code-reviewer`

**Run context**:

- Provide `$1` as `full`, `components`, `hooks`, `performance`, `accessibility`, `styling`, `forms`, or `testing`
- Optional: specify file or directory path as `$2`


## Review Configuration

The review will analyze: **$ARGUMENTS**

**Available review types:**

- `full` - Complete 360° review (default)
- `components` - Focus on component architecture and patterns
- `hooks` - React hooks usage and custom hooks
- `performance` - Rendering, memoization, bundle size
- `accessibility` - A11y compliance and ARIA
- `styling` - Tailwind CSS patterns and design system
- `forms` - Form handling with Actions and validation
- `testing` - Test coverage and strategies

## Phase 1: Identify Review Scope

### 1.1 Detect Scope

IF "$1" IS PROVIDED
THEN Analyze specific file or component: $ARGUMENTS
ELSE Analyze modified and affected components in the project
ENDIF

### 1.2 Project Configuration

- **Framework**: Next.js, Vite, Create React App, Remix
- **TypeScript**: tsconfig.json strictness level
- **Tailwind Config**: tailwind.config.js/ts customizations
- **Build Tool**: Vite, Webpack, Turbopack
- **State Management**: React Context, Zustand, Redux, Jotai

## Phase 2: React 19 Best Practices

### 2.1 New React 19 Features

#### Server Components & Actions

- Verify proper use of `"use server"` directive for Server Actions
- Check `"use client"` boundaries are minimal and intentional
- Validate Server Components don't import client-only code
- Ensure Actions return proper response structures

#### useActionState Hook

```jsx
// ✅ Correct: useActionState for form submissions
const [state, formAction, isPending] = useActionState(submitAction, initialState);

// ❌ Avoid: Manual state management for forms
const [loading, setLoading] = useState(false);
const [error, setError] = useState(null);
```

#### use() Hook for Async Data

```jsx
// ✅ Correct: use() with Suspense for data fetching
function Comments({ commentsPromise }) {
  const comments = use(commentsPromise);
  return comments.map(c => <p key={c.id}>{c.text}</p>);
}

// ❌ Avoid: useEffect for data fetching when use() is appropriate
useEffect(() => { fetchData().then(setData); }, []);
```

#### useFormStatus Hook

```jsx
// ✅ Correct: useFormStatus for submit button state
function SubmitButton() {
  const { pending } = useFormStatus();
  return <button disabled={pending}>{pending ? 'Saving...' : 'Save'}</button>;
}
```

#### useOptimistic Hook

```jsx
// ✅ Correct: Optimistic updates for better UX
const [optimisticItems, addOptimisticItem] = useOptimistic(
  items,
  (state, newItem) => [...state, { ...newItem, pending: true }]
);
```

### 2.2 Refs as Props (React 19)

```jsx
// ✅ React 19: ref is a regular prop
function Input({ ref, ...props }) {
  return <input ref={ref} {...props} />;
}

// ❌ Deprecated: forwardRef wrapper (still works but unnecessary)
const Input = forwardRef((props, ref) => <input ref={ref} {...props} />);
```

### 2.3 Document Metadata

```jsx
// ✅ React 19: Native metadata support
function BlogPost({ post }) {
  return (
    <article>
      <title>{post.title}</title>
      <meta name="description" content={post.summary} />
      <h1>{post.title}</h1>
    </article>
  );
}
```

## Phase 3: Component Architecture

### 3.1 Component Structure

- Single responsibility principle per component
- Prefer composition over prop drilling
- Use compound components for complex UI patterns
- Keep components under 200 lines, extract sub-components

### 3.2 Props Design

```jsx
// ✅ Correct: Discriminated unions for variant props
type ButtonProps = 
  | { variant: 'primary'; onClick: () => void }
  | { variant: 'link'; href: string };

// ✅ Correct: Spread remaining props
function Button({ variant, children, ...props }: ButtonProps) {
  return <button className={variants[variant]} {...props}>{children}</button>;
}

// ❌ Avoid: Boolean prop explosion
<Button isPrimary isLarge isDisabled isLoading />
```

### 3.3 Children Patterns

```jsx
// ✅ Correct: Render props for flexibility
<DataProvider render={(data) => <List items={data} />} />

// ✅ Correct: Compound components
<Select>
  <Select.Option value="1">One</Select.Option>
  <Select.Option value="2">Two</Select.Option>
</Select>
```

## Phase 4: Hooks Best Practices

### 4.1 Built-in Hooks Review

- **useState**: Avoid redundant state, derive when possible
- **useEffect**: Minimal dependencies, proper cleanup
- **useMemo/useCallback**: Only when profiler shows need
- **useRef**: DOM refs and mutable values that don't trigger re-render
- **useContext**: Check for missing providers, context splitting

### 4.2 Custom Hooks

```jsx
// ✅ Correct: Custom hook extracts reusable logic
function useDebounce<T>(value: T, delay: number): T {
  const [debouncedValue, setDebouncedValue] = useState(value);
  
  useEffect(() => {
    const timer = setTimeout(() => setDebouncedValue(value), delay);
    return () => clearTimeout(timer);
  }, [value, delay]);
  
  return debouncedValue;
}

// ❌ Avoid: Hooks that do too much
function useEverything() { /* manages auth, theme, data, routing... */ }
```

### 4.3 Hook Rules Compliance

- Hooks only at top level (no conditions/loops)
- Hooks only in React functions
- Exhaustive deps rule compliance
- No stale closure issues

## Phase 5: Tailwind CSS Best Practices

### 5.1 Utility Class Organization

```jsx
// ✅ Correct: Logical grouping of utilities
<div className="
  flex items-center gap-4           /* Layout */
  px-4 py-2                         /* Spacing */
  bg-white dark:bg-gray-800         /* Colors */
  rounded-lg shadow-md              /* Effects */
  hover:shadow-lg transition-shadow /* States */
">

// ❌ Avoid: Random ordering
<div className="shadow-md py-2 flex hover:shadow-lg bg-white px-4 rounded-lg">
```

### 5.2 Dark Mode Implementation

```jsx
// ✅ Correct: Consistent dark mode variants
<div className="bg-white dark:bg-gray-900 text-gray-900 dark:text-gray-100">
  <h1 className="text-gray-800 dark:text-white">Title</h1>
  <p className="text-gray-600 dark:text-gray-400">Description</p>
</div>

// ❌ Avoid: Inconsistent or missing dark mode
<div className="bg-white text-black"> /* No dark mode support */
```

### 5.3 Responsive Design

```jsx
// ✅ Correct: Mobile-first responsive
<div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-4">
  <div className="p-4 md:p-6 lg:p-8">
    <h2 className="text-lg md:text-xl lg:text-2xl">Heading</h2>
  </div>
</div>

// ❌ Avoid: Desktop-first or inconsistent breakpoints
<div className="lg:grid-cols-3 grid-cols-1"> /* Confusing order */
```

### 5.4 Component Variants with CVA/clsx

```jsx
// ✅ Correct: Use cva for variant management
import { cva } from 'class-variance-authority';

const button = cva('rounded font-medium transition-colors', {
  variants: {
    intent: {
      primary: 'bg-blue-600 text-white hover:bg-blue-700',
      secondary: 'bg-gray-200 text-gray-900 hover:bg-gray-300',
    },
    size: {
      sm: 'px-3 py-1.5 text-sm',
      md: 'px-4 py-2 text-base',
      lg: 'px-6 py-3 text-lg',
    },
  },
  defaultVariants: { intent: 'primary', size: 'md' },
});

// ❌ Avoid: String concatenation for variants
className={`btn ${isPrimary ? 'bg-blue-600' : 'bg-gray-200'} ${isLarge ? 'px-6' : 'px-4'}`}
```

### 5.5 Avoiding Tailwind Anti-patterns

```jsx
// ❌ Avoid: Arbitrary values when design tokens exist
<div className="mt-[13px] text-[#1a2b3c]">

// ✅ Correct: Use design system values
<div className="mt-3 text-gray-800">

// ❌ Avoid: @apply in CSS (loses utility benefits)
.btn { @apply px-4 py-2 rounded; }

// ✅ Correct: Component abstraction in JSX
const Button = ({ children }) => (
  <button className="px-4 py-2 rounded">{children}</button>
);
```

## Phase 6: Performance Optimization

### 6.1 Rendering Optimization

- Check for unnecessary re-renders with React DevTools
- Verify memo() usage is justified by profiler data
- Ensure keys are stable and unique (not index for dynamic lists)
- Use React.lazy() for code splitting

### 6.2 Bundle Size

- Tree-shaking friendly imports
- Dynamic imports for heavy dependencies
- Verify Tailwind purge/content configuration
- Check for duplicate dependencies

### 6.3 React Compiler (React 19)

```jsx
// React Compiler auto-optimizes, manual memoization often unnecessary
// ✅ Let compiler optimize
function ExpensiveList({ items }) {
  return items.map(item => <Item key={item.id} data={item} />);
}

// ❌ Avoid: Premature optimization
const MemoizedList = memo(({ items }) => {
  const processedItems = useMemo(() => items.map(process), [items]);
  const handleClick = useCallback(() => {}, []);
  // ...
});
```

## Phase 7: Accessibility (A11y)

### 7.1 Semantic HTML

- Use semantic elements (button, nav, main, article, section)
- Proper heading hierarchy (h1 > h2 > h3)
- Labels associated with form inputs
- Alt text for images

### 7.2 ARIA Attributes

```jsx
// ✅ Correct: Proper ARIA usage
<button 
  aria-label="Close dialog"
  aria-expanded={isOpen}
  aria-controls="menu-content"
>
  <XIcon aria-hidden="true" />
</button>

// ❌ Avoid: Redundant ARIA
<button role="button" aria-label="Click me button">Click me</button>
```

### 7.3 Keyboard Navigation

- All interactive elements are focusable
- Logical tab order
- Focus trap for modals/dialogs
- Visible focus indicators

### 7.4 Tailwind A11y Utilities

```jsx
// ✅ Correct: Screen reader utilities
<span className="sr-only">Loading</span>
<div aria-busy="true" className="animate-spin" />

// ✅ Correct: Focus visible styling
<button className="focus:outline-none focus-visible:ring-2 focus-visible:ring-blue-500">
```

## Phase 8: Forms & Validation

### 8.1 Form Actions (React 19)

```jsx
// ✅ Correct: Form with Server Action
async function createPost(formData: FormData) {
  'use server';
  const title = formData.get('title');
  await db.posts.create({ title });
  revalidatePath('/posts');
}

function CreatePostForm() {
  return (
    <form action={createPost}>
      <input name="title" required />
      <SubmitButton />
    </form>
  );
}
```

### 8.2 Client-side Validation

```jsx
// ✅ Correct: Progressive enhancement
<input
  type="email"
  required
  pattern="[a-z0-9._%+-]+@[a-z0-9.-]+\.[a-z]{2,}$"
  className="invalid:border-red-500 invalid:text-red-600"
/>
```

### 8.3 Form Libraries Integration

- React Hook Form with Tailwind styling
- Zod/Yup schema validation
- Error message display patterns

## Phase 9: Testing Strategy

### 9.1 Component Testing

- Unit tests with Vitest/Jest + Testing Library
- Integration tests for component interactions
- Snapshot tests for UI regression (use sparingly)

### 9.2 Testing Patterns

```jsx
// ✅ Correct: Query by role/label
const button = screen.getByRole('button', { name: /submit/i });
await userEvent.click(button);
expect(screen.getByText(/success/i)).toBeInTheDocument();

// ❌ Avoid: Query by test ID when better options exist
const button = screen.getByTestId('submit-btn');
```

### 9.3 Coverage Targets

- Components: > 80% coverage
- Custom hooks: > 90% coverage
- Utility functions: 100% coverage

## Phase 10: Final Review Report

### Critical Issues (P0 - Fix Immediately)

- Security vulnerabilities (XSS, injection)
- Accessibility blockers (no keyboard nav, missing labels)
- Memory leaks (missing cleanup in effects)
- Production crashes or broken builds

### High Priority (P1 - Next Release)

- Performance regressions (slow renders, large bundles)
- Missing error boundaries
- Inconsistent dark mode support
- Poor mobile experience

### Medium Priority (P2 - Next Sprint)

- Component refactoring for reusability
- Missing tests for critical paths
- Tailwind class organization
- TypeScript strict mode violations

### Low Priority (P3 - Backlog)

- Minor naming improvements
- Additional documentation
- Nice-to-have optimizations
- Code style preferences

## Quality Metrics

- **Component Coverage**: > 80% for shared components
- **Performance Budget**: LCP < 2.5s, FID < 100ms, CLS < 0.1
- **Bundle Size**: Main bundle < 200KB gzipped
- **Accessibility**: WCAG 2.1 AA compliance
- **TypeScript**: Strict mode enabled, no `any` types

## Recommended Actions

1. **Immediate**: Fix a11y issues, security vulnerabilities, broken builds
2. **Short term**: Migrate to React 19 patterns, optimize bundle
3. **Next sprint**: Improve test coverage, refactor large components
4. **Backlog**: Design system documentation, performance monitoring

## Integrated Support Tools

- React DevTools for component inspection and profiling
- Lighthouse for performance and a11y audits
- axe DevTools for accessibility testing
- Bundle analyzer (webpack-bundle-analyzer, vite-bundle-visualizer)
- Tailwind CSS IntelliSense for IDE support

---

## Examples

```bash
/devkit.react.code-review example-input
```

© Giuseppe Trisciuoglio · MIT · giuseppe-trisciuoglio/developer-kit

Похожие слэш-команды

Все слэш-команды по теме «Код-ревью и рефакторинг» →
react-flow-code-review existential-birds Скилл react-flow-code-review для Claude Code и Codex проверяет код на @xyflow/react по чек-листу: антипаттерны, лишние ре-рендеры, типы. Фиксирует тормоза графа и пересоздание нод. CX Codex +1 329установок react-router-code-review existential-birds Скилл react-router-code-review для Claude Code проверяет код роутинга в React Router v6.4 и новее: лоадеры, экшены, границы ошибок и навигацию. CX Codex +1 202установок next.js-react-typescript-cursor-rules qdleader Правило next.js-react-typescript-cursor-rules задаёт стиль и структуру кода для Next.js, React и TypeScript. Подходит для проектов с App Router, Shadcn UI, Radix UI и Tailwind. CX Codex +1 ★ 571звёзд репо typescript-react-reviewer dotneet Скилл typescript-react-reviewer для ревью кода на TypeScript и React 19: находит антипаттерны, ошибки хуков и проблемы типизации. Пригодится перед мержем PR. CX Codex +1 9 000установок react-best-practices mastra-ai Скилл react-best-practices для Claude Code, Cursor, Codex, GitHub Copilot и других агентов: 27 правил по 9 категориям оптимизации React. Подключается при написании, ревью или рефакторинге компонентов. CX Codex +1 2 900установок narrow-react-prop-types humanlayer Скилл narrow-react-prop-types сужает типы пропсов React-компонента до контракта, который реально используется в живом коде, и заставляет сторис и тесты подстроиться под него. CX Codex +1 1 500установок

Из того же набора191

Весь набор →
python-software-architect-expert Субагент python-software-architect-expert для Claude Code анализирует архитектуру Python-проекта и предлагает изменения с учётом Clean Architecture, DDD и SOLID. Разбирает модули и архитектурные решения. CX Codex ★ 372звёзд репо aws-architecture-review-expert Субагент aws-architecture-review-expert проверяет шаблоны CloudFormation и архитектуру AWS по шести столпам Well-Architected Framework и находит проблемы безопасности. CX Codex ★ 372звёзд репо devkit.generate-document Команда devkit.generate-document анализирует кодовую базу и готовит структурированные технические или бизнес-документы. Задайте тип документа, язык и цель. CX Codex +1 ★ 372звёзд репо speckit.check-integration Команда speckit.check-integration разбирает tasks.md и показывает, где задачи пересекаются с уже написанным кодом: что можно переиспользовать, а что дублирует существующее. CX Codex +1 ★ 372звёзд репо aws-cloudformation-cloudfront Скилл aws-cloudformation-cloudfront помогает собирать CloudFormation-шаблоны для CloudFront: настраивает origins, кэширование, домены, WAF и логи. CX Codex +1 ★ 372звёзд репо aws-cloudformation-cloudwatch Скилл aws-cloudformation-cloudwatch для Claude Code описывает CloudWatch в шаблоне CloudFormation: алармы, дашборды, лог-группы и метрик-фильтры. Мониторинг продакшена хранится в коде. CX Codex +1 ★ 372звёзд репо python-refactor-expert Субагент python-refactor-expert для Claude Code переписывает Python-код без изменения логики: наводит порядок в архитектуре, выносит настройки и внедряет тайпхинты. Пригодится после реализации новых фич. CX Codex ★ 372звёзд репо nestjs-security-expert Субагент nestjs-security-expert для Claude Code помогает настраивать аутентификацию и защищать NestJS API. Подключается при работе с JWT, ролями, OAuth и уязвимостями. CX Codex ★ 372звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой