sfera/CLAUDE.md

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

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

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

• rules-complete1.md - основные бизнес-правила (рекомендуется при сложных задачах)
• rules-complete2.md - система партнерства и дополнительные правила
• workflow-catalog.md - каталог всех бизнес-процессов системы
• MODULAR_ARCHITECTURE_PATTERN.md - ОБЯЗАТЕЛЬНАЯ архитектура для новых компонентов >500 строк

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

• 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
• Упоминание "компонент", "создание", "dashboard", ">500 строк", "архитектура" → читать MODULAR_ARCHITECTURE_PATTERN.md

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

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

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

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

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

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

1. При необходимости прочитать rules-complete1.md - для справки по бизнес-правилам
2. Читать rules-complete2.md - при работе с партнерством/контрагентами
3. Следовать правилам взаимодействия - см. interaction-integrity-rules.md
4. Проверить специфичные правила кабинета - если работа с конкретным типом организации
5. Проверить архитектурные требования - для компонентов >500 строк читать MODULAR_ARCHITECTURE_PATTERN.md
6. Использовать TodoWrite - для планирования задач
7. Следовать техническим правилам - GraphQL, TypeScript, система партнерства
8. Проверять реализацию - соответствие правилам и архитектуре

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

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

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

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

⚡ Принципы качества кода:

• Качество кода важнее скорости - лучше потратить время на правильное решение
• Pre-commit hooks существуют для защиты проекта - никогда не обходить их
• Исправлять ошибки, а не обходить их - каждая ошибка ESLint должна быть исправлена
• Обход проверок создает технический долг - --no-verify использовать только в крайних случаях
• Профессиональный подход к конфигурации - точная настройка инструментов, не "заметание под ковер"

📋 Подробные правила: см. разделы 1.2-1.3 в interaction-integrity-rules.md

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

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

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

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

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

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

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

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

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

🔄 КОМАНДЫ ОТКАТА

Откат через комментарии:

Основная команда:

"откати [описание] через комментарии"

Примеры:

• "откати центрирование поиска через комментарии"
• "откати изменения кнопки через комментарии"
• "откати новую логику через комментарии"

Дополнительные команды:

• "очисти комментарии" - удалить закомментированные варианты
• "переключи на вариант 2" - активировать закомментированный код
• "покажи варианты" - показать доступные варианты

📖 Подробнее: см. раздел 6.4 в interaction-integrity-rules.md

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

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

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

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

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

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

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

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

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