# СИСТЕМНЫЕ ПРАВИЛА ДЛЯ CLAUDE CODE

## 📚 ФАЙЛЫ ПРАВИЛ СИСТЕМЫ

### Обязательные для чтения:

- **`rules-complete.md`** - основные бизнес-правила (ВСЕГДА читать первым)
- **`workflow-catalog.md`** - каталог всех бизнес-процессов системы

### Специфичные правила по кабинетам:

- **`wholesale-cabinet-rules.md`** - при работе с кабинетом поставщика
- **`logist-cabinet-rules.md`** - при работе с кабинетом логистики
- **`fulfillment-cabinet-rules.md`** - при работе с кабинетом фулфилмента
- **`seller-ui-rules.md`** - при работе с UI/UX кабинета селлера
- **`visual-design-rules.md`** - при работе с UI/UX

### Правила взаимодействия:

- **`interaction-integrity-rules.md`** - детальная методология работы (честность, прозрачность, неизменность планов, каноническая последовательность)

### Автоматическая активация:

- Упоминание "поставщик", "wholesale", "/warehouse", "/supplier-orders" → читать wholesale-cabinet-rules.md
- Упоминание "логистика", "доставка", "logist", "/logistics-requests", "/routes" → читать logist-cabinet-rules.md
- Упоминание "фулфилмент", "fulfillment", "/services", "/employees" → читать fulfillment-cabinet-rules.md
- Упоминание "селлер", "seller", "/supplies", "/my-supplies" → читать seller-ui-rules.md
- Упоминание "workflow", "процесс", "этап", "статус" → читать workflow-catalog.md
- Упоминание "дизайн", "UI", "компонент", "стиль" → читать visual-design-rules.md

## 🚨 ЕДИНСТВЕННЫЙ ИСТОЧНИК ПРАВИЛ

**КРИТИЧЕСКИ ВАЖНО:** Общие правила системы находятся в файле **`rules-complete.md`** - это основной источник истины.

❌ **НЕ СУЩЕСТВУЕТ:**

- development-checklist.md (удален)
- rules.md (удален)
- rules1.md (удален)
- rules2.md (удален)
- CLAUDE.md устаревших версий

## 🎯 WORKFLOW РАЗРАБОТКИ

### Обязательный порядок действий:

1. **Читать `rules-complete.md`** - перед любым изменением кода
2. **Следовать правилам взаимодействия** - см. [interaction-integrity-rules.md](./interaction-integrity-rules.md)
3. **Проверить специфичные правила кабинета** - если работа с конкретным типом организации
4. **Использовать TodoWrite** - для планирования задач
5. **Следовать техническим правилам** - GraphQL, TypeScript, система партнерства
6. **Проверять реализацию** - соответствие правилам и архитектуре

## 📋 КЛЮЧЕВЫЕ ПРИНЦИПЫ

> ⚠️ **ВАЖНО**: Все детальные правила взаимодействия и поведенческие принципы перенесены в **[interaction-integrity-rules.md](./interaction-integrity-rules.md)**

### Основные принципы разработки:

1. **НЕ ПРЕДПОЛАГАТЬ** - всегда уточнять при сомнениях
2. **ПРОВЕРЯТЬ СХЕМЫ** - GraphQL и Prisma должны соответствовать коду
3. **СЛЕДОВАТЬ WORKFLOW** - не нарушать последовательность статусов
4. **ДОКУМЕНТИРОВАТЬ** - обновлять rules-complete.md при решениях проблем

### Правила взаимодействия (кратко):

- **Двухэтапный процесс**: Планирование → Одобрение → Выполнение
- **Неизменность планов**: согласованные планы нельзя менять без разрешения
- **Честность и прозрачность**: открыто сообщать о неопределенностях
- **Протоколы по сложности**: для каждого типа задач свой подход

## 🔧 КОМАНДЫ ПРОВЕРКИ КОДА

### Обязательные команды после изменений:

```bash
# TypeScript проверка типов
npm run typecheck

# Проверка линтером
npm run lint

# Запуск тестов
npm test

# Dev сервер для проверки работы
npm run dev
```

> ⚠️ **ВАЖНО**: Всегда выполнять эти команды перед завершением задачи!

## 💾 РАБОТА С КОНТЕКСТОМ

### Файлы для сохранения контекста:

- **`current-session.md`** - текущая сессия работы (активные задачи, решения, контекст)
- **`CLAUDE.md`** - системные правила и команды (этот файл)
- **TodoWrite инструмент** - для планирования и отслеживания задач

### При потере контекста:

1. **Первым делом прочитать**: `current-session.md`
2. **Проверить статус задач**: через TodoWrite
3. **Восстановить контекст**: из истории изменений в current-session.md

### Рекомендации для длинных сессий:

- Обновлять `current-session.md` после каждой важной задачи
- Фиксировать принятые решения и обоснования
- Документировать обнаруженные проблемы и их решения
- Использовать `--resume` флаг для продолжения сессий

## 🚨 НАПОМИНАНИЕ

**Этот файл служит для корректной работы system-reminder'ов. Все детальные правила находятся в `rules-complete.md`!**